1193 lines
42 KiB
YAML
1193 lines
42 KiB
YAML
---
|
|
version: '3'
|
|
|
|
includes:
|
|
ansible:
|
|
taskfile: ./.config/taskfiles/ansible/Taskfile.yml
|
|
optional: true
|
|
ansible:ansibler:
|
|
taskfile: ./.config/taskfiles/ansible/Taskfile-ansibler.yml
|
|
optional: true
|
|
ansible:playbook:
|
|
taskfile: ./.config/taskfiles/ansible/Taskfile-playbook.yml
|
|
optional: true
|
|
ansible:populate:
|
|
taskfile: ./.config/taskfiles/ansible/Taskfile-populate.yml
|
|
optional: true
|
|
ansible:test:
|
|
taskfile: ./.config/taskfiles/ansible/Taskfile-test.yml
|
|
optional: true
|
|
app:
|
|
taskfile: ./.config/taskfiles/app/Taskfile.yml
|
|
optional: true
|
|
app:virtualbox:
|
|
taskfile: ./.config/taskfiles/app/Taskfile-virtualbox.yml
|
|
optional: true
|
|
boilerplate:
|
|
taskfile: ./.config/taskfiles/boilerplate/Taskfile.yml
|
|
optional: true
|
|
boilerplate:populate:
|
|
taskfile: ./.config/taskfiles/boilerplate/Taskfile-populate.yml
|
|
optional: true
|
|
boilerplate:prompt:
|
|
taskfile: ./.config/taskfiles/boilerplate/Taskfile-prompt.yml
|
|
optional: true
|
|
ci:
|
|
taskfile: ./.config/taskfiles/ci/Taskfile.yml
|
|
optional: true
|
|
ci:github:
|
|
taskfile: ./.config/taskfiles/ci/Taskfile-github.yml
|
|
optional: true
|
|
cloud:
|
|
taskfile: ./.config/taskfiles/cloud/Taskfile.yml
|
|
optional: true
|
|
cloud:cloudflare:
|
|
taskfile: ./.config/taskfiles/cloud/Taskfile-cloudflare.yml
|
|
optional: true
|
|
cloud:dyno:
|
|
taskfile: ./.config/taskfiles/cloud/Taskfile-dyno.yml
|
|
optional: true
|
|
cloud:heroku:
|
|
taskfile: ./.config/taskfiles/cloud/Taskfile-heroku.yml
|
|
optional: true
|
|
cloud:s3:
|
|
taskfile: ./.config/taskfiles/cloud/Taskfile-s3.yml
|
|
optional: true
|
|
common:
|
|
taskfile: ./.config/taskfiles/common/Taskfile.yml
|
|
optional: true
|
|
common:code:
|
|
taskfile: ./.config/taskfiles/common/Taskfile-code.yml
|
|
optional: true
|
|
common:start:
|
|
taskfile: ./.config/taskfiles/common/Taskfile-start.yml
|
|
optional: true
|
|
common:update:
|
|
taskfile: ./.config/taskfiles/common/Taskfile-update.yml
|
|
optional: true
|
|
common:util:
|
|
taskfile: ./.config/taskfiles/common/Taskfile-util.yml
|
|
optional: true
|
|
docker:
|
|
taskfile: ./.config/taskfiles/docker/Taskfile.yml
|
|
optional: true
|
|
docker:build:
|
|
taskfile: ./.config/taskfiles/docker/Taskfile-build.yml
|
|
optional: true
|
|
docker:test:
|
|
taskfile: ./.config/taskfiles/docker/Taskfile-test.yml
|
|
optional: true
|
|
docker:update:
|
|
taskfile: ./.config/taskfiles/docker/Taskfile-update.yml
|
|
optional: true
|
|
dotfiles:
|
|
taskfile: ./.config/taskfiles/dotfiles/Taskfile.yml
|
|
optional: true
|
|
fix:
|
|
taskfile: ./.config/taskfiles/fix/Taskfile.yml
|
|
optional: true
|
|
git:
|
|
taskfile: ./.config/taskfiles/git/Taskfile.yml
|
|
optional: true
|
|
git:bug:
|
|
taskfile: ./.config/taskfiles/git/Taskfile-bug.yml
|
|
optional: true
|
|
git:github:
|
|
taskfile: ./.config/taskfiles/git/Taskfile-github.yml
|
|
optional: true
|
|
git:gitlab:
|
|
taskfile: ./.config/taskfiles/git/Taskfile-gitlab.yml
|
|
optional: true
|
|
git:gitomatic:
|
|
taskfile: ./.config/taskfiles/git/Taskfile-gitomatic.yml
|
|
optional: true
|
|
git:hook:
|
|
taskfile: ./.config/taskfiles/git/Taskfile-hook.yml
|
|
optional: true
|
|
git:issues:
|
|
taskfile: ./.config/taskfiles/git/Taskfile-issues.yml
|
|
optional: true
|
|
go:
|
|
taskfile: ./.config/taskfiles/go/Taskfile.yml
|
|
optional: true
|
|
go:goreleaser:
|
|
taskfile: ./.config/taskfiles/go/Taskfile-goreleaser.yml
|
|
optional: true
|
|
go:test:
|
|
taskfile: ./.config/taskfiles/go/Taskfile-test.yml
|
|
optional: true
|
|
image:
|
|
taskfile: ./.config/taskfiles/image/Taskfile.yml
|
|
optional: true
|
|
install:
|
|
taskfile: ./.config/taskfiles/install/Taskfile.yml
|
|
optional: true
|
|
install:ansible:
|
|
taskfile: ./.config/taskfiles/install/Taskfile-ansible.yml
|
|
optional: true
|
|
install:apt:
|
|
taskfile: ./.config/taskfiles/install/Taskfile-apt.yml
|
|
optional: true
|
|
install:gh:
|
|
taskfile: ./.config/taskfiles/install/Taskfile-gh.yml
|
|
optional: true
|
|
install:github:
|
|
taskfile: ./.config/taskfiles/install/Taskfile-github.yml
|
|
optional: true
|
|
install:go:
|
|
taskfile: ./.config/taskfiles/install/Taskfile-go.yml
|
|
optional: true
|
|
install:npm:
|
|
taskfile: ./.config/taskfiles/install/Taskfile-npm.yml
|
|
optional: true
|
|
install:pipx:
|
|
taskfile: ./.config/taskfiles/install/Taskfile-pipx.yml
|
|
optional: true
|
|
install:python:
|
|
taskfile: ./.config/taskfiles/install/Taskfile-python.yml
|
|
optional: true
|
|
install:qubes:
|
|
taskfile: ./.config/taskfiles/install/Taskfile-qubes.yml
|
|
optional: true
|
|
install:requirements:
|
|
taskfile: ./.config/taskfiles/install/Taskfile-requirements.yml
|
|
optional: true
|
|
install:rust:
|
|
taskfile: ./.config/taskfiles/install/Taskfile-rust.yml
|
|
optional: true
|
|
install:service:
|
|
taskfile: ./.config/taskfiles/install/Taskfile-service.yml
|
|
optional: true
|
|
install:software:
|
|
taskfile: ./.config/taskfiles/install/Taskfile-software.yml
|
|
optional: true
|
|
install:tap:
|
|
taskfile: ./.config/taskfiles/install/Taskfile-tap.yml
|
|
optional: true
|
|
install:ventoy:
|
|
taskfile: ./.config/taskfiles/install/Taskfile-ventoy.yml
|
|
optional: true
|
|
lint:
|
|
taskfile: ./.config/taskfiles/lint/Taskfile.yml
|
|
optional: true
|
|
lint:codeclimate:
|
|
taskfile: ./.config/taskfiles/lint/Taskfile-codeclimate.yml
|
|
optional: true
|
|
lint:esprint:
|
|
taskfile: ./.config/taskfiles/lint/Taskfile-esprint.yml
|
|
optional: true
|
|
lint:markdown:
|
|
taskfile: ./.config/taskfiles/lint/Taskfile-markdown.yml
|
|
optional: true
|
|
lint:prose:
|
|
taskfile: ./.config/taskfiles/lint/Taskfile-prose.yml
|
|
optional: true
|
|
localhost:
|
|
taskfile: ./../../Taskfile-localhost.yml
|
|
optional: true
|
|
|
|
log:
|
|
optional: true
|
|
taskfile: ./.config/taskfiles/log/Taskfile.yml
|
|
nest:
|
|
taskfile: ./.config/taskfiles/nest/Taskfile.yml
|
|
optional: true
|
|
npm:
|
|
taskfile: ./.config/taskfiles/npm/Taskfile.yml
|
|
optional: true
|
|
npm:bundle:
|
|
taskfile: ./.config/taskfiles/npm/Taskfile-bundle.yml
|
|
optional: true
|
|
npm:cov:
|
|
taskfile: ./.config/taskfiles/npm/Taskfile-cov.yml
|
|
optional: true
|
|
npm:doc:
|
|
taskfile: ./.config/taskfiles/npm/Taskfile-doc.yml
|
|
optional: true
|
|
packer:
|
|
taskfile: ./.config/taskfiles/packer/Taskfile.yml
|
|
optional: true
|
|
packer:build:
|
|
taskfile: ./.config/taskfiles/packer/Taskfile-build.yml
|
|
optional: true
|
|
packer:update:
|
|
taskfile: ./.config/taskfiles/packer/Taskfile-update.yml
|
|
optional: true
|
|
publish:
|
|
taskfile: ./.config/taskfiles/publish/Taskfile.yml
|
|
optional: true
|
|
publish:android:
|
|
taskfile: ./.config/taskfiles/publish/Taskfile-android.yml
|
|
optional: true
|
|
publish:brew:
|
|
taskfile: ./.config/taskfiles/publish/Taskfile-brew.yml
|
|
optional: true
|
|
publish:chrome:
|
|
taskfile: ./.config/taskfiles/publish/Taskfile-chrome.yml
|
|
optional: true
|
|
publish:firefox:
|
|
taskfile: ./.config/taskfiles/publish/Taskfile-firefox.yml
|
|
optional: true
|
|
publish:ios:
|
|
taskfile: ./.config/taskfiles/publish/Taskfile-ios.yml
|
|
optional: true
|
|
publish:menubar:
|
|
taskfile: ./.config/taskfiles/publish/Taskfile-menubar.yml
|
|
optional: true
|
|
publish:opera:
|
|
taskfile: ./.config/taskfiles/publish/Taskfile-opera.yml
|
|
optional: true
|
|
publish:snap:
|
|
taskfile: ./.config/taskfiles/publish/Taskfile-snap.yml
|
|
optional: true
|
|
python:
|
|
taskfile: ./.config/taskfiles/python/Taskfile.yml
|
|
optional: true
|
|
python:test:
|
|
taskfile: ./.config/taskfiles/python/Taskfile-test.yml
|
|
optional: true
|
|
release:
|
|
taskfile: ./.config/taskfiles/release/Taskfile.yml
|
|
optional: true
|
|
security:
|
|
taskfile: ./.config/taskfiles/security/Taskfile.yml
|
|
optional: true
|
|
security:disk:
|
|
taskfile: ./.config/taskfiles/security/Taskfile-disk.yml
|
|
optional: true
|
|
security:gpg:
|
|
taskfile: ./.config/taskfiles/security/Taskfile-gpg.yml
|
|
optional: true
|
|
security:ssh:
|
|
taskfile: ./.config/taskfiles/security/Taskfile-ssh.yml
|
|
optional: true
|
|
security:yubikey:
|
|
taskfile: ./.config/taskfiles/security/Taskfile-yubikey.yml
|
|
optional: true
|
|
symlink:
|
|
taskfile: ./.config/taskfiles/symlink/Taskfile.yml
|
|
optional: true
|
|
ui:
|
|
taskfile: ./.config/taskfiles/ui/Taskfile.yml
|
|
optional: true
|
|
update:
|
|
taskfile: ./.config/taskfiles/update/Taskfile.yml
|
|
optional: true
|
|
upstream:
|
|
taskfile: ./.config/taskfiles/upstream/Taskfile.yml
|
|
optional: true
|
|
upstream:common:
|
|
taskfile: ./.config/taskfiles/upstream/Taskfile-common.yml
|
|
optional: true
|
|
upstream:commondocs:
|
|
taskfile: ./.config/taskfiles/upstream/Taskfile-commondocs.yml
|
|
optional: true
|
|
upstream:docs:
|
|
taskfile: ./.config/taskfiles/upstream/Taskfile-docs.yml
|
|
optional: true
|
|
upstream:project:
|
|
taskfile: ./.config/taskfiles/upstream/Taskfile-project.yml
|
|
optional: true
|
|
upstream:shared:
|
|
taskfile: ./.config/taskfiles/upstream/Taskfile-shared.yml
|
|
optional: true
|
|
vagrant:
|
|
taskfile: ./.config/taskfiles/vagrant/Taskfile.yml
|
|
optional: true
|
|
vagrant:qubes:
|
|
taskfile: ./.config/taskfiles/vagrant/Taskfile-qubes.yml
|
|
optional: true
|
|
vscode:
|
|
taskfile: ./.config/taskfiles/vscode/Taskfile.yml
|
|
optional: true
|
|
web:
|
|
taskfile: ./.config/taskfiles/web/Taskfile.yml
|
|
optional: true
|
|
web:cloudflare:
|
|
taskfile: ./.config/taskfiles/web/Taskfile-cloudflare.yml
|
|
optional: true
|
|
web:ionic:
|
|
taskfile: ./.config/taskfiles/web/Taskfile-ionic.yml
|
|
optional: true
|
|
web:nx:
|
|
taskfile: ./.config/taskfiles/web/Taskfile-nx.yml
|
|
optional: true
|
|
web:profile:
|
|
taskfile: ./.config/taskfiles/web/Taskfile-profile.yml
|
|
optional: true
|
|
output: interleaved
|
|
|
|
vars:
|
|
DOCKERHUB_PROFILE:
|
|
sh: |
|
|
if [ -f .config/variables.json ] && type jq &> /dev/null; then
|
|
echo "$(jq -r '.profile.dockerhub' .config/variables.json)"
|
|
else
|
|
echo 'megabytelabs'
|
|
fi
|
|
DOCKERHUB_USER:
|
|
sh: |
|
|
if [ -f .config/variables.json ] && type jq &> /dev/null; then
|
|
echo "$(jq -r '.profile.dockerHubUser' .config/variables.json)"
|
|
else
|
|
echo 'ProfessorManhattan'
|
|
fi
|
|
ESLINT_FIX_RECURSIVE: 'true'
|
|
ESLINT_FORMATTER: stylish
|
|
ESLINT_FORMATTER_OPTIONS: git-log gitlab pretty summary
|
|
GALAXY_AUTHOR: ProfessorManhattan
|
|
GALAXY_COMPANY: Megabyte Labs
|
|
GALAXY_NAMESPACE:
|
|
sh: |
|
|
if [ -f meta/main.yml ]; then
|
|
grep namespace < meta/main.yml | sed 's/.*namespace: \\(.*\\)$/\\1/g'
|
|
else
|
|
if [ -f .config/variables.json ] && type jq &> /dev/null; then
|
|
echo "$(jq -r '.profile.galaxy' .config/variables.json)"
|
|
else
|
|
echo 'ProfessorManhattan'
|
|
fi
|
|
fi
|
|
GALAXY_ROLE_NAME:
|
|
sh: "if [ -f meta/main.yml ]; then grep role_name < meta/main.yml | sed 's/.*role_name: \\(.*\\)$/\\1/g'; fi"
|
|
GITHUB_ORG:
|
|
sh: |
|
|
if [ -f package.json ] && type jq &> /dev/null && [ "$(jq -r '.blueprint.repository.github' package.json)" != 'null' ]; then
|
|
echo "$(jq -r '.blueprint.repository.github' package.json | sed 's/https:\/\/github.com\///' | sed 's/\/.*$//')"
|
|
elif [ -f .config/variables.json ] && type jq &> /dev/null; then
|
|
echo "$(jq -r '.profile.githubOrg' .config/variables.json)"
|
|
else
|
|
echo 'megabyte-labs'
|
|
fi
|
|
GITHUB_USER:
|
|
sh: |
|
|
if [ -f .config/variables.json ] && type jq &> /dev/null; then
|
|
echo "$(jq -r '.profile.github' .config/variables.json)"
|
|
else
|
|
echo 'ProfessorManhattan'
|
|
fi
|
|
GROUP_EXEC_ASYNC: 'false'
|
|
# yamllint disable rule:line-length
|
|
IGNORE_FOLDERS: >-
|
|
-path './.autodoc/*' -o -path './.cache/*' -o -path './.common*' -o -path './.config/*' -o -path './.git/*' -o
|
|
-path './.modules/*' -o -path './.npm/*' -o
|
|
-path './.pnpm-store/*' -o -path './.shared/*' -o -path './.task/*' -o -path './.venv/*' -o -path './.vscode/*' -o
|
|
-path './build/*' -o -path './dist/*' -o -path './node_modules/*' -o -path './roles/*' -o -name pnpm-lock.yaml -o
|
|
-name package-lock.json -o -name poetry.lock -o -name '.variables.json' -o -name '.git'
|
|
INIT_SCRIPT: https://gitlab.com/megabyte-labs/gitlab-ci/-/raw/master/scripts/update-init.sh
|
|
LOG_FIX:
|
|
sh: chmod +x .config/log
|
|
MODEL_TASKFILE: https://gitlab.com/megabyte-labs/common/shared/-/raw/master/Taskfile.yml
|
|
NPM_KEEP_UPDATED: ''
|
|
NPM_PROGRAM: pnpm
|
|
PROJECT_TYPE:
|
|
sh: |
|
|
if type jq &> /dev/null && [ -f package.json ]; then VER="$(jq -r '.blueprint.group' package.json)"; if [ "$VER" == 'null' ]; then TYPE="$GROUP_TYPE"; else TYPE="$VER"; fi; else TYPE="$GROUP_TYPE"; fi
|
|
if type jq &> /dev/null && [ -f package.json ]; then VER="$(jq -r '.blueprint.subgroup' package.json)"; if [ "$VER" == 'null' ]; then SUBTYPE="$REPOSITORY_TYPE"; else SUBTYPE="$VER"; fi; else SUBTYPE="$REPOSITORY_TYPE"; fi
|
|
if [ "$TYPE" == 'common' ] && [ "$SUBTYPE" == 'shared' ]; then
|
|
echo 'shared'
|
|
elif [ "$TYPE" == 'common' ]; then
|
|
echo 'common'
|
|
elif [ "$TYPE" == 'documentation' ] && [ "$SUBTYPE" == 'shared' ]; then
|
|
echo 'commondocs'
|
|
elif [ "$TYPE" == 'documentation' ]; then
|
|
echo 'docs'
|
|
else
|
|
echo 'project'
|
|
fi
|
|
# yamllint enable rule:line-length
|
|
PYTHON_HANDLE:
|
|
sh: |
|
|
if type poetry &> /dev/null; then
|
|
echo 'poetry run '
|
|
else
|
|
echo ''
|
|
fi
|
|
PYTHON_VIRTUALENV: true
|
|
REPOSITORY_SUBTYPE:
|
|
sh: |
|
|
if [ -n "$REPOSITORY_TYPE" ]; then REPO_SUBTYPE="$REPOSITORY_TYPE"; fi
|
|
if type jq &> /dev/null && [ -f package.json ]; then
|
|
VER="$(jq -r '.blueprint.subgroup' package.json)"
|
|
if [ "$VER" == 'null' ]; then
|
|
if [ -n "$REPO_SUBTYPE" ]; then echo "$REPO_SUBTYPE"; else echo "misc"; fi
|
|
else
|
|
echo "$VER"
|
|
fi
|
|
else
|
|
if [ -n "$REPO_SUBTYPE" ]; then echo "$REPO_SUBTYPE"; else echo "misc"; fi
|
|
fi
|
|
REPOSITORY_TYPE:
|
|
sh: |
|
|
if [ -n "$GROUP_TYPE" ]; then REPO_TYPE="$GROUP_TYPE"; fi
|
|
if type jq &> /dev/null && [ -f package.json ]; then
|
|
VER="$(jq -r '.blueprint.group' package.json)"
|
|
if [ "$VER" == 'null' ]; then
|
|
if [ -n "$REPO_TYPE" ]; then echo "$REPO_TYPE"; else echo "misc"; fi
|
|
else
|
|
echo "$VER"
|
|
fi
|
|
else
|
|
if [ -n "$REPO_TYPE" ]; then echo "$REPO_TYPE"; else echo "misc"; fi
|
|
fi
|
|
SEMANTIC_CONFIG: semantic-release-config
|
|
TIMEZONE: America/New_York
|
|
|
|
env:
|
|
GOPATH:
|
|
sh: |
|
|
if [ -z "$GOPATH" ]; then
|
|
echo "$HOME/.local/go"
|
|
else
|
|
echo "$GOPATH"
|
|
fi
|
|
OSTYPE:
|
|
sh: |
|
|
{{if (eq OS "linux")}}LINUX_FLAVOR='linux-gnu'
|
|
LIBC=$(ldd /bin/ls | grep 'musl' | head -1 | cut -d ' ' -f1)
|
|
if [ -n "$LIBC" ]; then LINUX_FLAVOR='linux-musl'; fi{{end}}
|
|
echo "{{if (eq OS "linux")}}$LINUX_FLAVOR{{else}}darwin{{end}}"
|
|
PATH:
|
|
sh: |
|
|
PATH="$PATH:$HOME/.local/bin:$HOME/.poetry/bin:$HOME/.gem/bin:$HOME/.asdf/bin"
|
|
PATH="$PATH:$HOME/.local/go/bin:$HOME/go/bin"
|
|
PATH="$PATH:/home/linuxbrew/.linuxbrew/bin:/home/linuxbrew/.linuxbrew/sbin"
|
|
PATH="$PATH:$PWD/bin"
|
|
PATH="$PATH:$HOME/.volta/bin"
|
|
echo "$PATH"
|
|
RECORD_INSTALL:
|
|
sh: if [ -n "$CI" ]; then echo 'true'; fi
|
|
SENTRY_DSN:
|
|
sh: |
|
|
if type jq &> /dev/null; then
|
|
DSN="$(jq -r '.blueprint.sentryDSN' package.json)"
|
|
if [ "$DSN" != 'null' ]; then echo "$DSN"; fi
|
|
fi
|
|
VOLTA_HOME:
|
|
sh: echo "$HOME/.volta"
|
|
|
|
profile: |
|
|
if [[ "$OSTYPE" == 'linux-gnu'* ]] || [[ "$OSTYPE" == 'linux-musl'* ]]; then
|
|
if [ -f /home/linuxbrew/.linuxbrew/bin/brew ] && ! type brew > /dev/null; then
|
|
eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"
|
|
fi
|
|
fi
|
|
if [[ "$OSTYPE" == 'darwin'* ]] && type brew > /dev/null; then
|
|
BREW_PREFIX="$(brew --prefix)"
|
|
PATH="$PATH:$BREW_PREFIX/opt/coreutils/libexec/gnubin"
|
|
PATH="$PATH:$BREW_PREFIX/opt/findutils/libexec/gnubin"
|
|
PATH="$PATH:$BREW_PREFIX/opt/gnu-sed/libexec/gnubin"
|
|
PATH="$PATH:$BREW_PREFIX/opt/grep/libexec/gnubin"
|
|
PATH="$PATH:$BREW_PREFIX/opt/gnu-tar/libexec/gnubin"
|
|
PATH="$PATH:$BREW_PREFIX/opt/gawk/libexec/gnubin"
|
|
fi
|
|
if [ -f .venv/bin/activate ]; then
|
|
. .venv/bin/activate
|
|
fi
|
|
|
|
tasks:
|
|
build:
|
|
deps:
|
|
- install:software:jq
|
|
- install:software:node
|
|
desc: Build the project using the build script defined in `package.json`
|
|
summary: |
|
|
# Build the Project
|
|
|
|
Use this command to build the project. It executes the command defined
|
|
in `package.json` under the `.scripts.build` key.
|
|
vars:
|
|
NONINTERACTIVE_MISSING_BUILD_CMD: There must be a build command under `.scripts.build` in `package.json`!
|
|
log:
|
|
error: Encountered error while running `npm run build`
|
|
start: Running `npm run build`
|
|
success: Successfully ran `npm run build`
|
|
cmds:
|
|
- |
|
|
if [ "$(jq '.scripts.build' package.json)" != 'null' ]; then
|
|
if type npm &> /dev/null; then
|
|
npm run build
|
|
else
|
|
task {{.REPOSITORY_TYPE}}:build
|
|
fi
|
|
else
|
|
[[ $- == *i* ]] && task prepare || (.config/log error '{{.NONINTERACTIVE_MISSING_BUILD_CMD}}' && exit 1)
|
|
fi
|
|
|
|
clean:
|
|
desc: Removes optional folders that are cached during various tasks
|
|
summary: |
|
|
# Clean Project / Remove Optional Directories and Files
|
|
|
|
This task will remove all the unnecessary files that are downloaded, generated, and
|
|
cached during various build steps. This task is used by the `reset` task
|
|
which will re-generate the project from scratch. Ideally, this task and the reset task
|
|
should never be necessary. The `start` task should be used instead.
|
|
vars:
|
|
CLEAN_TARGETS: .autodoc .cache .task .venv node_modules tsconfig.tsbuildinfo venv
|
|
.variables.json
|
|
cmds:
|
|
- task: common:clean
|
|
vars:
|
|
CLEAN_TARGETS: '{{.CLEAN_TARGETS}}'
|
|
|
|
commit:
|
|
desc: Lint staged files, report spelling errors, and open a _required_ commit dialoge
|
|
summary: |
|
|
# Commit Code
|
|
|
|
This task will perform linting and auto-fixing on the files that have been staged in
|
|
git (i.e. the files that were added with `git add --all`). It will then report possible
|
|
spelling errors that you may choose to fix. Then, it opens a _required_ interactive commit
|
|
questionnaire that will help you make better commits that are compatible with software
|
|
that generates the CHANGELOG.md.
|
|
|
|
It is very important that you use this task to commit rather than the conventional approach
|
|
using `git commit -m`. However, if you really need to, you can add the flag `--no-verify`
|
|
to your regular `git commit -m` command to bypass the pre-commit hook.
|
|
cmds:
|
|
- task: common:commit
|
|
|
|
commit:all:
|
|
deps:
|
|
- install:software:git
|
|
desc: Add all the untracked changes and commit the code
|
|
summary: |
|
|
# Commit All Untracked Code
|
|
|
|
By default, this task is an alias for:
|
|
|
|
```
|
|
git add --all
|
|
git commit
|
|
```
|
|
|
|
If you pass a commit message as a CLI argument, then the pre-commit
|
|
logic will be bypassed. By bypassing the hooks, the commit message will be
|
|
excluded from the automatic CHANGELOG.md entry generated during commits.
|
|
Passing the commit message as a CLI argument can be done like so:
|
|
|
|
```
|
|
task commit -- "Added new files that do not need to show up in CHANGELOG.md"
|
|
```
|
|
log:
|
|
error: Error while running commit logic
|
|
start: Adding all changes and committing
|
|
success: Successfully commit changes
|
|
cmds:
|
|
- |
|
|
{{if .CLI_ARGS}}
|
|
task --list > /dev/null || (echo "ERROR: Invalid Taskfiles!" && exit 1)
|
|
git add --all
|
|
HUSKY=0 git commit -m "{{.CLI_ARGS}}" --no-verify
|
|
{{else}}
|
|
task --list > /dev/null || (echo "ERROR: Invalid Taskfiles!" && exit 1)
|
|
git add --all
|
|
git commit
|
|
{{end}}
|
|
|
|
commit:quick:
|
|
deps:
|
|
- ci:commit:config
|
|
cmds:
|
|
- |
|
|
task --list > /dev/null || (echo "ERROR: Invalid Taskfiles!" && exit 1)
|
|
git add --all
|
|
- HUSKY=0 git commit -m '🔧 chore(tweak): quick minor update' --no-verify
|
|
- git push origin master
|
|
|
|
devcontainer:
|
|
deps:
|
|
- install:npm:devcontainer
|
|
- install:software:docker
|
|
|
|
donothing: 'true'
|
|
|
|
fix:
|
|
desc: Run code auto-fixers / auto-formatters
|
|
summary: |
|
|
# Auto-Fix / Auto-Format Code
|
|
|
|
This task will automatically apply lint fixes across the whole project using
|
|
auto-fixers. Although unlikely, it is possible that auto-fixing can introduce
|
|
an error so the auto-fixes still have to be validated.
|
|
cmds:
|
|
- task: fix:all
|
|
|
|
fresh:
|
|
summary: Initialize a new project with only the Taskfile.yml present
|
|
cmds:
|
|
- curl -sSL https://gitlab.com/megabyte-labs/common/shared/-/raw/master/common/start.sh > start.sh
|
|
- curl -sSL https://gitlab.com/megabyte-labs/common/shared/-/blob/master/common/.gitignore > .gitignore
|
|
- curl -sSL https://gitlab.com/megabyte-labs/common/shared/-/blob/master/common/.editorconfig > .editorconfig
|
|
- curl -sSL https://gitlab.com/megabyte-labs/common/shared/-/blob/master/package.json > package.json
|
|
- curl -sSL https://gitlab.com/megabyte-labs/common/shared/-/blob/master/.gitlab-ci.yml > .gitlab-ci.yml
|
|
- TMP="$(mktemp)" && jq -r 'del(.blueprint)' package.json > "$TMP" && mv "$TMP" package.json
|
|
- bash start.sh
|
|
- task: prepare
|
|
|
|
get:links:
|
|
deps:
|
|
- install:software:jq
|
|
desc: Log useful links such as the current project's git repository link
|
|
vars:
|
|
GITHUB_URL:
|
|
sh: jq -r '.blueprint.repository.github' package.json
|
|
GITLAB_URL:
|
|
sh: jq -r '.blueprint.repository.gitlab' package.json
|
|
cmds:
|
|
- .config/log info 'GitHub -----> `{{.GITHUB_URL}}`'
|
|
- .config/log info 'GitLab -----> `{{.GITLAB_URL}}`'
|
|
|
|
group:exec:
|
|
desc: Execute group commands on any GitLab group (including repositories in sub-groups)
|
|
summary: |
|
|
# Run Commands on Multiple GitLab Repositories
|
|
|
|
This command requires that the `GITLAB_TOKEN` environment variable be set. With the
|
|
token defined, you can use this task to run scripts on repositories that fall under
|
|
any given group or sub-group. By default, it runs the script(s) on all the
|
|
repositories in the specified group and sub-groups.
|
|
|
|
You can use this task to perform adhoc bulk changes to large numbers of
|
|
repositories that are hosted on GitLab.
|
|
|
|
**Example usage:**
|
|
`task group:exec -- group/subgroup ---- 'bash <(curl https://myscript.com)'
|
|
|
|
In the example above, the bash command will be run in the root of each repository.
|
|
Be sure to wrap the command in quotes or you might observe some odd behavior.
|
|
cmds:
|
|
- task: git:gitlab:group:exec
|
|
|
|
init:
|
|
deps:
|
|
- install:software:jq
|
|
- install:software:yq
|
|
desc: Runs the initialization script
|
|
summary: |
|
|
# Initialize the Project
|
|
|
|
This command will mostly not be needed for pre-existing projects. This task:
|
|
|
|
1. Migrates legacy projects
|
|
2. Fixes common errors
|
|
3. Ensures the project is initialized
|
|
4. Prompts for missing metadata
|
|
5. Runs the `start` task
|
|
|
|
If you are facing difficulties, you can try running this task to reset the project,
|
|
perform common fixes, and run the whole start up routine.
|
|
|
|
## Using a Custom Initialization Script
|
|
|
|
You can control the initialization script that this task runs by specifying
|
|
`UPDATE_INIT_SCRIPT` as an environment variable. If it is not specified, then this
|
|
task runs the [default script]({{.INIT_SCRIPT}}).
|
|
log:
|
|
error: Failed to run initialization script
|
|
start: Initializing project by running initialization script
|
|
success: Successfully bootstrapped project by running initialization script
|
|
cmds:
|
|
- git init
|
|
- task: repair
|
|
- task: prepare
|
|
|
|
jumpusb:
|
|
desc: Creates a JumpUSB (https://jumpusb.com)
|
|
cmds:
|
|
- task: install:ventoy
|
|
|
|
lint:
|
|
desc: Lints the project using all linters
|
|
summary: |
|
|
# Lint the Project Using Most of the Linters
|
|
|
|
This task will do a project-wide linting using all of the linters that commonly
|
|
report errors. You can use this task to spot linting errors prior to running
|
|
the git pre-commit hooks.
|
|
|
|
**Example usage:**
|
|
`task lint`
|
|
cmds:
|
|
- task: lint:all
|
|
|
|
livereload:
|
|
deps:
|
|
- install:npm:nodemon
|
|
desc: Start the project with live-reloading (i.e. watch mode)
|
|
summary: |
|
|
# LiveReload the Project
|
|
|
|
Using LiveReload, you can automatically run the project any time you make
|
|
changes to the project. The LiveReload feature uses [nodemon](https://github.com/remy/nodemon)
|
|
with the configuration stored in `.config/nodemon.json`.
|
|
|
|
Whenever you make a change to the project, `task project:livereload` will run. You can
|
|
define the command that runs every time you make a change in the `Taskfile-project.yml`
|
|
`livereload` section. This file is kept intact even across upstream propagation updates,
|
|
unlike the regular `Taskfile.yml`.
|
|
|
|
**Example usage:**
|
|
`task livereload`
|
|
|
|
The default configuration (in `.config/nodemon.json`) is generic and makes assumptions
|
|
about the file types to watch based on what type project it is. If you would like to
|
|
use a different configuration, you can pass in the location of the configuration like so:
|
|
|
|
**Example with custom configuration:**
|
|
`task livereload -- nodemon.custom.json`
|
|
|
|
The task program also provides a `--watch` feature. However, it relies on the `sources` attribute
|
|
being defined so it might not work in all cases.
|
|
|
|
**Example using `task --watch`:**
|
|
`task --watch mytask`
|
|
log:
|
|
start: Starting `nodemon` live-reload session
|
|
cmds:
|
|
- |
|
|
if [ ! -f Taskfile-project.yml ]; then
|
|
.config/log error '`Taskfile-project.yml` must exist and have a `livereload` task to use with `nodemon`' && exit 1
|
|
fi
|
|
- nodemon --config {{if .CLI_ARGS}}{{.CLI_ARGS}}{{else}}.config/nodemon.json{{end}}
|
|
|
|
new:project:
|
|
desc: Create a new project
|
|
cmds:
|
|
- task: prepare
|
|
|
|
preload:
|
|
desc: Set up your workstation in advance by installing commonly used programs
|
|
summary: |
|
|
# Speed Up Future Development by Preloading Common System Applications
|
|
|
|
Just about every development task requires some sort of globally installed
|
|
application. TypeScript requires Node.js to be installed. Ansible requires
|
|
a handful of CLIs (and Python). This task will check for missing applications
|
|
and install them globally. If you do not run this task, the routines will
|
|
assume you want to keep the footprint small and use disposable virtual
|
|
environments whenever possible (i.e. `{{.NPX_PACKAGE}}` in the case of Node.js,
|
|
`poetry` in the case of Python, etc.).
|
|
|
|
## Reboot Requirements
|
|
|
|
Some software that is installed, like VirtualBox and Docker, require reboots so
|
|
it is recommended that you reboot after running this task.
|
|
|
|
## Passwordless Installation
|
|
|
|
This installation method and all the methods we use will only prompt for a sudo
|
|
password when absolutely necessary. If you already have common development tools
|
|
it is possible that you will not even have to enter a sudo password. This is
|
|
accomplished by installing to `$HOME/.local/bin` whenever a traditionally system
|
|
level binary is installed. However, if you are missing something like git, then
|
|
chances are you will be asked for a sudo password. In this case, we recommend
|
|
you adopt the Megabyte Labs philosophy and inspect the code before running it.
|
|
log:
|
|
error: Encountered error while preloading system with common dependencies (REBOOT RECOMMENDED)
|
|
start: Preloading system with common dependencies
|
|
success: Successfully preloaded system with common dependencies (REBOOT RECOMMENDED)
|
|
cmds:
|
|
- task: install:software:common
|
|
- task: install:brewfile
|
|
- task: install:extras
|
|
- task: install:go:bundle
|
|
- task: install:rust:bundle
|
|
- task: install:github:bundle
|
|
- task: install:npm:bundle
|
|
- task: install:pipx:bundle
|
|
- task: install:python:requirements
|
|
- task: install:modules:local
|
|
|
|
prepare:
|
|
desc: Prepares the project for the normal start command
|
|
summary: |
|
|
# Prepare the Project
|
|
|
|
This task ensures the project has all the required metadata. If a project
|
|
is missing required metadata then this task will interactively prompt the user
|
|
for the missing data. It also performs miscellaneous tasks that are sometimes
|
|
required by the `start` task.
|
|
log:
|
|
error: Encountered error while preparing the project
|
|
start: Preparing the project
|
|
success: Successfully prepared the project
|
|
cmds:
|
|
- task: boilerplate:check:package
|
|
- task: boilerplate:clean
|
|
|
|
publish:
|
|
desc: Publish a semantic release via `semantic-release`
|
|
summary: |
|
|
# Publish the Project
|
|
|
|
Using this task, you can publish a project to all its targets. The targets
|
|
depend on the project type. Most projects will include:
|
|
|
|
1. Updating version numbers in `package.json`, `pyproject.toml`, etc.
|
|
2. Adding a new git tag at the version and publishing it with updated assets
|
|
3. Publishing repository-specific items like NPM packages, PyPi packages, etc.
|
|
4. Publishing artifacts to GitLab Releases and GitHub Releases
|
|
5. Updating the `docs/CHANGELOG.md`
|
|
|
|
## Packages Used
|
|
|
|
This task runs `semantic-release` using the `semantic-release-config` package. The package
|
|
includes release instructions for:
|
|
|
|
1. Python packages
|
|
2. NPM packages
|
|
3. Dockerfile projects
|
|
4. Go projects
|
|
5. Ansible roles
|
|
|
|
## Formats
|
|
|
|
It does its best to ship projects out in as many formats (that make sense) as possible.
|
|
For instance, an NPM CLI gets published as:
|
|
|
|
1. NPM package
|
|
2. Binaries (including deb and rpm) available on GitHub/GitLab releases
|
|
3. Brew formulae
|
|
4. Snapcraft
|
|
5. Probably more implemented after writing this
|
|
|
|
## Python Package Notes
|
|
|
|
If `setup.cfg` is present, then the project is assumed to be a legacy Python
|
|
project that needs to run in environment with access to the `python-semantic`
|
|
extras defined in `pyproject.toml`.
|
|
log:
|
|
error: Error running `semantic-release` via `task publish`
|
|
start: Running `semantic-release` via `task publish`
|
|
success: Successfully ran `semantic-release` via `task publish`
|
|
cmds:
|
|
- task: publish:semantic-release
|
|
|
|
publish:force:
|
|
desc: Force a `semantic-release` even if there are no new eligible commits
|
|
summary: |
|
|
# Force a Release with Empty Commit
|
|
|
|
Trigger any kind of version bump / semantic release by passing
|
|
`PATCH UPDATE`, `MINOR UPDATE`, or `MAJOR UPDATE` in via CLI arguments.
|
|
This task will commit an empty commit message that will trigger the
|
|
corresponding version bump type.
|
|
|
|
**Example of patch update:**
|
|
`task publish:force -- 'PATCH UPDATE'`
|
|
|
|
**Example of minor update:**
|
|
`task publish:force -- 'MINOR UPDATE'`
|
|
|
|
**Example of major update:**
|
|
`task publish:force -- 'MAJOR UPDATE'`
|
|
vars:
|
|
UPDATE_LEVEL: '{{if .CLI_ARGS}}{{.CLI_ARGS}}{{else}}PATCH UPDATE{{end}}'
|
|
log:
|
|
error: Error creating update via `task publish:force`
|
|
start: Publishing `semantic-release` update via `task publish:force`
|
|
success: Successfully published update via `task publish:force`
|
|
cmds:
|
|
- |
|
|
HUSKY=0 git commit -a --allow-empty -m '🔨 chore(bump): Forced semantic-release {{.UPDATE_LEVEL}}' -n
|
|
- task: publish
|
|
|
|
pull:upstream:
|
|
desc: Pull from upstream repositories
|
|
summary: |
|
|
# Pull Changes from Upstream Repositories
|
|
|
|
This task will do a `git pull` on each repository defined in `.blueprint.upstreamRemotes`.
|
|
The variable should be an array of objects where each object has the `remote`, `url`, and `branch` keys.
|
|
|
|
**Sample value of `.blueprint.upstreamRemotes`:**
|
|
`[{ "remote": "ionic", "url": "git@github.com:ionic-team/ionic-docs.git", "branch": "main" }]`
|
|
log:
|
|
error: Encountered error while running `git pull` on each of the `upstreamRemotes`
|
|
start: Running `git pull` on each of the `upstreamRemotes`
|
|
success: Successfully pulled from `upstreamRemotes`
|
|
cmds:
|
|
- task: common:update:upstream:remotes:pull
|
|
|
|
repair:
|
|
cmds:
|
|
- task: common:repair
|
|
- |
|
|
TMP="$(mktemp)"
|
|
if [ -n "$UPDATE_INIT_SCRIPT" ]; then
|
|
curl -sSL "$UPDATE_INIT_SCRIPT" > "$TMP" && bash "$TMP" && rm "$TMP"
|
|
else
|
|
curl -sSL {{.INIT_SCRIPT}} > "$TMP" && bash "$TMP" && rm "$TMP"
|
|
fi
|
|
|
|
reset:
|
|
desc: Resets the project by removing all caches and then re-generating templated files
|
|
summary: |
|
|
# Reset Project and Re-Generate Assets
|
|
|
|
This task is intended to be used when there appear to be cache related issues.
|
|
It will first clean the project by removing common local libraries like `node_modules/`
|
|
and the `.cache/` folder, to name a couple. Then, without acquiring any upstream
|
|
updates, it re-generates any templated files.
|
|
cmds:
|
|
- task: common:reset
|
|
|
|
reset:force:
|
|
desc: 'Aggressively reset the project (**WARNING** This will wipe uncommitted work)'
|
|
summary: |
|
|
# Aggressively Reset Project
|
|
|
|
This task will completely wipe the project by:
|
|
|
|
1. Resetting to the HEAD
|
|
2. Removing all files that are not included in source control (i.e. `node_modules/` etc.)
|
|
3. Pulling the latest changes from `master`
|
|
|
|
This task is essentially the equivalent of deleteing the project and re-cloning it.
|
|
prompt:
|
|
type: confirm
|
|
message: Are you sure you want to forcefully reset the project?
|
|
answer:
|
|
cmds:
|
|
- task: common:reset:force
|
|
|
|
scripts:
|
|
interactive: true
|
|
deps:
|
|
- install:npm:ntl
|
|
desc: Run and view descriptions for `npm scripts` via an interactive dialog
|
|
summary: |
|
|
# Interactively Select Scripts Defined in package.json
|
|
|
|
Our projects use `run` (a fork of task) to handle most of the task running.
|
|
However, in some projects there may be scripts defined in package.json. This
|
|
task is a convenience method that will present a list of scripts alongside
|
|
their descriptions that you can interactively launch.
|
|
log:
|
|
error: Error running `NTL_RUNNER={{.NPM_PROGRAM}} ntl`
|
|
start: Running `NTL_RUNNER={{.NPM_PROGRAM}} ntl`
|
|
cmds:
|
|
- NTL_RUNNER={{.NPM_PROGRAM}} ntl
|
|
|
|
services:
|
|
desc: Update elements of the repository that require API access
|
|
summary: |
|
|
# Update Elements of the Repository that Require API Access
|
|
|
|
This task will ensure that the git repositories and other services related to the
|
|
project are updated with the proper configurations. It requires that certain
|
|
API keys be set. Generally, only project owners will use this task.
|
|
cmds:
|
|
- task: common:update:services
|
|
status:
|
|
- '[ -n "$GITLAB_CI" ] && [ "$REPOSITORY_UPDATE" != "true" ]'
|
|
|
|
shell:
|
|
desc: Start a terminal session using Docker with any Linux operating system
|
|
compile: |
|
|
'.tasks.common.shell = $this' common/Taskfile.yml
|
|
summary: |
|
|
# Start a Docker Terminal Session
|
|
|
|
Use Docker to run commands on nearly any operating system. The operating
|
|
systems are all stock distros with systemd added.
|
|
|
|
The selected environment will mount the current working directory to the
|
|
Docker container.
|
|
|
|
**Example opening an interactive prompt:**
|
|
`task shell`
|
|
|
|
**Example of directly shelling into a container:**
|
|
`task shell -- ubuntu-21.04`
|
|
|
|
## Available operating systems (that you can use with the example above):
|
|
|
|
* archlinux
|
|
* centos-7
|
|
* centos-8
|
|
* debian-9
|
|
* debian-10
|
|
* fedora-33
|
|
* fedora-34
|
|
* ubuntu-18.04
|
|
* ubuntu-20.04
|
|
* ubuntu-21.04
|
|
cmds:
|
|
- task: common:shell
|
|
|
|
ssh-keys:
|
|
deps:
|
|
- cloud:heroku:ssh-keys
|
|
- git:github:ssh-keys
|
|
- git:gitlab:ssh-keys
|
|
|
|
start:
|
|
desc: Start the project by installing / updating dependencies, repairing issues, and opening a tutorial
|
|
summary: |
|
|
# Start the Project
|
|
|
|
This task does everything that running `bash start.sh` does plus a little bit more:
|
|
|
|
1. Installs Homebrew if it is not already installed
|
|
2. Ensures Bodega is installed and up-to-date
|
|
3. Ensures common system dependencies and runtimes
|
|
4. Installs commonly used CLI tools
|
|
5. Ensures local dependencies such as `node_modules` are installed
|
|
6. Attempts to repair the project if it detects any issues
|
|
|
|
It basically sets up all the tools you need, in advance so that problems can be detected as early
|
|
as possible. In some cases, this command will open documentation or a tutorial to read while dependencies are being
|
|
installed.
|
|
log:
|
|
error: Yikes! Error starting the project!
|
|
start: Starting the project..
|
|
success: Project started!
|
|
cmds:
|
|
- task: common:start
|
|
|
|
synchronize:
|
|
desc: Set up the project and refresh it with the latest changes
|
|
summary: |
|
|
# Start the Project
|
|
|
|
This task will scaffold the project with the latest upstream changes
|
|
and ensure your development environment has all the dependencies installed.
|
|
|
|
This command should be used whenever the files that are automatically generated
|
|
need to be updated. It also serves as an entry point for new developers who
|
|
are getting started with the project.
|
|
|
|
**Example usage:**
|
|
`task start`
|
|
log:
|
|
error: Error encountered while starting up the project
|
|
start: Synchronizing project with upstream file changes and bootstrapping
|
|
success: Successfully synchronized the project with upstream file changes and also bootstrapped the project
|
|
cmds:
|
|
- task: upstream:{{.PROJECT_TYPE}}
|
|
|
|
tag:deps:
|
|
desc: Inject a new command in the `Taskfile.yml` that includes all tasks matching a given tag as deps
|
|
summary: |
|
|
# Create Task with Deps Based on Tag
|
|
|
|
Use this task to inject a new task in the `Taskfile.yml` that includes all the tasks
|
|
that are tagged with a certain tag as deps. The tag must be supplied as a CLI argument.
|
|
|
|
Say you have a task that looks like this:
|
|
|
|
```
|
|
my-task:
|
|
tags:
|
|
- docker
|
|
cmds:
|
|
- docker volume ls
|
|
```
|
|
|
|
Then, by running `task tag:deps -- docker`, you will get the following task injected into the
|
|
`Taskfile.yml` file:
|
|
|
|
```
|
|
deps:docker:
|
|
deps:
|
|
- my-task
|
|
```
|
|
cmds:
|
|
- task: common:util:task:tag:deps
|
|
|
|
template:
|
|
deps:
|
|
- install:npm:liquidjs
|
|
summary: |
|
|
# Render a Template
|
|
|
|
This task is provided to serve as an alias for developing new templated files.
|
|
cmds:
|
|
- |
|
|
function handlebars() {
|
|
FILE="$1"
|
|
TMP="$(mktemp)"
|
|
.config/log info 'Generating `'"${FILE//.liquid}"'` from `'"$FILE"'`'
|
|
hbs --data .variables.json --helper ./.config/hbs.cjs "$FILE" --stdout > "$TMP"
|
|
mv "$TMP" "${FILE//.liquid}"
|
|
rm "$FILE"
|
|
}
|
|
handlebars '{{.CLI_ARGS}}'
|
|
preconditions:
|
|
- sh: test -f .variables.json
|
|
msg: This task requires that you have already spun up the project by running `task start`
|
|
|
|
test:
|
|
deps:
|
|
- install:software:jq
|
|
- install:software:node
|
|
interactive: true
|
|
desc: Open an interactive dialog to select and run a Molecule test
|
|
summary: |
|
|
# Test the Project
|
|
|
|
This task calls `npm run test` which functions differently based on the
|
|
definition made in `package.json` under the `.scripts.test` key.
|
|
vars:
|
|
NONINTERACTIVE_MISSING_TEST_CMD: There must be a `.scripts.test` definition in `package.json`!
|
|
cmds:
|
|
- |
|
|
if [ "$(jq '.scripts.test' package.json)" != 'null' ]; then
|
|
npm run test
|
|
else
|
|
[[ $- == *i* ]] && task prepare || (.config/log error '{{.NONINTERACTIVE_MISSING_TEST_CMD}}' && exit 1)
|
|
fi
|
|
|
|
update:
|
|
desc: Fully update the repository
|
|
summary: |
|
|
# Update the Repository / Project
|
|
|
|
This task will:
|
|
|
|
1. Ensure Homebrew is installed
|
|
2. Ensure runtimes like Node.js, Go, Python, and Poetry are installed
|
|
3. Ensure the `PATH` environment variable is properly configured
|
|
4. Configure the environment if it is in a `$CI` environment
|
|
5. Run a repair script that is used to ensure older repositories are compatible with the Taskfile scripts
|
|
6. Prepare the repository by automatically setting up certain parts of the project
|
|
7. Run a full update on the repository with `task start`
|
|
8. Automatically commit changes
|
|
9. Update GitLab/GitHub repository settings if the `GITHUB_TOKEN` / `GITLAB_TOKEN` variables are set
|
|
|
|
Along the way, if any dependencies are missing they will be installed as well just like with all of the
|
|
tasks included in these Taskfiles.
|
|
log:
|
|
error: Failed to update the repository
|
|
start: Updating the repository..
|
|
success: Finished updating the repository
|
|
cmds:
|
|
- task: common:start
|
|
env:
|
|
UPDATE_PROJECT: 'true'
|
|
- task: common:update:finish
|
|
|
|
yubikey:
|
|
desc: Create an OpenGPG-enabled YubiKey
|
|
summary: |
|
|
# Create an OpenGPG-enabled YubiKey SmartCard
|
|
|
|
This task will walk you through creating an OpenGPG-enabled
|
|
YubiKey. You can then use it to manage your GPG keys and SSH keys.
|
|
It will prompt you for things like your pin and automatically
|
|
set up the YubiKey.
|
|
|
|
The interactive process simplifies this very popular guide on
|
|
how to set up a YubiKey like this:
|
|
|
|
[Guide on Using YubiKey for OpenGPG and SSH keys](https://github.com/drduh/YubiKey-Guide)
|
|
|
|
We do still recommend that you skim through the guide.
|
|
cmds:
|
|
- |
|
|
export GNUPGHOME="$HOME/.gnupgyubi"
|
|
export MASTER_KEY="$(LC_ALL=C tr -dc '[:upper:]' < /dev/urandom | fold -w 30 | head -n1)"
|
|
task security:yubikey:prepare
|