Skip to content

task

Prerequisites๐Ÿ”—

Install go-task

Install brew (if not already installed)

Install Pre-commit

Gotchas

OS Specific Limitations exist for Windows. For instance, without wrapping with a pwsh -c command you might get a failure with mkdir.

See prior issue Command can not be run in Windows ยท Issue #319 ยท go-task/task ยท GitHub for more information.

Common Config Setup๐Ÿ”—

version: '3'
silent: true
output: prefixed
dotenv: [.env]

includes:
  compose: ./Taskfile.compose.yml
  precommit: ./Taskfile.precommit.yml
env:
  AWS_SDK_LOAD_CONFIG: 1
  AWS_REGION: us-east-1
  DOCKER_BUILDKIT: 1

Common Variable Setup๐Ÿ”—

The following are console escape sequences to provide some nice formatting for the output

vars:
  black: \033[:0;30m
  red: \033[:0;31m
  green: \033[:0;32m
  orange: \033[:0;33m
  blue: \033[:0;34m
  purple: \033[:0;35m
  cyan: \033[:0;36m
  light_gray: \033[:0;37m
  dark_gray: \033[:1;30m
  light_red: \033[:1;31m
  light_green: \033[:1;32m
  yellow: \033[:1;33m
  light_blue: \033[:1;34m
  light_purple: \033[:1;35m
  light_cyan: \033[:1;36m
  white: \033[:1;37m
  nocolor: \u001b[0m
  reversed: \u001b[7m
  ARTIFACT_DIRECTORY: ./artifacts/

Common Base Config๐Ÿ”—

This is stuff I'd normally paste to get me started on a task file.

tasks:
  default:
    cmds:
      - task: list
  list:
    desc: list tasks
    cmds:
      - task --list
  vars:
    desc: variable output
    cmds:
      - |
        echo -e "{{.light_gray}}=== โ„น {{ .reversed }} Variable Info from Task {{ .nocolor }} === "
        echo -e "{{.light_gray}}ARTIFACT_DIRECTORY          {{.nocolor}}: {{ .orange}}{{ .ARTIFACT_DIRECTORY }} {{ .nocolor }}"
        echo -e "{{.light_gray}}DOCKER_BUILDKIT             {{.nocolor}}: {{ .orange}}{{ .DOCKER_BUILDKIT }} {{ .nocolor }}"
        echo -e "{{.light_gray}}AWS_SDK_LOAD_CONFIG         {{.nocolor}}: {{ .orange}}{{ .AWS_SDK_LOAD_CONFIG }} {{ .nocolor }}"
        echo -e "{{.light_gray}}AWS_REGION                  {{.nocolor}}: {{ .orange}}{{ .AWS_REGION }} {{ .nocolor }}"
  test:
    desc: run basic tests against compose projects
    prefix: ๐Ÿงช
    cmds:
      - |
        echo "todo"

console logging๐Ÿ”—

test -f nonexistentfile ||         echo -e "{{.red}}file does not exist: [{{ .NONEXISTENTFILE }}]  {{.nocolor}}"

Pre-Commit๐Ÿ”—

I use this framework to simplify my project linting and checks.

You can load this as a seperate base file by creating it in the same root directory of your project with the name: Taskfile.precommit.yml and include it as the base config shows.

---
version: '3'
silent: true
output: prefixed

tasks:
  run:
    desc: run pre-commit against all files manually
    cmds:
      - pre-commit run --all-files
  autoupdate:
    desc: update the precommit file with latest
    cmds:
      - pre-commit autoupdate
  init:
    desc: ensure precommit tooling is available
    prefix: โš™๏ธ
    cmds:
      - |
        {{if eq OS "windows"}}
        pip install pre-commit || echo -e "{{.light_cyan}} ๐Ÿ”ฅ you need python installed to run this  {{.nocolor}}"
        {{else}}
        echo "setting up precommit. This requires brew (works on Linux & macOS)"
        echo "if fails install linux brew with following command"
        if brew --version &>/dev/null ; then
          echo -e  "{{.green}} โœ… Command succeeded, validated homebrew installed {{.nocolor}}"
        else
          echo -e "{{.red}} โ— Command failed. Homebrew not detected {{.nocolor}}"
          echo -e "{{.red}}โ— install homebrew on Linux or macOS (not root) using the following command and try again: {{.nocolor}}"
          echo -e "{{.orange}} /bin/bash -c ""\$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"" {{.nocolor}}"
        fi
        export HOMEBREW_NO_AUTO_UPDATE=1
        package=pre-commit
        brew list $package &>/dev/null || brew install $package
        {{end}}

Install Tool From GitHub Release๐Ÿ”—

Without using any external dependency tooling, here's a way to add a task that might need to grab a binary) using jq and curl.

init:ci:
  desc: setup tooling for project and download dependencies
  cmds:
    - |
      go mod tidy && echo -e "{{.green}} โœ… go mod tidy completed{{.nocolor}}"
      go install github.com/goreleaser/goreleaser@latest
      go get github.com/caarlos0/svu  # Semver versioning tool
      mkdir {{ .TOOLS_DIRECTORY }}
      {{if eq OS "windows"}}
      DOWNLOAD_URL=`curl -sL https://api.github.com/repos/restechnica/semverbot/releases/latest | jq -r '.assets[].browser_download_url' | grep "windows"`
      curl -qo tools/sbot -sL $DOWNLOAD_URL
      {{end}}
      {{if eq OS "darwin"}}
      DOWNLOAD_URL=`curl -sL https://api.github.com/repos/restechnica/semverbot/releases/latest | jq -r '.assets[].browser_download_url' | grep "darwin"`
      curl -qo tools/sbot -sL $DOWNLOAD_URL
      chmod +rwx ./tools/sbot
      {{end}}
      {{if eq OS "linux"}}
      DOWNLOAD_URL=`curl -sL https://api.github.com/repos/restechnica/semverbot/releases/latest | jq -r '.assets[].browser_download_url' | grep "linux"`
      curl -qo tools/sbot -sL $DOWNLOAD_URL
      chmod +rwx ./tools/sbot
      {{end}}
      echo -e "{{.green}} โœ… go semverbot downloaded to tools{{.nocolor}}"

Initialize Project Tooling๐Ÿ”—

I think any project requiring non-standardized tooling should have this setup in a standard init style command that makes it easy to get up and running, assuming that the basic SDK tooling is installed of course. To solve SDK's and other lower level tooling, you'll want to use Docker with Codespaces or other methods to ensure tooling setup is standardized and easy (Ansible, Docker, etc.)

init:
  desc: initialize all tooling for ci and developer work locally
  cmds:
    - task: init:dev
    - task: init:ci
init:dev:
  desc: initialize tools for a developer, but not required for CI
  cmds:
    - |
      go install github.com/evilmartians/lefthook@master
      lefthook install
init:ci:
  desc: setup tooling for project and download dependencies
  cmds:
    - |
      go mod tidy && echo -e "{{.green}} โœ… go mod tidy completed{{.nocolor}}"
      go install github.com/goreleaser/goreleaser@latest

This would be how I'd setup a project.

Notice the seperation of ci and dev tooling.

This is important if you don't want to needlessly add duration to your CI checks.

This will give flexibility to ensure tooling like Lefthook or others aren't installed by a CI build.