v3.15.1

.editorconfig

@@ -8,6 +8,6 @@ charset = utf-8
 trim_trailing_whitespace = true
 indent_style = tab
 
-[*.{md,mdx,yml,yaml,json,toml,htm,html,js,ts,vue,css,svg,sh,bash,fish}]
+[*.{md,yml,yaml,json,toml,htm,html,js,css,svg,sh,bash}]
 indent_style = space
 indent_size = 2

.gitattributes

@@ -1,2 +1 @@
 * text=auto
-*.mdx -linguist-detectable

.github/CODE_OF_CONDUCT.md

@@ -0,0 +1,46 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as contributors and maintainers pledge to making participation in our project and our community a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, gender identity and expression, level of experience, nationality, personal appearance, race, religion, or sexual identity and orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable behavior and are expected to take appropriate and fair corrective action in response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, or to ban temporarily or permanently any contributor for other behaviors that they deem inappropriate, threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces when an individual is representing the project or its community. Examples of representing a project or community include using an official project e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event. Representation of a project may be further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team at andrey.nering@gmail.com. The project team will review and investigate all complaints, and will respond in a way that it deems appropriate to the circumstances. The project team is obligated to maintain confidentiality with regard to the reporter of an incident. Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good faith may face temporary or permanent repercussions as determined by other members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4, available at [http://contributor-covenant.org/version/1/4][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/4/

.github/CONTRIBUTING.md

@@ -0,0 +1,6 @@
+* Bug reports and feature requests are welcome in [the issues][issues]
+* Pull Requests are welcome. For more complex changes and features it's
+  recommended to open an issue with the feature request first
+* Documentation contributions are as important as code contributions
+
+[issues]: https://github.com/go-task/task/issues

.github/FUNDING.yml

@@ -0,0 +1,3 @@
+github: andreynering
+open_collective: task
+custom: 'https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=GSVDU63RKG45A&currency_code=USD&source=url'

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,13 @@
+---
+name: Bug Report
+about: Use the template to report bugs and issues
+---
+
+- Task version:
+- Operating System:
+
+### Example Taskfile showing the issue
+
+```yaml
+
+```

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -1,69 +0,0 @@
-name: '🐞 Bug Report'
-description: Report a bug in Task.
-labels: ['state: needs-triage']
-body:
-  - type: markdown
-    attributes:
-      value: |
-        Thanks for your bug report!
-
-        Before submitting, please check the list of [existing issues](https://github.com/go-task/task/issues) and make sure the same bug was not already reported by someone else.
-
-  - type: textarea
-    id: description
-    attributes:
-      label: Description
-      description: Describe the bug you're seeing.
-      placeholder: |
-        - What did you do?
-        - What did you expect to happen?
-        - What happened instead?
-    validations:
-      required: true
-
-  - type: input
-    id: version
-    attributes:
-      label: Version
-      description: What version(s) of Task is the issue occurring on?
-    validations:
-      required: true
-
-  - type: input
-    id: os
-    attributes:
-      label: Operating system
-      description: What operating system(s) is the issue occurring on?
-    validations:
-      required: true
-
-  - type: dropdown
-    id: experiments
-    attributes:
-      label: Experiments Enabled
-      description: Do you have any experiments enabled? You can check by running `task --experiments`.
-      multiple: true
-      options:
-        - Env Precedence
-        - Gentle Force
-        - Map Variables (1)
-        - Map Variables (2)
-        - Remote Taskfiles
-    validations:
-      required: false
-
-  - type: textarea
-    id: logs
-    attributes:
-      label: Example Taskfile
-      description: |
-        If you have a Taskfile that reproduces the issue, please paste it here.
-        This will be automatically formatted into code, so no need for backticks.
-      render: YAML
-      placeholder: |
-        version: '3'
-
-        tasks:
-          default:
-            cmds:
-              - 'echo "This Taskfile is buggy :("'

.github/ISSUE_TEMPLATE/config.yml

@@ -1,11 +1,5 @@
 blank_issues_enabled: false
 contact_links:
-  - name: '🔌 Task for Visual Studio Code'
-    url: https://github.com/go-task/vscode-task
-    about: 'Issues related to the Visual Studio Code extension should be opened here.'
-  - name: '💬 Help forum on Discord'
-    url: https://discord.com/channels/974121106208354339/1025054680289660989
-    about: 'The #help channel on our Discord is the best way to get help from the community.'
-  - name: '❓ Questions, Ideas and General Discussions'
+  - name: Questions, Ideas and General Discussions
     url: https://github.com/go-task/task/discussions
-    about: 'Ask questions and discuss general ideas with the community.'
+    about: Ask questions and discuss general ideas with the community

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,11 @@
+---
+name: Feature Request
+about: Use the template to make feature requests
+---
+
+Describe in detail what feature do you want to see in Task.
+Give examples if possible.
+
+Please, search if this wasn't proposed before, and if this is more like an idea
+than a strong feature request, consider opening a
+[discussion](https://github.com/go-task/task/discussions) instead.

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -1,23 +0,0 @@
-name: '✨ Feature Request'
-description: Suggest a new feature or enhancement for Task.
-labels: ['state: needs-triage']
-body:
-  - type: markdown
-    attributes:
-      value: |
-        Thanks for your feature request!
-
-        Before submitting, please check the list of [existing issues](https://github.com/go-task/task/issues) and make sure the same change was not already requested by someone else.
-        If your request is more of an idea than a feature request, consider opening a [discussion](https://github.com/go-task/task/discussions) instead.
-
-  - type: textarea
-    id: description
-    attributes:
-      label: Description
-      description: Describe the feature/enhancement you want to see in Task.
-      placeholder: |
-        - Give a general overview of the feature/enhancement.
-        - Explain problem is the change trying to solve.
-        - Give examples of how you would use the feature.
-    validations:
-      required: true

.github/dependabot.yml

@@ -0,0 +1,10 @@
+version: 2
+
+updates:
+  - package-ecosystem: gomod
+    directory: /
+    schedule:
+      interval: weekly
+      day: saturday
+      time: '08:00'
+      timezone: America/Sao_Paulo

.github/pull_request_template.md

@@ -1,9 +0,0 @@
-<!--
-
-Thanks for your pull request, we really appreciate contributions!
-
-Please understand that it may take some time to be reviewed.
-
-Also, make sure to follow the [Contribution Guide](https://taskfile.dev/contributing/).
-
--->

.github/renovate.json

@@ -1,36 +0,0 @@
-{
-  "$schema": "https://docs.renovatebot.com/renovate-schema.json",
-  "extends": [
-    "config:recommended",
-    "group:allNonMajor",
-    "schedule:weekly",
-    ":semanticCommitTypeAll(chore)"
-  ],
-  "mode": "full",
-  "addLabels":["area: dependencies"],
-  "customManagers": [
-    {
-      "customType": "regex",
-      "fileMatch": ["^\\.github/workflows/.*\\.ya?ml$"],
-      "matchStrings": [
-        "uses:\\s*golangci/golangci-lint-action@\\S+\\s+with:\\s+version:\\s*(?<currentValue>v[\\d.]+)"
-      ],
-      "datasourceTemplate": "github-releases",
-      "depNameTemplate": "golangci/golangci-lint"
-    }
-  ],
-  "packageRules": [
-    {
-      "matchManagers": ["github-actions"],
-      "addLabels": ["area: github actions"]
-    },
-    {
-      "matchCategories": ["js", "node"],
-      "addLabels": ["lang: javascript"]
-    },
-    {
-      "matchCategories": ["golang"],
-      "addLabels": ["lang: go"]
-    }
-  ]
-}

.github/workflows/issue-awaiting-response.yml

@@ -1,43 +0,0 @@
-name: issue awaiting response
-
-on:
-  issue_comment:
-    types: [created]
-
-jobs:
-  issue-awaiting-response:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/github-script@v8
-        with:
-          github-token: ${{secrets.GH_PAT}}
-          script: |
-            const issue = await github.rest.issues.get({
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              issue_number: context.issue.number,
-            })
-            const comments = await github.paginate(
-              github.rest.issues.listComments, {
-                owner: context.repo.owner,
-                repo: context.repo.repo,
-                issue_number: context.issue.number,
-              }
-            )
-            const labels = await github.paginate(
-              github.rest.issues.listLabelsOnIssue, {
-                issue_number: context.issue.number,
-                owner: context.repo.owner,
-                repo: context.repo.repo,
-              }
-            )
-            if (labels.find(label => label.name === 'state: awaiting response')) {
-              if (comments[comments.length-1].user?.login === issue.data.user?.login) {
-                github.rest.issues.removeLabel({
-                  owner: context.repo.owner,
-                  repo: context.repo.repo,
-                  issue_number: context.issue.number,
-                  name: 'state: awaiting response'
-                })
-              }
-            }

.github/workflows/issue-closed.yml

@@ -1,29 +0,0 @@
-name: issue closed
-
-on:
-  issues:
-    types: [closed]
-
-jobs:
-  issue-closed:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/github-script@v8
-        with:
-          github-token: ${{secrets.GH_PAT}}
-          script: |
-            const labels = await github.paginate(
-              github.rest.issues.listLabelsOnIssue, {
-                issue_number: context.issue.number,
-                owner: context.repo.owner,
-                repo: context.repo.repo,
-              }
-            )
-            if (labels.find(label => label.name === 'state: needs triage')) {
-              github.rest.issues.removeLabel({
-                owner: context.repo.owner,
-                repo: context.repo.repo,
-                issue_number: context.issue.number,
-                name: 'state: needs triage'
-              })
-            }

.github/workflows/issue-experiment.yml

@@ -1,123 +0,0 @@
-name: issue experiment
-
-on:
-  issues:
-    types: [labeled]
-
-jobs:
-  issue-experiment-proposed:
-    if: github.event.label.name == format('status{0} proposed', ':')
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/github-script@v8
-        with:
-          github-token: ${{secrets.GH_PAT}}
-          script: |
-            github.rest.issues.createComment({
-              issue_number: context.issue.number,
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              body: 'This issue has been marked as an experiment proposal! :test_tube: It will now enter a period of consultation during which we encourage the community to provide feedback on the proposed design. Please see the [experiment workflow documentation](https://taskfile.dev/experiments#workflow) for more information on how we release experiments.'
-            })
-  issue-experiment-draft:
-    if: github.event.label.name == format('status{0} draft', ':')
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/github-script@v8
-        with:
-          github-token: ${{secrets.GH_PAT}}
-          script: |
-            github.rest.issues.createComment({
-              issue_number: context.issue.number,
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              body: 'This experiment has been marked as a draft! :sparkles: This means that an initial implementation has been added to the latest release of Task! You can find information about this experiment and how to enable it in our [experiments documentation](https://taskfile.dev/experiments). Please see the [experiment workflow documentation](https://taskfile.dev/experiments#workflow) for more information on how we release experiments.'
-            })
-  issue-experiment-candidate:
-    if: github.event.label.name == format('status{0} candidate', ':')
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/github-script@v8
-        with:
-          github-token: ${{secrets.GH_PAT}}
-          script: |
-            github.rest.issues.createComment({
-              issue_number: context.issue.number,
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              body: 'This experiment has been marked as a candidate! :fire: This means that the  implementation is nearing completion and we are entering a period for final comments and feedback! You can find information about this experiment and how to enable it in our [experiments documentation](https://taskfile.dev/experiments). Please see the [experiment workflow documentation](https://taskfile.dev/experiments#workflow) for more information on how we release experiments.'
-            })
-  issue-experiment-stable:
-    if: github.event.label.name == format('status{0} stable', ':')
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/github-script@v8
-        with:
-          github-token: ${{secrets.GH_PAT}}
-          script: |
-            github.rest.issues.createComment({
-              issue_number: context.issue.number,
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              body: 'This experiment has been marked as stable! :metal: This means that the  implementation is now final and ready to be released. No more changes will be made and the experiment is safe to use in production! You can find information about this experiment and how to enable it in our [experiments documentation](https://taskfile.dev/experiments). Please see the [experiment workflow documentation](https://taskfile.dev/experiments#workflow) for more information on how we release experiments.'
-            })
-  issue-experiment-released:
-    if: github.event.label.name == format('status{0} released', ':')
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/github-script@v8
-        with:
-          github-token: ${{secrets.GH_PAT}}
-          script: |
-            github.rest.issues.createComment({
-              issue_number: context.issue.number,
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              body: 'This experiment has been released! :rocket: This means that it is no longer an experiment and is available in the latest major version of Task. Please see the [experiment workflow documentation](https://taskfile.dev/experiments#workflow) for more information on how we release experiments.'
-            })
-            github.rest.issues.update({
-              issue_number: context.issue.number,
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              state: 'closed'
-            })
-  issue-experiment-abandoned:
-    if: github.event.label.name == format('status{0} abandoned', ':')
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/github-script@v8
-        with:
-          github-token: ${{secrets.GH_PAT}}
-          script: |
-            github.rest.issues.createComment({
-              issue_number: context.issue.number,
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              body: 'This experiment has been abandoned. :disappointed: This means that this feature will not be added to Task and any experimental functionality will be removed. Please see the [experiment workflow documentation](https://taskfile.dev/experiments#workflow) for more information on how we release experiments.'
-            })
-            github.rest.issues.update({
-              issue_number: context.issue.number,
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              state: 'closed'
-            })
-  issue-experiment-superseded:
-    if: github.event.label.name == format('status{0} superseded', ':')
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/github-script@v8
-        with:
-          github-token: ${{secrets.GH_PAT}}
-          script: |
-            github.rest.issues.createComment({
-              issue_number: context.issue.number,
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              body: 'This experiment has been superseded. :seedling: This means that another experiment has replaced this one. Please see the [experiment workflow documentation](https://taskfile.dev/experiments#workflow) for more information on how we release experiments.'
-            })
-            github.rest.issues.update({
-              issue_number: context.issue.number,
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              state: 'closed'
-            })

.github/workflows/issue-needs-triage.yml

@@ -1,29 +0,0 @@
-name: issue needs triage
-
-on:
-  issues:
-    types: [opened]
-
-jobs:
-  issue-needs-triage:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/github-script@v8
-        with:
-          github-token: ${{secrets.GH_PAT}}
-          script: |
-            const labels = await github.paginate(
-              github.rest.issues.listLabelsOnIssue, {
-                issue_number: context.issue.number,
-                owner: context.repo.owner,
-                repo: context.repo.repo,
-              }
-            )
-            if (labels.length === 0) {
-              github.rest.issues.addLabels({
-                issue_number: context.issue.number,
-                owner: context.repo.owner,
-                repo: context.repo.repo,
-                labels: ['state: needs triage']
-              })
-            }

.github/workflows/lint.yml

@@ -6,38 +6,19 @@ on:
     tags:
       - v*
     branches:
-      - main
+      - master
 
 jobs:
   lint:
-    name: Lint
-    strategy:
-      matrix:
-        go-version: [1.24.x, 1.25.x]
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/setup-go@v6
+      - uses: actions/setup-go@v3
         with:
-          go-version: ${{matrix.go-version}}
+          go-version: 1.18.x
 
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v3
 
       - name: golangci-lint
-        uses: golangci/golangci-lint-action@v9
+        uses: golangci/golangci-lint-action@v3
         with:
-          version: v2.7.2
-
-  lint-jsonschema:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/setup-python@v6
-        with:
-          python-version: 3.14
-
-      - uses: actions/checkout@v6
-
-      - name: install check-jsonschema
-        run: python -m pip install 'check-jsonschema==0.27.3'
-
-      - name: check-jsonschema (metaschema)
-        run: check-jsonschema --check-metaschema website/src/public/schema.json
+          version: v1.46.1

.github/workflows/release-nightly.yml

@@ -1,30 +0,0 @@
-name: Release nightly
-
-on:
-  workflow_dispatch:
-  schedule:
-    - cron: 0 0 * * *
-jobs:
-  goreleaser:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v6
-        with:
-          fetch-depth: 0
-
-      - name: Set up Go
-        uses: actions/setup-go@v6
-        with:
-          go-version: 1.25.x
-
-      - name: Run GoReleaser
-        uses: goreleaser/goreleaser-action@v6
-        with:
-          distribution: goreleaser-pro
-          version: latest
-          args: release --clean --nightly -f .goreleaser-nightly.yml
-        env:
-          GITHUB_TOKEN: ${{secrets.GH_PAT}}
-          GORELEASER_KEY: ${{secrets.GORELEASER_KEY}}
-          CLOUDSMITH_TOKEN: ${{secrets.CLOUDSMITH_TOKEN}}

.github/workflows/release.yml

@@ -3,55 +3,24 @@ name: goreleaser
 on:
   push:
     tags:
-      - 'v*'
-
-permissions:
-  id-token: write  # Required for OIDC
-  contents: read
+      - '*'
 
 jobs:
   goreleaser:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v6
-        with:
-          fetch-depth: 0
+        uses: actions/checkout@v3
 
       - name: Set up Go
-        uses: actions/setup-go@v6
+        uses: actions/setup-go@v3
         with:
-          go-version: 1.25.x
-
-      - uses: actions/setup-node@v6
-        with:
-          node-version: '24'
-          registry-url: 'https://registry.npmjs.org'
-
-      - name: Update npm
-        run: npm install -g npm@latest
-
-      - name: Install Task
-        uses: go-task/setup-task@v1
-
-      - name: Install pnpm
-        uses: pnpm/action-setup@v4
-        with:
-          package_json_file: 'website/package.json'
-          run_install: 'true'
+          go-version: 1.19.x
 
       - name: Run GoReleaser
-        uses: goreleaser/goreleaser-action@v6
+        uses: goreleaser/goreleaser-action@v2
         with:
-          distribution: goreleaser-pro
           version: latest
-          args: release --clean --draft
+          args: release --rm-dist
         env:
           GITHUB_TOKEN: ${{secrets.GH_PAT}}
-          GORELEASER_KEY: ${{secrets.GORELEASER_KEY}}
-          CLOUDSMITH_TOKEN: ${{secrets.CLOUDSMITH_TOKEN}}
-
-      - name: Deploy Website
-        shell: bash
-        run: |
-          task website:deploy:prod

.github/workflows/test.yml

@@ -6,25 +6,25 @@ on:
     tags:
       - v*
     branches:
-      - main
+      - master
 
 jobs:
   test:
     name: Test
     strategy:
       matrix:
-        go-version: [1.24.x, 1.25.x]
+        go-version: [1.18.x, 1.19.x]
         platform: [ubuntu-latest, macos-latest, windows-latest]
     runs-on: ${{matrix.platform}}
     steps:
       - name: Set up Go ${{matrix.go-version}}
-        uses: actions/setup-go@v6
+        uses: actions/setup-go@v3
         with:
           go-version: ${{matrix.go-version}}
         id: go
 
       - name: Check out code into the Go module directory
-        uses: actions/checkout@v6
+        uses: actions/checkout@v3
 
       - name: Download Go modules
         run: go mod download

.github/workflows/website-deploy.yml

@@ -0,0 +1,35 @@
+name: Website Deploy
+
+on:
+  push:
+    branches:
+      - master
+
+jobs:
+  website-deploy:
+    name: Website Deploy
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+
+      - uses: actions/setup-node@v3
+        with:
+          node-version: 16.x
+          cache: yarn
+          cache-dependency-path: ./docs/yarn.lock
+
+      - name: Install dependencies
+        run: yarn install --frozen-lockfile
+        working-directory: ./docs
+
+      - name: Build website
+        run: yarn build
+        working-directory: ./docs
+
+      - name: Website Deploy
+        uses: peaceiris/actions-gh-pages@v3
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./docs/build
+          user_name: task-bot
+          user_email: 106601941+task-bot@users.noreply.github.com

.github/workflows/website-test.yml

@@ -0,0 +1,27 @@
+name: Website Test
+
+on:
+  pull_request:
+    branches:
+      - master
+
+jobs:
+  website-test:
+    name: Website Test
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+
+      - uses: actions/setup-node@v3
+        with:
+          node-version: 16.x
+          cache: yarn
+          cache-dependency-path: ./docs/yarn.lock
+
+      - name: Install dependencies
+        run: yarn install --frozen-lockfile
+        working-directory: ./docs
+
+      - name: Test build website
+        run: yarn build
+        working-directory: ./docs

.gitignore

@@ -10,9 +10,6 @@
 # Output of the go coverage tool, specifically when used with LiteIDE
 *.out
 
-# Graphvis files
-*.gv
-
 # Project-local glide cache, RE: https://github.com/Masterminds/glide/issues/736
 .glide/
 
@@ -24,8 +21,7 @@ dist/
 
 # editors
 .idea/
-.vscode/settings.json
-.fleet/
+.vscode/
 
 # exuberant ctags
 tags
@@ -34,4 +30,3 @@ tags
 !/bin/.keep
 /testdata/vars/v1
 /tmp
-node_modules

.golangci.yml

@@ -1,64 +0,0 @@
-version: "2"
-
-formatters:
-  enable:
-    - gofmt
-    - gofumpt
-    - goimports
-    - gci
-  settings:
-    gofmt:
-      simplify: true
-      rewrite-rules:
-        - pattern: interface{}
-          replacement: any
-    gofumpt:
-      module-path: github.com/go-task/task/v3
-    goimports:
-      local-prefixes:
-        - github.com/go-task
-    gci:
-      sections:
-        - standard
-        - default
-        - prefix(github.com/go-task)
-        - localmodule
-  exclusions:
-    generated: lax
-    paths:
-      - third_party$
-      - builtin$
-      - examples$
-
-linters:
-  enable:
-    - depguard
-    - mirror
-    - misspell
-    - noctx
-    - paralleltest
-    - thelper
-    - tparallel
-    - usetesting
-  settings:
-    depguard:
-      rules:
-        main:
-          files:
-            - $all
-            - '!$test'
-            - '!**/errors/*.go'
-          deny:
-            - pkg: errors
-              desc: Use github.com/go-task/task/v3/errors instead
-  exclusions:
-    generated: lax
-    presets:
-      - comments
-      - common-false-positives
-      - legacy
-      - std-error-handling
-    paths:
-      - third_party$
-      - builtin$
-      - examples$

.goreleaser-nightly.yml

@@ -1,15 +0,0 @@
-# yaml-language-server: $schema=https://goreleaser.com/static/schema.json
-version: 2
-pro: true
-
-release:
-  name_template: 'v{{.Version}}'
-
-nightly:
-  publish_release: true
-  keep_single_release: true
-  version_template: "{{incminor .Version}}-nightly"
-
-includes:
-  - from_file:
-      path: ./.goreleaser.yml

.goreleaser.yml

@@ -1,75 +1,62 @@
-# yaml-language-server: $schema=https://goreleaser.com/static/schema.json
-version: 2
-
-builds:
-  - binary: task
-    main: ./cmd/task
-    goos:
-      - windows
-      - darwin
-      - linux
-      - freebsd
-    goarch:
-      - '386'
-      - amd64
-      - arm
-      - arm64
-      - riscv64
-    goarm:
-      - '6'
-    ignore:
-      - goos: darwin
-        goarch: '386'
-      - goos: darwin
-        goarch: riscv64
-      - goos: windows
-        goarch: riscv64
-    env:
-      - CGO_ENABLED=0
-    mod_timestamp: '{{ .CommitTimestamp }}'
-    flags:
-      - -trimpath
-    ldflags:
-      - "-s -w"
-      - "{{if .IsNightly}}-X github.com/go-task/task/v3/internal/version.version={{.Version}}{{end}}"
+build:
+  binary: task
+  main: ./cmd/task
+  goos:
+    - windows
+    - darwin
+    - linux
+  goarch:
+    - 386
+    - amd64
+    - arm
+    - arm64
+  goarm:
+    - 6
+  ignore:
+    - goos: darwin
+      goarch: 386
+  env:
+    - CGO_ENABLED=0
+  mod_timestamp: '{{ .CommitTimestamp }}'
+  flags:
+    - -trimpath
+  ldflags:
+    - -s -w # Don't set main.version.
 
 gomod:
   proxy: true
 
 archives:
-  - name_template: '{{.Binary}}_{{.Os}}_{{.Arch}}'
+  - name_template: "{{.Binary}}_{{.Os}}_{{.Arch}}"
     files:
       - README.md
       - LICENSE
       - completion/**/*
     format_overrides:
       - goos: windows
-        formats: [zip]
+        format: zip
 
-git:
-  ignore_tags:
-    - "{{if not .IsNightly}}nightly{{end}}"
+release:
+  draft: true
 
 snapshot:
-  version_template: '{{.Version}}'
+  name_template: "{{.Tag}}"
 
 checksum:
-  name_template: 'task_checksums.txt'
+  name_template: "task_checksums.txt"
 
 nfpms:
   - vendor: Task
     homepage: https://taskfile.dev
-    maintainer: The Task authors <task@taskfile.dev>
+    maintainer: Andrey Nering <andrey@nering.com.br>
     description: Simple task runner written in Go
-    section: golang
     license: MIT
     conflicts:
       - taskwarrior
     formats:
       - deb
       - rpm
-      - apk
-    file_name_template: '{{.ProjectName}}_{{.Version}}_{{.Os}}_{{.Arch}}'
+    file_name_template: "{{.ProjectName}}_{{.Os}}_{{.Arch}}"
     contents:
       - src: completion/bash/task.bash
         dst: /etc/bash_completion.d/task
@@ -83,11 +70,12 @@ brews:
     description: Task runner / simpler Make alternative written in Go
     license: MIT
     homepage: https://taskfile.dev
-    directory: Formula
-    repository:
+    folder: Formula
+    tap:
       owner: go-task
       name: homebrew-tap
-    test: system "#{bin}/task", "--help"
+    test:
+      system "#{bin}/task", "--help"
     install: |-
       bin.install "task"
       bash_completion.install "completion/bash/task.bash" => "task"
@@ -96,79 +84,3 @@ brews:
     commit_author:
       name: task-bot
       email: 106601941+task-bot@users.noreply.github.com
-
-winget:
-  - name: Task
-    publisher: Task
-    short_description: A task runner / simpler Make alternative written in Go
-    description: Task is a task runner / build tool that aims to be simpler and easier to use than, for example, GNU Make.
-    license: MIT
-    homepage: https://taskfile.dev/
-    publisher_url: https://taskfile.dev/
-    publisher_support_url: https://github.com/go-task/task/issues
-    package_identifier: Task.Task
-    commit_author:
-      name: task-bot
-      email: 106601941+task-bot@users.noreply.github.com
-    commit_msg_template: 'chore: release {{.PackageIdentifier}} {{.Tag}}'
-    release_notes_url: https://github.com/go-task/task/releases/tag/{{.Tag}}
-    tags:
-      - build
-      - build-tool
-      - devops
-      - go
-      - make
-      - makefile
-      - runner
-      - task
-      - task-runner
-      - taskfile
-      - tool
-    repository:
-      owner: go-task
-      name: winget-pkgs
-      branch: 'task-{{.Version}}'
-      pull_request:
-        enabled: true
-        draft: false
-        check_boxes: true
-        base:
-          owner: microsoft
-          name: winget-pkgs
-          branch: master
-        body: |
-          /cc @andreynering @pd93 @vmaerten
-
-
-npms:
-  - name: "@go-task/cli"
-    repository: "git+https://github.com/go-task/task.git"
-    bugs: https://github.com/go-task/task/issues
-    description: A task runner / simpler Make alternative written in Go
-    homepage: https://taskfile.dev
-    license: MIT
-    author: "The Task authors"
-    access: public
-    keywords:
-      - "task"
-      - "taskfile"
-      - "build-tool"
-      - "task-runner"
-
-
-cloudsmiths:
-  - organization: "task"
-    repository: "{{if not .IsNightly}}task{{end}}"
-    formats:
-      - deb
-      - rpm
-      - apk
-    distributions:
-      deb:
-        - "any-distro/any-version"
-      rpm:
-        - "any-distro/any-version"
-      alpine:
-        - "any-distro/any-version"
-    component: main
-    republish: true

.mockery.yaml

@@ -1,8 +0,0 @@
-all: False
-template: testify
-filename: '{{base (trimSuffix ".go" .InterfaceFile)}}_mock.go'
-packages:
-  github.com/go-task/task/v3/internal/fingerprint:
-    interfaces:
-      SourcesCheckable:
-      StatusCheckable:

.prettierrc.yml

@@ -1,7 +0,0 @@
-trailingComma: none
-singleQuote: true
-overrides:
-  - files: "*.md"
-    options:
-      printWidth: 80
-      proseWrap: always

.taskrc.yml

@@ -1,4 +0,0 @@
-experiments:
-  GENTLE_FORCE: 0
-  REMOTE_TASKFILES: 0
-  ENV_PRECEDENCE: 0

.vscode/extensions.json

@@ -1,7 +0,0 @@
-{
-  "recommendations": [
-    "editorconfig.editorconfig",
-    "golang.go",
-    "task.vscode-task"
-  ]
-}

.vscode/settings-sample.json

@@ -1,14 +0,0 @@
-{
-  "yaml.schemas": {
-    "./website/src/public/schema.json": [
-        "Taskfile.yml",
-        "Taskfile.yaml",
-        "taskfile.yml",
-        "taskfile.yaml"
-    ]
-  },
-  "gopls": {
-      "formatting.local": "github.com/go-task"
-  },
-  "go.formatTool": "gofumpt"
-}

README.md

@@ -1,6 +1,6 @@
 <div align="center">
   <a href="https://taskfile.dev">
-    <img src="website/src/public/img/logo.svg" width="200px" height="200px" />
+    <img src="docs/static/img/logo.svg" width="200px" height="200px" />
   </a>
 
   <h1>Task</h1>
@@ -10,23 +10,6 @@
   </p>
 
   <p>
-    <a href="https://taskfile.dev/docs/installation">Installation</a> | <a href="https://taskfile.dev/docs/getting-started">Getting Started</a> | <a href="https://taskfile.dev/docs/guide">Docs</a> | <a href="https://twitter.com/taskfiledev">Twitter</a> | <a href="https://bsky.app/profile/taskfile.dev">Bluesky</a> | <a href="https://fosstodon.org/@task">Mastodon</a> | <a href="https://discord.gg/6TY36E39UK">Discord</a>
+    See <a href="https://taskfile.dev">taskfile.dev</a> for the documentation.
   </p>
-
-  <h1>Gold Sponsors</h1>
-
-  <table>
-    <tr>
-      <td align="center" valign="middle">
-        <a target="_blank" href="https://devowl.io">
-          <img src="website/src/public/img/devowl.io.svg" height="100px" width="200px" title="devowl.io" />
-        </a>
-      </td>
-      <td align="center" valign="middle">
-        <a target="_blank" href="https://magic.dev/">
-          <img src="website/src/public/img/magic.png" height="100px" width="200px" title="Magic" />
-        </a>
-      </td>
-    </tr>
-  </table>
 </div>

Taskfile.yml

@@ -1,14 +1,16 @@
 version: '3'
 
 includes:
-  website:
-    aliases: [w, docs, d]
-    taskfile: ./website
-    dir: ./website
+  docs:
+    taskfile: ./docs
+    dir: ./docs
 
 vars:
-  BIN: "{{.ROOT_DIR}}/bin"
-  GOTESTSUM_FORMAT: '{{if .CI}}github-actions{{else}}pkgname{{end}}'
+  GIT_COMMIT:
+    sh: git log -n 1 --format=%h
+
+  GO_PACKAGES:
+    sh: go list ./...
 
 env:
   CGO_ENABLED: '0'
@@ -19,58 +21,12 @@ tasks:
       - task: lint
       - task: test
 
-  run:
-    desc: Runs Task
-    cmds:
-      - go run ./cmd/task {{.CLI_ARGS}}
-
   install:
     desc: Installs Task
-    aliases: [i]
     sources:
       - './**/*.go'
     cmds:
-      - go install -v ./cmd/task
-
-  generate:
-    aliases: [gen, g]
-    desc: Runs all generate tasks
-    cmds:
-      - task: generate:mocks
-      - task: generate:fixtures
-
-  generate:mocks:
-    desc: Runs Mockery to create mocks
-    aliases: [gen:mocks, g:mocks]
-    deps: [install:mockery]
-    sources:
-      - "internal/fingerprint/checker.go"
-    generates:
-      - "internal/mocks/*.go"
-    cmds:
-      - find . -type f -name *_mock.go -delete
-      - "{{.BIN}}/mockery"
-
-  generate:fixtures:
-    desc: Runs tests and generates golden fixture files
-    aliases: [gen:fixtures, g:fixtures]
-    env:
-      GOLDIE_UPDATE: 'true'
-      GOLDIE_TEMPLATE: 'true'
-    cmds:
-      - find ./testdata -name '*.golden' -delete
-      - go test ./...
-
-  install:mockery:
-    desc: Installs mockgen; a tool to generate mock files
-    vars:
-      MOCKERY_VERSION: v3.2.2
-    env:
-      GOBIN: "{{.BIN}}"
-    status:
-      - go version -m {{.BIN}}/mockery | grep github.com/vektra/mockery | grep {{.MOCKERY_VERSION}}
-    cmds:
-      - GOBIN="{{.BIN}}" go install github.com/vektra/mockery/v3@{{.MOCKERY_VERSION}}
+      - go install -v -ldflags="-w -s -X main.version={{.GIT_COMMIT}}" ./cmd/task
 
   mod:
     desc: Downloads and tidy Go modules
@@ -80,153 +36,64 @@ tasks:
 
   clean:
     desc: Cleans temp files and folders
-    aliases: [clear]
     cmds:
       - rm -rf dist/
       - rm -rf tmp/
 
   lint:
     desc: Runs golangci-lint
-    aliases: [l]
     sources:
       - './**/*.go'
-      - .golangci.yml
-      - go.mod
     cmds:
       - golangci-lint run
 
-  lint:fix:
-    desc: Runs golangci-lint and fixes any issues
-    sources:
-      - './**/*.go'
-      - .golangci.yml
-      - go.mod
-    cmds:
-      - golangci-lint run --fix
-
-  format:
-    desc: Runs golangci-lint and formats any Go files
-    aliases: [fmt, f]
-    sources:
-      - './**/*.go'
-      - .golangci.yml
-    cmds:
-      - golangci-lint fmt
-
   sleepit:build:
     desc: Builds the sleepit test helper
     sources:
       - ./cmd/sleepit/**/*.go
     generates:
-      - "{{.BIN}}/sleepit"
+      - ./bin/sleepit
     cmds:
-      - go build -o {{.BIN}}/sleepit{{exeExt}} ./cmd/sleepit
+      - go build -o ./bin/sleepit{{exeExt}} ./cmd/sleepit
 
   sleepit:run:
     desc: Builds the sleepit test helper
     deps: [sleepit:build]
     cmds:
-      - "{{.BIN}}/sleepit {{.CLI_ARGS}}"
+      - ./bin/sleepit {{.CLI_ARGS}}
     silent: true
 
   test:
     desc: Runs test suite
-    aliases: [t]
-    deps: [gotestsum:install]
-    sources:
-      - "**/*.go"
-      - "testdata/**/*"
+    deps: [install]
     cmds:
-      - gotestsum -f '{{.GOTESTSUM_FORMAT}}' ./...
+      - go test {{catLines .GO_PACKAGES}}
 
-  test:watch:
-    desc: Runs test suite with watch tests included
-    deps: [sleepit:build, gotestsum:install]
+  test:signals:
+    desc: Runs test suite with signals tests included
+    deps: [install, sleepit:build]
     cmds:
-      - gotestsum -f '{{.GOTESTSUM_FORMAT}}' ./... -tags 'watch'
+      - go test {{catLines .GO_PACKAGES}} -tags signals
 
-  test:all:
-    desc: Runs test suite with signals and watch tests included
-    deps: [sleepit:build, gotestsum:install]
-    cmds:
-      - gotestsum -f '{{.GOTESTSUM_FORMAT}}' -tags 'signals watch' ./...
-
-  goreleaser:test:
+  test-release:
     desc: Tests release process without publishing
     cmds:
-      - goreleaser --snapshot --clean
+      - goreleaser --snapshot --rm-dist
 
-  gotestsum:install:
-    desc: Installs gotestsum
-    status:
-      - command -v gotestsum
-    cmds:
-      - go install gotest.tools/gotestsum@latest
-
-  goreleaser:install:
-    desc: Installs goreleaser
-    cmds:
-      - go install github.com/goreleaser/goreleaser/v2@latest
-
-  gorelease:install:
-    desc: "Installs gorelease: https://pkg.go.dev/golang.org/x/exp/cmd/gorelease"
-    status:
-      - command -v gorelease
-    cmds:
-      - go install golang.org/x/exp/cmd/gorelease@latest
-
-  api:check:
-    desc: Checks what changes have been made to the public API
-    deps: [gorelease:install]
+  docs:changelog:
+    desc: Copy CHANGELOG.md to the documentation website
     vars:
-      LATEST:
-        sh: git describe --tags --abbrev=0
+      FILE: docs/docs/changelog.md
     cmds:
-      - gorelease -base={{.LATEST}}
+      - rm {{.FILE}}
+      - 'echo "---" >> {{.FILE}}'
+      - 'echo "slug: /changelog/" >> {{.FILE}}'
+      - 'echo "sidebar_position: 6" >> {{.FILE}}'
+      - 'echo "---" >> {{.FILE}}'
+      - 'echo "" >> {{.FILE}}'
+      - 'cat CHANGELOG.md >> {{.FILE}}'
 
-  release:*:
-    desc: Prepare the project for a new release
-    summary: |
-      This task will do the following:
-
-      - Update the version and date in the CHANGELOG.md file
-      - Update the version in the package.json and package-lock.json files
-      - Copy the latest docs to the "current" version on the website
-      - Commit the changes
-      - Create a new tag
-      - Push the commit/tag to the repository
-      - Create a GitHub release
-
-      To use the task, run "task release:<version>" where "<version>" is is one of:
-
-      - "major" - Bumps the major number
-      - "minor" - Bumps the minor number
-      - "patch" - Bumps the patch number
-      - A semver compatible version number (e.g. "1.2.3")
-    vars:
-      VERSION:
-        sh: "go run ./cmd/release --version {{index .MATCH 0}}"
-      COMPLETE_MESSAGE: |
-        Creating release with GoReleaser: https://github.com/go-task/task/actions/workflows/release.yml
-
-        Please wait for the CI to finish and then do the following:
-
-        - Copy the changelog for v{{.VERSION}} to the GitHub release
-        - Update and push the snapcraft manifest in https://github.com/go-task/snap/blob/main/snap/snapcraft.yaml
-    preconditions:
-      - sh: test $(git rev-parse --abbrev-ref HEAD) = "main"
-        msg: "You must be on the main branch to release"
-      - sh: "[[ -z $(git diff --shortstat main) ]]"
-        msg: "You must have a clean working tree to release"
-    prompt: "Are you sure you want to release version {{.VERSION}}?"
+  packages:
     cmds:
-      - cmd: echo "Releasing v{{.VERSION}}"
-        silent: true
-      - "go run ./cmd/release {{.VERSION}}"
-      - "git add --all"
-      - "git commit -m v{{.VERSION}}"
-      - "git push"
-      - "git tag v{{.VERSION}}"
-      - "git push origin tag v{{.VERSION}}"
-      - cmd: printf "%s" '{{.COMPLETE_MESSAGE}}'
-        silent: true
+      - echo '{{.GO_PACKAGES}}'
+    silent: true

args/args.go

@@ -3,54 +3,59 @@ package args
 import (
 	"strings"
 
-	"github.com/spf13/pflag"
-	"mvdan.cc/sh/v3/syntax"
-
-	"github.com/go-task/task/v3"
-	"github.com/go-task/task/v3/taskfile/ast"
+	"github.com/go-task/task/v3/taskfile"
 )
 
-// Get fetches the remaining arguments after CLI parsing and splits them into
-// two groups: the arguments before the double dash (--) and the arguments after
-// the double dash.
-func Get() ([]string, []string, error) {
-	args := pflag.Args()
-	doubleDashPos := pflag.CommandLine.ArgsLenAtDash()
-
-	if doubleDashPos == -1 {
-		return args, nil, nil
-	}
-	return args[:doubleDashPos], args[doubleDashPos:], nil
-}
-
-// Parse parses command line argument: tasks and global variables
-func Parse(args ...string) ([]*task.Call, *ast.Vars) {
-	calls := []*task.Call{}
-	globals := ast.NewVars()
+// ParseV3 parses command line argument: tasks and global variables
+func ParseV3(args ...string) ([]taskfile.Call, *taskfile.Vars) {
+	var calls []taskfile.Call
+	var globals = &taskfile.Vars{}
 
 	for _, arg := range args {
 		if !strings.Contains(arg, "=") {
-			calls = append(calls, &task.Call{Task: arg})
+			calls = append(calls, taskfile.Call{Task: arg})
 			continue
 		}
 
 		name, value := splitVar(arg)
-		globals.Set(name, ast.Var{Value: value})
+		globals.Set(name, taskfile.Var{Static: value})
+	}
+
+	if len(calls) == 0 {
+		calls = append(calls, taskfile.Call{Task: "default"})
 	}
 
 	return calls, globals
 }
 
-func ToQuotedString(args []string) (string, error) {
-	var quotedCliArgs []string
+// ParseV2 parses command line argument: tasks and vars of each task
+func ParseV2(args ...string) ([]taskfile.Call, *taskfile.Vars) {
+	var calls []taskfile.Call
+	var globals = &taskfile.Vars{}
+
 	for _, arg := range args {
-		quotedCliArg, err := syntax.Quote(arg, syntax.LangBash)
-		if err != nil {
-			return "", err
+		if !strings.Contains(arg, "=") {
+			calls = append(calls, taskfile.Call{Task: arg})
+			continue
+		}
+
+		if len(calls) < 1 {
+			name, value := splitVar(arg)
+			globals.Set(name, taskfile.Var{Static: value})
+		} else {
+			if calls[len(calls)-1].Vars == nil {
+				calls[len(calls)-1].Vars = &taskfile.Vars{}
+			}
+			name, value := splitVar(arg)
+			calls[len(calls)-1].Vars.Set(name, taskfile.Var{Static: value})
 		}
-		quotedCliArgs = append(quotedCliArgs, quotedCliArg)
 	}
-	return strings.Join(quotedCliArgs, " "), nil
+
+	if len(calls) == 0 {
+		calls = append(calls, taskfile.Call{Task: "default"})
+	}
+
+	return calls, globals
 }
 
 func splitVar(s string) (string, string) {

args/args_test.go

@@ -6,22 +6,19 @@ import (
 
 	"github.com/stretchr/testify/assert"
 
-	"github.com/go-task/task/v3"
 	"github.com/go-task/task/v3/args"
-	"github.com/go-task/task/v3/taskfile/ast"
+	"github.com/go-task/task/v3/taskfile"
 )
 
-func TestArgs(t *testing.T) {
-	t.Parallel()
-
+func TestArgsV3(t *testing.T) {
 	tests := []struct {
 		Args            []string
-		ExpectedCalls   []*task.Call
-		ExpectedGlobals *ast.Vars
+		ExpectedCalls   []taskfile.Call
+		ExpectedGlobals *taskfile.Vars
 	}{
 		{
 			Args: []string{"task-a", "task-b", "task-c"},
-			ExpectedCalls: []*task.Call{
+			ExpectedCalls: []taskfile.Call{
 				{Task: "task-a"},
 				{Task: "task-b"},
 				{Task: "task-c"},
@@ -29,99 +26,184 @@ func TestArgs(t *testing.T) {
 		},
 		{
 			Args: []string{"task-a", "FOO=bar", "task-b", "task-c", "BAR=baz", "BAZ=foo"},
-			ExpectedCalls: []*task.Call{
+			ExpectedCalls: []taskfile.Call{
 				{Task: "task-a"},
 				{Task: "task-b"},
 				{Task: "task-c"},
 			},
-			ExpectedGlobals: ast.NewVars(
-				&ast.VarElement{
-					Key: "FOO",
-					Value: ast.Var{
-						Value: "bar",
-					},
+			ExpectedGlobals: &taskfile.Vars{
+				Keys: []string{"FOO", "BAR", "BAZ"},
+				Mapping: map[string]taskfile.Var{
+					"FOO": taskfile.Var{Static: "bar"},
+					"BAR": taskfile.Var{Static: "baz"},
+					"BAZ": taskfile.Var{Static: "foo"},
 				},
-				&ast.VarElement{
-					Key: "BAR",
-					Value: ast.Var{
-						Value: "baz",
-					},
-				},
-				&ast.VarElement{
-					Key: "BAZ",
-					Value: ast.Var{
-						Value: "foo",
-					},
-				},
-			),
+			},
 		},
 		{
 			Args: []string{"task-a", "CONTENT=with some spaces"},
-			ExpectedCalls: []*task.Call{
+			ExpectedCalls: []taskfile.Call{
 				{Task: "task-a"},
 			},
-			ExpectedGlobals: ast.NewVars(
-				&ast.VarElement{
-					Key: "CONTENT",
-					Value: ast.Var{
-						Value: "with some spaces",
-					},
+			ExpectedGlobals: &taskfile.Vars{
+				Keys: []string{"CONTENT"},
+				Mapping: map[string]taskfile.Var{
+					"CONTENT": taskfile.Var{Static: "with some spaces"},
 				},
-			),
+			},
 		},
 		{
 			Args: []string{"FOO=bar", "task-a", "task-b"},
-			ExpectedCalls: []*task.Call{
+			ExpectedCalls: []taskfile.Call{
 				{Task: "task-a"},
 				{Task: "task-b"},
 			},
-			ExpectedGlobals: ast.NewVars(
-				&ast.VarElement{
-					Key: "FOO",
-					Value: ast.Var{
-						Value: "bar",
-					},
+			ExpectedGlobals: &taskfile.Vars{
+				Keys: []string{"FOO"},
+				Mapping: map[string]taskfile.Var{
+					"FOO": {Static: "bar"},
 				},
-			),
+			},
 		},
 		{
-			Args:          nil,
-			ExpectedCalls: []*task.Call{},
+			Args: nil,
+			ExpectedCalls: []taskfile.Call{
+				{Task: "default"},
+			},
 		},
 		{
-			Args:          []string{},
-			ExpectedCalls: []*task.Call{},
+			Args: []string{},
+			ExpectedCalls: []taskfile.Call{
+				{Task: "default"},
+			},
 		},
 		{
-			Args:          []string{"FOO=bar", "BAR=baz"},
-			ExpectedCalls: []*task.Call{},
-			ExpectedGlobals: ast.NewVars(
-				&ast.VarElement{
-					Key: "FOO",
-					Value: ast.Var{
-						Value: "bar",
-					},
+			Args: []string{"FOO=bar", "BAR=baz"},
+			ExpectedCalls: []taskfile.Call{
+				{Task: "default"},
+			},
+			ExpectedGlobals: &taskfile.Vars{
+				Keys: []string{"FOO", "BAR"},
+				Mapping: map[string]taskfile.Var{
+					"FOO": {Static: "bar"},
+					"BAR": {Static: "baz"},
 				},
-				&ast.VarElement{
-					Key: "BAR",
-					Value: ast.Var{
-						Value: "baz",
-					},
-				},
-			),
+			},
 		},
 	}
 
 	for i, test := range tests {
 		t.Run(fmt.Sprintf("TestArgs%d", i+1), func(t *testing.T) {
-			t.Parallel()
-
-			calls, globals := args.Parse(test.Args...)
+			calls, globals := args.ParseV3(test.Args...)
 			assert.Equal(t, test.ExpectedCalls, calls)
 			if test.ExpectedGlobals.Len() > 0 || globals.Len() > 0 {
 				assert.Equal(t, test.ExpectedGlobals, globals)
-				assert.Equal(t, test.ExpectedGlobals, globals)
 			}
 		})
 	}
 }
+
+func TestArgsV2(t *testing.T) {
+	tests := []struct {
+		Args            []string
+		ExpectedCalls   []taskfile.Call
+		ExpectedGlobals *taskfile.Vars
+	}{
+		{
+			Args: []string{"task-a", "task-b", "task-c"},
+			ExpectedCalls: []taskfile.Call{
+				{Task: "task-a"},
+				{Task: "task-b"},
+				{Task: "task-c"},
+			},
+		},
+		{
+			Args: []string{"task-a", "FOO=bar", "task-b", "task-c", "BAR=baz", "BAZ=foo"},
+			ExpectedCalls: []taskfile.Call{
+				{
+					Task: "task-a",
+					Vars: &taskfile.Vars{
+						Keys: []string{"FOO"},
+						Mapping: map[string]taskfile.Var{
+							"FOO": taskfile.Var{Static: "bar"},
+						},
+					},
+				},
+				{Task: "task-b"},
+				{
+					Task: "task-c",
+					Vars: &taskfile.Vars{
+						Keys: []string{"BAR", "BAZ"},
+						Mapping: map[string]taskfile.Var{
+							"BAR": taskfile.Var{Static: "baz"},
+							"BAZ": taskfile.Var{Static: "foo"},
+						},
+					},
+				},
+			},
+		},
+		{
+			Args: []string{"task-a", "CONTENT=with some spaces"},
+			ExpectedCalls: []taskfile.Call{
+				{
+					Task: "task-a",
+					Vars: &taskfile.Vars{
+						Keys: []string{"CONTENT"},
+						Mapping: map[string]taskfile.Var{
+							"CONTENT": taskfile.Var{Static: "with some spaces"},
+						},
+					},
+				},
+			},
+		},
+		{
+			Args: []string{"FOO=bar", "task-a", "task-b"},
+			ExpectedCalls: []taskfile.Call{
+				{Task: "task-a"},
+				{Task: "task-b"},
+			},
+			ExpectedGlobals: &taskfile.Vars{
+				Keys: []string{"FOO"},
+				Mapping: map[string]taskfile.Var{
+					"FOO": {Static: "bar"},
+				},
+			},
+		},
+		{
+			Args: nil,
+			ExpectedCalls: []taskfile.Call{
+				{Task: "default"},
+			},
+		},
+		{
+			Args: []string{},
+			ExpectedCalls: []taskfile.Call{
+				{Task: "default"},
+			},
+		},
+		{
+			Args: []string{"FOO=bar", "BAR=baz"},
+			ExpectedCalls: []taskfile.Call{
+				{Task: "default"},
+			},
+			ExpectedGlobals: &taskfile.Vars{
+				Keys: []string{"FOO", "BAR"},
+				Mapping: map[string]taskfile.Var{
+					"FOO": {Static: "bar"},
+					"BAR": {Static: "baz"},
+				},
+			},
+		},
+	}
+
+	for i, test := range tests {
+		t.Run(fmt.Sprintf("TestArgs%d", i+1), func(t *testing.T) {
+			calls, globals := args.ParseV2(test.Args...)
+			assert.Equal(t, test.ExpectedCalls, calls)
+			if test.ExpectedGlobals.Len() > 0 || globals.Len() > 0 {
+				assert.Equal(t, test.ExpectedGlobals, globals)
+			}
+
+		})
+	}
+}

call.go

@@ -1,11 +0,0 @@
-package task
-
-import "github.com/go-task/task/v3/taskfile/ast"
-
-// Call is the parameters to a task call
-type Call struct {
-	Task     string
-	Vars     *ast.Vars
-	Silent   bool
-	Indirect bool // True if the task was called by another task
-}

cmd/release/main.go

@@ -1,137 +0,0 @@
-package main
-
-import (
-	"fmt"
-	"os"
-	"regexp"
-	"strings"
-	"time"
-
-	"github.com/Masterminds/semver/v3"
-	"github.com/spf13/pflag"
-
-	"github.com/go-task/task/v3/errors"
-)
-
-const (
-	changelogSource = "CHANGELOG.md"
-	changelogTarget = "website/src/docs/changelog.md"
-	versionFile     = "internal/version/version.txt"
-)
-
-var changelogReleaseRegex = regexp.MustCompile(`## Unreleased`)
-
-// Flags
-var (
-	versionFlag bool
-)
-
-func init() {
-	pflag.BoolVarP(&versionFlag, "version", "v", false, "resolved version number")
-	pflag.Parse()
-}
-
-func main() {
-	if err := release(); err != nil {
-		fmt.Println(err)
-		os.Exit(1)
-	}
-}
-
-func release() error {
-	if len(pflag.Args()) != 1 {
-		return errors.New("error: expected version number")
-	}
-
-	version, err := getVersion(versionFile)
-	if err != nil {
-		return err
-	}
-
-	if err := bumpVersion(version, pflag.Arg(0)); err != nil {
-		return err
-	}
-
-	if versionFlag {
-		fmt.Println(version)
-		return nil
-	}
-
-	if err := changelog(version); err != nil {
-		return err
-	}
-
-	if err := setVersionFile(versionFile, version); err != nil {
-		return err
-	}
-
-	return nil
-}
-
-func getVersion(filename string) (*semver.Version, error) {
-	b, err := os.ReadFile(filename)
-	if err != nil {
-		return nil, err
-	}
-	return semver.NewVersion(strings.TrimSpace(string(b)))
-}
-
-func bumpVersion(version *semver.Version, verb string) error {
-	switch verb {
-	case "major":
-		*version = version.IncMajor()
-	case "minor":
-		*version = version.IncMinor()
-	case "patch":
-		*version = version.IncPatch()
-	default:
-		*version = *semver.MustParse(verb)
-	}
-	return nil
-}
-
-func changelog(version *semver.Version) error {
-	// Open changelog target file
-	b, err := os.ReadFile(changelogTarget)
-	if err != nil {
-		return err
-	}
-
-	// Get the current frontmatter
-	currentChangelog := string(b)
-	sections := strings.SplitN(currentChangelog, "---", 3)
-	if len(sections) != 3 {
-		return errors.New("error: invalid frontmatter")
-	}
-	frontmatter := strings.TrimSpace(sections[1])
-
-	// Open changelog source file
-	b, err = os.ReadFile(changelogSource)
-	if err != nil {
-		return err
-	}
-	changelog := string(b)
-	date := time.Now().Format("2006-01-02")
-
-	// Replace "Unreleased" with the new version and date
-	changelog = changelogReleaseRegex.ReplaceAllString(changelog, fmt.Sprintf("## v%s - %s", version, date))
-
-	// Write the changelog to the source file
-	if err := os.WriteFile(changelogSource, []byte(changelog), 0o644); err != nil {
-		return err
-	}
-
-	// Wrap the changelog content with v-pre directive for VitePress to prevent
-	// Vue from interpreting template syntax like {{.TASK_VERSION}}
-	changelogWithVPre := strings.Replace(changelog, "# Changelog\n\n", "# Changelog\n\n::: v-pre\n\n", 1) + "\n:::"
-
-	// Add the frontmatter to the changelog
-	changelogWithFrontmatter := fmt.Sprintf("---\n%s\n---\n\n%s", frontmatter, changelogWithVPre)
-
-	// Write the changelog to the target file
-	return os.WriteFile(changelogTarget, []byte(changelogWithFrontmatter), 0o644)
-}
-
-func setVersionFile(fileName string, version *semver.Version) error {
-	return os.WriteFile(fileName, []byte(version.String()+"\n"), 0o644)
-}

cmd/sleepit/sleepit.go

@@ -19,8 +19,10 @@ Commands
   handle      Handle signals: on reception of SIGINT perform cleanup before exiting
   version     Show the sleepit version`
 
-// Filled by the linker.
-var fullVersion = "unknown" // example: v0.0.9-8-g941583d027-dirty
+var (
+	// Filled by the linker.
+	fullVersion = "unknown" // example: v0.0.9-8-g941583d027-dirty
+)
 
 func main() {
 	os.Exit(run(os.Args[1:]))
@@ -128,11 +130,11 @@ func supervisor(
 // The goroutine will prepend its prints with the prefix `name`.
 // The goroutine will simulate some work and will terminate when one of the following
 // conditions happens:
-//  1. When `howlong` is elapsed. This case will be signaled on the `workerDone` channel.
-//  2. When something happens on channel `canceled`. Note that this simulates real-life,
-//     so cancellation is not instantaneous: if the caller wants a synchronous cancel,
-//     it should send a message; if instead it wants an asynchronous cancel, it should
-//     close the channel.
+// 1. When `howlong` is elapsed. This case will be signaled on the `workerDone` channel.
+// 2. When something happens on channel `canceled`. Note that this simulates real-life,
+//    so cancellation is not instantaneous: if the caller wants a synchronous cancel,
+//    it should send a message; if instead it wants an asynchronous cancel, it should
+//    close the channel.
 func worker(
 	canceled <-chan struct{},
 	howlong time.Duration,
@@ -159,7 +161,7 @@ func worker(
 	return workerDone
 }
 
-// Do some work and then return, so that the caller can decide whether to continue or not.
+// Do some work and then return, so that the caller can decide wether to continue or not.
 // Return true when all work is done.
 func doSomeWork(deadline time.Time) bool {
 	if time.Now().After(deadline) {

cmd/task/task.go

@@ -3,196 +3,265 @@ package main
 import (
 	"context"
 	"fmt"
+	"log"
 	"os"
 	"path/filepath"
-	"strconv"
+	"runtime/debug"
+	"strings"
 
 	"github.com/spf13/pflag"
+	"mvdan.cc/sh/v3/syntax"
 
 	"github.com/go-task/task/v3"
 	"github.com/go-task/task/v3/args"
-	"github.com/go-task/task/v3/errors"
-	"github.com/go-task/task/v3/experiments"
-	"github.com/go-task/task/v3/internal/filepathext"
-	"github.com/go-task/task/v3/internal/flags"
 	"github.com/go-task/task/v3/internal/logger"
-	"github.com/go-task/task/v3/internal/version"
-	"github.com/go-task/task/v3/taskfile/ast"
+	"github.com/go-task/task/v3/taskfile"
 )
 
+var (
+	version = ""
+)
+
+const usage = `Usage: task [-ilfwvsd] [--init] [--list] [--force] [--watch] [--verbose] [--silent] [--dir] [--taskfile] [--dry] [--summary] [task...]
+
+Runs the specified task(s). Falls back to the "default" task if no task name
+was specified, or lists all tasks if an unknown task name was specified.
+
+Example: 'task hello' with the following 'Taskfile.yml' file will generate an
+'output.txt' file with the content "hello".
+
+'''
+version: '3'
+tasks:
+  hello:
+    cmds:
+      - echo "I am going to write a file named 'output.txt' now."
+      - echo "hello" > output.txt
+    generates:
+      - output.txt
+'''
+
+Options:
+`
+
 func main() {
-	if err := run(); err != nil {
-		l := &logger.Logger{
-			Stdout:  os.Stdout,
-			Stderr:  os.Stderr,
-			Verbose: flags.Verbose,
-			Color:   flags.Color,
-		}
-		if err, ok := err.(*errors.TaskRunError); ok && flags.ExitCode {
-			emitCIErrorAnnotation(err)
-			l.Errf(logger.Red, "%v\n", err)
-			os.Exit(err.TaskExitCode())
-		}
-		if err, ok := err.(errors.TaskError); ok {
-			emitCIErrorAnnotation(err)
-			l.Errf(logger.Red, "%v\n", err)
-			os.Exit(err.Code())
-		}
-		emitCIErrorAnnotation(err)
-		l.Errf(logger.Red, "%v\n", err)
-		os.Exit(errors.CodeUnknown)
-	}
-	os.Exit(errors.CodeOk)
-}
+	log.SetFlags(0)
+	log.SetOutput(os.Stderr)
 
-// emitCIErrorAnnotation emits an error annotation for supported CI providers.
-func emitCIErrorAnnotation(err error) {
-	if isGA, _ := strconv.ParseBool(os.Getenv("GITHUB_ACTIONS")); !isGA {
+	pflag.Usage = func() {
+		log.Print(usage)
+		pflag.PrintDefaults()
+	}
+
+	var (
+		versionFlag bool
+		helpFlag    bool
+		init        bool
+		list        bool
+		listAll     bool
+		status      bool
+		force       bool
+		watch       bool
+		verbose     bool
+		silent      bool
+		dry         bool
+		summary     bool
+		exitCode    bool
+		parallel    bool
+		concurrency int
+		dir         string
+		entrypoint  string
+		output      taskfile.Output
+		color       bool
+	)
+
+	pflag.BoolVar(&versionFlag, "version", false, "show Task version")
+	pflag.BoolVarP(&helpFlag, "help", "h", false, "shows Task usage")
+	pflag.BoolVarP(&init, "init", "i", false, "creates a new Taskfile.yaml in the current folder")
+	pflag.BoolVarP(&list, "list", "l", false, "lists tasks with description of current Taskfile")
+	pflag.BoolVarP(&listAll, "list-all", "a", false, "lists tasks with or without a description")
+	pflag.BoolVar(&status, "status", false, "exits with non-zero exit code if any of the given tasks is not up-to-date")
+	pflag.BoolVarP(&force, "force", "f", false, "forces execution even when the task is up-to-date")
+	pflag.BoolVarP(&watch, "watch", "w", false, "enables watch of the given task")
+	pflag.BoolVarP(&verbose, "verbose", "v", false, "enables verbose mode")
+	pflag.BoolVarP(&silent, "silent", "s", false, "disables echoing")
+	pflag.BoolVarP(&parallel, "parallel", "p", false, "executes tasks provided on command line in parallel")
+	pflag.BoolVarP(&dry, "dry", "n", false, "compiles and prints tasks in the order that they would be run, without executing them")
+	pflag.BoolVar(&summary, "summary", false, "show summary about a task")
+	pflag.BoolVarP(&exitCode, "exit-code", "x", false, "pass-through the exit code of the task command")
+	pflag.StringVarP(&dir, "dir", "d", "", "sets directory of execution")
+	pflag.StringVarP(&entrypoint, "taskfile", "t", "", `choose which Taskfile to run. Defaults to "Taskfile.yml"`)
+	pflag.StringVarP(&output.Name, "output", "o", "", "sets output style: [interleaved|group|prefixed]")
+	pflag.StringVar(&output.Group.Begin, "output-group-begin", "", "message template to print before a task's grouped output")
+	pflag.StringVar(&output.Group.End, "output-group-end", "", "message template to print after a task's grouped output")
+	pflag.BoolVarP(&color, "color", "c", true, "colored output. Enabled by default. Set flag to false or use NO_COLOR=1 to disable")
+	pflag.IntVarP(&concurrency, "concurrency", "C", 0, "limit number tasks to run concurrently")
+	pflag.Parse()
+
+	if versionFlag {
+		fmt.Printf("Task version: %s\n", getVersion())
 		return
 	}
-	if e, ok := err.(*errors.TaskRunError); ok {
-		fmt.Fprintf(os.Stdout, "::error title=Task '%s' failed::%v\n", e.TaskName, e.Err)
-		return
-	}
-	fmt.Fprintf(os.Stdout, "::error title=Task failed::%v\n", err)
-}
 
-func run() error {
-	log := &logger.Logger{
-		Stdout:  os.Stdout,
-		Stderr:  os.Stderr,
-		Verbose: flags.Verbose,
-		Color:   flags.Color,
-	}
-
-	if err := flags.Validate(); err != nil {
-		return err
-	}
-
-	if err := experiments.Validate(); err != nil {
-		log.Warnf("%s\n", err.Error())
-	}
-
-	if flags.Version {
-		fmt.Println(version.GetVersionWithBuildInfo())
-		return nil
-	}
-
-	if flags.Help {
+	if helpFlag {
 		pflag.Usage()
-		return nil
+		return
 	}
 
-	if flags.Experiments {
-		return log.PrintExperiments()
-	}
-
-	if flags.Init {
+	if init {
 		wd, err := os.Getwd()
 		if err != nil {
-			return err
+			log.Fatal(err)
 		}
-		args, _, err := args.Get()
-		if err != nil {
-			return err
+		if err := task.InitTaskfile(os.Stdout, wd); err != nil {
+			log.Fatal(err)
 		}
-		path := wd
-		if len(args) > 0 {
-			name := args[0]
-			if filepathext.IsExtOnly(name) {
-				name = filepathext.SmartJoin(filepath.Dir(name), "Taskfile"+filepath.Ext(name))
-			}
-			path = filepathext.SmartJoin(wd, name)
-		}
-		finalPath, err := task.InitTaskfile(path)
-		if err != nil {
-			return err
-		}
-		if !flags.Silent {
-			if flags.Verbose {
-				log.Outf(logger.Default, "%s\n", task.DefaultTaskfile)
-			}
-			log.Outf(logger.Green, "Taskfile created: %s\n", filepathext.TryAbsToRel(finalPath))
-		}
-		return nil
+		return
 	}
 
-	if flags.Completion != "" {
-		script, err := task.Completion(flags.Completion)
-		if err != nil {
-			return err
-		}
-		fmt.Println(script)
-		return nil
+	if dir != "" && entrypoint != "" {
+		log.Fatal("task: You can't set both --dir and --taskfile")
+		return
+	}
+	if entrypoint != "" {
+		dir = filepath.Dir(entrypoint)
+		entrypoint = filepath.Base(entrypoint)
+	}
+
+	if output.Name != "group" {
+		if output.Group.Begin != "" {
+			log.Fatal("task: You can't set --output-group-begin without --output=group")
+			return
+		}
+		if output.Group.End != "" {
+			log.Fatal("task: You can't set --output-group-end without --output=group")
+			return
+		}
+	}
+
+	e := task.Executor{
+		Force:       force,
+		Watch:       watch,
+		Verbose:     verbose,
+		Silent:      silent,
+		Dir:         dir,
+		Dry:         dry,
+		Entrypoint:  entrypoint,
+		Summary:     summary,
+		Parallel:    parallel,
+		Color:       color,
+		Concurrency: concurrency,
+
+		Stdin:  os.Stdin,
+		Stdout: os.Stdout,
+		Stderr: os.Stderr,
+
+		OutputStyle: output,
+	}
+
+	if (list || listAll) && silent {
+		e.ListTaskNames(listAll)
+		return
 	}
 
-	e := task.NewExecutor(
-		flags.WithFlags(),
-		task.WithVersionCheck(true),
-	)
 	if err := e.Setup(); err != nil {
-		return err
+		log.Fatal(err)
+	}
+	v, err := e.Taskfile.ParsedVersion()
+	if err != nil {
+		log.Fatal(err)
+		return
 	}
 
-	if flags.ClearCache {
-		cachePath := filepath.Join(e.TempDir.Remote, "remote")
-		return os.RemoveAll(cachePath)
+	if list {
+		e.ListTasksWithDesc()
+		return
 	}
 
-	listOptions := task.NewListOptions(
-		flags.List,
-		flags.ListAll,
-		flags.ListJson,
-		flags.NoStatus,
-		flags.Nested,
+	if listAll {
+		e.ListAllTasks()
+		return
+	}
+
+	var (
+		calls   []taskfile.Call
+		globals *taskfile.Vars
 	)
-	if listOptions.ShouldListTasks() {
-		if flags.Silent {
-			return e.ListTaskNames(flags.ListAll)
-		}
-		foundTasks, err := e.ListTasks(listOptions)
-		if err != nil {
-			return err
-		}
-		if !foundTasks {
-			os.Exit(errors.CodeUnknown)
-		}
-		return nil
-	}
 
-	// Parse the remaining arguments
-	cliArgsPreDash, cliArgsPostDash, err := args.Get()
+	tasksAndVars, cliArgs, err := getArgs()
 	if err != nil {
-		return err
-	}
-	calls, globals := args.Parse(cliArgsPreDash...)
-
-	// If there are no calls, run the default task instead
-	if len(calls) == 0 {
-		calls = append(calls, &task.Call{Task: "default"})
+		log.Fatal(err)
 	}
 
-	cliArgsPostDashQuoted, err := args.ToQuotedString(cliArgsPostDash)
-	if err != nil {
-		return err
+	if v >= 3.0 {
+		calls, globals = args.ParseV3(tasksAndVars...)
+	} else {
+		calls, globals = args.ParseV2(tasksAndVars...)
 	}
-	globals.Set("CLI_ARGS", ast.Var{Value: cliArgsPostDashQuoted})
-	globals.Set("CLI_ARGS_LIST", ast.Var{Value: cliArgsPostDash})
-	globals.Set("CLI_FORCE", ast.Var{Value: flags.Force || flags.ForceAll})
-	globals.Set("CLI_SILENT", ast.Var{Value: flags.Silent})
-	globals.Set("CLI_VERBOSE", ast.Var{Value: flags.Verbose})
-	globals.Set("CLI_OFFLINE", ast.Var{Value: flags.Offline})
-	globals.Set("CLI_ASSUME_YES", ast.Var{Value: flags.AssumeYes})
-	e.Taskfile.Vars.ReverseMerge(globals, nil)
-	if !flags.Watch {
+
+	globals.Set("CLI_ARGS", taskfile.Var{Static: cliArgs})
+	e.Taskfile.Vars.Merge(globals)
+
+	if !watch {
 		e.InterceptInterruptSignals()
 	}
 
 	ctx := context.Background()
 
-	if flags.Status {
-		return e.Status(ctx, calls...)
+	if status {
+		if err := e.Status(ctx, calls...); err != nil {
+			log.Fatal(err)
+		}
+		return
 	}
 
-	return e.Run(ctx, calls...)
+	if err := e.Run(ctx, calls...); err != nil {
+		e.Logger.Errf(logger.Red, "%v", err)
+
+		if exitCode {
+			if err, ok := err.(*task.TaskRunError); ok {
+				os.Exit(err.ExitCode())
+			}
+		}
+		os.Exit(1)
+	}
+}
+
+func getArgs() ([]string, string, error) {
+	var (
+		args          = pflag.Args()
+		doubleDashPos = pflag.CommandLine.ArgsLenAtDash()
+	)
+
+	if doubleDashPos == -1 {
+		return args, "", nil
+	}
+
+	var quotedCliArgs []string
+	for _, arg := range args[doubleDashPos:] {
+		quotedCliArg, err := syntax.Quote(arg, syntax.LangBash)
+		if err != nil {
+			return nil, "", err
+		}
+		quotedCliArgs = append(quotedCliArgs, quotedCliArg)
+	}
+	return args[:doubleDashPos], strings.Join(quotedCliArgs, " "), nil
+}
+
+func getVersion() string {
+	if version != "" {
+		return version
+	}
+
+	info, ok := debug.ReadBuildInfo()
+	if !ok || info.Main.Version == "" {
+		return "unknown"
+	}
+
+	version = info.Main.Version
+	if info.Main.Sum != "" {
+		version += fmt.Sprintf(" (%s)", info.Main.Sum)
+	}
+
+	return version
 }

compiler.go

@@ -1,226 +0,0 @@
-package task
-
-import (
-	"bytes"
-	"context"
-	"fmt"
-	"os"
-	"path/filepath"
-	"strings"
-	"sync"
-
-	"github.com/go-task/task/v3/internal/env"
-	"github.com/go-task/task/v3/internal/execext"
-	"github.com/go-task/task/v3/internal/filepathext"
-	"github.com/go-task/task/v3/internal/logger"
-	"github.com/go-task/task/v3/internal/templater"
-	"github.com/go-task/task/v3/internal/version"
-	"github.com/go-task/task/v3/taskfile/ast"
-)
-
-type Compiler struct {
-	Dir            string
-	Entrypoint     string
-	UserWorkingDir string
-
-	TaskfileEnv  *ast.Vars
-	TaskfileVars *ast.Vars
-
-	Logger *logger.Logger
-
-	dynamicCache   map[string]string
-	muDynamicCache sync.Mutex
-}
-
-func (c *Compiler) GetTaskfileVariables() (*ast.Vars, error) {
-	return c.getVariables(nil, nil, true)
-}
-
-func (c *Compiler) GetVariables(t *ast.Task, call *Call) (*ast.Vars, error) {
-	return c.getVariables(t, call, true)
-}
-
-func (c *Compiler) FastGetVariables(t *ast.Task, call *Call) (*ast.Vars, error) {
-	return c.getVariables(t, call, false)
-}
-
-func (c *Compiler) getVariables(t *ast.Task, call *Call, evaluateShVars bool) (*ast.Vars, error) {
-	result := env.GetEnviron()
-	specialVars, err := c.getSpecialVars(t, call)
-	if err != nil {
-		return nil, err
-	}
-	for k, v := range specialVars {
-		result.Set(k, ast.Var{Value: v})
-	}
-
-	getRangeFunc := func(dir string) func(k string, v ast.Var) error {
-		return func(k string, v ast.Var) error {
-			cache := &templater.Cache{Vars: result}
-			// Replace values
-			newVar := templater.ReplaceVar(v, cache)
-			// If the variable should not be evaluated, but is nil, set it to an empty string
-			// This stops empty interface errors when using the templater to replace values later
-			// Preserve the Sh field so it can be displayed in summary
-			if !evaluateShVars && newVar.Value == nil {
-				result.Set(k, ast.Var{Value: "", Sh: newVar.Sh})
-				return nil
-			}
-			// If the variable should not be evaluated and it is set, we can set it and return
-			if !evaluateShVars {
-				result.Set(k, ast.Var{Value: newVar.Value, Sh: newVar.Sh})
-				return nil
-			}
-			// Now we can check for errors since we've handled all the cases when we don't want to evaluate
-			if err := cache.Err(); err != nil {
-				return err
-			}
-			// If the variable is already set, we can set it and return
-			if newVar.Value != nil || newVar.Sh == nil {
-				result.Set(k, ast.Var{Value: newVar.Value})
-				return nil
-			}
-			// If the variable is dynamic, we need to resolve it first
-			static, err := c.HandleDynamicVar(newVar, dir, env.GetFromVars(result))
-			if err != nil {
-				return err
-			}
-			result.Set(k, ast.Var{Value: static})
-			return nil
-		}
-	}
-	rangeFunc := getRangeFunc(c.Dir)
-
-	var taskRangeFunc func(k string, v ast.Var) error
-	if t != nil {
-		// NOTE(@andreynering): We're manually joining these paths here because
-		// this is the raw task, not the compiled one.
-		cache := &templater.Cache{Vars: result}
-		dir := templater.Replace(t.Dir, cache)
-		if err := cache.Err(); err != nil {
-			return nil, err
-		}
-		dir = filepathext.SmartJoin(c.Dir, dir)
-		taskRangeFunc = getRangeFunc(dir)
-	}
-
-	for k, v := range c.TaskfileEnv.All() {
-		if err := rangeFunc(k, v); err != nil {
-			return nil, err
-		}
-	}
-	for k, v := range c.TaskfileVars.All() {
-		if err := rangeFunc(k, v); err != nil {
-			return nil, err
-		}
-	}
-	if t != nil {
-		for k, v := range t.IncludeVars.All() {
-			if err := rangeFunc(k, v); err != nil {
-				return nil, err
-			}
-		}
-		for k, v := range t.IncludedTaskfileVars.All() {
-			if err := taskRangeFunc(k, v); err != nil {
-				return nil, err
-			}
-		}
-	}
-
-	if t == nil || call == nil {
-		return result, nil
-	}
-
-	for k, v := range call.Vars.All() {
-		if err := rangeFunc(k, v); err != nil {
-			return nil, err
-		}
-	}
-	for k, v := range t.Vars.All() {
-		if err := taskRangeFunc(k, v); err != nil {
-			return nil, err
-		}
-	}
-
-	return result, nil
-}
-
-func (c *Compiler) HandleDynamicVar(v ast.Var, dir string, e []string) (string, error) {
-	c.muDynamicCache.Lock()
-	defer c.muDynamicCache.Unlock()
-
-	// If the variable is not dynamic or it is empty, return an empty string
-	if v.Sh == nil || *v.Sh == "" {
-		return "", nil
-	}
-
-	if c.dynamicCache == nil {
-		c.dynamicCache = make(map[string]string, 30)
-	}
-	if result, ok := c.dynamicCache[*v.Sh]; ok {
-		return result, nil
-	}
-
-	// NOTE(@andreynering): If a var have a specific dir, use this instead
-	if v.Dir != "" {
-		dir = v.Dir
-	}
-
-	var stdout bytes.Buffer
-	opts := &execext.RunCommandOptions{
-		Command: *v.Sh,
-		Dir:     dir,
-		Stdout:  &stdout,
-		Stderr:  c.Logger.Stderr,
-		Env:     e,
-	}
-	if err := execext.RunCommand(context.Background(), opts); err != nil {
-		return "", fmt.Errorf(`task: Command "%s" failed: %s`, opts.Command, err)
-	}
-
-	// Trim a single trailing newline from the result to make most command
-	// output easier to use in shell commands.
-	result := strings.TrimSuffix(stdout.String(), "\r\n")
-	result = strings.TrimSuffix(result, "\n")
-
-	c.dynamicCache[*v.Sh] = result
-	c.Logger.VerboseErrf(logger.Magenta, "task: dynamic variable: %q result: %q\n", *v.Sh, result)
-
-	return result, nil
-}
-
-// ResetCache clear the dynamic variables cache
-func (c *Compiler) ResetCache() {
-	c.muDynamicCache.Lock()
-	defer c.muDynamicCache.Unlock()
-
-	c.dynamicCache = nil
-}
-
-func (c *Compiler) getSpecialVars(t *ast.Task, call *Call) (map[string]string, error) {
-	allVars := map[string]string{
-		"TASK_EXE":         filepath.ToSlash(os.Args[0]),
-		"ROOT_TASKFILE":    filepathext.SmartJoin(c.Dir, c.Entrypoint),
-		"ROOT_DIR":         c.Dir,
-		"USER_WORKING_DIR": c.UserWorkingDir,
-		"TASK_VERSION":     version.GetVersion(),
-	}
-	if t != nil {
-		allVars["TASK"] = t.Task
-		allVars["TASK_DIR"] = filepathext.SmartJoin(c.Dir, t.Dir)
-		allVars["TASKFILE"] = t.Location.Taskfile
-		allVars["TASKFILE_DIR"] = filepath.Dir(t.Location.Taskfile)
-	} else {
-		allVars["TASK"] = ""
-		allVars["TASK_DIR"] = ""
-		allVars["TASKFILE"] = ""
-		allVars["TASKFILE_DIR"] = ""
-	}
-	if call != nil {
-		allVars["ALIAS"] = call.Task
-	} else {
-		allVars["ALIAS"] = ""
-	}
-
-	return allVars, nil
-}

completion.go

@@ -1,34 +0,0 @@
-package task
-
-import (
-	_ "embed"
-	"fmt"
-)
-
-//go:embed completion/bash/task.bash
-var completionBash string
-
-//go:embed completion/fish/task.fish
-var completionFish string
-
-//go:embed completion/ps/task.ps1
-var completionPowershell string
-
-//go:embed completion/zsh/_task
-var completionZsh string
-
-func Completion(completion string) (string, error) {
-	// Get the file extension for the selected shell
-	switch completion {
-	case "bash":
-		return completionBash, nil
-	case "fish":
-		return completionFish, nil
-	case "powershell":
-		return completionPowershell, nil
-	case "zsh":
-		return completionZsh, nil
-	default:
-		return "", fmt.Errorf("unknown shell: %s", completion)
-	}
-}

completion/bash/task.bash

@@ -1,7 +1,6 @@
 # vim: set tabstop=2 shiftwidth=2 expandtab:
 
 _GO_TASK_COMPLETION_LIST_OPTION='--list-all'
-TASK_CMD="${TASK_EXE:-task}"
 
 function _task()
 {
@@ -22,7 +21,7 @@ function _task()
 
   # Handle special arguments of options.
   case "$prev" in
-    -d|--dir|--remote-cache-dir)
+    -d|--dir)
       _filedir -d
       return $?
     ;;
@@ -53,4 +52,4 @@ function _task()
   __ltrim_colon_completions "$cur"
 }
 
-complete -F _task "$TASK_CMD"
+complete -F _task task

completion/fish/task.fish

@@ -1,116 +1,29 @@
-set -l GO_TASK_PROGNAME (if set -q GO_TASK_PROGNAME; echo $GO_TASK_PROGNAME; else if set -q TASK_EXE; echo $TASK_EXE; else; echo task; end)
+set GO_TASK_PROGNAME task
 
-# Cache variables for experiments (global)
-set -g __task_experiments_cache ""
-set -g __task_experiments_cache_time 0
-
-# Helper function to get experiments with 1-second cache
-function __task_get_experiments
-    set -l now (date +%s)
-    set -l ttl 1  # Cache for 1 second only
-
-    # Return cached value if still valid
-    if test (math "$now - $__task_experiments_cache_time") -lt $ttl
-        printf '%s\n' $__task_experiments_cache
-        return
-    end
-
-    # Refresh cache
-    set -g __task_experiments_cache (task --experiments 2>/dev/null)
-    set -g __task_experiments_cache_time $now
-    printf '%s\n' $__task_experiments_cache
-end
-
-# Helper function to check if an experiment is enabled
-function __task_is_experiment_enabled
-    set -l experiment $argv[1]
-    __task_get_experiments | string match -qr "^\* $experiment:.*on"
-end
-
-function __task_get_tasks --description "Prints all available tasks with their description" --inherit-variable GO_TASK_PROGNAME
-  # Check if the global task is requested
-  set -l global_task false
-  commandline --current-process | read --tokenize --list --local cmd_args
-  for arg in $cmd_args
-    if test "_$arg" = "_--"
-      break # ignore arguments to be passed to the task
-    end
-    if test "_$arg" = "_--global" -o "_$arg" = "_-g"
-      set global_task true
-      break
-    end
-  end
-
-  # Read the list of tasks (and potential errors)
-  if $global_task
-    $GO_TASK_PROGNAME --global --list-all
-  else
-    $GO_TASK_PROGNAME --list-all
-  end 2>&1 | read -lz rawOutput
-
-  # Return on non-zero exit code (for cases when there is no Taskfile found or etc.)
-  if test $status -ne 0
-    return
-  end
-
-  # Grab names and descriptions (if any) of the tasks
-  set -l output (echo $rawOutput | sed -e '1d; s/\* \(.*\):\s\{2,\}\(.*\)\s\{2,\}(\(aliases.*\))/\1\t\2\t\3/' -e 's/\* \(.*\):\s\{2,\}\(.*\)/\1\t\2/'| string split0)
+function __task_get_tasks --description "Prints all available tasks with their description"
+	set -l output ($GO_TASK_PROGNAME --list-all | sed '1d; s/\* \(.*\):\s*\(.*\)/\1\t\2/' | string split0)
   if test $output
-    echo $output
+      echo $output
   end
 end
 
-complete -c $GO_TASK_PROGNAME \
-  -d 'Runs the specified task(s). Falls back to the "default" task if no task name was specified, or lists all tasks if an unknown task name was specified.' \
-  -xa "(__task_get_tasks)" \
-  -n "not __fish_seen_subcommand_from --"
+complete -c $GO_TASK_PROGNAME -d 'Runs the specified task(s). Falls back to the "default" task if no task name was specified, or lists all tasks if an unknown task name was
+specified.' -xa "(__task_get_tasks)"
 
-# Standard flags
-complete -c $GO_TASK_PROGNAME -s a -l list-all                  -d 'list all tasks'
-complete -c $GO_TASK_PROGNAME -s c -l color                     -d 'colored output (default true)'
-complete -c $GO_TASK_PROGNAME -s C -l concurrency               -d 'limit number of concurrent tasks'
-complete -c $GO_TASK_PROGNAME      -l completion                -d 'generate shell completion script' -xa "bash zsh fish powershell"
-complete -c $GO_TASK_PROGNAME -s d -l dir                       -d 'set directory of execution'
-complete -c $GO_TASK_PROGNAME      -l disable-fuzzy             -d 'disable fuzzy matching for task names'
-complete -c $GO_TASK_PROGNAME -s n -l dry                       -d 'compile and print tasks without executing'
-complete -c $GO_TASK_PROGNAME -s x -l exit-code                 -d 'pass-through exit code of task command'
-complete -c $GO_TASK_PROGNAME      -l experiments               -d 'list available experiments'
-complete -c $GO_TASK_PROGNAME -s F -l failfast                  -d 'when running tasks in parallel, stop all tasks if one fails'
-complete -c $GO_TASK_PROGNAME -s f -l force                     -d 'force execution even when up-to-date'
-complete -c $GO_TASK_PROGNAME -s g -l global                    -d 'run global Taskfile from home directory'
-complete -c $GO_TASK_PROGNAME -s h -l help                      -d 'show help'
-complete -c $GO_TASK_PROGNAME -s i -l init                      -d 'create new Taskfile'
-complete -c $GO_TASK_PROGNAME      -l insecure                  -d 'allow insecure Taskfile downloads'
-complete -c $GO_TASK_PROGNAME -s I -l interval                  -d 'interval to watch for changes'
-complete -c $GO_TASK_PROGNAME -s j -l json                      -d 'format task list as JSON'
-complete -c $GO_TASK_PROGNAME -s l -l list                      -d 'list tasks with descriptions'
-complete -c $GO_TASK_PROGNAME      -l nested                    -d 'nest namespaces when listing as JSON'
-complete -c $GO_TASK_PROGNAME      -l no-status                 -d 'ignore status when listing as JSON'
-complete -c $GO_TASK_PROGNAME -s o -l output                    -d 'set output style' -xa "interleaved group prefixed"
-complete -c $GO_TASK_PROGNAME      -l output-group-begin        -d 'message template before grouped output'
-complete -c $GO_TASK_PROGNAME      -l output-group-end          -d 'message template after grouped output'
-complete -c $GO_TASK_PROGNAME      -l output-group-error-only   -d 'hide output from successful tasks'
-complete -c $GO_TASK_PROGNAME -s p -l parallel                  -d 'execute tasks in parallel'
-complete -c $GO_TASK_PROGNAME -s s -l silent                    -d 'disable echoing'
-complete -c $GO_TASK_PROGNAME      -l sort                      -d 'set task sorting order' -xa "default alphanumeric none"
-complete -c $GO_TASK_PROGNAME      -l status                    -d 'exit non-zero if tasks not up-to-date'
-complete -c $GO_TASK_PROGNAME      -l summary                   -d 'show task summary'
-complete -c $GO_TASK_PROGNAME -s t -l taskfile                  -d 'choose Taskfile to run'
-complete -c $GO_TASK_PROGNAME -s v -l verbose                   -d 'verbose output'
-complete -c $GO_TASK_PROGNAME      -l version                   -d 'show version'
-complete -c $GO_TASK_PROGNAME -s w -l watch                     -d 'watch mode, re-run on changes'
-complete -c $GO_TASK_PROGNAME -s y -l yes                       -d 'assume yes to all prompts'
 
-# Experimental flags (dynamically checked at completion time via -n condition)
-# GentleForce experiment
-complete -c $GO_TASK_PROGNAME -n "__task_is_experiment_enabled GENTLE_FORCE" -l force-all -d 'force execution of task and all dependencies'
-
-# RemoteTaskfiles experiment - Options
-complete -c $GO_TASK_PROGNAME -n "__task_is_experiment_enabled REMOTE_TASKFILES" -l offline          -d 'use only local or cached Taskfiles'
-complete -c $GO_TASK_PROGNAME -n "__task_is_experiment_enabled REMOTE_TASKFILES" -l timeout          -d 'timeout for remote Taskfile downloads'
-complete -c $GO_TASK_PROGNAME -n "__task_is_experiment_enabled REMOTE_TASKFILES" -l expiry           -d 'cache expiry duration'
-complete -c $GO_TASK_PROGNAME -n "__task_is_experiment_enabled REMOTE_TASKFILES" -l remote-cache-dir -d 'directory to cache remote Taskfiles' -xa "(__fish_complete_directories)"
-
-# RemoteTaskfiles experiment - Operations
-complete -c $GO_TASK_PROGNAME -n "__task_is_experiment_enabled REMOTE_TASKFILES" -l download    -d 'download remote Taskfile'
-complete -c $GO_TASK_PROGNAME -n "__task_is_experiment_enabled REMOTE_TASKFILES" -l clear-cache -d 'clear remote Taskfile cache'
+complete -c $GO_TASK_PROGNAME -s c -l color     -d 'colored output (default true)'
+complete -c $GO_TASK_PROGNAME -s d -l dir       -d 'sets directory of execution'
+complete -c $GO_TASK_PROGNAME      -l dry       -d 'compiles and prints tasks in the order that they would be run, without executing them'
+complete -c $GO_TASK_PROGNAME -s f -l force     -d 'forces execution even when the task is up-to-date'
+complete -c $GO_TASK_PROGNAME -s h -l help      -d 'shows Task usage'
+complete -c $GO_TASK_PROGNAME -s i -l init      -d 'creates a new Taskfile.yml in the current folder'
+complete -c $GO_TASK_PROGNAME -s l -l list      -d 'lists tasks with description of current Taskfile'
+complete -c $GO_TASK_PROGNAME -s o -l output    -d 'sets output style: [interleaved|group|prefixed]' -xa "interleaved group prefixed"
+complete -c $GO_TASK_PROGNAME -s p -l parallel  -d 'executes tasks provided on command line in parallel'
+complete -c $GO_TASK_PROGNAME -s s -l silent    -d 'disables echoing'
+complete -c $GO_TASK_PROGNAME      -l status    -d 'exits with non-zero exit code if any of the given tasks is not up-to-date'
+complete -c $GO_TASK_PROGNAME      -l summary   -d 'show summary about a task'
+complete -c $GO_TASK_PROGNAME -s t -l taskfile  -d 'choose which Taskfile to run. Defaults to "Taskfile.yml"'
+complete -c $GO_TASK_PROGNAME -s v -l verbose   -d 'enables verbose mode'
+complete -c $GO_TASK_PROGNAME      -l version   -d 'show Task version'
+complete -c $GO_TASK_PROGNAME -s w -l watch     -d 'enables watch of the given task'

completion/ps/task.ps1

@@ -1,88 +1,10 @@
-using namespace System.Management.Automation
-
-Register-ArgumentCompleter -CommandName task -ScriptBlock {
-	param($commandName, $parameterName, $wordToComplete, $commandAst, $fakeBoundParameters)
-
-	if ($commandName.StartsWith('-')) {
-		$completions = @(
-			# Standard flags (alphabetical order)
-			[CompletionResult]::new('-a', '-a', [CompletionResultType]::ParameterName, 'list all tasks'),
-			[CompletionResult]::new('--list-all', '--list-all', [CompletionResultType]::ParameterName, 'list all tasks'),
-			[CompletionResult]::new('-c', '-c', [CompletionResultType]::ParameterName, 'colored output'),
-			[CompletionResult]::new('--color', '--color', [CompletionResultType]::ParameterName, 'colored output'),
-			[CompletionResult]::new('-C', '-C', [CompletionResultType]::ParameterName, 'limit concurrent tasks'),
-			[CompletionResult]::new('--concurrency', '--concurrency', [CompletionResultType]::ParameterName, 'limit concurrent tasks'),
-			[CompletionResult]::new('--completion', '--completion', [CompletionResultType]::ParameterName, 'generate shell completion'),
-			[CompletionResult]::new('-d', '-d', [CompletionResultType]::ParameterName, 'set directory'),
-			[CompletionResult]::new('--dir', '--dir', [CompletionResultType]::ParameterName, 'set directory'),
-			[CompletionResult]::new('--disable-fuzzy', '--disable-fuzzy', [CompletionResultType]::ParameterName, 'disable fuzzy matching'),
-			[CompletionResult]::new('-n', '-n', [CompletionResultType]::ParameterName, 'dry run'),
-			[CompletionResult]::new('--dry', '--dry', [CompletionResultType]::ParameterName, 'dry run'),
-			[CompletionResult]::new('-x', '-x', [CompletionResultType]::ParameterName, 'pass-through exit code'),
-			[CompletionResult]::new('--exit-code', '--exit-code', [CompletionResultType]::ParameterName, 'pass-through exit code'),
-			[CompletionResult]::new('--experiments', '--experiments', [CompletionResultType]::ParameterName, 'list experiments'),
-			[CompletionResult]::new('-F', '-F', [CompletionResultType]::ParameterName, 'fail fast on pallalel tasks'),
-			[CompletionResult]::new('--failfast', '--failfast', [CompletionResultType]::ParameterName, 'force execution'),
-			[CompletionResult]::new('-f', '-f', [CompletionResultType]::ParameterName, 'force execution'),
-			[CompletionResult]::new('--force', '--force', [CompletionResultType]::ParameterName, 'force execution'),
-			[CompletionResult]::new('-g', '-g', [CompletionResultType]::ParameterName, 'run global Taskfile'),
-			[CompletionResult]::new('--global', '--global', [CompletionResultType]::ParameterName, 'run global Taskfile'),
-			[CompletionResult]::new('-h', '-h', [CompletionResultType]::ParameterName, 'show help'),
-			[CompletionResult]::new('--help', '--help', [CompletionResultType]::ParameterName, 'show help'),
-			[CompletionResult]::new('-i', '-i', [CompletionResultType]::ParameterName, 'create new Taskfile'),
-			[CompletionResult]::new('--init', '--init', [CompletionResultType]::ParameterName, 'create new Taskfile'),
-			[CompletionResult]::new('--insecure', '--insecure', [CompletionResultType]::ParameterName, 'allow insecure downloads'),
-			[CompletionResult]::new('-I', '-I', [CompletionResultType]::ParameterName, 'watch interval'),
-			[CompletionResult]::new('--interval', '--interval', [CompletionResultType]::ParameterName, 'watch interval'),
-			[CompletionResult]::new('-j', '-j', [CompletionResultType]::ParameterName, 'format as JSON'),
-			[CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'format as JSON'),
-			[CompletionResult]::new('-l', '-l', [CompletionResultType]::ParameterName, 'list tasks'),
-			[CompletionResult]::new('--list', '--list', [CompletionResultType]::ParameterName, 'list tasks'),
-			[CompletionResult]::new('--nested', '--nested', [CompletionResultType]::ParameterName, 'nest namespaces in JSON'),
-			[CompletionResult]::new('--no-status', '--no-status', [CompletionResultType]::ParameterName, 'ignore status in JSON'),
-			[CompletionResult]::new('-o', '-o', [CompletionResultType]::ParameterName, 'set output style'),
-			[CompletionResult]::new('--output', '--output', [CompletionResultType]::ParameterName, 'set output style'),
-			[CompletionResult]::new('--output-group-begin', '--output-group-begin', [CompletionResultType]::ParameterName, 'template before group'),
-			[CompletionResult]::new('--output-group-end', '--output-group-end', [CompletionResultType]::ParameterName, 'template after group'),
-			[CompletionResult]::new('--output-group-error-only', '--output-group-error-only', [CompletionResultType]::ParameterName, 'hide successful output'),
-			[CompletionResult]::new('-p', '-p', [CompletionResultType]::ParameterName, 'execute in parallel'),
-			[CompletionResult]::new('--parallel', '--parallel', [CompletionResultType]::ParameterName, 'execute in parallel'),
-			[CompletionResult]::new('-s', '-s', [CompletionResultType]::ParameterName, 'silent mode'),
-			[CompletionResult]::new('--silent', '--silent', [CompletionResultType]::ParameterName, 'silent mode'),
-			[CompletionResult]::new('--sort', '--sort', [CompletionResultType]::ParameterName, 'task sorting order'),
-			[CompletionResult]::new('--status', '--status', [CompletionResultType]::ParameterName, 'check task status'),
-			[CompletionResult]::new('--summary', '--summary', [CompletionResultType]::ParameterName, 'show task summary'),
-			[CompletionResult]::new('-t', '-t', [CompletionResultType]::ParameterName, 'choose Taskfile'),
-			[CompletionResult]::new('--taskfile', '--taskfile', [CompletionResultType]::ParameterName, 'choose Taskfile'),
-			[CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'verbose output'),
-			[CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'verbose output'),
-			[CompletionResult]::new('--version', '--version', [CompletionResultType]::ParameterName, 'show version'),
-			[CompletionResult]::new('-w', '-w', [CompletionResultType]::ParameterName, 'watch mode'),
-			[CompletionResult]::new('--watch', '--watch', [CompletionResultType]::ParameterName, 'watch mode'),
-			[CompletionResult]::new('-y', '-y', [CompletionResultType]::ParameterName, 'assume yes'),
-			[CompletionResult]::new('--yes', '--yes', [CompletionResultType]::ParameterName, 'assume yes')
-		)
-
-		# Experimental flags (dynamically added based on enabled experiments)
-		$experiments = & task --experiments 2>$null | Out-String
-
-		if ($experiments -match '\* GENTLE_FORCE:.*on') {
-			$completions += [CompletionResult]::new('--force-all', '--force-all', [CompletionResultType]::ParameterName, 'force all dependencies')
-		}
-
-		if ($experiments -match '\* REMOTE_TASKFILES:.*on') {
-			# Options
-			$completions += [CompletionResult]::new('--offline', '--offline', [CompletionResultType]::ParameterName, 'use cached Taskfiles')
-			$completions += [CompletionResult]::new('--timeout', '--timeout', [CompletionResultType]::ParameterName, 'download timeout')
-			$completions += [CompletionResult]::new('--expiry', '--expiry', [CompletionResultType]::ParameterName, 'cache expiry')
-			$completions += [CompletionResult]::new('--remote-cache-dir', '--remote-cache-dir', [CompletionResultType]::ParameterName, 'cache directory')
-			# Operations
-			$completions += [CompletionResult]::new('--download', '--download', [CompletionResultType]::ParameterName, 'download remote Taskfile')
-			$completions += [CompletionResult]::new('--clear-cache', '--clear-cache', [CompletionResultType]::ParameterName, 'clear cache')
-		}
-
-		return $completions.Where{ $_.CompletionText.StartsWith($commandName) }
-	}
-
-	return 	$(task --list-all --silent) | Where-Object { $_.StartsWith($commandName) } | ForEach-Object { return $_ + " " }
+$scriptBlock = {
+	param($commandName, $wordToComplete, $cursorPosition)
+	$curReg = "task{.exe}? (.*?)$"
+	$startsWith = $wordToComplete | Select-String $curReg -AllMatches | ForEach-Object { $_.Matches.Groups[1].Value }
+	$reg = "\* ($startsWith.+?):"
+	$listOutput = $(task --list-all)
+	$listOutput | Select-String $reg -AllMatches | ForEach-Object { $_.Matches.Groups[1].Value + " " }
 }
+
+Register-ArgumentCompleter -Native -CommandName task -ScriptBlock $scriptBlock

completion/zsh/_task

@@ -1,15 +1,7 @@
 #compdef task
+
+local context state state_descr line
 typeset -A opt_args
-TASK_CMD="${TASK_EXE:-task}"
-compdef _task "$TASK_CMD"
-
-_GO_TASK_COMPLETION_LIST_OPTION="${GO_TASK_COMPLETION_LIST_OPTION:---list-all}"
-
-# Check if an experiment is enabled
-function __task_is_experiment_enabled() {
-    local experiment=$1
-    task --experiments 2>/dev/null | grep -q "^\* ${experiment}:.*on"
-}
 
 # Listing commands from Taskfile.yml
 function __task_list() {
@@ -17,134 +9,52 @@ function __task_list() {
     local -i enabled=0
     local taskfile item task desc
 
-    cmd=($TASK_CMD)
-    taskfile=${(Qv)opt_args[(i)-t|--taskfile]}
-    taskfile=${taskfile//\~/$HOME}
-
-    for arg in "${words[@]:0:$CURRENT}"; do
-        if [[ "$arg" = "--" ]]; then
-            # Use default completion for words after `--` as they are CLI_ARGS.
-            _default
-            return 0
-        fi
-    done
+    cmd=(task)
+    taskfile="${(v)opt_args[(i)-t|--taskfile]}"
 
     if [[ -n "$taskfile" && -f "$taskfile" ]]; then
-        cmd+=(--taskfile "$taskfile")
-    fi
-
-    # Check if global flag is set
-    if (( ${+opt_args[(i)-g|--global]} )); then
-        cmd+=(--global)
-    fi
-
-    if output=$("${cmd[@]}" $_GO_TASK_COMPLETION_LIST_OPTION 2>/dev/null); then
         enabled=1
+        cmd+=(--taskfile "$taskfile")
+    else
+        for taskfile in Taskfile{,.dist}.{yaml,yml}; do
+            if [[ -f "$taskfile" ]]; then
+                enabled=1
+                break
+            fi
+        done
     fi
 
     (( enabled )) || return 0
 
     scripts=()
-
-    # Read zstyle verbose option (default = true via -T)
-    local show_desc
-    zstyle -T ":completion:${curcontext}:" verbose && show_desc=true || show_desc=false
-
-    for item in "${(@)${(f)output}[2,-1]#\* }"; do
+    for item in "${(@)${(f)$("${cmd[@]}" --list-all)}[2,-1]#\* }"; do
         task="${item%%:[[:space:]]*}"
-
-        if [[ "$show_desc" == "true" ]]; then
-            local desc="${item##[^[:space:]]##[[:space:]]##}"
-            scripts+=( "${task//:/\\:}:$desc" )
-        else
-            scripts+=( "$task" )
-        fi
+        desc="${item##[^[:space:]]##[[:space:]]##}"
+        scripts+=( "${task//:/\\:}:$desc" )
     done
-
-    if [[ "$show_desc" == "true" ]]; then
-        _describe 'Task to run' scripts
-    else
-        compadd -Q -a scripts
-    fi
+    _describe 'Task to run' scripts
 }
 
-_task() {
-    local -a standard_args operation_args
-
-    standard_args=(
-        '(-C --concurrency)'{-C,--concurrency}'[limit number of concurrent tasks]: '
-        '(-p --parallel)'{-p,--parallel}'[run command-line tasks in parallel]'
-        '(-F --failfast)'{-F,--failfast}'[when running tasks in parallel, stop all tasks if one fails]'
-        '(-f --force)'{-f,--force}'[run even if task is up-to-date]'
-        '(-c --color)'{-c,--color}'[colored output]'
-        '(--completion)--completion[generate shell completion script]:shell:(bash zsh fish powershell)'
-        '(-d --dir)'{-d,--dir}'[dir to run in]:execution dir:_dirs'
-        '(--disable-fuzzy)--disable-fuzzy[disable fuzzy matching for task names]'
-        '(-n --dry)'{-n,--dry}'[compiles and prints tasks without executing]'
-        '(--dry)--dry[dry-run mode, compile and print tasks only]'
-        '(-x --exit-code)'{-x,--exit-code}'[pass-through exit code of task command]'
-        '(--experiments)--experiments[list available experiments]'
-        '(-g --global)'{-g,--global}'[run global Taskfile from home directory]'
-        '(--insecure)--insecure[allow insecure Taskfile downloads]'
-        '(-I --interval)'{-I,--interval}'[interval to watch for changes]:duration: '
-        '(-j --json)'{-j,--json}'[format task list as JSON]'
-        '(--nested)--nested[nest namespaces when listing as JSON]'
-        '(--no-status)--no-status[ignore status when listing as JSON]'
-        '(-o --output)'{-o,--output}'[set output style]:style:(interleaved group prefixed)'
-        '(--output-group-begin)--output-group-begin[message template before grouped output]:template text: '
-        '(--output-group-end)--output-group-end[message template after grouped output]:template text: '
-        '(--output-group-error-only)--output-group-error-only[hide output from successful tasks]'
-        '(-s --silent)'{-s,--silent}'[disable echoing]'
-        '(--sort)--sort[set task sorting order]:order:(default alphanumeric none)'
-        '(--status)--status[exit non-zero if supplied tasks not up-to-date]'
-        '(--summary)--summary[show summary\: field from tasks instead of running them]'
-        '(-t --taskfile)'{-t,--taskfile}'[specify a different taskfile]:taskfile:_files'
-        '(-v --verbose)'{-v,--verbose}'[verbose mode]'
-        '(-w --watch)'{-w,--watch}'[watch-mode for given tasks, re-run when inputs change]'
-        '(-y --yes)'{-y,--yes}'[assume yes to all prompts]'
-    )
-
-    # Experimental flags (dynamically added based on enabled experiments)
-    # Options (modify behavior)
-    if __task_is_experiment_enabled "GENTLE_FORCE"; then
-        standard_args+=('(--force-all)--force-all[force execution of task and all dependencies]')
-    fi
-
-    if __task_is_experiment_enabled "REMOTE_TASKFILES"; then
-        standard_args+=(
-            '(--offline --download)--offline[use only local or cached Taskfiles]'
-            '(--timeout)--timeout[timeout for remote Taskfile downloads]:duration: '
-            '(--expiry)--expiry[cache expiry duration]:duration: '
-            '(--remote-cache-dir)--remote-cache-dir[directory to cache remote Taskfiles]:cache dir:_dirs'
-        )
-    fi
-
-    operation_args=(
-        # Task names completion (can be specified multiple times)
-        '(operation)*: :__task_list'
-        # Operational args completion (mutually exclusive)
-        + '(operation)'
-            '(*)'{-l,--list}'[list describable tasks]'
-            '(*)'{-a,--list-all}'[list all tasks]'
-            '(*)'{-i,--init}'[create new Taskfile.yml]'
-            '(- *)'{-h,--help}'[show help]'
-            '(- *)--version[show version and exit]'
-    )
-
-    # Experimental operations (dynamically added based on enabled experiments)
-    if __task_is_experiment_enabled "REMOTE_TASKFILES"; then
-        standard_args+=(
-            '(--offline --clear-cache)--download[download remote Taskfile]'
-        )
-        operation_args+=(
-            '(* --download)--clear-cache[clear remote Taskfile cache]'
-        )
-    fi
-
-    _arguments -S $standard_args $operation_args
-}
-
-# don't run the completion function when being source-ed or eval-ed
-if [ "$funcstack[1]" = "_task" ]; then
-    _task "$@"
-fi
+_arguments \
+    '(-C --concurrency)'{-C,--concurrency}'[limit number of concurrent tasks]: ' \
+    '(-p --parallel)'{-p,--parallel}'[run command-line tasks in parallel]' \
+    '(-f --force)'{-f,--force}'[run even if task is up-to-date]' \
+    '(-c --color)'{-c,--color}'[colored output]' \
+    '(-d --dir)'{-d,--dir}'[dir to run in]:execution dir:_dirs' \
+    '(--dry)--dry[dry-run mode, compile and print tasks only]' \
+    '(-o --output)'{-o,--output}'[set output style]:style:(interleaved group prefixed)' \
+    '(--output-group-begin)--output-group-begin[message template before grouped output]:template text: ' \
+    '(--output-group-end)--output-group-end[message template after grouped output]:template text: ' \
+    '(-s --silent)'{-s,--silent}'[disable echoing]' \
+    '(--status)--status[exit non-zero if supplied tasks not up-to-date]' \
+    '(--summary)--summary[show summary\: field from tasks instead of running them]' \
+    '(-t --taskfile)'{-t,--taskfile}'[specify a different taskfile]:taskfile:_files' \
+    '(-v --verbose)'{-v,--verbose}'[verbose mode]' \
+    '(-w --watch)'{-w,--watch}'[watch-mode for given tasks, re-run when inputs change]' \
+    + '(operation)' \
+        {-l,--list}'[list describable tasks]' \
+        {-a,--list-all}'[list all tasks]' \
+        {-i,--init}'[create new Taskfile.yaml]' \
+        '(-*)'{-h,--help}'[show help]' \
+        '(-*)--version[show version and exit]' \
+        '*: :__task_list'

docs/.gitignore

@@ -0,0 +1,20 @@
+# Dependencies
+/node_modules
+
+# Production
+/build
+
+# Generated files
+.docusaurus
+.cache-loader
+
+# Misc
+.DS_Store
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*

docs/Taskfile.yml

@@ -0,0 +1,30 @@
+version: '3'
+
+tasks:
+  setup:
+    desc: Setup Docusaurus locally
+    cmds:
+      - yarn install
+
+  start:
+    desc: Start website
+    vars:
+      HOST: '{{default "localhost" .HOST}}'
+      PORT: '{{default "3001" .PORT}}'
+    cmds:
+      - npx docusaurus start --no-open --host={{.HOST}} --port={{.PORT}}
+
+  build:
+    desc: Build website
+    cmds:
+      - npx docusaurus build
+
+  clean:
+    desc: Clean temp directories
+    cmds:
+      - rm -rf ./build
+
+  deploy:
+    desc: Build and deploy Docusaurus. Requires GIT_USER and GIT_PASS envs to be previous set
+    cmds:
+      - npx docusaurus deploy

docs/babel.config.js

@@ -0,0 +1,3 @@
+module.exports = {
+  presets: [require.resolve('@docusaurus/core/lib/babel/preset')],
+};

docs/blog/authors.yml

@@ -0,0 +1,5 @@
+andreynering:
+  name: Andrey Nering
+  title: Maintainer of Task
+  url: https://github.com/andreynering
+  image_url: https://github.com/andreynering.png

docs/docs/api_reference.md

@@ -0,0 +1,235 @@
+---
+slug: /api/
+sidebar_position: 4
+---
+
+# API Reference
+
+## CLI
+
+Task command line tool has the following syntax:
+
+```bash
+task [--flags] [tasks...] [-- CLI_ARGS...]
+```
+
+:::tip
+
+If `--` is given, all remaning arguments will be assigned to a special `CLI_ARGS`
+variable
+
+:::
+
+| Short | Flag | Type | Default | Description |
+| - | - | - | - | - |
+| `-c` | `--color` | `bool` | `true` | Colored output. Enabled by default. Set flag to `false` or use `NO_COLOR=1` to disable. |
+| `-C` | `--concurrency` | `int` | `0` | Limit number tasks to run concurrently. Zero means unlimited. |
+| `-d` | `--dir` | `string` | Working directory | Sets directory of execution. |
+| `-n` | `--dry` | `bool` | `false` | Compiles and prints tasks in the order that they would be run, without executing them. |
+| `-x` | `--exit-code` | `bool` | `false` | Pass-through the exit code of the task command. |
+| `-f` | `--force` | `bool` | `false` | Forces execution even when the task is up-to-date. |
+| `-h` | `--help` | `bool` | `false` | Shows Task usage. |
+| `-i` | `--init` | `bool` | `false` | Creates a new Taskfile.yaml in the current folder. |
+| `-l` | `--list` | `bool` | `false` | Lists tasks with description of current Taskfile. |
+| `-a` | `--list-all` | `bool` | `false` | Lists tasks with or without a description. |
+| `-o` | `--output` | `string` | Default set in the Taskfile or `intervealed` | Sets output style: [`interleaved`/`group`/`prefixed`]. |
+|      | `--output-group-begin` | `string` | | Message template to print before a task's grouped output. |
+|      | `--output-group-end `  | `string` | | Message template to print after a task's grouped output. |
+| `-p` | `--parallel` | `bool` | `false` | Executes tasks provided on command line in parallel. |
+| `-s` | `--silent` | `bool` | `false` | Disables echoing. |
+|      | `--status` | `bool` | `false` | Exits with non-zero exit code if any of the given tasks is not up-to-date. |
+|      | `--summary` | `bool` | `false` | Show summary about a task. |
+| `-t` | `--taskfile` | `string` | `Taskfile.yml` or `Taskfile.yaml` | |
+| `-v` | `--verbose` | `bool` | `false` | Enables verbose mode. |
+|      | `--version` | `bool` | `false` | Show Task version. |
+| `-w` | `--watch` | `bool` | `false` | Enables watch of the given task. |
+
+## Special Variables
+
+There are some special variables that is available on the templating system:
+
+| Var | Description |
+| - | - |
+| `CLI_ARGS` | Contain all extra arguments passed after `--` when calling Task through the CLI. |
+| `TASK` | The name of the current task. |
+| `ROOT_DIR` | The absolute path of the root Taskfile. |
+| `TASKFILE_DIR` | The absolute path of the included Taskfile. |
+| `CHECKSUM` | The checksum of the files listed in `sources`. Only available within the `status` prop and if method is set to `checksum`. |
+| `TIMESTAMP` | The date object of the greatest timestamp of the files listes in `sources`. Only available within the `status` prop and if method is set to `timestamp`. |
+
+## ENV
+
+Some environment variables can be overriden to adjust Task behavior.
+
+| ENV | Default | Description |
+| - | - | - |
+| `TASK_TEMP_DIR` | `.task` | Location of the temp dir. Can relative to the project like `tmp/task` or absolute like `/tmp/.task` or `~/.task`. |
+| `TASK_COLOR_RESET` | `0` | Color used for white. |
+| `TASK_COLOR_BLUE` | `34` | Color used for blue. |
+| `TASK_COLOR_GREEN` | `32` | Color used for green. |
+| `TASK_COLOR_CYAN` | `36` | Color used for cyan. |
+| `TASK_COLOR_YELLOW` | `33` | Color used for yellow. |
+| `TASK_COLOR_MAGENTA` | `35` | Color used for magenta. |
+| `TASK_COLOR_RED` | `31` | Color used for red. |
+
+## Schema
+
+### Taskfile
+
+| Attribute | Type | Default | Description |
+| - | - | - | - |
+| `version` | `string` | | Version of the Taskfile. The current version is `3`. |
+| `includes` | [`map[string]Include`](#include) | | Additional Taskfiles to be included. |
+| `output` | `string` | `interleaved` | Output mode. Available options: `interleaved`, `group` and `prefixed`. |
+| `method` | `string` | `checksum` | Default method in this Taskfile. Can be overriden in a task by task basis. Available options: `checksum`, `timestamp` and `none`. |
+| `silent` | `bool` | `false` | Default "silent" options for this Taskfile. If `false`, can be overidden with `true` in a task by task basis. |
+| `run` | `string` | `always` | Default "run" option for this Taskfile. Available options: `always`, `once` and `when_changed`. |
+| `vars` | [`map[string]Variable`](#variable) | | Global variables. |
+| `env` | [`map[string]Variable`](#variable) | | Global environment. |
+| `dotenv` | `[]string` | | A list of `.env` file paths to be parsed. |
+| `tasks` | [`map[string]Task`](#task) | | The task definitions. |
+
+
+### Include
+
+| Attribute | Type | Default | Description |
+| - | - | - | - |
+| `taskfile` | `string` | | The path for the Taskfile or directory to be included. If a directory, Task will look for files named `Taskfile.yml` or `Taskfile.yaml` inside that directory. If a relative path, resolved relative to the directory containing the including Taskfile. |
+| `dir` | `string` | The parent Taskfile directory | The working directory of the included tasks when run. |
+| `optional` | `bool` | `false` | If `true`, no errors will be thrown if the specified file does not exist. |
+
+:::info
+
+Informing only a string like below is equivalent to setting that value to the `taskfile` attribute.
+
+```yaml
+includes:
+  foo: ./path
+```
+
+:::
+
+### Task
+
+| Attribute | Type | Default | Description |
+| - | - | - | - |
+| `desc` | `string` | | A short description of the task. This is listed when calling `task --list`. |
+| `summary` | `string` | | A longer description of the task. This is listed when calling `task --summary [task]`. |
+| `sources` | `[]string` | | List of sources to check before running this task. Relevant for `checksum` and `timestamp` methods. Can be file paths or star globs. |
+| `dir` | `string` | | The current directory which this task should run. |
+| `method` | `string` | `checksum` | Method used by this task. Default to the one declared globally or `checksum`. Available options: `checksum`, `timestamp` and `none` |
+| `silent` | `bool` | `false` | Skips some output for this task. Note that STDOUT and STDERR of the commands will still be redirected. |
+| `run` | `string` | The one declared globally in the Taskfile or `always` | Specifies whether the task should run again or not if called more than once. Available options: `always`, `once` and `when_changed`. |
+| `prefix` | `string` | | Allows to override the prefix print before the STDOUT. Only relevant when using the `prefixed` output mode. |
+| `ignore_error` | `bool` | `false` | Continue execution if errors happen while executing the commands. |
+| `generates` | `[]string` | | List of files meant to be generated by this task. Relevant for `timestamp` method. Can be file paths or star globs. |
+| `status` | `[]string` | | List of commands to check if this task should run. The task is skipped otherwise. This overrides `method`, `sources` and `generates`. |
+| `preconditions` | [`[]Precondition`](#precondition) | | List of commands to check if this task should run. The task errors otherwise. |
+| `vars` | [`map[string]Variable`](#variable) | | Task variables. |
+| `env` | [`map[string]Variable`](#variable) | | Task environment. |
+| `deps` | [`[]Dependency`](#dependency) | | List of dependencies of this task. |
+| `cmds` | [`[]Command`](#command) | | List of commands to be executed. |
+
+:::info
+
+These alternative syntaxes are available. They will set the given values to
+`cmds` and everything else will be set to their default values:
+
+```yaml
+tasks:
+  foo: echo "foo"
+
+  foobar:
+    - echo "foo"
+    - echo "bar"
+
+  baz:
+    cmd: echo "baz"
+```
+
+:::
+
+### Dependency
+
+| Attribute | Type | Default | Description |
+| - | - | - | - |
+| `task` | `string` | | The task to be execute as a dependency. |
+| `vars` | [`map[string]Variable`](#variable) | | Optional additional variables to be passed to this task. |
+
+:::tip
+
+If you don't want to set additional variables, it's enough to declare the
+dependency as a list of strings (they will be assigned to `task`):
+
+```yaml
+tasks:
+  foo:
+    deps: [foo, bar]
+```
+
+:::
+
+### Command
+
+| Attribute | Type | Default | Description |
+| - | - | - | - |
+| `cmd` | `string` | | The shell command to be executed. |
+| `defer` | `string` | | Alternative to `cmd`, but schedules the command to be executed at the end of this task instead of immediately. This cannot be used together with `cmd`. |
+| `silent` | `bool` | `false` | Skips some output for this command. Note that STDOUT and STDERR of the commands will still be redirected. |
+| `ignore_error` | `bool` | `false` | Continue execution if errors happen while executing the command. |
+| `task` | `string` | | Set this to trigger execution of another task instead of running a command. This cannot be set together with `cmd`. |
+| `vars` | [`map[string]Variable`](#variable) | | Optional additional variables to be passed to the referenced task. Only relevant when setting `task` instead of `cmd`. |
+
+:::info
+
+If given as a a string, the value will be assigned to `cmd`:
+
+```yaml
+tasks:
+  foo:
+    cmds:
+      - echo "foo"
+      - echo "bar"
+```
+
+:::
+
+### Variable
+
+| Attribute | Type | Default | Description |
+| - | - | - | - |
+| *itself* | `string` | | A static value that will be set to the variable. |
+| `sh` | `string` | | A shell command. The output (`STDOUT`) will be assigned to the variable. |
+
+:::info
+
+Static and dynamic variables have different syntaxes, like below:
+
+```yaml
+vars:
+  STATIC: static
+  DYNAMIC:
+    sh: echo "dynamic"
+```
+
+:::
+
+### Precondition
+
+| Attribute | Type | Default | Description |
+| - | - | - | - |
+| `sh` | `string` | | Command to be executed. If a non-zero exit code is returned, the task errors without executing its commands. |
+| `msg` | `string` | | Optional message to print if the precondition isn't met. |
+
+:::tip
+
+If you don't want to set a different message, you can declare a precondition
+like this and the value will be assigned to `sh`:
+
+```yaml
+tasks:
+  foo:
+    precondition: test -f Taskfile.yml
+```
+
+:::

docs/docs/changelog.md

@@ -0,0 +1,567 @@
+---
+slug: /changelog/
+sidebar_position: 6
+---
+
+# Changelog
+
+## v3.15.1 - 2022-09-08
+
+- Fix error when using variable in `env:` introduced in the previous release
+  ([#858](https://github.com/go-task/task/issues/858), [#866](https://github.com/go-task/task/pull/866)).
+- Fix handling of `CLI_ARGS` (`--`) in Bash completion
+  ([#863](https://github.com/go-task/task/pull/863)).
+- On zsh completion, add ability to replace `--list-all` with `--list` as
+  already possible on the Bash completion
+  ([#861](https://github.com/go-task/task/pull/861)).
+
+## v3.15.0 - 2022-09-03
+
+- Add new special variables `ROOT_DIR` and `TASKFILE_DIR`. This was a highly
+  requested feature
+  ([#215](https://github.com/go-task/task/issues/215), [#857](https://github.com/go-task/task/pull/857), [Documentation](https://taskfile.dev/api/#special-variables)).
+- Follow symlinks on `sources`
+  ([#826](https://github.com/go-task/task/issues/826), [#831](https://github.com/go-task/task/pull/831)).
+- Improvements and fixes to Bash completion
+  ([#835](https://github.com/go-task/task/pull/835), [#844](https://github.com/go-task/task/pull/844)).
+
+## v3.14.1 - 2022-08-03
+
+- Always resolve relative include paths relative to the including Taskfile
+  ([#822](https://github.com/go-task/task/issues/822), [#823](https://github.com/go-task/task/pull/823)).
+- Fix ZSH and PowerShell completions to consider all tasks instead of just the
+  public ones (those with descriptions)
+  ([#803](https://github.com/go-task/task/pull/803)).
+
+## v3.14.0 - 2022-07-08
+
+- Add ability to override the `.task` directory location with the
+  `TASK_TEMP_DIR` environment variable.
+- Allow to override Task colors using environment variables:
+  `TASK_COLOR_RESET`, `TASK_COLOR_BLUE`, `TASK_COLOR_GREEN`,
+  `TASK_COLOR_CYAN`, `TASK_COLOR_YELLOW`, `TASK_COLOR_MAGENTA`
+  and `TASK_COLOR_RED`
+  ([#568](https://github.com/go-task/task/pull/568), [#792](https://github.com/go-task/task/pull/792)).
+- Fixed bug when using the `output: group` mode where STDOUT and STDERR were
+  being print in separated blocks instead of in the right order
+  ([#779](https://github.com/go-task/task/issues/779)).
+- Starting on this release, ARM architecture binaries are been released to Snap
+  as well
+  ([#795](https://github.com/go-task/task/issues/795)).
+- i386 binaries won't be available anymore on Snap because Ubuntu removed the support
+  for this architecture.
+- Upgrade mvdan.cc/sh, which fixes a bug with associative arrays
+  ([#785](https://github.com/go-task/task/issues/785), [mvdan/sh#884](https://github.com/mvdan/sh/issues/884), [mvdan/sh#893](https://github.com/mvdan/sh/pull/893)).
+
+## v3.13.0 - 2022-06-13
+
+- Added `-n` as an alias to `--dry`
+  ([#776](https://github.com/go-task/task/issues/776), [#777](https://github.com/go-task/task/pull/777)).
+- Fix behavior of interrupt (SIGINT, SIGTERM) signals. Task will now give time
+  for the processes running to do cleanup work
+  ([#458](https://github.com/go-task/task/issues/458), [#479](https://github.com/go-task/task/pull/479), [#728](https://github.com/go-task/task/issues/728), [#769](https://github.com/go-task/task/pull/769)).
+- Add new `--exit-code` (`-x`) flag that will pass-through the exit form the
+  command being ran
+  ([#755](https://github.com/go-task/task/pull/755)).
+
+## v3.12.1 - 2022-05-10
+
+- Fixed bug where, on Windows, variables were ending with `\r` because we were
+  only removing the final `\n` but not `\r\n`
+  ([#717](https://github.com/go-task/task/issues/717)).
+
+## v3.12.0 - 2022-03-31
+
+- The `--list` and `--list-all` flags can now be combined with the `--silent`
+  flag to print the task names only, without their description
+  ([#691](https://github.com/go-task/task/pull/691)).
+- Added support for multi-level inclusion of Taskfiles. This means that
+  included Taskfiles can also include other Taskfiles. Before this was limited
+  to one level
+  ([#390](https://github.com/go-task/task/issues/390), [#623](https://github.com/go-task/task/discussions/623), [#656](https://github.com/go-task/task/pull/656)).
+- Add ability to specify vars when including a Taskfile.
+  [Check out the documentation](https://taskfile.dev/#/usage?id=vars-of-included-taskfiles)
+  for more information.
+  ([#677](https://github.com/go-task/task/pull/677)).
+
+## v3.11.0 - 2022-02-19
+
+- Task now supports printing begin and end messages when using the `group`
+  output mode, useful for grouping tasks in CI systems.
+  [Check out the documentation](http://taskfile.dev/#/usage?id=output-syntax) for more information
+  ([#647](https://github.com/go-task/task/issues/647), [#651](https://github.com/go-task/task/pull/651)).
+- Add `Taskfile.dist.yml` and `Taskfile.dist.yaml` to the supported file
+  name list. [Check out the documentation](https://taskfile.dev/#/usage?id=supported-file-names) for more information
+  ([#498](https://github.com/go-task/task/issues/498), [#666](https://github.com/go-task/task/pull/666)).
+
+## v3.10.0 - 2022-01-04
+
+- A new `--list-all` (alias `-a`) flag is now available. It's similar to the
+  exiting `--list` (`-l`) but prints all tasks, even those without a
+  description
+  ([#383](https://github.com/go-task/task/issues/383), [#401](https://github.com/go-task/task/pull/401)).
+- It's now possible to schedule cleanup commands to run once a task finishes
+  with the `defer:` keyword
+  ([Documentation](https://taskfile.dev/#/usage?id=doing-task-cleanup-with-defer), [#475](https://github.com/go-task/task/issues/475), [#626](https://github.com/go-task/task/pull/626)).
+- Remove long deprecated and undocumented `$` variable prefix and `^` command
+  prefix
+  ([#642](https://github.com/go-task/task/issues/642), [#644](https://github.com/go-task/task/issues/644), [#645](https://github.com/go-task/task/pull/645)).
+- Add support for `.yaml` extension (as an alternative to `.yml`).
+  This was requested multiple times throughout the years. Enjoy!
+  ([#183](https://github.com/go-task/task/issues/183), [#184](https://github.com/go-task/task/pull/184), [#369](https://github.com/go-task/task/issues/369), [#584](https://github.com/go-task/task/issues/584), [#621](https://github.com/go-task/task/pull/621)).
+- Fixed error when computing a variable when the task directory do not exist
+  yet
+  ([#481](https://github.com/go-task/task/issues/481), [#579](https://github.com/go-task/task/pull/579)).
+
+## v3.9.2 - 2021-12-02
+
+- Upgrade [mvdan/sh](https://github.com/mvdan/sh) which contains a fix a for
+  a important regression on Windows
+  ([#619](https://github.com/go-task/task/issues/619), [mvdan/sh#768](https://github.com/mvdan/sh/issues/768), [mvdan/sh#769](https://github.com/mvdan/sh/pull/769)).
+
+## v3.9.1 - 2021-11-28
+
+- Add logging in verbose mode for when a task starts and finishes
+  ([#533](https://github.com/go-task/task/issues/533), [#588](https://github.com/go-task/task/pull/588)).
+- Fix an issue with preconditions and context errors
+  ([#597](https://github.com/go-task/task/issues/597), [#598](https://github.com/go-task/task/pull/598)).
+- Quote each `{{.CLI_ARGS}}` argument to prevent one with spaces to become many
+  ([#613](https://github.com/go-task/task/pull/613)).
+- Fix  nil pointer when `cmd:` was left empty
+  ([#612](https://github.com/go-task/task/issues/612), [#614](https://github.com/go-task/task/pull/614)).
+- Upgrade [mvdan/sh](https://github.com/mvdan/sh) which contains two
+  relevant fixes:
+  - Fix quote of empty strings in `shellQuote`
+    ([#609](https://github.com/go-task/task/issues/609), [mvdan/sh#763](https://github.com/mvdan/sh/issues/763)).
+  - Fix issue of wrong environment variable being picked when there's another
+    very similar one
+    ([#586](https://github.com/go-task/task/issues/586), [mvdan/sh#745](https://github.com/mvdan/sh/pull/745)).
+- Install shell completions automatically when installing via Homebrew
+  ([#264](https://github.com/go-task/task/issues/264), [#592](https://github.com/go-task/task/pull/592), [go-task/homebrew-tap#2](https://github.com/go-task/homebrew-tap/pull/2)).
+
+## v3.9.0 - 2021-10-02
+
+- A new `shellQuote` function was added to the template system
+  (`{{shellQuote "a string"}}`) to ensure a string is safe for use in shell
+  ([mvdan/sh#727](https://github.com/mvdan/sh/pull/727), [mvdan/sh#737](https://github.com/mvdan/sh/pull/737), [Documentation](https://pkg.go.dev/mvdan.cc/sh/v3@v3.4.0/syntax#Quote))
+- In this version [mvdan.cc/sh](https://github.com/mvdan/sh) was upgraded
+  with some small fixes and features
+  - The `read -p` flag is now supported
+    ([#314](https://github.com/go-task/task/issues/314), [mvdan/sh#551](https://github.com/mvdan/sh/issues/551), [mvdan/sh#772](https://github.com/mvdan/sh/pull/722))
+  - The `pwd -P` and `pwd -L` flags are now supported
+    ([#553](https://github.com/go-task/task/issues/553), [mvdan/sh#724](https://github.com/mvdan/sh/issues/724), [mvdan/sh#728](https://github.com/mvdan/sh/pull/728))
+  - The `$GID` environment variable is now correctly being set
+    ([#561](https://github.com/go-task/task/issues/561), [mvdan/sh#723](https://github.com/mvdan/sh/pull/723))
+
+## v3.8.0 - 2021-09-26
+
+- Add `interactive: true` setting to improve support for interactive CLI apps
+  ([#217](https://github.com/go-task/task/issues/217), [#563](https://github.com/go-task/task/pull/563)).
+- Fix some `nil` errors
+  ([#534](https://github.com/go-task/task/issues/534), [#573](https://github.com/go-task/task/pull/573)).
+- Add ability to declare an included Taskfile as optional
+  ([#519](https://github.com/go-task/task/issues/519), [#552](https://github.com/go-task/task/pull/552)).
+- Add support for including Taskfiles in the home directory by using `~`
+  ([#539](https://github.com/go-task/task/issues/539), [#557](https://github.com/go-task/task/pull/557)).
+
+## v3.7.3 - 2021-09-04
+
+- Add official support to Apple M1 ([#564](https://github.com/go-task/task/pull/564), [#567](https://github.com/go-task/task/pull/567)).
+- Our [official Homebrew tap](https://github.com/go-task/homebrew-tap) will
+  support more platforms, including Apple M1
+
+## v3.7.0 - 2021-07-31
+
+- Add `run:` setting to control if tasks should run multiple times or not.
+  Available options are `always` (the default), `when_changed` (if a variable
+  modified the task) and `once` (run only once no matter what).
+  This is a long time requested feature. Enjoy!
+  ([#53](https://github.com/go-task/task/issues/53), [#359](https://github.com/go-task/task/pull/359)).
+
+## v3.6.0 - 2021-07-10
+
+- Allow using both `sources:` and `status:` in the same task
+  ([#411](https://github.com/go-task/task/issues/411), [#427](https://github.com/go-task/task/issues/427), [#477](https://github.com/go-task/task/pull/477)).
+- Small optimization and bug fix: don't compute variables if not needed for
+  `dotenv:` ([#517](https://github.com/go-task/task/issues/517)).
+
+## v3.5.0 - 2021-07-04
+
+- Add support for interpolation in `dotenv:`
+  ([#433](https://github.com/go-task/task/discussions/433), [#434](https://github.com/go-task/task/issues/434), [#453](https://github.com/go-task/task/pull/453)).
+
+## v3.4.3 - 2021-05-30
+
+- Add support for the `NO_COLOR` environment variable.
+  ([#459](https://github.com/go-task/task/issues/459), [fatih/color#137](https://github.com/fatih/color/pull/137)).
+- Fix bug where sources were not considering the right directory
+  in `--watch` mode
+  ([#484](https://github.com/go-task/task/issues/484), [#485](https://github.com/go-task/task/pull/485)).
+
+## v3.4.2 - 2021-04-23
+
+- On watch, report which file failed to read
+  ([#472](https://github.com/go-task/task/pull/472)).
+- Do not try to catch SIGKILL signal, which are not actually possible
+  ([#476](https://github.com/go-task/task/pull/476)).
+- Improve version reporting when building Task from source using Go Modules
+  ([#462](https://github.com/go-task/task/pull/462), [#473](https://github.com/go-task/task/pull/473)).
+
+## v3.4.1 - 2021-04-17
+
+- Improve error reporting when parsing YAML: in some situations where you
+  would just see an generic error, you'll now see the actual error with
+  more detail: the YAML line the failed to parse, for example
+  ([#467](https://github.com/go-task/task/issues/467)).
+- A JSON Schema was published [here](https://json.schemastore.org/taskfile.json)
+  and is automatically being used by some editors like Visual Studio Code
+  ([#135](https://github.com/go-task/task/issues/135)).
+- Print task name before the command in the log output
+  ([#398](https://github.com/go-task/task/pull/398)).
+
+## v3.3.0 - 2021-03-20
+
+- Add support for delegating CLI arguments to commands with `--` and a
+  special `CLI_ARGS` variable
+  ([#327](https://github.com/go-task/task/issues/327)).
+- Add a `--concurrency` (alias `-C`) flag, to limit the number of tasks that
+  run concurrently. This is useful for heavy workloads.
+  ([#345](https://github.com/go-task/task/pull/345)).
+
+## v3.2.2 - 2021-01-12
+
+- Improve performance of `--list` and `--summary` by skipping running shell
+  variables for these flags
+  ([#332](https://github.com/go-task/task/issues/332)).
+- Fixed a bug where an environment in a Taskfile was not always overridable
+  by the system environment
+  ([#425](https://github.com/go-task/task/issues/425)).
+- Fixed environment from .env files not being available as variables
+  ([#379](https://github.com/go-task/task/issues/379)).
+- The install script is now working for ARM platforms
+  ([#428](https://github.com/go-task/task/pull/428)).
+
+## v3.2.1 - 2021-01-09
+
+- Fixed some bugs and regressions regarding dynamic variables and directories
+  ([#426](https://github.com/go-task/task/issues/426)).
+- The [slim-sprig](https://github.com/go-task/slim-sprig) package was updated
+  with the upstream [sprig](https://github.com/Masterminds/sprig).
+
+## v3.2.0 - 2021-01-07
+
+- Fix the `.task` directory being created in the task directory instead of the
+  Taskfile directory
+  ([#247](https://github.com/go-task/task/issues/247)).
+- Fix a bug where dynamic variables (those declared with `sh:`) were not
+  running in the task directory when the task has a custom dir or it was
+  in an included Taskfile
+  ([#384](https://github.com/go-task/task/issues/384)).
+- The watch feature (via the `--watch` flag) got a few different bug fixes and
+  should be more stable now
+  ([#423](https://github.com/go-task/task/pull/423), [#365](https://github.com/go-task/task/issues/365)).
+
+## v3.1.0 - 2021-01-03
+
+- Fix a bug when the checksum up-to-date resolution is used by a task
+  with a custom `label:` attribute
+  ([#412](https://github.com/go-task/task/issues/412)).
+- Starting from this release, we're releasing official ARMv6 and ARM64 binaries
+  for Linux
+  ([#375](https://github.com/go-task/task/issues/375), [#418](https://github.com/go-task/task/issues/418)).
+- Task now respects the order of declaration of included Taskfiles when
+  evaluating variables declaring by them
+  ([#393](https://github.com/go-task/task/issues/393)).
+- `set -e` is now automatically set on every command. This was done to fix an
+  issue where multiline string commands wouldn't really fail unless the
+  sentence was in the last line
+  ([#403](https://github.com/go-task/task/issues/403)).
+
+## v3.0.1 - 2020-12-26
+
+- Allow use as a library by moving the required packages out of the `internal`
+  directory
+  ([#358](https://github.com/go-task/task/pull/358)).
+- Do not error if a specified dotenv file does not exist
+  ([#378](https://github.com/go-task/task/issues/378), [#385](https://github.com/go-task/task/pull/385)).
+- Fix panic when you have empty tasks in your Taskfile
+  ([#338](https://github.com/go-task/task/issues/338), [#362](https://github.com/go-task/task/pull/362)).
+
+## v3.0.0 - 2020-08-16
+
+- On `v3`, all CLI variables will be considered global variables
+  ([#336](https://github.com/go-task/task/issues/336), [#341](https://github.com/go-task/task/pull/341))
+- Add support to `.env` like files
+  ([#324](https://github.com/go-task/task/issues/324), [#356](https://github.com/go-task/task/pull/356)).
+- Add `label:` to task so you can override the task name in the logs
+  ([#321](https://github.com/go-task/task/issues/321]), [#337](https://github.com/go-task/task/pull/337)).
+- Refactor how variables work on version 3
+  ([#311](https://github.com/go-task/task/pull/311)).
+- Disallow `expansions` on v3 since it has no effect.
+- `Taskvars.yml` is not automatically included anymore.
+- `Taskfile_{{OS}}.yml` is not automatically included anymore.
+- Allow interpolation on `includes`, so you can manually include a Taskfile
+  based on operation system, for example.
+- Expose `.TASK` variable in templates with the task name
+  ([#252](https://github.com/go-task/task/issues/252)).
+- Implement short task syntax
+  ([#194](https://github.com/go-task/task/issues/194), [#240](https://github.com/go-task/task/pull/240)).
+- Added option to make included Taskfile run commands on its own directory
+  ([#260](https://github.com/go-task/task/issues/260), [#144](https://github.com/go-task/task/issues/144))
+- Taskfiles in version 1 are not supported anymore
+  ([#237](https://github.com/go-task/task/pull/237)).
+- Added global `method:` option. With this option, you can set a default
+  method to all tasks in a Taskfile
+  ([#246](https://github.com/go-task/task/issues/246)).
+- Changed default method from `timestamp` to `checksum`
+  ([#246](https://github.com/go-task/task/issues/246)).
+- New magic variables are now available when using `status:`:
+  `.TIMESTAMP` which contains the greatest modification date
+  from the files listed in `sources:`, and `.CHECKSUM`, which
+  contains a checksum of all files listed in `status:`.
+  This is useful for manual checking when using external, or even remote,
+  artifacts when using `status:`
+  ([#216](https://github.com/go-task/task/pull/216)).
+- We're now using [slim-sprig](https://github.com/go-task/slim-sprig) instead of
+  [sprig](https://github.com/Masterminds/sprig), which allowed a file size
+  reduction of about 22%
+  ([#219](https://github.com/go-task/task/pull/219)).
+- We now use some colors on Task output to better distinguish message types -
+  commands are green, errors are red, etc
+  ([#207](https://github.com/go-task/task/pull/207)).
+
+## v2.8.1 - 2020-05-20
+
+- Fix error code for the `--help` flag
+  ([#300](https://github.com/go-task/task/issues/300), [#330](https://github.com/go-task/task/pull/330)).
+- Print version to stdout instead of stderr
+  ([#299](https://github.com/go-task/task/issues/299), [#329](https://github.com/go-task/task/pull/329)).
+- Supress `context` errors when using the `--watch` flag
+  ([#313](https://github.com/go-task/task/issues/313), [#317](https://github.com/go-task/task/pull/317)).
+- Support templating on description
+  ([#276](https://github.com/go-task/task/issues/276), [#283](https://github.com/go-task/task/pull/283)).
+
+## v2.8.0 - 2019-12-07
+
+- Add `--parallel` flag (alias `-p`) to run tasks given by the command line in
+  parallel
+  ([#266](https://github.com/go-task/task/pull/266)).
+- Fixed bug where calling the `task` CLI only informing global vars would not
+  execute the `default` task.
+- Add hability to silent all tasks by adding `silent: true` a the root of the
+  Taskfile.
+
+## v2.7.1 - 2019-11-10
+
+- Fix error being raised when `exit 0` was called
+  ([#251](https://github.com/go-task/task/issues/251)).
+
+## v2.7.0 - 2019-09-22
+
+- Fixed panic bug when assigning a global variable
+  ([#229](https://github.com/go-task/task/issues/229), [#243](https://github.com/go-task/task/issues/234)).
+- A task with `method: checksum` will now re-run if generated files are deleted
+  ([#228](https://github.com/go-task/task/pull/228), [#238](https://github.com/go-task/task/issues/238)).
+
+## v2.6.0 - 2019-07-21
+
+- Fixed some bugs regarding minor version checks on `version:`.
+- Add `preconditions:` to task
+  ([#205](https://github.com/go-task/task/pull/205)).
+- Create directory informed on `dir:` if it doesn't exist
+  ([#209](https://github.com/go-task/task/issues/209), [#211](https://github.com/go-task/task/pull/211)).
+- We now have a `--taskfile` flag (alias `-t`), which can be used to run
+  another Taskfile (other than the default `Taskfile.yml`)
+  ([#221](https://github.com/go-task/task/pull/221)).
+- It's now possible to install Task using Homebrew on Linux
+  ([go-task/homebrew-tap#1](https://github.com/go-task/homebrew-tap/pull/1)).
+
+## v2.5.2 - 2019-05-11
+
+- Reverted YAML upgrade due issues with CRLF on Windows
+  ([#201](https://github.com/go-task/task/issues/201), [go-yaml/yaml#450](https://github.com/go-yaml/yaml/issues/450)).
+- Allow setting global variables through the CLI
+  ([#192](https://github.com/go-task/task/issues/192)).
+
+## 2.5.1 - 2019-04-27
+
+- Fixed some issues with interactive command line tools, where sometimes
+  the output were not being shown, and similar issues
+  ([#114](https://github.com/go-task/task/issues/114), [#190](https://github.com/go-task/task/issues/190), [#200](https://github.com/go-task/task/pull/200)).
+- Upgraded [go-yaml/yaml](https://github.com/go-yaml/yaml) from v2 to v3.
+
+## v2.5.0 - 2019-03-16
+
+- We moved from the taskfile.org domain to the new fancy taskfile.dev domain.
+  While stuff is being redirected, we strongly recommend to everyone that use
+  [this install script](https://taskfile.dev/#/installation?id=install-script)
+  to use the new taskfile.dev domain on scripts from now on.
+- Fixed to the ZSH completion
+  ([#182](https://github.com/go-task/task/pull/182)).
+- Add [`--summary` flag along with `summary:` task attribute](https://taskfile.org/#/usage?id=display-summary-of-task)
+  ([#180](https://github.com/go-task/task/pull/180)).
+
+## v2.4.0 - 2019-02-21
+
+- Allow calling a task of the root Taskfile from an included Taskfile
+  by prefixing it with `:`
+  ([#161](https://github.com/go-task/task/issues/161), [#172](https://github.com/go-task/task/issues/172)),
+- Add flag to override the `output` option
+  ([#173](https://github.com/go-task/task/pull/173));
+- Fix bug where Task was persisting the new checksum on the disk when the Dry
+  Mode is enabled
+  ([#166](https://github.com/go-task/task/issues/166));
+- Fix file timestamp issue when the file name has spaces
+  ([#176](https://github.com/go-task/task/issues/176));
+- Mitigating path expanding issues on Windows
+  ([#170](https://github.com/go-task/task/pull/170)).
+
+## v2.3.0 - 2019-01-02
+
+- On Windows, Task can now be installed using [Scoop](https://scoop.sh/)
+  ([#152](https://github.com/go-task/task/pull/152));
+- Fixed issue with file/directory globing
+  ([#153](https://github.com/go-task/task/issues/153));
+- Added ability to globally set environment variables
+  (
+    [#138](https://github.com/go-task/task/pull/138),
+    [#159](https://github.com/go-task/task/pull/159)
+  ).
+
+## v2.2.1 - 2018-12-09
+
+- This repository now uses Go Modules (#143). We'll still keep the `vendor` directory in sync for some time, though;
+- Fixing a bug when the Taskfile has no tasks but includes another Taskfile (#150);
+- Fix a bug when calling another task or a dependency in an included Taskfile (#151).
+
+## v2.2.0 - 2018-10-25
+
+- Added support for [including other Taskfiles](https://taskfile.org/#/usage?id=including-other-taskfiles) (#98)
+  - This should be considered experimental. For now, only including local files is supported, but support for including remote Taskfiles is being discussed. If you have any feedback, please comment on #98.
+- Task now have a dedicated documentation site: https://taskfile.org
+  - Thanks to [Docsify](https://docsify.js.org/) for making this pretty easy. To check the source code, just take a look at the [docs](https://github.com/go-task/task/tree/master/docs) directory of this repository. Contributions to the documentation is really appreciated.
+
+## v2.1.1 - 2018-09-17
+
+- Fix suggestion to use `task --init` not being shown anymore (when a `Taskfile.yml` is not found)
+- Fix error when using checksum method and no file exists for a source glob (#131)
+- Fix signal handling when the `--watch` flag is given (#132)
+
+## v2.1.0 - 2018-08-19
+
+- Add a `ignore_error` option to task and command (#123)
+- Add a dry run mode (`--dry` flag) (#126)
+
+## v2.0.3 - 2018-06-24
+
+- Expand environment variables on "dir", "sources" and "generates" (#116)
+- Fix YAML merging syntax (#112)
+- Add ZSH completion (#111)
+- Implement new `output` option. Please check out the [documentation](https://github.com/go-task/task#output-syntax)
+
+## v2.0.2 - 2018-05-01
+
+- Fix merging of YAML anchors (#112)
+
+## v2.0.1 - 2018-03-11
+
+- Fixes panic on `task --list`
+
+## v2.0.0 - 2018-03-08
+
+Version 2.0.0 is here, with a new Taskfile format.
+
+Please, make sure to read the [Taskfile versions](https://github.com/go-task/task/blob/master/TASKFILE_VERSIONS.md) document, since it describes in depth what changed for this version.
+
+* New Taskfile version 2 (https://github.com/go-task/task/issues/77)
+* Possibility to have global variables in the `Taskfile.yml` instead of `Taskvars.yml` (https://github.com/go-task/task/issues/66)
+* Small improvements and fixes
+
+## v1.4.4 - 2017-11-19
+
+- Handle SIGINT and SIGTERM (#75);
+- List: print message with there's no task with description;
+- Expand home dir ("~" symbol) on paths (#74);
+- Add Snap as an installation method;
+- Move examples to its own repo;
+- Watch: also walk on tasks called on on "cmds", and not only on "deps";
+- Print logs to stderr instead of stdout (#68);
+- Remove deprecated `set` keyword;
+- Add checksum based status check, alternative to timestamp based.
+
+## v1.4.3 - 2017-09-07
+
+- Allow assigning variables to tasks at run time via CLI (#33)
+- Added suport for multiline variables from sh (#64)
+- Fixes env: remove square braces and evaluate shell (#62)
+- Watch: change watch library and few fixes and improvements
+- When use watching, cancel and restart long running process on file change (#59 and #60)
+
+## v1.4.2 - 2017-07-30
+
+- Flag to set directory of execution
+- Always echo command if is verbose mode
+- Add silent mode to disable echoing of commands
+- Fixes and improvements of variables (#56)
+
+## v1.4.1 - 2017-07-15
+
+- Allow use of YAML for dynamic variables instead of $ prefix
+  - `VAR: {sh: echo Hello}` instead of `VAR: $echo Hello`
+- Add `--list` (or `-l`) flag to print existing tasks
+- OS specific Taskvars file (e.g. `Taskvars_windows.yml`, `Taskvars_linux.yml`, etc)
+- Consider task up-to-date on equal timestamps (#49)
+- Allow absolute path in generates section (#48)
+- Bugfix: allow templating when calling deps (#42)
+- Fix panic for invalid task in cyclic dep detection
+- Better error output for dynamic variables in Taskvars.yml (#41)
+- Allow template evaluation in parameters
+
+## v1.4.0 - 2017-07-06
+
+- Cache dynamic variables
+- Add verbose mode (`-v` flag)
+- Support to task parameters (overriding vars) (#31) (#32)
+- Print command, also when "set:" is specified (#35)
+- Improve task command help text (#35)
+
+## v1.3.1 - 2017-06-14
+
+- Fix glob not working on commands (#28)
+- Add ExeExt template function
+- Add `--init` flag to create a new Taskfile
+- Add status option to prevent task from running (#27)
+- Allow interpolation on `generates` and `sources` attributes (#26)
+
+## v1.3.0 - 2017-04-24
+
+- Migrate from os/exec.Cmd to a native Go sh/bash interpreter
+  - This is a potentially breaking change if you use Windows.
+  - Now, `cmd` is not used anymore on Windows. Always use Bash-like syntax for your commands, even on Windows.
+- Add "ToSlash" and "FromSlash" to template functions
+- Use functions defined on github.com/Masterminds/sprig
+- Do not redirect stdin while running variables commands
+- Using `context` and `errgroup` packages (this will make other tasks to be cancelled, if one returned an error)
+
+## v1.2.0 - 2017-04-02
+
+- More tests and Travis integration
+- Watch a task (experimental)
+- Possibility to call another task
+- Fix "=" not being reconized in variables/environment variables
+- Tasks can now have a description, and help will print them (#10)
+- Task dependencies now run concurrently
+- Support for a default task (#16)
+
+## v1.1.0 - 2017-03-08
+
+- Support for YAML, TOML and JSON (#1)
+- Support running command in another directory (#4)
+- `--force` or `-f` flag to force execution of task even when it's up-to-date
+- Detection of cyclic dependencies (#5)
+- Support for variables (#6, #9, #14)
+- Operation System specific commands and variables (#13)
+
+## v1.0.0 - 2017-02-28
+
+- Add LICENSE file

docs/docs/community.md

@@ -0,0 +1,63 @@
+---
+slug: /community/
+sidebar_position: 6
+---
+
+# Community
+
+Some of the work to improve the Task ecosystem is done by the community, be
+it installation methods or integrations with code editor. I (the author) am
+thankful for everyone that helps me to improve the overall experience.
+
+## Editor Integrations
+
+### JSON Schema
+
+[@KROSF](https://github.com/KROSF) worked on a JSON Schema [into this Gist](https://gist.github.com/KROSF/c5435acf590acd632f71bb720f685895),
+which later was made officially available by [@Crandel](https://github.com/Crandel)
+at [https://json.schemastore.org/taskfile.json](https://json.schemastore.org/taskfile.json).
+Further improvements are possible by opening pull requests changing
+[this file](https://github.com/SchemaStore/schemastore/blob/master/src/schemas/json/taskfile.json).
+Some code editors, like Visual Studio Code, make use of Schema Store
+automatically.
+
+### Visual Studio Code extension
+
+Additionally, there's also some work done by
+[@paulvarache](https://github.com/paulvarache) in making an Visual Studio Code
+extension, which has its code [here](https://github.com/paulvarache/vscode-taskfile)
+and is published [here](https://marketplace.visualstudio.com/items?itemName=paulvarache.vscode-taskfile).
+
+### Sublime Text 4 package
+
+There is a convenience wrapper for initializing and running tasks from Sublime Text's command palette. The package is
+developed by [@biozz](https://github.com/biozz), the source code is available [here](https://github.com/biozz/sublime-taskfile)
+and it is published on Package Control [here](https://packagecontrol.io/packages/Taskfile).
+
+### IntelliJ plugin
+
+There's a JetBrains IntelliJ plugin done by
+[@lechuckroh](https://github.com/lechuckroh), which has its code [here](https://github.com/lechuckroh/task-intellij-plugin)
+and is published [here](https://plugins.jetbrains.com/plugin/17058-taskfile).
+
+## Installation methods
+
+Some installation methods are maintained by third party:
+
+- [GitHub Actions](https://github.com/arduino/setup-task)
+  by [@arduino](https://github.com/arduino)
+- [AUR](https://aur.archlinux.org/packages/taskfile-git)
+  by [@kovetskiy](https://github.com/kovetskiy)
+- [Scoop](https://github.com/lukesampson/scoop-extras/blob/master/bucket/task.json)
+- [Fedora](https://packages.fedoraproject.org/pkgs/golang-github-task/go-task/)
+- [NixOS](https://github.com/NixOS/nixpkgs/blob/master/pkgs/development/tools/go-task/default.nix)
+
+## More
+
+Also, thanks for all the [code contributors](https://github.com/go-task/task/graphs/contributors),
+[financial contributors](https://opencollective.com/task), all those who
+[reported bugs](https://github.com/go-task/task/issues?q=is%3Aissue) and
+[answered questions](https://github.com/go-task/task/discussions).
+
+If you know something that is missing in this document, please submit a
+pull request.

docs/docs/donate.md

@@ -0,0 +1,36 @@
+---
+slug: /donate/
+sidebar_position: 9
+---
+
+# Donate
+
+If you find this project useful, you can consider donating by using one of the
+channels listed below.
+
+This is just a way of saying "thank you", it won't give you any benefits like
+higher priority on issues or something similar.
+
+## Open Collective
+
+Task is on [Open Collective](https://opencollective.com/task) and you have
+these options to donate:
+
+- [$2 per month](https://opencollective.com/task/contribute/backer-4034/checkout)
+- [$5 per month](https://opencollective.com/task/contribute/supporter-8404/checkout)
+- [$20 per month](https://opencollective.com/task/contribute/sponsor-4035/checkout)
+- [$50 per month](https://opencollective.com/task/contribute/sponsor-28775/checkout)
+- [Custom value - One-time donation option supported](https://opencollective.com/task/donate)
+
+## GitHub Sponsors
+
+- [@andreynering](https://github.com/sponsors/andreynering)
+
+## PayPal
+
+- [Any value - One-time donation](https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=GSVDU63RKG45A&currency_code=USD&source=url)
+
+## PIX (Brazil only)
+
+If you're Brazilian, you can donate any value by
+[using this QR Code](/img/pix.png).

docs/docs/installation.md

@@ -0,0 +1,183 @@
+---
+slug: /installation/
+sidebar_position: 2
+---
+
+# Installation
+
+Task offers many installation methods. Check out the available methods below.
+
+## Package Managers
+
+### Homebrew
+
+If you're on macOS or Linux and have [Homebrew][homebrew] installed, getting
+Task is as simple as running:
+
+```bash
+brew install go-task/tap/go-task
+```
+
+### Snap
+
+Task is available in [Snapcraft][snapcraft], but keep in mind that your
+Linux distribution should allow classic confinement for Snaps to Task work
+right:
+
+```bash
+sudo snap install task --classic
+```
+
+### Chocolatey
+
+If you're on Windows and have [Chocolatey][choco] installed, getting
+Task is as simple as running:
+
+```bash
+choco install go-task
+```
+
+This installation method is community owned.
+
+
+### Scoop
+
+If you're on Windows and have [Scoop][scoop] installed, getting
+Task is as simple as running:
+
+```cmd
+scoop install task
+```
+
+This installation method is community owned. After a new release of Task, it
+may take some time until it's available on Scoop.
+
+### AUR
+
+If you're on Arch Linux you can install Task from
+[AUR](https://aur.archlinux.org/packages/taskfile-git) using your favorite
+package manager such as `yay`, `pacaur` or `yaourt`:
+
+```cmd
+yay -S taskfile-git
+```
+
+This installation method is community owned, but since it's `-git` version of
+the package, it's always latest available version based on the Git repository.
+
+### Fedora
+
+If you're on Fedora Linux you can install Task from the official
+[Fedora](https://packages.fedoraproject.org/pkgs/golang-github-task/go-task/) repository using `dnf`:
+
+```cmd
+sudo dnf install go-task
+```
+
+This installation method is community owned. After a new release of Task, it
+may take some time until it's available in [Fedora](https://packages.fedoraproject.org/pkgs/golang-github-task/go-task/).
+
+### Nix
+
+If you're on NixOS or have Nix installed
+you can install Task from [nixpkgs](https://github.com/NixOS/nixpkgs):
+
+```cmd
+nix-env -iA nixpkgs.go-task
+```
+
+This installation method is community owned. After a new release of Task, it
+may take some time until it's available in [nixpkgs](https://github.com/NixOS/nixpkgs).
+
+## Get The Binary
+
+### Binary
+
+You can download the binary from the [releases page on GitHub][releases] and
+add to your `$PATH`.
+
+DEB and RPM packages are also available.
+
+The `task_checksums.txt` file contains the SHA-256 checksum for each file.
+
+### Install Script
+
+We also have an [install script][installscript] which is very useful in
+scenarios like CI. Many thanks to [GoDownloader][godownloader] for enabling the
+easy generation of this script.
+
+By default, it installs on the `./bin` directory relative to the working
+directory:
+
+```bash
+sh -c "$(curl --location https://taskfile.dev/install.sh)" -- -d
+```
+
+It is possible to override the installation directory with the `-b` parameter.
+On Linux, common choices are `~/.local/bin` and `~/bin` to install for the
+current user or `/usr/local/bin` to install for all users:
+
+```bash
+sh -c "$(curl --location https://taskfile.dev/install.sh)" -- -d -b ~/.local/bin
+```
+
+:::caution
+
+On macOS and Windows, `~/.local/bin` and `~/bin` are not added to `$PATH` by
+default.
+
+:::
+
+### GitHub Actions
+
+If you want to install Task in GitHub Actions you can try using
+[this action](https://github.com/arduino/setup-task)
+by the Arduino team:
+
+```yaml
+- name: Install Task
+  uses: arduino/setup-task@v1
+```
+
+This installation method is community owned.
+
+## Build From Source
+
+### Go Modules
+
+First, make sure you have [Go][go] properly installed and setup.
+
+You can easily install the latest release globally by running:
+
+```bash
+go install github.com/go-task/task/v3/cmd/task@latest
+```
+
+Or you can install into another directory:
+
+```bash
+env GOBIN=/bin go install github.com/go-task/task/v3/cmd/task@latest
+```
+
+If using Go 1.15 or earlier, instead use:
+
+```bash
+env GO111MODULE=on go get -u github.com/go-task/task/v3/cmd/task@latest
+```
+
+:::tip
+
+For CI environments we recommend using the [install script](#get-the-binary)
+instead, which is faster and more stable, since it'll just download the latest
+released binary.
+
+:::
+
+[go]: https://golang.org/
+[snapcraft]: https://snapcraft.io/task
+[homebrew]: https://brew.sh/
+[installscript]: https://github.com/go-task/task/blob/master/install-task.sh
+[releases]: https://github.com/go-task/task/releases
+[godownloader]: https://github.com/goreleaser/godownloader
+[choco]: https://chocolatey.org/
+[scoop]: https://scoop.sh/

docs/docs/intro.md

@@ -0,0 +1,57 @@
+---
+slug: /
+sidebar_position: 1
+title: Home
+---
+
+# Task
+
+<div align="center">
+  <img id="logo" src="img/logo.svg" height="250px" width="250px" />
+</div>
+
+Task is a task runner / build tool that aims to be simpler and easier to use
+than, for example, [GNU Make][make].
+
+Since it's written in [Go][go], Task is just a single binary and has no other
+dependencies, which means you don't need to mess with any complicated install
+setups just to use a build tool.
+
+Once [installed](installation.md), you just need to describe your build tasks
+using a simple [YAML][yaml] schema in a file called `Taskfile.yml`:
+
+```yaml title="Taskfile.yml"
+version: '3'
+
+tasks:
+  hello:
+    cmds:
+      - echo 'Hello World from Task!'
+    silent: true
+```
+
+And call it by running `task hello` from your terminal.
+
+The above example is just the start, you can take a look at the [usage](/usage)
+guide to check the full schema documentation and Task features.
+
+## Features
+
+- [Easy installation](installation.md): just download a single binary, add to
+  `$PATH` and you're done! Or you can also install using [Homebrew][homebrew],
+  [Snapcraft][snapcraft], or [Scoop][scoop] if you want.
+- Available on CIs: by adding [this simple command](installation.md#install-script)
+  to install on your CI script and you're ready to use Task as part of your CI pipeline;
+- Truly cross-platform: while most build tools only work well on Linux or macOS,
+  Task also supports Windows thanks to [this shell interpreter for Go][sh].
+- Great for code generation: you can easily [prevent a task from running](/usage#prevent-unnecessary-work)
+  if a given set of files haven't changed since last run (based either on its
+  timestamp or content).
+
+[make]: https://www.gnu.org/software/make/
+[go]: https://go.dev/
+[yaml]: http://yaml.org/
+[homebrew]: https://brew.sh/
+[snapcraft]: https://snapcraft.io/
+[scoop]: https://scoop.sh/
+[sh]: https://github.com/mvdan/sh

docs/docs/releasing.md

@@ -0,0 +1,55 @@
+---
+slug: /releasing/
+sidebar_position: 7
+---
+
+# Releasing
+
+The release process of Task is done with the help of
+[GoReleaser][goreleaser]. You can test the release process locally by calling
+the `test-release` task of the Taskfile.
+
+[GitHub Actions](https://github.com/go-task/task/actions) should release
+artifacts automatically when a new Git tag is pushed to master
+(raw executables and DEB and RPM packages).
+
+Since v3.15.0, raw executables can also be reproduced and verified locally by
+checking out a specific tag and calling `goreleaser build`, using the Go version
+defined in the above GitHub Actions.
+
+# Homebrew
+
+To release a new version on the [Homebrew tap][homebrewtap] edit the
+[Formula/go-task.rb][gotaskrb] file, updating with the new version, download
+URL and sha256.
+
+# Snapcraft
+
+The exception is the publishing of a new version of the
+[snap package][snappackage]. This current require two steps after publishing
+the binaries:
+
+* Updating the current version on [snapcraft.yaml][snapcraftyaml].
+* Moving both `amd64`, `armhf` and `arm64` new artifacts to the stable channel on
+the [Snapcraft dashboard][snapcraftdashboard].
+
+# Scoop
+
+Scoop is a command-line package manager for the Windows operating system.
+Scoop package manifests are maintained by the community.
+Scoop owners usually take care of updating versions there by editing [this file](https://github.com/lukesampson/scoop-extras/blob/master/bucket/task.json).
+If you think its Task version is outdated, open an issue to let us know.
+
+# Nix
+
+Nix is a community owned installation method. Nix package maintainers usually take care
+of updating versions there by editing
+[this file](https://github.com/NixOS/nixpkgs/blob/nixos-unstable/pkgs/development/tools/go-task/default.nix).
+If you think its Task version is outdated, open an issue to let us know.
+
+[goreleaser]: https://goreleaser.com/
+[homebrewtap]: https://github.com/go-task/homebrew-tap
+[gotaskrb]: https://github.com/go-task/homebrew-tap/blob/master/Formula/go-task.rb
+[snappackage]: https://github.com/go-task/snap
+[snapcraftyaml]: https://github.com/go-task/snap/blob/master/snap/snapcraft.yaml#L2
+[snapcraftdashboard]: https://snapcraft.io/task/releases

docs/docs/styleguide.md

@@ -1,33 +1,44 @@
 ---
-title: Style Guide
-description:
-  Official style guide for Taskfile.yml files with best practices and
-  recommended conventions
-outline: deep
+slug: /styleguide/
+sidebar_position: 5
 ---
 
-# Style Guide
+# Styleguide
 
-This is the official style guide for `Taskfile.yml` files. It provides basic
-instructions for keeping your Taskfiles clean and familiar to other users.
+This is the official Task styleguide for `Taskfile.yml` files. This guide
+contains some basic instructions to keep your Taskfile clean and familiar to
+other users.
 
-This guide contains general guidelines, but they do not necessarily need to be
-followed strictly. Feel free to disagree and do things differently if you need
-or want to. Any improvements to this guide are welcome! Please open an issue or
-create a pull request to contribute.
+This contains general guidelines, but they don't necessarily need to be strictly
+followed. Feel free to disagree and proceed differently at some point if you
+need or want to. Also, feel free to open issues or pull requests with
+improvements to this guide.
 
-## Use the suggested ordering of the main sections
+## Use `Taskfile.yml` and not `taskfile.yml`
 
 ```yaml
-version:
-includes:
-# optional configurations (output, silent, method, run, etc.)
-vars:
-env: # followed or replaced by dotenv
-tasks:
+# bad
+taskfile.yml
+
+
+# good
+Taskfile.yml
 ```
 
-## Use two spaces for indentation
+This is important especially for Linux users. Windows and macOS have case
+insensitive filesystems, so `taskfile.yml` will end up working, even that not
+officially supported. On Linux, only `Taskfile.yml` will work, though.
+
+## Use the correct order of keywords
+
+- `version:`
+- `includes:`
+- Configuration ones, like `output:`, `silent:`, `method:` and `run:`
+- `vars:`
+- `env:`, `dotenv:`
+- `tasks:`
+
+## Use 2 spaces for indentation
 
 This is the most common convention for YAML files, and Task follows it.
 
@@ -46,7 +57,7 @@ tasks:
       - echo 'foo'
 ```
 
-## Separate the main sections with empty lines
+## Separate with spaces the mains sections
 
 ```yaml
 # bad
@@ -80,7 +91,7 @@ tasks:
   # ...
 ```
 
-## Separate tasks with empty lines
+## Add spaces between tasks
 
 ```yaml
 # bad
@@ -115,7 +126,7 @@ tasks:
       - echo 'baz'
 ```
 
-## Use only uppercase letters for variable names
+## Use upper-case variable names
 
 ```yaml
 # bad
@@ -142,7 +153,7 @@ tasks:
       - go build -o {{.BINARY_NAME}} .
 ```
 
-## Avoid using whitespace when templating variables
+## Don't wrap vars in spaces when templating
 
 ```yaml
 # bad
@@ -163,10 +174,9 @@ tasks:
       - echo '{{.MESSAGE}}'
 ```
 
-This convention is also commonly used in templates for the Go programming
-language.
+This convention is also used by most people for any Go templating.
 
-## Use kebab case for task names
+## Separate task name words with a dash
 
 ```yaml
 # bad
@@ -187,7 +197,7 @@ tasks:
       - echo 'Do something'
 ```
 
-## Use a colon to separate the task namespace and name
+## Use colon for task namespacing
 
 ```yaml
 # good
@@ -204,27 +214,3 @@ tasks:
 ```
 
 This is also done automatically when using included Taskfiles.
-
-## Prefer using external scripts instead of multi-line commands
-
-```yaml
-# bad
-version: '3'
-
-tasks:
-  build:
-    cmds:
-      - |
-        for i in $(seq 1 10); do
-          echo $i
-          echo "some other complex logic"
-        done'
-
-# good
-version: '3'
-
-tasks:
-  build:
-    cmds:
-      - ./scripts/my_complex_script.sh
-```

docs/docs/taskfile_versions.md

@@ -0,0 +1,230 @@
+---
+slug: /taskfile-versions/
+sidebar_position: 8
+---
+
+# Taskfile Versions
+
+The Taskfile syntax and features changed with time. This document explains what
+changed on each version and how to upgrade your Taskfile.
+
+## What the Taskfile version mean
+
+The Taskfile version follows the Task version. E.g. the change to Taskfile
+version `2` means that Task `v2.0.0` should be release to support it.
+
+The `version:` key on Taskfile accepts a semver string, so either `2`, `2.0` or
+`2.0.0` is accepted. If you choose to use `2.0` Task will not enable future
+`2.1` features, but if you choose to use `2`, then any `2.x.x` features will be
+available, but not `3.0.0+`.
+
+## Version 1
+
+> NOTE: Taskfiles in version 1 are not supported on Task >= v3.0.0 anymore.
+
+In the first version of the `Taskfile`, the `version:` key was not available,
+because the tasks was in the root of the YAML document. Like this:
+
+```yaml
+echo:
+  cmds:
+    - echo "Hello, World!"
+```
+
+The variable priority order was also different:
+
+1. Call variables
+2. Environment
+3. Task variables
+4. `Taskvars.yml` variables
+
+## Version 2.0
+
+At version 2, we introduced the `version:` key, to allow us to evolve Task
+with new features without breaking existing Taskfiles. The new syntax is as
+follows:
+
+```yaml
+version: '2'
+
+tasks:
+  echo:
+    cmds:
+      - echo "Hello, World!"
+```
+
+Version 2 allows you to write global variables directly in the Taskfile,
+if you don't want to create a `Taskvars.yml`:
+
+```yaml
+version: '2'
+
+vars:
+  GREETING: Hello, World!
+
+tasks:
+  greet:
+    cmds:
+      - echo "{{.GREETING}}"
+```
+
+The variable priority order changed to the following:
+
+1. Task variables
+2. Call variables
+3. Taskfile variables
+4. Taskvars file variables
+5. Environment variables
+
+A new global option was added to configure the number of variables expansions
+(which default to 2):
+
+```yaml
+version: '2'
+
+expansions: 3
+
+vars:
+  FOO: foo
+  BAR: bar
+  BAZ: baz
+  FOOBAR: "{{.FOO}}{{.BAR}}"
+  FOOBARBAZ: "{{.FOOBAR}}{{.BAZ}}"
+
+tasks:
+  default:
+    cmds:
+      - echo "{{.FOOBARBAZ}}"
+```
+
+## Version 2.1
+
+Version 2.1 includes a global `output` option, to allow having more control
+over how commands output are printed to the console
+(see [documentation][output] for more info):
+
+```yaml
+version: '2'
+
+output: prefixed
+
+tasks:
+  server:
+    cmds:
+      - go run main.go
+  prefix: server
+```
+
+From this version it's also possible to ignore errors of a command or task
+(check documentation [here][ignore_errors]):
+
+```yaml
+version: '2'
+
+tasks:
+  example-1:
+    cmds:
+      - cmd: exit 1
+        ignore_error: true
+      - echo "This will be print"
+
+  example-2:
+    cmds:
+      - exit 1
+      - echo "This will be print"
+    ignore_error: true
+```
+
+## Version 2.2
+
+Version 2.2 comes with a global `includes` options to include other
+Taskfiles:
+
+```yaml
+version: '2'
+
+includes:
+  docs: ./documentation # will look for ./documentation/Taskfile.yml
+  docker: ./DockerTasks.yml
+```
+
+## Version 2.6
+
+Version 2.6 comes with `preconditions` stanza in tasks.
+
+```yaml
+version: '2'
+
+tasks:
+  upload_environment:
+    preconditions:
+      - test -f .env
+    cmds:
+      - aws s3 cp .env s3://myenvironment
+```
+
+Please check the [documentation][includes]
+
+[output]: usage.md#output-syntax
+[ignore_errors]: usage.md#ignore-errors
+[includes]: usage.md#including-other-taskfiles
+
+## Version 3
+
+These are some major changes done on `v3`:
+
+- Task's output will now be colored
+- Added support for `.env` like files
+- Added `label:` setting to task so one can override how the task name
+  appear in the logs
+- A global `method:` was added to allow setting the default method,
+  and Task's default changed to `checksum`
+- Two magic variables were added when using `status:`: `CHECKSUM` and
+  `TIMESTAMP` which contains, respectively, the md5 checksum and greatest
+  modification timestamp of the files listed on `sources:`
+- Also, the `TASK` variable is always available with the current task name
+- CLI variables are always treated as global variables
+- Added `dir:` option to `includes` to allow choosing on which directory an
+  included Taskfile will run:
+
+```yaml
+includes:
+  docs:
+    taskfile: ./docs
+    dir: ./docs
+```
+
+- Implemented short task syntax. All below syntaxes are equivalent:
+
+```yaml
+version: '3'
+
+tasks:
+  print:
+    cmds:
+      - echo "Hello, World!"
+```
+
+```yaml
+version: '3'
+
+tasks:
+  print:
+    - echo "Hello, World!"
+```
+
+```yaml
+version: '3'
+
+tasks:
+  print: echo "Hello, World!"
+```
+
+- There was a major refactor on how variables are handled. They're now easier
+  to understand. The `expansions:` setting was removed as it became unncessary.
+  This is the order in which Task will process variables, each level can see
+  the variables set by the previous one and override those.
+  - Environment variables
+  - Global + CLI variables
+  - Call variables
+  - Task variables

docs/docusaurus.config.js

@@ -0,0 +1,179 @@
+// @ts-check
+// Note: type annotations allow type checking and IDEs autocompletion
+
+const lightCodeTheme = require('prism-react-renderer/themes/github');
+const darkCodeTheme = require('prism-react-renderer/themes/dracula');
+
+const GITHUB_URL = 'https://github.com/go-task/task';
+const TWITTER_URL = 'https://twitter.com/taskfiledev';
+const DISCORD_URL = 'https://discord.gg/6TY36E39UK';
+
+/** @type {import('@docusaurus/types').Config} */
+const config = {
+  title: 'Task',
+  tagline: 'A task runner / simpler Make alternative written in Go ',
+  url: 'https://taskfile.dev',
+  baseUrl: '/',
+  onBrokenLinks: 'throw',
+  onBrokenMarkdownLinks: 'throw',
+  favicon: 'img/favicon.ico',
+
+  organizationName: 'go-task',
+  projectName: 'task',
+  deploymentBranch: 'gh-pages',
+
+  i18n: {
+    defaultLocale: 'en',
+    locales: ['en']
+  },
+
+  presets: [
+    [
+      'classic',
+      /** @type {import('@docusaurus/preset-classic').Options} */
+      ({
+        docs: {
+          routeBasePath: '/',
+          sidebarPath: require.resolve('./sidebars.js')
+        },
+        blog: false,
+        theme: {
+          customCss: [
+            require.resolve('./src/css/custom.css'),
+            require.resolve('./src/css/carbon.css')
+          ]
+        },
+        gtag: {
+          trackingID: 'G-4RT25NXQ7N',
+          anonymizeIP: true
+        },
+        sitemap: {
+          changefreq: 'weekly',
+          priority: 0.5,
+          ignorePatterns: ['/tags/**']
+        }
+      })
+    ]
+  ],
+
+  themeConfig:
+    /** @type {import('@docusaurus/preset-classic').ThemeConfig} */
+    ({
+      metadata: [
+        {
+          name: 'og:image',
+          content: 'https://taskfile.dev/img/og-image.png'
+        }
+      ],
+      navbar: {
+        title: 'Task',
+        logo: {
+          alt: 'Task Logo',
+          src: 'img/logo.svg'
+        },
+        items: [
+          {
+            type: 'doc',
+            docId: 'installation',
+            position: 'left',
+            label: 'Installation'
+          },
+          {
+            type: 'doc',
+            docId: 'usage',
+            position: 'left',
+            label: 'Usage'
+          },
+          {
+            type: 'doc',
+            docId: 'api_reference',
+            position: 'left',
+            label: 'API'
+          },
+          {
+            type: 'doc',
+            docId: 'donate',
+            position: 'left',
+            label: 'Donate'
+          },
+          {
+            href: GITHUB_URL,
+            label: 'GitHub',
+            position: 'right'
+          },
+          {
+            href: TWITTER_URL,
+            label: 'Twitter',
+            position: 'right'
+          },
+          {
+            href: DISCORD_URL,
+            label: 'Discord',
+            position: 'right'
+          }
+        ]
+      },
+      footer: {
+        style: 'dark',
+        links: [
+          {
+            title: 'Pages',
+            items: [
+              {
+                label: 'Installation',
+                to: '/installation/'
+              },
+              {
+                label: 'Usage',
+                to: '/usage/'
+              },
+              {
+                label: 'Donate',
+                to: '/donate/'
+              }
+            ]
+          },
+          {
+            title: 'Community',
+            items: [
+              {
+                label: 'GitHub',
+                href: GITHUB_URL
+              },
+              {
+                label: 'Twitter',
+                href: TWITTER_URL
+              },
+              {
+                label: 'Discord',
+                href: DISCORD_URL
+              },
+              {
+                label: 'OpenCollective',
+                href: 'https://opencollective.com/task'
+              }
+            ]
+          }
+        ]
+      },
+      prism: {
+        theme: lightCodeTheme,
+        darkTheme: darkCodeTheme
+      },
+      // NOTE(@andreynering): Don't worry, these keys are meant to be public =)
+      algolia: {
+        appId: '7IZIJ13AI7',
+        apiKey: '34b64ae4fc8d9da43d9a13d9710aaddc',
+        indexName: 'taskfile'
+      }
+    }),
+
+  scripts: [
+    {
+      src: '/js/carbon.js',
+      async: true
+    }
+  ]
+};
+
+module.exports = config;

docs/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "taskfile-dev",
+  "version": "0.0.0",
+  "private": true,
+  "scripts": {
+    "docusaurus": "docusaurus",
+    "start": "docusaurus start",
+    "build": "docusaurus build",
+    "swizzle": "docusaurus swizzle",
+    "deploy": "docusaurus deploy",
+    "clear": "docusaurus clear",
+    "serve": "docusaurus serve",
+    "write-translations": "docusaurus write-translations",
+    "write-heading-ids": "docusaurus write-heading-ids"
+  },
+  "dependencies": {
+    "@docusaurus/core": "2.0.0-beta.20",
+    "@docusaurus/preset-classic": "2.0.0-beta.20",
+    "@mdx-js/react": "^1.6.22",
+    "clsx": "^1.1.1",
+    "prism-react-renderer": "^1.3.1",
+    "raw-loader": "^4.0.2",
+    "react": "^17.0.2",
+    "react-dom": "^17.0.2"
+  },
+  "devDependencies": {
+    "@docusaurus/module-type-aliases": "2.0.0-beta.20"
+  },
+  "browserslist": {
+    "production": [
+      ">0.5%",
+      "not dead",
+      "not op_mini all"
+    ],
+    "development": [
+      "last 1 chrome version",
+      "last 1 firefox version",
+      "last 1 safari version"
+    ]
+  }
+}

docs/prettier.config.js

@@ -0,0 +1,4 @@
+module.exports = {
+  trailingComma: 'none',
+  singleQuote: true
+};

docs/sidebars.js

@@ -0,0 +1,14 @@
+// @ts-check
+
+/** @type {import('@docusaurus/plugin-content-docs').SidebarsConfig} */
+const sidebars = {
+  tutorialSidebar: [
+    { type: 'autogenerated', dirName: '.' },
+    {
+      type: 'html',
+      value: '<div id="sidebar-ads"></div>'
+    }
+  ]
+};
+
+module.exports = sidebars;

docs/src/css/carbon.css

@@ -0,0 +1,65 @@
+#carbonads * {
+  margin: initial;
+  padding: initial;
+}
+#carbonads {
+  display: flex;
+  max-width: 330px;
+  background-color: hsl(0, 0%, 98%);
+  box-shadow: 0 1px 4px 1px hsla(0, 0%, 0%, 0.1);
+  z-index: 100;
+}
+#carbonads a {
+  color: inherit;
+  text-decoration: none;
+}
+#carbonads a:hover {
+  color: inherit;
+}
+#carbonads span {
+  position: relative;
+  display: block;
+  overflow: hidden;
+}
+#carbonads .carbon-wrap {
+  display: flex;
+}
+#carbonads .carbon-img {
+  display: block;
+  margin: 0;
+  line-height: 1;
+}
+#carbonads .carbon-img img {
+  display: block;
+}
+#carbonads .carbon-text {
+  font-size: 13px;
+  padding: 10px;
+  margin-bottom: 16px;
+  line-height: 1.5;
+  text-align: left;
+}
+#carbonads .carbon-poweredby {
+  display: block;
+  padding: 6px 8px;
+  background: #f1f1f2;
+  text-align: center;
+  text-transform: uppercase;
+  letter-spacing: 0.5px;
+  font-weight: 600;
+  font-size: 8px;
+  line-height: 1;
+  border-top-left-radius: 3px;
+  position: absolute;
+  bottom: 0;
+  right: 0;
+}
+
+[data-theme='dark'] #carbonads {
+  background-color: hsl(0, 0%, 35%);
+  box-shadow: 0 1px 4px 1px hsl(0, 0%, 55%);
+}
+
+[data-theme='dark'] #carbonads .carbon-poweredby {
+  background-color: hsl(0, 0%, 55%);
+}

docs/src/css/custom.css

@@ -0,0 +1,29 @@
+@import url('https://fonts.googleapis.com/css2?family=Roboto+Mono:ital,wght@0,400;0,700;1,400;1,700&family=Roboto:ital,wght@0,400;0,700;1,400;1,700&display=swap');
+
+:root {
+  --ifm-font-family-base: Roboto, system-ui, -apple-system, Segoe UI, Ubuntu, Cantarell, Noto Sans, sans-serif, BlinkMacSystemFont, 'Segoe UI', Helvetica, Arial, sans-serif;
+  --ifm-font-family-monospace: 'Roboto Mono', SFMono-Regular, Menlo, Monaco, Consolas, 'Liberation Mono', 'Courier New', monospace;
+
+  --ifm-color-primary: #43ABA2 ;
+  --ifm-color-primary-dark: #3AB2A6;
+  --ifm-color-primary-darker: #32B8AB;
+  --ifm-color-primary-darkest: #29BEB0;
+  --ifm-color-primary-light: #4CA59D;
+  --ifm-color-primary-lighter: #559F98;
+  --ifm-color-primary-lightest: #5D9993;
+  --ifm-code-font-size: 95%;
+  --docusaurus-highlighted-code-line-bg: rgba(0, 0, 0, 0.1);
+}
+
+[data-theme='dark'] {
+  --docusaurus-highlighted-code-line-bg: rgba(0, 0, 0, 0.3);
+}
+
+.code-block--max-width {
+  width: 100%;
+}
+
+#carbonads {
+  margin-top: 30px;
+  margin-right: 10px;
+}

docs/static/install.sh

@@ -64,15 +64,15 @@ get_binaries() {
   case "$PLATFORM" in
     darwin/amd64) BINARIES="task" ;;
     darwin/arm64) BINARIES="task" ;;
-    darwin/arm) BINARIES="task" ;;
+    darwin/armv6) BINARIES="task" ;;
     linux/386) BINARIES="task" ;;
     linux/amd64) BINARIES="task" ;;
     linux/arm64) BINARIES="task" ;;
-    linux/arm) BINARIES="task" ;;
+    linux/armv6) BINARIES="task" ;;
     windows/386) BINARIES="task" ;;
     windows/amd64) BINARIES="task" ;;
     windows/arm64) BINARIES="task" ;;
-    windows/arm) BINARIES="task" ;;
+    windows/armv6) BINARIES="task" ;;
     *)
       log_crit "platform $PLATFORM is not supported.  Make sure this script is up-to-date and file request at https://github.com/${PREFIX}/issues/new"
       exit 1
@@ -184,9 +184,9 @@ uname_arch() {
     i686) arch="386" ;;
     i386) arch="386" ;;
     aarch64) arch="arm64" ;;
-    armv5*) arch="arm" ;;
-    armv6*) arch="arm" ;;
-    armv7*) arch="arm" ;;
+    armv5*) arch="armv5" ;;
+    armv6*) arch="armv6" ;;
+    armv7*) arch="armv7" ;;
   esac
   echo ${arch}
 }
@@ -214,7 +214,9 @@ uname_arch_check() {
     386) return 0 ;;
     amd64) return 0 ;;
     arm64) return 0 ;;
-    arm) return 0 ;;
+    armv5) return 0 ;;
+    armv6) return 0 ;;
+    armv7) return 0 ;;
     ppc64) return 0 ;;
     ppc64le) return 0 ;;
     mips) return 0 ;;

docs/static/js/carbon.js

@@ -0,0 +1,24 @@
+(function () {
+  function attachAd() {
+    const el = document.createElement('script');
+    el.setAttribute('type', 'text/javascript');
+    el.setAttribute('id', '_carbonads_js');
+    el.setAttribute(
+      'src',
+      '//cdn.carbonads.com/carbon.js?serve=CESI65QJ&placement=taskfiledev'
+    );
+    el.setAttribute('async', 'async');
+
+    const wrapper = document.getElementById('sidebar-ads');
+    wrapper.innerHTML = '';
+    wrapper.appendChild(el);
+  }
+
+  setTimeout(function () {
+    attachAd();
+
+    window.addEventListener('popstate', function () {
+      attachAd();
+    });
+  }, 1000);
+})();

errors.go

@@ -0,0 +1,53 @@
+package task
+
+import (
+	"errors"
+	"fmt"
+
+	"mvdan.cc/sh/v3/interp"
+)
+
+var (
+	// ErrTaskfileAlreadyExists is returned on creating a Taskfile if one already exists
+	ErrTaskfileAlreadyExists = errors.New("task: A Taskfile already exists")
+)
+
+type taskNotFoundError struct {
+	taskName string
+}
+
+func (err *taskNotFoundError) Error() string {
+	return fmt.Sprintf(`task: Task %q not found`, err.taskName)
+}
+
+type TaskRunError struct {
+	taskName string
+	err      error
+}
+
+func (err *TaskRunError) Error() string {
+	return fmt.Sprintf(`task: Failed to run task %q: %v`, err.taskName, err.err)
+}
+
+func (err *TaskRunError) ExitCode() int {
+	if c, ok := interp.IsExitStatus(err.err); ok {
+		return int(c)
+	}
+
+	return 1
+}
+
+// MaximumTaskCallExceededError is returned when a task is called too
+// many times. In this case you probably have a cyclic dependendy or
+// infinite loop
+type MaximumTaskCallExceededError struct {
+	task string
+}
+
+func (e *MaximumTaskCallExceededError) Error() string {
+	return fmt.Sprintf(
+		`task: maximum task call exceeded (%d) for task %q: probably an cyclic dep or infinite loop`,
+		MaximumTaskCall,
+		e.task,
+	)
+}

errors/error_taskfile_decode.go

@@ -1,127 +0,0 @@
-package errors
-
-import (
-	"bytes"
-	"cmp"
-	"errors"
-	"fmt"
-	"strings"
-
-	"github.com/fatih/color"
-	"go.yaml.in/yaml/v4"
-)
-
-type (
-	TaskfileDecodeError struct {
-		Message  string
-		Location string
-		Line     int
-		Column   int
-		Tag      string
-		Snippet  string
-		Err      error
-	}
-)
-
-func NewTaskfileDecodeError(err error, node *yaml.Node) *TaskfileDecodeError {
-	// If the error is already a DecodeError, return it
-	taskfileInvalidErr := &TaskfileDecodeError{}
-	if errors.As(err, &taskfileInvalidErr) {
-		return taskfileInvalidErr
-	}
-	return &TaskfileDecodeError{
-		Line:   node.Line,
-		Column: node.Column,
-		Tag:    node.ShortTag(),
-		Err:    err,
-	}
-}
-
-func (err *TaskfileDecodeError) Error() string {
-	buf := &bytes.Buffer{}
-
-	// Print the error message
-	if err.Message != "" {
-		fmt.Fprintln(buf, color.RedString("err:  %s", err.Message))
-	} else {
-		// Extract the errors from the TypeError
-		te := &yaml.TypeError{}
-		if errors.As(err.Err, &te) {
-			if len(te.Errors) > 1 {
-				fmt.Fprintln(buf, color.RedString("errs:"))
-				for _, message := range te.Errors {
-					fmt.Fprintln(buf, color.RedString("- %s", message.Err.Error()))
-				}
-			} else {
-				fmt.Fprintln(buf, color.RedString("err:  %s", te.Errors[0].Err.Error()))
-			}
-		} else {
-			// Otherwise print the error message normally
-			fmt.Fprintln(buf, color.RedString("err:  %s", err.Err))
-		}
-	}
-	fmt.Fprintln(buf, color.RedString("file: %s:%d:%d", err.Location, err.Line, err.Column))
-	fmt.Fprint(buf, err.Snippet)
-	return buf.String()
-}
-
-func (err *TaskfileDecodeError) Debug() string {
-	const indentWidth = 2
-	buf := &bytes.Buffer{}
-	fmt.Fprintln(buf, "TaskfileDecodeError:")
-
-	// Recursively loop through the error chain and print any details
-	var debug func(error, int)
-	debug = func(err error, indent int) {
-		indentStr := strings.Repeat(" ", indent*indentWidth)
-
-		// Nothing left to unwrap
-		if err == nil {
-			fmt.Fprintf(buf, "%sEnd of chain\n", indentStr)
-			return
-		}
-
-		// Taskfile decode error
-		decodeErr := &TaskfileDecodeError{}
-		if errors.As(err, &decodeErr) {
-			fmt.Fprintf(buf, "%s%s (%s:%d:%d)\n",
-				indentStr,
-				cmp.Or(decodeErr.Message, "<no_message>"),
-				decodeErr.Location,
-				decodeErr.Line,
-				decodeErr.Column,
-			)
-			debug(errors.Unwrap(err), indent+1)
-			return
-		}
-
-		fmt.Fprintf(buf, "%s%s\n", indentStr, err)
-		debug(errors.Unwrap(err), indent+1)
-	}
-	debug(err, 0)
-	return buf.String()
-}
-
-func (err *TaskfileDecodeError) Unwrap() error {
-	return err.Err
-}
-
-func (err *TaskfileDecodeError) Code() int {
-	return CodeTaskfileDecode
-}
-
-func (err *TaskfileDecodeError) WithMessage(format string, a ...any) *TaskfileDecodeError {
-	err.Message = fmt.Sprintf(format, a...)
-	return err
-}
-
-func (err *TaskfileDecodeError) WithTypeMessage(t string) *TaskfileDecodeError {
-	err.Message = fmt.Sprintf("cannot unmarshal %s into %s", err.Tag, t)
-	return err
-}
-
-func (err *TaskfileDecodeError) WithFileInfo(location string, snippet string) *TaskfileDecodeError {
-	err.Location = location
-	err.Snippet = snippet
-	return err
-}

errors/errors.go

@@ -1,72 +0,0 @@
-package errors
-
-import "errors"
-
-// General exit codes
-const (
-	CodeOk      int = iota // Used when the program exits without errors
-	CodeUnknown            // Used when no other exit code is appropriate
-)
-
-// TaskRC related exit codes
-const (
-	CodeTaskRCNotFoundError int = iota + 50
-)
-
-// Taskfile related exit codes
-const (
-	CodeTaskfileNotFound int = iota + 100
-	CodeTaskfileAlreadyExists
-	CodeTaskfileDecode
-	CodeTaskfileFetchFailed
-	CodeTaskfileNotTrusted
-	CodeTaskfileNotSecure
-	CodeTaskfileCacheNotFound
-	CodeTaskfileVersionCheckError
-	CodeTaskfileNetworkTimeout
-	CodeTaskfileInvalid
-	CodeTaskfileCycle
-	CodeTaskfileDoesNotMatchChecksum
-)
-
-// Task related exit codes
-const (
-	CodeTaskNotFound int = iota + 200
-	CodeTaskRunError
-	CodeTaskInternal
-	CodeTaskNameConflict
-	CodeTaskCalledTooManyTimes
-	CodeTaskCancelled
-	CodeTaskMissingRequiredVars
-	CodeTaskNotAllowedVars
-)
-
-// TaskError extends the standard error interface with a Code method. This code will
-// be used as the exit code of the program which allows the user to distinguish
-// between different types of errors.
-type TaskError interface {
-	error
-	Code() int
-}
-
-// New returns an error that formats as the given text. Each call to New returns
-// a distinct error value even if the text is identical. This wraps the standard
-// errors.New function so that we don't need to alias that package.
-func New(text string) error {
-	return errors.New(text)
-}
-
-// Is wraps the standard errors.Is function so that we don't need to alias that package.
-func Is(err, target error) bool {
-	return errors.Is(err, target)
-}
-
-// As wraps the standard errors.As function so that we don't need to alias that package.
-func As(err error, target any) bool {
-	return errors.As(err, target)
-}
-
-// Unwrap wraps the standard errors.Unwrap function so that we don't need to alias that package.
-func Unwrap(err error) error {
-	return errors.Unwrap(err)
-}

errors/errors_task.go

@@ -1,208 +0,0 @@
-package errors
-
-import (
-	"errors"
-	"fmt"
-	"strings"
-
-	"mvdan.cc/sh/v3/interp"
-)
-
-// TaskNotFoundError is returned when the specified task is not found in the
-// Taskfile.
-type TaskNotFoundError struct {
-	TaskName   string
-	DidYouMean string
-}
-
-func (err *TaskNotFoundError) Error() string {
-	if err.DidYouMean != "" {
-		return fmt.Sprintf(
-			`task: Task %q does not exist. Did you mean %q?`,
-			err.TaskName,
-			err.DidYouMean,
-		)
-	}
-
-	return fmt.Sprintf(`task: Task %q does not exist`, err.TaskName)
-}
-
-func (err *TaskNotFoundError) Code() int {
-	return CodeTaskNotFound
-}
-
-// TaskRunError is returned when a command in a task returns a non-zero exit
-// code.
-type TaskRunError struct {
-	TaskName string
-	Err      error
-}
-
-func (err *TaskRunError) Error() string {
-	return fmt.Sprintf(`task: Failed to run task %q: %v`, err.TaskName, err.Err)
-}
-
-func (err *TaskRunError) Code() int {
-	return CodeTaskRunError
-}
-
-func (err *TaskRunError) TaskExitCode() int {
-	var exit interp.ExitStatus
-	if errors.As(err.Err, &exit) {
-		return int(exit)
-	}
-	return err.Code()
-}
-
-func (err *TaskRunError) Unwrap() error {
-	return err.Err
-}
-
-// TaskInternalError when the user attempts to invoke a task that is internal.
-type TaskInternalError struct {
-	TaskName string
-}
-
-func (err *TaskInternalError) Error() string {
-	return fmt.Sprintf(`task: Task "%s" is internal`, err.TaskName)
-}
-
-func (err *TaskInternalError) Code() int {
-	return CodeTaskInternal
-}
-
-// TaskNameConflictError is returned when multiple tasks with a matching name or
-// alias are found.
-type TaskNameConflictError struct {
-	Call      string
-	TaskNames []string
-}
-
-func (err *TaskNameConflictError) Error() string {
-	return fmt.Sprintf(`task: Found multiple tasks (%s) that match %q`, strings.Join(err.TaskNames, ", "), err.Call)
-}
-
-func (err *TaskNameConflictError) Code() int {
-	return CodeTaskNameConflict
-}
-
-type TaskNameFlattenConflictError struct {
-	TaskName string
-	Include  string
-}
-
-func (err *TaskNameFlattenConflictError) Error() string {
-	return fmt.Sprintf(`task: Found multiple tasks (%s) included by "%s""`, err.TaskName, err.Include)
-}
-
-func (err *TaskNameFlattenConflictError) Code() int {
-	return CodeTaskNameConflict
-}
-
-// TaskCalledTooManyTimesError is returned when the maximum task call limit is
-// exceeded. This is to prevent infinite loops and cyclic dependencies.
-type TaskCalledTooManyTimesError struct {
-	TaskName        string
-	MaximumTaskCall int
-}
-
-func (err *TaskCalledTooManyTimesError) Error() string {
-	return fmt.Sprintf(
-		`task: Maximum task call exceeded (%d) for task %q: probably an cyclic dep or infinite loop`,
-		err.MaximumTaskCall,
-		err.TaskName,
-	)
-}
-
-func (err *TaskCalledTooManyTimesError) Code() int {
-	return CodeTaskCalledTooManyTimes
-}
-
-// TaskCancelledByUserError is returned when the user does not accept an optional prompt to continue.
-type TaskCancelledByUserError struct {
-	TaskName string
-}
-
-func (err *TaskCancelledByUserError) Error() string {
-	return fmt.Sprintf(`task: Task %q cancelled by user`, err.TaskName)
-}
-
-func (err *TaskCancelledByUserError) Code() int {
-	return CodeTaskCancelled
-}
-
-// TaskCancelledNoTerminalError is returned when trying to run a task with a prompt in a non-terminal environment.
-type TaskCancelledNoTerminalError struct {
-	TaskName string
-}
-
-func (err *TaskCancelledNoTerminalError) Error() string {
-	return fmt.Sprintf(
-		`task: Task %q cancelled because it has a prompt and the environment is not a terminal. Use --yes (-y) to run anyway.`,
-		err.TaskName,
-	)
-}
-
-func (err *TaskCancelledNoTerminalError) Code() int {
-	return CodeTaskCancelled
-}
-
-// TaskMissingRequiredVarsError is returned when a task is missing required variables.
-
-type MissingVar struct {
-	Name          string
-	AllowedValues []string
-}
-type TaskMissingRequiredVarsError struct {
-	TaskName    string
-	MissingVars []MissingVar
-}
-
-func (v MissingVar) String() string {
-	if len(v.AllowedValues) == 0 {
-		return v.Name
-	}
-	return fmt.Sprintf("%s (allowed values: %v)", v.Name, v.AllowedValues)
-}
-
-func (err *TaskMissingRequiredVarsError) Error() string {
-	vars := make([]string, 0, len(err.MissingVars))
-	for _, v := range err.MissingVars {
-		vars = append(vars, v.String())
-	}
-
-	return fmt.Sprintf(
-		`task: Task %q cancelled because it is missing required variables: %s`,
-		err.TaskName,
-		strings.Join(vars, ", "))
-}
-
-func (err *TaskMissingRequiredVarsError) Code() int {
-	return CodeTaskMissingRequiredVars
-}
-
-type NotAllowedVar struct {
-	Value string
-	Enum  []string
-	Name  string
-}
-
-type TaskNotAllowedVarsError struct {
-	TaskName       string
-	NotAllowedVars []NotAllowedVar
-}
-
-func (err *TaskNotAllowedVarsError) Error() string {
-	var builder strings.Builder
-
-	builder.WriteString(fmt.Sprintf("task: Task %q cancelled because it is missing required variables:\n", err.TaskName))
-	for _, s := range err.NotAllowedVars {
-		builder.WriteString(fmt.Sprintf("  - %s has an invalid value : '%s' (allowed values : %v)\n", s.Name, s.Value, s.Enum))
-	}
-
-	return builder.String()
-}
-
-func (err *TaskNotAllowedVarsError) Code() int {
-	return CodeTaskNotAllowedVars
-}

errors/errors_taskfile.go

@@ -1,214 +0,0 @@
-package errors
-
-import (
-	"fmt"
-	"net/http"
-	"time"
-
-	"github.com/Masterminds/semver/v3"
-)
-
-// TaskfileNotFoundError is returned when no appropriate Taskfile is found when
-// searching the filesystem.
-type TaskfileNotFoundError struct {
-	URI     string
-	Walk    bool
-	AskInit bool
-}
-
-func (err TaskfileNotFoundError) Error() string {
-	var walkText string
-	if err.Walk {
-		walkText = " (or any of the parent directories)."
-	}
-	if err.AskInit {
-		walkText += " Run `task --init` to create a new Taskfile."
-	}
-	return fmt.Sprintf(`task: No Taskfile found at %q%s`, err.URI, walkText)
-}
-
-func (err TaskfileNotFoundError) Code() int {
-	return CodeTaskfileNotFound
-}
-
-// TaskfileAlreadyExistsError is returned on creating a Taskfile if one already
-// exists.
-type TaskfileAlreadyExistsError struct{}
-
-func (err TaskfileAlreadyExistsError) Error() string {
-	return "task: A Taskfile already exists"
-}
-
-func (err TaskfileAlreadyExistsError) Code() int {
-	return CodeTaskfileAlreadyExists
-}
-
-// TaskfileInvalidError is returned when the Taskfile contains syntax errors or
-// cannot be parsed for some reason.
-type TaskfileInvalidError struct {
-	URI string
-	Err error
-}
-
-func (err TaskfileInvalidError) Error() string {
-	return fmt.Sprintf("task: Failed to parse %s:\n%v", err.URI, err.Err)
-}
-
-func (err TaskfileInvalidError) Code() int {
-	return CodeTaskfileInvalid
-}
-
-// TaskfileFetchFailedError is returned when no appropriate Taskfile is found when
-// searching the filesystem.
-type TaskfileFetchFailedError struct {
-	URI            string
-	HTTPStatusCode int
-}
-
-func (err TaskfileFetchFailedError) Error() string {
-	var statusText string
-	if err.HTTPStatusCode != 0 {
-		statusText = fmt.Sprintf(" with status code %d (%s)", err.HTTPStatusCode, http.StatusText(err.HTTPStatusCode))
-	}
-	return fmt.Sprintf(`task: Download of %q failed%s`, err.URI, statusText)
-}
-
-func (err TaskfileFetchFailedError) Code() int {
-	return CodeTaskfileFetchFailed
-}
-
-// TaskfileNotTrustedError is returned when the user does not accept the trust
-// prompt when downloading a remote Taskfile.
-type TaskfileNotTrustedError struct {
-	URI string
-}
-
-func (err *TaskfileNotTrustedError) Error() string {
-	return fmt.Sprintf(
-		`task: Taskfile %q not trusted by user`,
-		err.URI,
-	)
-}
-
-func (err *TaskfileNotTrustedError) Code() int {
-	return CodeTaskfileNotTrusted
-}
-
-// TaskfileNotSecureError is returned when the user attempts to download a
-// remote Taskfile over an insecure connection.
-type TaskfileNotSecureError struct {
-	URI string
-}
-
-func (err *TaskfileNotSecureError) Error() string {
-	return fmt.Sprintf(
-		`task: Taskfile %q cannot be downloaded over an insecure connection. You can override this by using the --insecure flag`,
-		err.URI,
-	)
-}
-
-func (err *TaskfileNotSecureError) Code() int {
-	return CodeTaskfileNotSecure
-}
-
-// TaskfileCacheNotFoundError is returned when the user attempts to use an offline
-// (cached) Taskfile but the files does not exist in the cache.
-type TaskfileCacheNotFoundError struct {
-	URI string
-}
-
-func (err *TaskfileCacheNotFoundError) Error() string {
-	return fmt.Sprintf(
-		`task: Taskfile %q was not found in the cache. Remove the --offline flag to use a remote copy or download it using the --download flag`,
-		err.URI,
-	)
-}
-
-func (err *TaskfileCacheNotFoundError) Code() int {
-	return CodeTaskfileCacheNotFound
-}
-
-// TaskfileVersionCheckError is returned when the user attempts to run a
-// Taskfile that does not contain a Taskfile schema version key or if they try
-// to use a feature that is not supported by the schema version.
-type TaskfileVersionCheckError struct {
-	URI           string
-	SchemaVersion *semver.Version
-	Message       string
-}
-
-func (err *TaskfileVersionCheckError) Error() string {
-	if err.SchemaVersion == nil {
-		return fmt.Sprintf(
-			`task: Missing schema version in Taskfile %q`,
-			err.URI,
-		)
-	}
-	return fmt.Sprintf(
-		"task: Invalid schema version in Taskfile %q:\nSchema version (%s) %s",
-		err.URI,
-		err.SchemaVersion.String(),
-		err.Message,
-	)
-}
-
-func (err *TaskfileVersionCheckError) Code() int {
-	return CodeTaskfileVersionCheckError
-}
-
-// TaskfileNetworkTimeoutError is returned when the user attempts to use a remote
-// Taskfile but a network connection could not be established within the timeout.
-type TaskfileNetworkTimeoutError struct {
-	URI     string
-	Timeout time.Duration
-}
-
-func (err *TaskfileNetworkTimeoutError) Error() string {
-	return fmt.Sprintf(
-		`task: Network connection timed out after %s while attempting to download Taskfile %q`,
-		err.Timeout, err.URI,
-	)
-}
-
-func (err *TaskfileNetworkTimeoutError) Code() int {
-	return CodeTaskfileNetworkTimeout
-}
-
-// TaskfileCycleError is returned when we detect that a Taskfile includes a
-// set of Taskfiles that include each other in a cycle.
-type TaskfileCycleError struct {
-	Source      string
-	Destination string
-}
-
-func (err TaskfileCycleError) Error() string {
-	return fmt.Sprintf("task: include cycle detected between %s <--> %s",
-		err.Source,
-		err.Destination,
-	)
-}
-
-func (err TaskfileCycleError) Code() int {
-	return CodeTaskfileCycle
-}
-
-// TaskfileDoesNotMatchChecksum is returned when a Taskfile's checksum does not
-// match the one pinned in the parent Taskfile.
-type TaskfileDoesNotMatchChecksum struct {
-	URI              string
-	ExpectedChecksum string
-	ActualChecksum   string
-}
-
-func (err *TaskfileDoesNotMatchChecksum) Error() string {
-	return fmt.Sprintf(
-		"task: The checksum of the Taskfile at %q does not match!\ngot: %q\nwant: %q",
-		err.URI,
-		err.ActualChecksum,
-		err.ExpectedChecksum,
-	)
-}
-
-func (err *TaskfileDoesNotMatchChecksum) Code() int {
-	return CodeTaskfileDoesNotMatchChecksum
-}

errors/errors_taskrc.go

@@ -1,20 +0,0 @@
-package errors
-
-import "fmt"
-
-type TaskRCNotFoundError struct {
-	URI  string
-	Walk bool
-}
-
-func (err TaskRCNotFoundError) Error() string {
-	var walkText string
-	if err.Walk {
-		walkText = " (or any of the parent directories)"
-	}
-	return fmt.Sprintf(`task: No Task config file found at %q%s`, err.URI, walkText)
-}
-
-func (err TaskRCNotFoundError) Code() int {
-	return CodeTaskRCNotFoundError
-}

executor.go

@@ -1,562 +0,0 @@
-package task
-
-import (
-	"context"
-	"io"
-	"os"
-	"sync"
-	"time"
-
-	"github.com/puzpuzpuz/xsync/v4"
-	"github.com/sajari/fuzzy"
-
-	"github.com/go-task/task/v3/internal/logger"
-	"github.com/go-task/task/v3/internal/output"
-	"github.com/go-task/task/v3/internal/sort"
-	"github.com/go-task/task/v3/taskfile/ast"
-)
-
-type (
-	// An ExecutorOption is any type that can apply a configuration to an
-	// [Executor].
-	ExecutorOption interface {
-		ApplyToExecutor(*Executor)
-	}
-	// An Executor is used for processing Taskfile(s) and executing the task(s)
-	// within them.
-	Executor struct {
-		// Flags
-		Dir                 string
-		Entrypoint          string
-		TempDir             TempDir
-		Force               bool
-		ForceAll            bool
-		Insecure            bool
-		Download            bool
-		Offline             bool
-		TrustedHosts        []string
-		Timeout             time.Duration
-		CacheExpiryDuration time.Duration
-		RemoteCacheDir      string
-		Watch               bool
-		Verbose             bool
-		Silent              bool
-		DisableFuzzy        bool
-		AssumeYes           bool
-		AssumeTerm          bool // Used for testing
-		Dry                 bool
-		Summary             bool
-		Parallel            bool
-		Color               bool
-		Concurrency         int
-		Interval            time.Duration
-		Failfast            bool
-
-		// I/O
-		Stdin  io.Reader
-		Stdout io.Writer
-		Stderr io.Writer
-
-		// Internal
-		Taskfile           *ast.Taskfile
-		Logger             *logger.Logger
-		Compiler           *Compiler
-		Output             output.Output
-		OutputStyle        ast.Output
-		TaskSorter         sort.Sorter
-		UserWorkingDir     string
-		EnableVersionCheck bool
-
-		fuzzyModel     *fuzzy.Model
-		fuzzyModelOnce sync.Once
-
-		concurrencySemaphore chan struct{}
-		taskCallCount        map[string]*int32
-		mkdirMutexMap        map[string]*sync.Mutex
-		executionHashes      map[string]context.Context
-		executionHashesMutex sync.Mutex
-		watchedDirs          *xsync.Map[string, bool]
-	}
-	TempDir struct {
-		Remote      string
-		Fingerprint string
-	}
-)
-
-// NewExecutor creates a new [Executor] and applies the given functional options
-// to it.
-func NewExecutor(opts ...ExecutorOption) *Executor {
-	e := &Executor{
-		Timeout:              time.Second * 10,
-		Stdin:                os.Stdin,
-		Stdout:               os.Stdout,
-		Stderr:               os.Stderr,
-		Logger:               nil,
-		Compiler:             nil,
-		Output:               nil,
-		OutputStyle:          ast.Output{},
-		TaskSorter:           sort.AlphaNumericWithRootTasksFirst,
-		UserWorkingDir:       "",
-		fuzzyModel:           nil,
-		concurrencySemaphore: nil,
-		taskCallCount:        map[string]*int32{},
-		mkdirMutexMap:        map[string]*sync.Mutex{},
-		executionHashes:      map[string]context.Context{},
-		executionHashesMutex: sync.Mutex{},
-	}
-	e.Options(opts...)
-	return e
-}
-
-// Options loops through the given [ExecutorOption] functions and applies them
-// to the [Executor].
-func (e *Executor) Options(opts ...ExecutorOption) {
-	for _, opt := range opts {
-		opt.ApplyToExecutor(e)
-	}
-}
-
-// WithDir sets the working directory of the [Executor]. By default, the
-// directory is set to the user's current working directory.
-func WithDir(dir string) ExecutorOption {
-	return &dirOption{dir}
-}
-
-type dirOption struct {
-	dir string
-}
-
-func (o *dirOption) ApplyToExecutor(e *Executor) {
-	e.Dir = o.dir
-}
-
-// WithEntrypoint sets the entrypoint (main Taskfile) of the [Executor]. By
-// default, Task will search for one of the default Taskfiles in the given
-// directory.
-func WithEntrypoint(entrypoint string) ExecutorOption {
-	return &entrypointOption{entrypoint}
-}
-
-type entrypointOption struct {
-	entrypoint string
-}
-
-func (o *entrypointOption) ApplyToExecutor(e *Executor) {
-	e.Entrypoint = o.entrypoint
-}
-
-// WithTempDir sets the temporary directory that will be used by [Executor] for
-// storing temporary files like checksums and cached remote files. By default,
-// the temporary directory is set to the user's temporary directory.
-func WithTempDir(tempDir TempDir) ExecutorOption {
-	return &tempDirOption{tempDir}
-}
-
-type tempDirOption struct {
-	tempDir TempDir
-}
-
-func (o *tempDirOption) ApplyToExecutor(e *Executor) {
-	e.TempDir = o.tempDir
-}
-
-// WithForce ensures that the [Executor] always runs a task, even when
-// fingerprinting or prompts would normally stop it.
-func WithForce(force bool) ExecutorOption {
-	return &forceOption{force}
-}
-
-type forceOption struct {
-	force bool
-}
-
-func (o *forceOption) ApplyToExecutor(e *Executor) {
-	e.Force = o.force
-}
-
-// WithForceAll ensures that the [Executor] always runs all tasks (including
-// subtasks), even when fingerprinting or prompts would normally stop them.
-func WithForceAll(forceAll bool) ExecutorOption {
-	return &forceAllOption{forceAll}
-}
-
-type forceAllOption struct {
-	forceAll bool
-}
-
-func (o *forceAllOption) ApplyToExecutor(e *Executor) {
-	e.ForceAll = o.forceAll
-}
-
-// WithInsecure allows the [Executor] to make insecure connections when reading
-// remote taskfiles. By default, insecure connections are rejected.
-func WithInsecure(insecure bool) ExecutorOption {
-	return &insecureOption{insecure}
-}
-
-type insecureOption struct {
-	insecure bool
-}
-
-func (o *insecureOption) ApplyToExecutor(e *Executor) {
-	e.Insecure = o.insecure
-}
-
-// WithDownload forces the [Executor] to download a fresh copy of the taskfile
-// from the remote source.
-func WithDownload(download bool) ExecutorOption {
-	return &downloadOption{download}
-}
-
-type downloadOption struct {
-	download bool
-}
-
-func (o *downloadOption) ApplyToExecutor(e *Executor) {
-	e.Download = o.download
-}
-
-// WithOffline stops the [Executor] from being able to make network connections.
-// It will still be able to read local files and cached copies of remote files.
-func WithOffline(offline bool) ExecutorOption {
-	return &offlineOption{offline}
-}
-
-type offlineOption struct {
-	offline bool
-}
-
-func (o *offlineOption) ApplyToExecutor(e *Executor) {
-	e.Offline = o.offline
-}
-
-// WithTrustedHosts configures the [Executor] with a list of trusted hosts for remote
-// Taskfiles. Hosts in this list will not prompt for user confirmation.
-func WithTrustedHosts(trustedHosts []string) ExecutorOption {
-	return &trustedHostsOption{trustedHosts}
-}
-
-type trustedHostsOption struct {
-	trustedHosts []string
-}
-
-func (o *trustedHostsOption) ApplyToExecutor(e *Executor) {
-	e.TrustedHosts = o.trustedHosts
-}
-
-// WithTimeout sets the [Executor]'s timeout for fetching remote taskfiles. By
-// default, the timeout is set to 10 seconds.
-func WithTimeout(timeout time.Duration) ExecutorOption {
-	return &timeoutOption{timeout}
-}
-
-type timeoutOption struct {
-	timeout time.Duration
-}
-
-func (o *timeoutOption) ApplyToExecutor(e *Executor) {
-	e.Timeout = o.timeout
-}
-
-// WithCacheExpiryDuration sets the duration after which the cache is considered
-// expired. By default, the cache is 0 (disabled).
-func WithCacheExpiryDuration(duration time.Duration) ExecutorOption {
-	return &cacheExpiryDurationOption{duration: duration}
-}
-
-type cacheExpiryDurationOption struct {
-	duration time.Duration
-}
-
-func (o *cacheExpiryDurationOption) ApplyToExecutor(r *Executor) {
-	r.CacheExpiryDuration = o.duration
-}
-
-// WithRemoteCacheDir sets the directory where remote taskfiles are cached.
-func WithRemoteCacheDir(dir string) ExecutorOption {
-	return &remoteCacheDirOption{dir: dir}
-}
-
-type remoteCacheDirOption struct {
-	dir string
-}
-
-func (o *remoteCacheDirOption) ApplyToExecutor(e *Executor) {
-	e.RemoteCacheDir = o.dir
-}
-
-// WithWatch tells the [Executor] to keep running in the background and watch
-// for changes to the fingerprint of the tasks that are run. When changes are
-// detected, a new task run is triggered.
-func WithWatch(watch bool) ExecutorOption {
-	return &watchOption{watch}
-}
-
-type watchOption struct {
-	watch bool
-}
-
-func (o *watchOption) ApplyToExecutor(e *Executor) {
-	e.Watch = o.watch
-}
-
-// WithVerbose tells the [Executor] to output more information about the tasks
-// that are run.
-func WithVerbose(verbose bool) ExecutorOption {
-	return &verboseOption{verbose}
-}
-
-type verboseOption struct {
-	verbose bool
-}
-
-func (o *verboseOption) ApplyToExecutor(e *Executor) {
-	e.Verbose = o.verbose
-}
-
-// WithSilent tells the [Executor] to suppress all output except for the output
-// of the tasks that are run.
-func WithSilent(silent bool) ExecutorOption {
-	return &silentOption{silent}
-}
-
-type silentOption struct {
-	silent bool
-}
-
-func (o *silentOption) ApplyToExecutor(e *Executor) {
-	e.Silent = o.silent
-}
-
-// WithDisableFuzzy tells the [Executor] to disable fuzzy matching for task names.
-func WithDisableFuzzy(disableFuzzy bool) ExecutorOption {
-	return &disableFuzzyOption{disableFuzzy}
-}
-
-type disableFuzzyOption struct {
-	disableFuzzy bool
-}
-
-func (o *disableFuzzyOption) ApplyToExecutor(e *Executor) {
-	e.DisableFuzzy = o.disableFuzzy
-}
-
-// WithAssumeYes tells the [Executor] to assume "yes" for all prompts.
-func WithAssumeYes(assumeYes bool) ExecutorOption {
-	return &assumeYesOption{assumeYes}
-}
-
-type assumeYesOption struct {
-	assumeYes bool
-}
-
-func (o *assumeYesOption) ApplyToExecutor(e *Executor) {
-	e.AssumeYes = o.assumeYes
-}
-
-// WithAssumeTerm is used for testing purposes to simulate a terminal.
-func WithAssumeTerm(assumeTerm bool) ExecutorOption {
-	return &assumeTermOption{assumeTerm}
-}
-
-type assumeTermOption struct {
-	assumeTerm bool
-}
-
-func (o *assumeTermOption) ApplyToExecutor(e *Executor) {
-	e.AssumeTerm = o.assumeTerm
-}
-
-// WithDry tells the [Executor] to output the commands that would be run without
-// actually running them.
-func WithDry(dry bool) ExecutorOption {
-	return &dryOption{dry}
-}
-
-type dryOption struct {
-	dry bool
-}
-
-func (o *dryOption) ApplyToExecutor(e *Executor) {
-	e.Dry = o.dry
-}
-
-// WithSummary tells the [Executor] to output a summary of the given tasks
-// instead of running them.
-func WithSummary(summary bool) ExecutorOption {
-	return &summaryOption{summary}
-}
-
-type summaryOption struct {
-	summary bool
-}
-
-func (o *summaryOption) ApplyToExecutor(e *Executor) {
-	e.Summary = o.summary
-}
-
-// WithParallel tells the [Executor] to run tasks given in the same call in
-// parallel.
-func WithParallel(parallel bool) ExecutorOption {
-	return &parallelOption{parallel}
-}
-
-type parallelOption struct {
-	parallel bool
-}
-
-func (o *parallelOption) ApplyToExecutor(e *Executor) {
-	e.Parallel = o.parallel
-}
-
-// WithColor tells the [Executor] whether or not to output using colorized
-// strings.
-func WithColor(color bool) ExecutorOption {
-	return &colorOption{color}
-}
-
-type colorOption struct {
-	color bool
-}
-
-func (o *colorOption) ApplyToExecutor(e *Executor) {
-	e.Color = o.color
-}
-
-// WithConcurrency sets the maximum number of tasks that the [Executor] can run
-// in parallel.
-func WithConcurrency(concurrency int) ExecutorOption {
-	return &concurrencyOption{concurrency}
-}
-
-type concurrencyOption struct {
-	concurrency int
-}
-
-func (o *concurrencyOption) ApplyToExecutor(e *Executor) {
-	e.Concurrency = o.concurrency
-}
-
-// WithInterval sets the interval at which the [Executor] will wait for
-// duplicated events before running a task.
-func WithInterval(interval time.Duration) ExecutorOption {
-	return &intervalOption{interval}
-}
-
-type intervalOption struct {
-	interval time.Duration
-}
-
-func (o *intervalOption) ApplyToExecutor(e *Executor) {
-	e.Interval = o.interval
-}
-
-// WithOutputStyle sets the output style of the [Executor]. By default, the
-// output style is set to the style defined in the Taskfile.
-func WithOutputStyle(outputStyle ast.Output) ExecutorOption {
-	return &outputStyleOption{outputStyle}
-}
-
-type outputStyleOption struct {
-	outputStyle ast.Output
-}
-
-func (o *outputStyleOption) ApplyToExecutor(e *Executor) {
-	e.OutputStyle = o.outputStyle
-}
-
-// WithTaskSorter sets the sorter that the [Executor] will use to sort tasks. By
-// default, the sorter is set to sort tasks alphabetically, but with tasks with
-// no namespace (in the root Taskfile) first.
-func WithTaskSorter(sorter sort.Sorter) ExecutorOption {
-	return &taskSorterOption{sorter}
-}
-
-type taskSorterOption struct {
-	sorter sort.Sorter
-}
-
-func (o *taskSorterOption) ApplyToExecutor(e *Executor) {
-	e.TaskSorter = o.sorter
-}
-
-// WithStdin sets the [Executor]'s standard input [io.Reader].
-func WithStdin(stdin io.Reader) ExecutorOption {
-	return &stdinOption{stdin}
-}
-
-type stdinOption struct {
-	stdin io.Reader
-}
-
-func (o *stdinOption) ApplyToExecutor(e *Executor) {
-	e.Stdin = o.stdin
-}
-
-// WithStdout sets the [Executor]'s standard output [io.Writer].
-func WithStdout(stdout io.Writer) ExecutorOption {
-	return &stdoutOption{stdout}
-}
-
-type stdoutOption struct {
-	stdout io.Writer
-}
-
-func (o *stdoutOption) ApplyToExecutor(e *Executor) {
-	e.Stdout = o.stdout
-}
-
-// WithStderr sets the [Executor]'s standard error [io.Writer].
-func WithStderr(stderr io.Writer) ExecutorOption {
-	return &stderrOption{stderr}
-}
-
-type stderrOption struct {
-	stderr io.Writer
-}
-
-func (o *stderrOption) ApplyToExecutor(e *Executor) {
-	e.Stderr = o.stderr
-}
-
-// WithIO sets the [Executor]'s standard input, output, and error to the same
-// [io.ReadWriter].
-func WithIO(rw io.ReadWriter) ExecutorOption {
-	return &ioOption{rw}
-}
-
-type ioOption struct {
-	rw io.ReadWriter
-}
-
-func (o *ioOption) ApplyToExecutor(e *Executor) {
-	e.Stdin = o.rw
-	e.Stdout = o.rw
-	e.Stderr = o.rw
-}
-
-// WithVersionCheck tells the [Executor] whether or not to check the version of
-func WithVersionCheck(enableVersionCheck bool) ExecutorOption {
-	return &versionCheckOption{enableVersionCheck}
-}
-
-type versionCheckOption struct {
-	enableVersionCheck bool
-}
-
-func (o *versionCheckOption) ApplyToExecutor(e *Executor) {
-	e.EnableVersionCheck = o.enableVersionCheck
-}
-
-// WithFailfast tells the [Executor] whether or not to check the version of
-func WithFailfast(failfast bool) ExecutorOption {
-	return &failfastOption{failfast}
-}
-
-type failfastOption struct {
-	failfast bool
-}
-
-func (o *failfastOption) ApplyToExecutor(e *Executor) {
-	e.Failfast = o.failfast
-}

experiments/errors.go

@@ -1,35 +0,0 @@
-package experiments
-
-import (
-	"fmt"
-	"strconv"
-	"strings"
-
-	"github.com/go-task/task/v3/internal/slicesext"
-)
-
-type InvalidValueError struct {
-	Name          string
-	AllowedValues []int
-	Value         int
-}
-
-func (err InvalidValueError) Error() string {
-	return fmt.Sprintf(
-		"task: Experiment %q has an invalid value %q (allowed values: %s)",
-		err.Name,
-		err.Value,
-		strings.Join(slicesext.Convert(err.AllowedValues, strconv.Itoa), ", "),
-	)
-}
-
-type InactiveError struct {
-	Name string
-}
-
-func (err InactiveError) Error() string {
-	return fmt.Sprintf(
-		"task: Experiment %q is inactive and cannot be enabled",
-		err.Name,
-	)
-}

experiments/experiment.go

@@ -1,67 +0,0 @@
-package experiments
-
-import (
-	"fmt"
-	"slices"
-	"strconv"
-
-	"github.com/go-task/task/v3/taskrc/ast"
-)
-
-type Experiment struct {
-	Name          string // The name of the experiment.
-	AllowedValues []int  // The values that can enable this experiment.
-	Value         int    // The version of the experiment that is enabled.
-}
-
-// New creates a new experiment with the given name and sets the values that can
-// enable it.
-func New(xName string, config *ast.TaskRC, allowedValues ...int) Experiment {
-	var value int
-	if config != nil {
-		value = config.Experiments[xName]
-	}
-
-	if value == 0 {
-		value, _ = strconv.Atoi(getEnv(xName))
-	}
-
-	x := Experiment{
-		Name:          xName,
-		AllowedValues: allowedValues,
-		Value:         value,
-	}
-	xList = append(xList, x)
-	return x
-}
-
-func (x Experiment) Enabled() bool {
-	return slices.Contains(x.AllowedValues, x.Value)
-}
-
-func (x Experiment) Active() bool {
-	return len(x.AllowedValues) > 0
-}
-
-func (x Experiment) Valid() error {
-	if !x.Active() && x.Value != 0 {
-		return &InactiveError{
-			Name: x.Name,
-		}
-	}
-	if !x.Enabled() && x.Value != 0 {
-		return &InvalidValueError{
-			Name:          x.Name,
-			AllowedValues: x.AllowedValues,
-			Value:         x.Value,
-		}
-	}
-	return nil
-}
-
-func (x Experiment) String() string {
-	if x.Enabled() {
-		return fmt.Sprintf("on (%d)", x.Value)
-	}
-	return "off"
-}

experiments/experiment_test.go

@@ -1,140 +0,0 @@
-package experiments_test
-
-import (
-	"strconv"
-	"testing"
-
-	"github.com/stretchr/testify/assert"
-
-	"github.com/go-task/task/v3/experiments"
-	"github.com/go-task/task/v3/taskrc/ast"
-)
-
-func TestNew(t *testing.T) {
-	const (
-		exampleExperiment    = "EXAMPLE"
-		exampleExperimentEnv = "TASK_X_EXAMPLE"
-	)
-	tests := []struct {
-		name          string
-		config        *ast.TaskRC
-		allowedValues []int
-		env           int
-		wantEnabled   bool
-		wantActive    bool
-		wantValid     error
-		wantValue     int
-	}{
-		{
-			name:        `[] allowed, env=""`,
-			wantEnabled: false,
-			wantActive:  false,
-		},
-		{
-			name:        `[] allowed, env="1"`,
-			env:         1,
-			wantEnabled: false,
-			wantActive:  false,
-			wantValid: &experiments.InactiveError{
-				Name: exampleExperiment,
-			},
-			wantValue: 1,
-		},
-		{
-			name:          `[1] allowed, env=""`,
-			allowedValues: []int{1},
-			wantEnabled:   false,
-			wantActive:    true,
-		},
-		{
-			name:          `[1] allowed, env="1"`,
-			allowedValues: []int{1},
-			env:           1,
-			wantEnabled:   true,
-			wantActive:    true,
-			wantValue:     1,
-		},
-		{
-			name:          `[1] allowed, env="2"`,
-			allowedValues: []int{1},
-			env:           2,
-			wantEnabled:   false,
-			wantActive:    true,
-			wantValid: &experiments.InvalidValueError{
-				Name:          exampleExperiment,
-				AllowedValues: []int{1},
-				Value:         2,
-			},
-			wantValue: 2,
-		},
-		{
-			name:          `[1, 2] allowed, env="1"`,
-			allowedValues: []int{1, 2},
-			env:           1,
-			wantEnabled:   true,
-			wantActive:    true,
-			wantValue:     1,
-		},
-		{
-			name:          `[1, 2] allowed, env="1"`,
-			allowedValues: []int{1, 2},
-			env:           2,
-			wantEnabled:   true,
-			wantActive:    true,
-			wantValue:     2,
-		},
-		{
-			name: `[1] allowed, config="1"`,
-			config: &ast.TaskRC{
-				Experiments: map[string]int{
-					exampleExperiment: 1,
-				},
-			},
-			allowedValues: []int{1},
-			wantEnabled:   true,
-			wantActive:    true,
-			wantValue:     1,
-		},
-		{
-			name: `[1] allowed, config="2"`,
-			config: &ast.TaskRC{
-				Experiments: map[string]int{
-					exampleExperiment: 2,
-				},
-			},
-			allowedValues: []int{1},
-			wantEnabled:   false,
-			wantActive:    true,
-			wantValid: &experiments.InvalidValueError{
-				Name:          exampleExperiment,
-				AllowedValues: []int{1},
-				Value:         2,
-			},
-			wantValue: 2,
-		},
-		{
-			name: `[1, 2] allowed, env="1", config="2"`,
-			config: &ast.TaskRC{
-				Experiments: map[string]int{
-					exampleExperiment: 2,
-				},
-			},
-			allowedValues: []int{1, 2},
-			env:           1,
-			wantEnabled:   true,
-			wantActive:    true,
-			wantValue:     2,
-		},
-	}
-	for _, tt := range tests {
-		t.Run(tt.name, func(t *testing.T) {
-			t.Setenv(exampleExperimentEnv, strconv.Itoa(tt.env))
-			x := experiments.New(exampleExperiment, tt.config, tt.allowedValues...)
-			assert.Equal(t, exampleExperiment, x.Name)
-			assert.Equal(t, tt.wantEnabled, x.Enabled())
-			assert.Equal(t, tt.wantActive, x.Active())
-			assert.Equal(t, tt.wantValid, x.Valid())
-			assert.Equal(t, tt.wantValue, x.Value)
-		})
-	}
-}

experiments/experiments.go

@@ -1,89 +0,0 @@
-package experiments
-
-import (
-	"fmt"
-	"os"
-	"path/filepath"
-	"strings"
-
-	"github.com/joho/godotenv"
-
-	"github.com/go-task/task/v3/taskrc"
-	"github.com/go-task/task/v3/taskrc/ast"
-)
-
-const envPrefix = "TASK_X_"
-
-// Active experiments.
-var (
-	GentleForce     Experiment
-	RemoteTaskfiles Experiment
-	EnvPrecedence   Experiment
-)
-
-// Inactive experiments. These are experiments that cannot be enabled, but are
-// preserved for error handling.
-var (
-	AnyVariables Experiment
-	MapVariables Experiment
-)
-
-// An internal list of all the initialized experiments used for iterating.
-var xList []Experiment
-
-func Parse(dir string) {
-	config, _ := taskrc.GetConfig(dir)
-	ParseWithConfig(dir, config)
-}
-
-func ParseWithConfig(dir string, config *ast.TaskRC) {
-	// Read any .env files
-	readDotEnv(dir)
-	// Initialize the experiments
-	GentleForce = New("GENTLE_FORCE", config, 1)
-	RemoteTaskfiles = New("REMOTE_TASKFILES", config, 1)
-	EnvPrecedence = New("ENV_PRECEDENCE", config, 1)
-	AnyVariables = New("ANY_VARIABLES", config)
-	MapVariables = New("MAP_VARIABLES", config)
-}
-
-// Validate checks if any experiments have been enabled while being inactive.
-// If one is found, the function returns an error.
-func Validate() error {
-	for _, x := range List() {
-		if err := x.Valid(); err != nil {
-			return err
-		}
-	}
-	return nil
-}
-
-func List() []Experiment {
-	return xList
-}
-
-func getEnv(xName string) string {
-	envName := fmt.Sprintf("%s%s", envPrefix, xName)
-	return os.Getenv(envName)
-}
-
-func getFilePath(filename, dir string) string {
-	if dir != "" {
-		return filepath.Join(dir, filename)
-	}
-	return filename
-}
-
-func readDotEnv(dir string) {
-	env, err := godotenv.Read(getFilePath(".env", dir))
-	if err != nil {
-		return
-	}
-
-	// If the env var is an experiment, set it.
-	for key, value := range env {
-		if strings.HasPrefix(key, envPrefix) {
-			os.Setenv(key, value)
-		}
-	}
-}

formatter_test.go

@@ -1,235 +0,0 @@
-package task_test
-
-import (
-	"bytes"
-	"path/filepath"
-	"testing"
-
-	"github.com/sebdah/goldie/v2"
-	"github.com/stretchr/testify/require"
-
-	"github.com/go-task/task/v3"
-	"github.com/go-task/task/v3/experiments"
-	"github.com/go-task/task/v3/taskfile/ast"
-)
-
-type (
-	// A FormatterTestOption is a function that configures an [FormatterTest].
-	FormatterTestOption interface {
-		applyToFormatterTest(*FormatterTest)
-	}
-	// A FormatterTest is a test wrapper around a [task.Executor] to make it
-	// easy to write tests for the task formatter. See [NewFormatterTest] for
-	// information on creating and running FormatterTests. These tests use
-	// fixture files to assert whether the result of the output is correct. If
-	// Task's behavior has been changed, the fixture files can be updated by
-	// running `task gen:fixtures`.
-	FormatterTest struct {
-		TaskTest
-		task           string
-		vars           map[string]any
-		executorOpts   []task.ExecutorOption
-		listOptions    task.ListOptions
-		wantSetupError bool
-		wantListError  bool
-	}
-)
-
-// NewFormatterTest sets up a new [task.Executor] with the given options and
-// runs a task with the given [FormatterTestOption]s. The output of the task is
-// written to a set of fixture files depending on the configuration of the test.
-func NewFormatterTest(t *testing.T, opts ...FormatterTestOption) {
-	t.Helper()
-	tt := &FormatterTest{
-		task: "default",
-		vars: map[string]any{},
-		TaskTest: TaskTest{
-			experiments:         map[*experiments.Experiment]int{},
-			fixtureTemplateData: map[string]any{},
-		},
-	}
-	// Apply the functional options
-	for _, opt := range opts {
-		opt.applyToFormatterTest(tt)
-	}
-	// Enable any experiments that have been set
-	for x, v := range tt.experiments {
-		prev := *x
-		*x = experiments.Experiment{
-			Name:          prev.Name,
-			AllowedValues: []int{v},
-			Value:         v,
-		}
-		t.Cleanup(func() {
-			*x = prev
-		})
-	}
-	tt.run(t)
-}
-
-// Functional options
-
-// WithListOptions sets the list options for the formatter.
-func WithListOptions(opts task.ListOptions) FormatterTestOption {
-	return &listOptionsTestOption{opts}
-}
-
-type listOptionsTestOption struct {
-	listOptions task.ListOptions
-}
-
-func (opt *listOptionsTestOption) applyToFormatterTest(t *FormatterTest) {
-	t.listOptions = opt.listOptions
-}
-
-// WithListError tells the test to expect an error when running the formatter.
-// A fixture will be created with the output of any errors.
-func WithListError() FormatterTestOption {
-	return &listErrorTestOption{}
-}
-
-type listErrorTestOption struct{}
-
-func (opt *listErrorTestOption) applyToFormatterTest(t *FormatterTest) {
-	t.wantListError = true
-}
-
-// Helpers
-
-// writeFixtureErrList is a wrapper for writing the output of an error when
-// running the formatter to a fixture file.
-func (tt *FormatterTest) writeFixtureErrList(
-	t *testing.T,
-	g *goldie.Goldie,
-	err error,
-) {
-	t.Helper()
-	tt.writeFixture(t, g, "err-list", []byte(err.Error()))
-}
-
-// run is the main function for running the test. It sets up the task executor,
-// runs the task, and writes the output to a fixture file.
-func (tt *FormatterTest) run(t *testing.T) {
-	t.Helper()
-	f := func(t *testing.T) {
-		t.Helper()
-		var buf bytes.Buffer
-
-		opts := append(
-			tt.executorOpts,
-			task.WithStdout(&buf),
-			task.WithStderr(&buf),
-		)
-
-		// Set up the task executor
-		e := task.NewExecutor(opts...)
-
-		// Create a golden fixture file for the output
-		g := goldie.New(t,
-			goldie.WithFixtureDir(filepath.Join(e.Dir, "testdata")),
-		)
-
-		// Call setup and check for errors
-		if err := e.Setup(); tt.wantSetupError {
-			require.Error(t, err)
-			tt.writeFixtureErrSetup(t, g, err)
-			tt.writeFixtureBuffer(t, g, buf)
-			return
-		} else {
-			require.NoError(t, err)
-		}
-
-		// Create the task call
-		vars := ast.NewVars()
-		for key, value := range tt.vars {
-			vars.Set(key, ast.Var{Value: value})
-		}
-
-		// Run the formatter and check for errors
-		if _, err := e.ListTasks(tt.listOptions); tt.wantListError {
-			require.Error(t, err)
-			tt.writeFixtureErrList(t, g, err)
-			tt.writeFixtureBuffer(t, g, buf)
-			return
-		} else {
-			require.NoError(t, err)
-		}
-
-		tt.writeFixtureBuffer(t, g, buf)
-	}
-
-	// Run the test (with a name if it has one)
-	if tt.name != "" {
-		t.Run(tt.name, f)
-	} else {
-		f(t)
-	}
-}
-
-func TestNoLabelInList(t *testing.T) {
-	t.Parallel()
-
-	NewFormatterTest(t,
-		WithExecutorOptions(
-			task.WithDir("testdata/label_list"),
-		),
-		WithListOptions(task.ListOptions{
-			ListOnlyTasksWithDescriptions: true,
-		}),
-	)
-}
-
-// task -al case 1: listAll list all tasks
-func TestListAllShowsNoDesc(t *testing.T) {
-	t.Parallel()
-
-	NewFormatterTest(t,
-		WithExecutorOptions(
-			task.WithDir("testdata/list_mixed_desc"),
-		),
-		WithListOptions(task.ListOptions{
-			ListAllTasks: true,
-		}),
-	)
-}
-
-// task -al case 2: !listAll list some tasks (only those with desc)
-func TestListCanListDescOnly(t *testing.T) {
-	t.Parallel()
-
-	NewFormatterTest(t,
-		WithExecutorOptions(
-			task.WithDir("testdata/list_mixed_desc"),
-		),
-		WithListOptions(task.ListOptions{
-			ListOnlyTasksWithDescriptions: true,
-		}),
-	)
-}
-
-func TestListDescInterpolation(t *testing.T) {
-	t.Parallel()
-
-	NewFormatterTest(t,
-		WithExecutorOptions(
-			task.WithDir("testdata/list_desc_interpolation"),
-		),
-		WithListOptions(task.ListOptions{
-			ListOnlyTasksWithDescriptions: true,
-		}),
-	)
-}
-
-func TestJsonListFormat(t *testing.T) {
-	t.Parallel()
-
-	NewFormatterTest(t,
-		WithExecutorOptions(
-			task.WithDir("testdata/json_list_format"),
-		),
-		WithListOptions(task.ListOptions{
-			FormatTaskListAsJSON: true,
-		}),
-		WithFixtureTemplating(),
-	)
-}

go.mod

@@ -1,93 +1,27 @@
 module github.com/go-task/task/v3
 
-go 1.24.0
-
 require (
-	github.com/Ladicle/tabwriter v1.0.0
-	github.com/Masterminds/semver/v3 v3.4.0
-	github.com/alecthomas/chroma/v2 v2.20.0
-	github.com/chainguard-dev/git-urls v1.0.2
-	github.com/davecgh/go-spew v1.1.1
-	github.com/dominikbraun/graph v0.23.0
-	github.com/elliotchance/orderedmap/v3 v3.1.0
-	github.com/fatih/color v1.18.0
-	github.com/fsnotify/fsnotify v1.9.0
-	github.com/go-task/slim-sprig/v3 v3.0.0
-	github.com/go-task/template v0.2.0
-	github.com/google/uuid v1.6.0
-	github.com/hashicorp/go-getter v1.8.3
-	github.com/joho/godotenv v1.5.1
+	github.com/fatih/color v1.13.0
+	github.com/go-task/slim-sprig v0.0.0-20210107165309-348f09dbbbc0
+	github.com/joho/godotenv v1.4.0
+	github.com/mattn/go-zglob v0.0.3
 	github.com/mitchellh/hashstructure/v2 v2.0.2
-	github.com/puzpuzpuz/xsync/v4 v4.2.0
-	github.com/sajari/fuzzy v1.0.0
-	github.com/sebdah/goldie/v2 v2.8.0
-	github.com/spf13/pflag v1.0.10
-	github.com/stretchr/testify v1.11.1
-	github.com/zeebo/xxh3 v1.0.2
-	go.yaml.in/yaml/v4 v4.0.0-rc.3
-	golang.org/x/sync v0.19.0
-	golang.org/x/term v0.38.0
-	mvdan.cc/sh/moreinterp v0.0.0-20251109230715-65adef8e2c5b
-	mvdan.cc/sh/v3 v3.12.0
+	github.com/radovskyb/watcher v1.0.7
+	github.com/spf13/pflag v1.0.5
+	github.com/stretchr/testify v1.8.0
+	golang.org/x/sync v0.0.0-20210220032951-036812b2e83c
+	gopkg.in/yaml.v3 v3.0.1
+	mvdan.cc/sh/v3 v3.6.0-0.dev.0.20220704111049-a6e3029cd899
 )
 
 require (
-	cloud.google.com/go v0.110.0 // indirect
-	cloud.google.com/go/compute/metadata v0.3.0 // indirect
-	cloud.google.com/go/iam v0.13.0 // indirect
-	cloud.google.com/go/storage v1.29.0 // indirect
-	github.com/aws/aws-sdk-go-v2 v1.36.3 // indirect
-	github.com/aws/aws-sdk-go-v2/aws/protocol/eventstream v1.6.10 // indirect
-	github.com/aws/aws-sdk-go-v2/config v1.29.15 // indirect
-	github.com/aws/aws-sdk-go-v2/credentials v1.17.68 // indirect
-	github.com/aws/aws-sdk-go-v2/feature/ec2/imds v1.16.30 // indirect
-	github.com/aws/aws-sdk-go-v2/internal/configsources v1.3.34 // indirect
-	github.com/aws/aws-sdk-go-v2/internal/endpoints/v2 v2.6.34 // indirect
-	github.com/aws/aws-sdk-go-v2/internal/ini v1.8.3 // indirect
-	github.com/aws/aws-sdk-go-v2/internal/v4a v1.3.34 // indirect
-	github.com/aws/aws-sdk-go-v2/service/internal/accept-encoding v1.12.3 // indirect
-	github.com/aws/aws-sdk-go-v2/service/internal/checksum v1.7.2 // indirect
-	github.com/aws/aws-sdk-go-v2/service/internal/presigned-url v1.12.15 // indirect
-	github.com/aws/aws-sdk-go-v2/service/internal/s3shared v1.18.15 // indirect
-	github.com/aws/aws-sdk-go-v2/service/s3 v1.80.1 // indirect
-	github.com/aws/aws-sdk-go-v2/service/sso v1.25.3 // indirect
-	github.com/aws/aws-sdk-go-v2/service/ssooidc v1.30.1 // indirect
-	github.com/aws/aws-sdk-go-v2/service/sts v1.33.20 // indirect
-	github.com/aws/smithy-go v1.22.3 // indirect
-	github.com/bgentry/go-netrc v0.0.0-20140422174119-9fd32a8b3d3d // indirect
-	github.com/dlclark/regexp2 v1.11.5 // indirect
-	github.com/dustin/go-humanize v1.0.1 // indirect
-	github.com/golang/groupcache v0.0.0-20241129210726-2c02b8208cf8 // indirect
-	github.com/golang/protobuf v1.5.4 // indirect
-	github.com/google/go-cmp v0.7.0 // indirect
-	github.com/googleapis/enterprise-certificate-proxy v0.2.3 // indirect
-	github.com/googleapis/gax-go/v2 v2.7.1 // indirect
-	github.com/hashicorp/aws-sdk-go-base/v2 v2.0.0-beta.65 // indirect
-	github.com/hashicorp/go-cleanhttp v0.5.2 // indirect
-	github.com/hashicorp/go-version v1.6.0 // indirect
-	github.com/klauspost/compress v1.18.0 // indirect
-	github.com/klauspost/cpuid/v2 v2.2.7 // indirect
-	github.com/klauspost/pgzip v1.2.6 // indirect
-	github.com/mattn/go-colorable v0.1.14 // indirect
-	github.com/mattn/go-isatty v0.0.20 // indirect
-	github.com/mitchellh/go-homedir v1.1.0 // indirect
-	github.com/pierrec/lz4/v4 v4.1.22 // indirect
+	github.com/davecgh/go-spew v1.1.1 // indirect
+	github.com/mattn/go-colorable v0.1.9 // indirect
+	github.com/mattn/go-isatty v0.0.14 // indirect
 	github.com/pmezard/go-difflib v1.0.0 // indirect
-	github.com/sergi/go-diff v1.3.2-0.20230802210424-5b0b94c5c0d3 // indirect
-	github.com/stretchr/objx v0.5.2 // indirect
-	github.com/u-root/u-root v0.15.1-0.20251014130006-62f7144b33da // indirect
-	github.com/u-root/uio v0.0.0-20240224005618-d2acac8f3701 // indirect
-	github.com/ulikunitz/xz v0.5.15 // indirect
-	go.opencensus.io v0.24.0 // indirect
-	golang.org/x/net v0.47.0 // indirect
-	golang.org/x/oauth2 v0.27.0 // indirect
-	golang.org/x/sys v0.39.0 // indirect
-	golang.org/x/text v0.31.0 // indirect
-	golang.org/x/xerrors v0.0.0-20220907171357-04be3eba64a2 // indirect
-	google.golang.org/api v0.114.0 // indirect
-	google.golang.org/appengine v1.6.7 // indirect
-	google.golang.org/genproto v0.0.0-20230410155749-daa745c078e1 // indirect
-	google.golang.org/grpc v1.56.3 // indirect
-	google.golang.org/protobuf v1.33.0 // indirect
-	gopkg.in/yaml.v3 v3.0.1 // indirect
+	golang.org/x/sys v0.0.0-20220715151400-c0bba94af5f8 // indirect
+	golang.org/x/term v0.0.0-20210927222741-03fcf44c2211 // indirect
+	gopkg.in/check.v1 v1.0.0-20180628173108-788fd7840127 // indirect
 )
+
+go 1.18

go.sum

@@ -1,293 +1,55 @@
-cloud.google.com/go v0.26.0/go.mod h1:aQUYkXzVsufM+DwF1aE+0xfcU+56JwCaLick0ClmMTw=
-cloud.google.com/go v0.110.0 h1:Zc8gqp3+a9/Eyph2KDmcGaPtbKRIoqq4YTlL4NMD0Ys=
-cloud.google.com/go v0.110.0/go.mod h1:SJnCLqQ0FCFGSZMUNUf84MV3Aia54kn7pi8st7tMzaY=
-cloud.google.com/go/compute/metadata v0.3.0 h1:Tz+eQXMEqDIKRsmY3cHTL6FVaynIjX2QxYC4trgAKZc=
-cloud.google.com/go/compute/metadata v0.3.0/go.mod h1:zFmK7XCadkQkj6TtorcaGlCW1hT1fIilQDwofLpJ20k=
-cloud.google.com/go/iam v0.13.0 h1:+CmB+K0J/33d0zSQ9SlFWUeCCEn5XJA0ZMZ3pHE9u8k=
-cloud.google.com/go/iam v0.13.0/go.mod h1:ljOg+rcNfzZ5d6f1nAUJ8ZIxOaZUVoS14bKCtaLZ/D0=
-cloud.google.com/go/longrunning v0.4.1 h1:v+yFJOfKC3yZdY6ZUI933pIYdhyhV8S3NpWrXWmg7jM=
-cloud.google.com/go/longrunning v0.4.1/go.mod h1:4iWDqhBZ70CvZ6BfETbvam3T8FMvLK+eFj0E6AaRQTo=
-cloud.google.com/go/storage v1.29.0 h1:6weCgzRvMg7lzuUurI4697AqIRPU1SvzHhynwpW31jI=
-cloud.google.com/go/storage v1.29.0/go.mod h1:4puEjyTKnku6gfKoTfNOU/W+a9JyuVNxjpS5GBrB8h4=
-github.com/BurntSushi/toml v0.3.1/go.mod h1:xHWCNGjB5oqiDr8zfno3MHue2Ht5sIBksp03qcyfWMU=
-github.com/Ladicle/tabwriter v1.0.0 h1:DZQqPvMumBDwVNElso13afjYLNp0Z7pHqHnu0r4t9Dg=
-github.com/Ladicle/tabwriter v1.0.0/go.mod h1:c4MdCjxQyTbGuQO/gvqJ+IA/89UEwrsD6hUCW98dyp4=
-github.com/Masterminds/semver/v3 v3.4.0 h1:Zog+i5UMtVoCU8oKka5P7i9q9HgrJeGzI9SA1Xbatp0=
-github.com/Masterminds/semver/v3 v3.4.0/go.mod h1:4V+yj/TJE1HU9XfppCwVMZq3I84lprf4nC11bSS5beM=
-github.com/alecthomas/assert/v2 v2.11.0 h1:2Q9r3ki8+JYXvGsDyBXwH3LcJ+WK5D0gc5E8vS6K3D0=
-github.com/alecthomas/assert/v2 v2.11.0/go.mod h1:Bze95FyfUr7x34QZrjL+XP+0qgp/zg8yS+TtBj1WA3k=
-github.com/alecthomas/chroma/v2 v2.20.0 h1:sfIHpxPyR07/Oylvmcai3X/exDlE8+FA820NTz+9sGw=
-github.com/alecthomas/chroma/v2 v2.20.0/go.mod h1:e7tViK0xh/Nf4BYHl00ycY6rV7b8iXBksI9E359yNmA=
-github.com/alecthomas/repr v0.5.1 h1:E3G4t2QbHTSNpPKBgMTln5KLkZHLOcU7r37J4pXBuIg=
-github.com/alecthomas/repr v0.5.1/go.mod h1:Fr0507jx4eOXV7AlPV6AVZLYrLIuIeSOWtW57eE/O/4=
-github.com/aws/aws-sdk-go-v2 v1.36.3 h1:mJoei2CxPutQVxaATCzDUjcZEjVRdpsiiXi2o38yqWM=
-github.com/aws/aws-sdk-go-v2 v1.36.3/go.mod h1:LLXuLpgzEbD766Z5ECcRmi8AzSwfZItDtmABVkRLGzg=
-github.com/aws/aws-sdk-go-v2/aws/protocol/eventstream v1.6.10 h1:zAybnyUQXIZ5mok5Jqwlf58/TFE7uvd3IAsa1aF9cXs=
-github.com/aws/aws-sdk-go-v2/aws/protocol/eventstream v1.6.10/go.mod h1:qqvMj6gHLR/EXWZw4ZbqlPbQUyenf4h82UQUlKc+l14=
-github.com/aws/aws-sdk-go-v2/config v1.29.15 h1:I5XjesVMpDZXZEZonVfjI12VNMrYa38LtLnw4NtY5Ss=
-github.com/aws/aws-sdk-go-v2/config v1.29.15/go.mod h1:tNIp4JIPonlsgaO5hxO372a6gjhN63aSWl2GVl5QoBQ=
-github.com/aws/aws-sdk-go-v2/credentials v1.17.68 h1:cFb9yjI02/sWHBSYXAtkamjzCuRymvmeFmt0TC0MbYY=
-github.com/aws/aws-sdk-go-v2/credentials v1.17.68/go.mod h1:H6E+jBzyqUu8u0vGaU6POkK3P0NylYEeRZ6ynBpMqIk=
-github.com/aws/aws-sdk-go-v2/feature/ec2/imds v1.16.30 h1:x793wxmUWVDhshP8WW2mlnXuFrO4cOd3HLBroh1paFw=
-github.com/aws/aws-sdk-go-v2/feature/ec2/imds v1.16.30/go.mod h1:Jpne2tDnYiFascUEs2AWHJL9Yp7A5ZVy3TNyxaAjD6M=
-github.com/aws/aws-sdk-go-v2/internal/configsources v1.3.34 h1:ZK5jHhnrioRkUNOc+hOgQKlUL5JeC3S6JgLxtQ+Rm0Q=
-github.com/aws/aws-sdk-go-v2/internal/configsources v1.3.34/go.mod h1:p4VfIceZokChbA9FzMbRGz5OV+lekcVtHlPKEO0gSZY=
-github.com/aws/aws-sdk-go-v2/internal/endpoints/v2 v2.6.34 h1:SZwFm17ZUNNg5Np0ioo/gq8Mn6u9w19Mri8DnJ15Jf0=
-github.com/aws/aws-sdk-go-v2/internal/endpoints/v2 v2.6.34/go.mod h1:dFZsC0BLo346mvKQLWmoJxT+Sjp+qcVR1tRVHQGOH9Q=
-github.com/aws/aws-sdk-go-v2/internal/ini v1.8.3 h1:bIqFDwgGXXN1Kpp99pDOdKMTTb5d2KyU5X/BZxjOkRo=
-github.com/aws/aws-sdk-go-v2/internal/ini v1.8.3/go.mod h1:H5O/EsxDWyU+LP/V8i5sm8cxoZgc2fdNR9bxlOFrQTo=
-github.com/aws/aws-sdk-go-v2/internal/v4a v1.3.34 h1:ZNTqv4nIdE/DiBfUUfXcLZ/Spcuz+RjeziUtNJackkM=
-github.com/aws/aws-sdk-go-v2/internal/v4a v1.3.34/go.mod h1:zf7Vcd1ViW7cPqYWEHLHJkS50X0JS2IKz9Cgaj6ugrs=
-github.com/aws/aws-sdk-go-v2/service/internal/accept-encoding v1.12.3 h1:eAh2A4b5IzM/lum78bZ590jy36+d/aFLgKF/4Vd1xPE=
-github.com/aws/aws-sdk-go-v2/service/internal/accept-encoding v1.12.3/go.mod h1:0yKJC/kb8sAnmlYa6Zs3QVYqaC8ug2AbnNChv5Ox3uA=
-github.com/aws/aws-sdk-go-v2/service/internal/checksum v1.7.2 h1:BCG7DCXEXpNCcpwCxg1oi9pkJWH2+eZzTn9MY56MbVw=
-github.com/aws/aws-sdk-go-v2/service/internal/checksum v1.7.2/go.mod h1:iu6FSzgt+M2/x3Dk8zhycdIcHjEFb36IS8HVUVFoMg0=
-github.com/aws/aws-sdk-go-v2/service/internal/presigned-url v1.12.15 h1:dM9/92u2F1JbDaGooxTq18wmmFzbJRfXfVfy96/1CXM=
-github.com/aws/aws-sdk-go-v2/service/internal/presigned-url v1.12.15/go.mod h1:SwFBy2vjtA0vZbjjaFtfN045boopadnoVPhu4Fv66vY=
-github.com/aws/aws-sdk-go-v2/service/internal/s3shared v1.18.15 h1:moLQUoVq91LiqT1nbvzDukyqAlCv89ZmwaHw/ZFlFZg=
-github.com/aws/aws-sdk-go-v2/service/internal/s3shared v1.18.15/go.mod h1:ZH34PJUc8ApjBIfgQCFvkWcUDBtl/WTD+uiYHjd8igA=
-github.com/aws/aws-sdk-go-v2/service/s3 v1.80.1 h1:xYEAf/6QHiTZDccKnPMbsMwlau13GsDsTgdue3wmHGw=
-github.com/aws/aws-sdk-go-v2/service/s3 v1.80.1/go.mod h1:qbn305Je/IofWBJ4bJz/Q7pDEtnnoInw/dGt71v6rHE=
-github.com/aws/aws-sdk-go-v2/service/sso v1.25.3 h1:1Gw+9ajCV1jogloEv1RRnvfRFia2cL6c9cuKV2Ps+G8=
-github.com/aws/aws-sdk-go-v2/service/sso v1.25.3/go.mod h1:qs4a9T5EMLl/Cajiw2TcbNt2UNo/Hqlyp+GiuG4CFDI=
-github.com/aws/aws-sdk-go-v2/service/ssooidc v1.30.1 h1:hXmVKytPfTy5axZ+fYbR5d0cFmC3JvwLm5kM83luako=
-github.com/aws/aws-sdk-go-v2/service/ssooidc v1.30.1/go.mod h1:MlYRNmYu/fGPoxBQVvBYr9nyr948aY/WLUvwBMBJubs=
-github.com/aws/aws-sdk-go-v2/service/sts v1.33.20 h1:oIaQ1e17CSKaWmUTu62MtraRWVIosn/iONMuZt0gbqc=
-github.com/aws/aws-sdk-go-v2/service/sts v1.33.20/go.mod h1:cQnB8CUnxbMU82JvlqjKR2HBOm3fe9pWorWBza6MBJ4=
-github.com/aws/smithy-go v1.22.3 h1:Z//5NuZCSW6R4PhQ93hShNbyBbn8BWCmCVCt+Q8Io5k=
-github.com/aws/smithy-go v1.22.3/go.mod h1:t1ufH5HMublsJYulve2RKmHDC15xu1f26kHCp/HgceI=
-github.com/bgentry/go-netrc v0.0.0-20140422174119-9fd32a8b3d3d h1:xDfNPAt8lFiC1UJrqV3uuy861HCTo708pDMbjHHdCas=
-github.com/bgentry/go-netrc v0.0.0-20140422174119-9fd32a8b3d3d/go.mod h1:6QX/PXZ00z/TKoufEY6K/a0k6AhaJrQKdFe6OfVXsa4=
-github.com/census-instrumentation/opencensus-proto v0.2.1/go.mod h1:f6KPmirojxKA12rnyqOA5BBL4O983OfeGPqjHWSTneU=
-github.com/chainguard-dev/git-urls v1.0.2 h1:pSpT7ifrpc5X55n4aTTm7FFUE+ZQHKiqpiwNkJrVcKQ=
-github.com/chainguard-dev/git-urls v1.0.2/go.mod h1:rbGgj10OS7UgZlbzdUQIQpT0k/D4+An04HJY7Ol+Y/o=
-github.com/client9/misspell v0.3.4/go.mod h1:qj6jICC3Q7zFZvVWo7KLAzC3yx5G7kyvSDkc90ppPyw=
-github.com/cncf/udpa/go v0.0.0-20191209042840-269d4d468f6f/go.mod h1:M8M6+tZqaGXZJjfX53e64911xZQV5JYwmTeXPW+k8Sc=
-github.com/creack/pty v1.1.24 h1:bJrF4RRfyJnbTJqzRLHzcGaZK1NeM5kTC9jGgovnR1s=
-github.com/creack/pty v1.1.24/go.mod h1:08sCNb52WyoAwi2QDyzUCTgcvVFhUzewun7wtTfvcwE=
+github.com/creack/pty v1.1.17 h1:QeVUsEDNrLBW4tMgZHvxy18sKtr6VI492kBhUfhDJNI=
 github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
 github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
 github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
-github.com/dlclark/regexp2 v1.11.5 h1:Q/sSnsKerHeCkc/jSTNq1oCm7KiVgUMZRDUoRu0JQZQ=
-github.com/dlclark/regexp2 v1.11.5/go.mod h1:DHkYz0B9wPfa6wondMfaivmHpzrQ3v9q8cnmRbL6yW8=
-github.com/dominikbraun/graph v0.23.0 h1:TdZB4pPqCLFxYhdyMFb1TBdFxp8XLcJfTTBQucVPgCo=
-github.com/dominikbraun/graph v0.23.0/go.mod h1:yOjYyogZLY1LSG9E33JWZJiq5k83Qy2C6POAuiViluc=
-github.com/dustin/go-humanize v1.0.1 h1:GzkhY7T5VNhEkwH0PVJgjz+fX1rhBrR7pRT3mDkpeCY=
-github.com/dustin/go-humanize v1.0.1/go.mod h1:Mu1zIs6XwVuF/gI1OepvI0qD18qycQx+mFykh5fBlto=
-github.com/elliotchance/orderedmap/v3 v3.1.0 h1:j4DJ5ObEmMBt/lcwIecKcoRxIQUEnw0L804lXYDt/pg=
-github.com/elliotchance/orderedmap/v3 v3.1.0/go.mod h1:G+Hc2RwaZvJMcS4JpGCOyViCnGeKf0bTYCGTO4uhjSo=
-github.com/envoyproxy/go-control-plane v0.9.0/go.mod h1:YTl/9mNaCwkRvm6d1a2C3ymFceY/DCBVvsKhRF0iEA4=
-github.com/envoyproxy/go-control-plane v0.9.1-0.20191026205805-5f8ba28d4473/go.mod h1:YTl/9mNaCwkRvm6d1a2C3ymFceY/DCBVvsKhRF0iEA4=
-github.com/envoyproxy/go-control-plane v0.9.4/go.mod h1:6rpuAdCZL397s3pYoYcLgu1mIlRU8Am5FuJP05cCM98=
-github.com/envoyproxy/protoc-gen-validate v0.1.0/go.mod h1:iSmxcyjqTsJpI2R4NaDN7+kN2VEUnK/pcBlmesArF7c=
-github.com/fatih/color v1.18.0 h1:S8gINlzdQ840/4pfAwic/ZE0djQEH3wM94VfqLTZcOM=
-github.com/fatih/color v1.18.0/go.mod h1:4FelSpRwEGDpQ12mAdzqdOukCy4u8WUtOY6lkT/6HfU=
-github.com/fsnotify/fsnotify v1.9.0 h1:2Ml+OJNzbYCTzsxtv8vKSFD9PbJjmhYF14k/jKC7S9k=
-github.com/fsnotify/fsnotify v1.9.0/go.mod h1:8jBTzvmWwFyi3Pb8djgCCO5IBqzKJ/Jwo8TRcHyHii0=
-github.com/go-quicktest/qt v1.101.0 h1:O1K29Txy5P2OK0dGo59b7b0LR6wKfIhttaAhHUyn7eI=
-github.com/go-quicktest/qt v1.101.0/go.mod h1:14Bz/f7NwaXPtdYEgzsx46kqSxVwTbzVZsDC26tQJow=
-github.com/go-task/slim-sprig/v3 v3.0.0 h1:sUs3vkvUymDpBKi3qH1YSqBQk9+9D/8M2mN1vB6EwHI=
-github.com/go-task/slim-sprig/v3 v3.0.0/go.mod h1:W848ghGpv3Qj3dhTPRyJypKRiqCdHZiAzKg9hl15HA8=
-github.com/go-task/template v0.2.0 h1:xW7ek0o65FUSTbKcSNeg2Vyf/I7wYXFgLUznptvviBE=
-github.com/go-task/template v0.2.0/go.mod h1:dbdoUb6qKnHQi1y6o+IdIrs0J4o/SEhSTA6bbzZmdtc=
-github.com/golang/glog v0.0.0-20160126235308-23def4e6c14b/go.mod h1:SBH7ygxi8pfUlaOkMMuAQtPIUF8ecWP5IEl/CR7VP2Q=
-github.com/golang/groupcache v0.0.0-20200121045136-8c9f03a8e57e/go.mod h1:cIg4eruTrX1D+g88fzRXU5OdNfaM+9IcxsU14FzY7Hc=
-github.com/golang/groupcache v0.0.0-20241129210726-2c02b8208cf8 h1:f+oWsMOmNPc8JmEHVZIycC7hBoQxHH9pNKQORJNozsQ=
-github.com/golang/groupcache v0.0.0-20241129210726-2c02b8208cf8/go.mod h1:wcDNUvekVysuuOpQKo3191zZyTpiI6se1N1ULghS0sw=
-github.com/golang/mock v1.1.1/go.mod h1:oTYuIxOrZwtPieC+H1uAHpcLFnEyAGVDL/k47Jfbm0A=
-github.com/golang/protobuf v1.2.0/go.mod h1:6lQm79b+lXiMfvg/cZm0SGofjICqVBUtrP5yJMmIC1U=
-github.com/golang/protobuf v1.3.1/go.mod h1:6lQm79b+lXiMfvg/cZm0SGofjICqVBUtrP5yJMmIC1U=
-github.com/golang/protobuf v1.3.2/go.mod h1:6lQm79b+lXiMfvg/cZm0SGofjICqVBUtrP5yJMmIC1U=
-github.com/golang/protobuf v1.4.0-rc.1/go.mod h1:ceaxUfeHdC40wWswd/P6IGgMaK3YpKi5j83Wpe3EHw8=
-github.com/golang/protobuf v1.4.0-rc.1.0.20200221234624-67d41d38c208/go.mod h1:xKAWHe0F5eneWXFV3EuXVDTCmh+JuBKY0li0aMyXATA=
-github.com/golang/protobuf v1.4.0-rc.2/go.mod h1:LlEzMj4AhA7rCAGe4KMBDvJI+AwstrUpVNzEA03Pprs=
-github.com/golang/protobuf v1.4.0-rc.4.0.20200313231945-b860323f09d0/go.mod h1:WU3c8KckQ9AFe+yFwt9sWVRKCVIyN9cPHBJSNnbL67w=
-github.com/golang/protobuf v1.4.0/go.mod h1:jodUvKwWbYaEsadDk5Fwe5c77LiNKVO9IDvqG2KuDX0=
-github.com/golang/protobuf v1.4.1/go.mod h1:U8fpvMrcmy5pZrNK1lt4xCsGvpyWQ/VVv6QDs8UjoX8=
-github.com/golang/protobuf v1.4.3/go.mod h1:oDoupMAO8OvCJWAcko0GGGIgR6R6ocIYbsSw735rRwI=
-github.com/golang/protobuf v1.5.4 h1:i7eJL8qZTpSEXOPTxNKhASYpMn+8e5Q6AdndVa1dWek=
-github.com/golang/protobuf v1.5.4/go.mod h1:lnTiLA8Wa4RWRcIUkrtSVa5nRhsEGBg48fD6rSs7xps=
-github.com/google/go-cmp v0.2.0/go.mod h1:oXzfMopK8JAjlY9xF4vHSVASa0yLyX7SntLO5aqRK0M=
-github.com/google/go-cmp v0.3.0/go.mod h1:8QqcDgzrUqlUb/G2PQTWiueGozuR1884gddMywk6iLU=
-github.com/google/go-cmp v0.3.1/go.mod h1:8QqcDgzrUqlUb/G2PQTWiueGozuR1884gddMywk6iLU=
-github.com/google/go-cmp v0.4.0/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE=
-github.com/google/go-cmp v0.5.0/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE=
-github.com/google/go-cmp v0.5.3/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE=
-github.com/google/go-cmp v0.7.0 h1:wk8382ETsv4JYUZwIsn6YpYiWiBsYLSJiTsyBybVuN8=
-github.com/google/go-cmp v0.7.0/go.mod h1:pXiqmnSA92OHEEa9HXL2W4E7lf9JzCmGVUdgjX3N/iU=
-github.com/google/martian/v3 v3.3.2 h1:IqNFLAmvJOgVlpdEBiQbDc2EwKW77amAycfTuWKdfvw=
-github.com/google/martian/v3 v3.3.2/go.mod h1:oBOf6HBosgwRXnUGWUB05QECsc6uvmMiJ3+6W4l/CUk=
-github.com/google/uuid v1.1.2/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo=
-github.com/google/uuid v1.6.0 h1:NIvaJDMOsjHA8n1jAhLSgzrAzy1Hgr+hNrb57e+94F0=
-github.com/google/uuid v1.6.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo=
-github.com/googleapis/enterprise-certificate-proxy v0.2.3 h1:yk9/cqRKtT9wXZSsRH9aurXEpJX+U6FLtpYTdC3R06k=
-github.com/googleapis/enterprise-certificate-proxy v0.2.3/go.mod h1:AwSRAtLfXpU5Nm3pW+v7rGDHp09LsPtGY9MduiEsR9k=
-github.com/googleapis/gax-go/v2 v2.7.1 h1:gF4c0zjUP2H/s/hEGyLA3I0fA2ZWjzYiONAD6cvPr8A=
-github.com/googleapis/gax-go/v2 v2.7.1/go.mod h1:4orTrqY6hXxxaUL4LHIPl6lGo8vAE38/qKbhSAKP6QI=
-github.com/hashicorp/aws-sdk-go-base/v2 v2.0.0-beta.65 h1:81+kWbE1yErFBMjME0I5k3x3kojjKsWtPYHEAutoPow=
-github.com/hashicorp/aws-sdk-go-base/v2 v2.0.0-beta.65/go.mod h1:WtMzv9T++tfWVea+qB2MXoaqxw33S8bpJslzUike2mQ=
-github.com/hashicorp/go-cleanhttp v0.5.2 h1:035FKYIWjmULyFRBKPs8TBQoi0x6d9G4xc9neXJWAZQ=
-github.com/hashicorp/go-cleanhttp v0.5.2/go.mod h1:kO/YDlP8L1346E6Sodw+PrpBSV4/SoxCXGY6BqNFT48=
-github.com/hashicorp/go-getter v1.8.3 h1:gIS+oTNv3kyYAvlUVgMR46MiG0bM0KuSON/KZEvRoRg=
-github.com/hashicorp/go-getter v1.8.3/go.mod h1:CUTt9x2bCtJ/sV8ihgrITL3IUE+0BE1j/e4n5P/GIM4=
-github.com/hashicorp/go-version v1.6.0 h1:feTTfFNnjP967rlCxM/I9g701jU+RN74YKx2mOkIeek=
-github.com/hashicorp/go-version v1.6.0/go.mod h1:fltr4n8CU8Ke44wwGCBoEymUuxUHl09ZGVZPK5anwXA=
-github.com/hexops/gotextdiff v1.0.3 h1:gitA9+qJrrTCsiCl7+kh75nPqQt1cx4ZkudSTLoUqJM=
-github.com/hexops/gotextdiff v1.0.3/go.mod h1:pSWU5MAI3yDq+fZBTazCSJysOMbxWL1BSow5/V2vxeg=
-github.com/joho/godotenv v1.5.1 h1:7eLL/+HRGLY0ldzfGMeQkb7vMd0as4CfYvUVzLqw0N0=
-github.com/joho/godotenv v1.5.1/go.mod h1:f4LDr5Voq0i2e/R5DDNOoa2zzDfwtkZa6DnEwAbqwq4=
-github.com/klauspost/compress v1.18.0 h1:c/Cqfb0r+Yi+JtIEq73FWXVkRonBlf0CRNYc8Zttxdo=
-github.com/klauspost/compress v1.18.0/go.mod h1:2Pp+KzxcywXVXMr50+X0Q/Lsb43OQHYWRCY2AiWywWQ=
-github.com/klauspost/cpuid/v2 v2.2.7 h1:ZWSB3igEs+d0qvnxR/ZBzXVmxkgt8DdzP6m9pfuVLDM=
-github.com/klauspost/cpuid/v2 v2.2.7/go.mod h1:Lcz8mBdAVJIBVzewtcLocK12l3Y+JytZYpaMropDUws=
-github.com/klauspost/pgzip v1.2.6 h1:8RXeL5crjEUFnR2/Sn6GJNWtSQ3Dk8pq4CL3jvdDyjU=
-github.com/klauspost/pgzip v1.2.6/go.mod h1:Ch1tH69qFZu15pkjo5kYi6mth2Zzwzt50oCQKQE9RUs=
-github.com/kr/pretty v0.1.0/go.mod h1:dAy3ld7l9f0ibDNOQOHHMYYIIbhfbHSm3C4ZsoJORNo=
-github.com/kr/pretty v0.3.1 h1:flRD4NNwYAUpkphVc1HcthR4KEIFJ65n8Mw5qdRn3LE=
-github.com/kr/pretty v0.3.1/go.mod h1:hoEshYVHaxMs3cyo3Yncou5ZscifuDolrwPKZanG3xk=
-github.com/kr/pty v1.1.1/go.mod h1:pFQYn66WHrOpPYNljwOMqo10TkYh1fy3cYio2l3bCsQ=
-github.com/kr/text v0.1.0/go.mod h1:4Jbv+DJW3UT/LiOwJeYQe1efqtUx/iVham/4vfdArNI=
+github.com/fatih/color v1.13.0 h1:8LOYc1KYPPmyKMuN8QV2DNRWNbLo6LZ0iLs8+mlH53w=
+github.com/fatih/color v1.13.0/go.mod h1:kLAiJbzzSOZDVNGyDpeOxJ47H46qBXwg5ILebYFFOfk=
+github.com/frankban/quicktest v1.14.0 h1:+cqqvzZV87b4adx/5ayVOaYZ2CrvM4ejQvUdBzPPUss=
+github.com/go-task/slim-sprig v0.0.0-20210107165309-348f09dbbbc0 h1:p104kn46Q8WdvHunIJ9dAyjPVtrBPhSr3KT2yUst43I=
+github.com/go-task/slim-sprig v0.0.0-20210107165309-348f09dbbbc0/go.mod h1:fyg7847qk6SyHyPtNmDHnmrv/HOrqktSC+C9fM+CJOE=
+github.com/google/go-cmp v0.5.6 h1:BKbKCqvP6I+rmFHt06ZmyQtvB8xAkWdhFyr0ZUNZcxQ=
+github.com/joho/godotenv v1.4.0 h1:3l4+N6zfMWnkbPEXKng2o2/MR5mSwTrBih4ZEkkz1lg=
+github.com/joho/godotenv v1.4.0/go.mod h1:f4LDr5Voq0i2e/R5DDNOoa2zzDfwtkZa6DnEwAbqwq4=
+github.com/kr/pretty v0.3.0 h1:WgNl7dwNpEZ6jJ9k1snq4pZsg7DOEN8hP9Xw0Tsjwk0=
 github.com/kr/text v0.2.0 h1:5Nx0Ya0ZqY2ygV366QzturHI13Jq95ApcVaJBhpS+AY=
-github.com/kr/text v0.2.0/go.mod h1:eLer722TekiGuMkidMxC/pM04lWEeraHUUmBw8l2grE=
-github.com/mattn/go-colorable v0.1.14 h1:9A9LHSqF/7dyVVX6g0U9cwm9pG3kP9gSzcuIPHPsaIE=
-github.com/mattn/go-colorable v0.1.14/go.mod h1:6LmQG8QLFO4G5z1gPvYEzlUgJ2wF+stgPZH1UqBm1s8=
-github.com/mattn/go-isatty v0.0.20 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWEY=
-github.com/mattn/go-isatty v0.0.20/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y=
-github.com/mitchellh/go-homedir v1.1.0 h1:lukF9ziXFxDFPkA1vsr5zpc1XuPDn/wFntq5mG+4E0Y=
-github.com/mitchellh/go-homedir v1.1.0/go.mod h1:SfyaCUpYCn1Vlf4IUYiD9fPX4A5wJrkLzIz1N1q0pr0=
+github.com/mattn/go-colorable v0.1.9 h1:sqDoxXbdeALODt0DAeJCVp38ps9ZogZEAXjus69YV3U=
+github.com/mattn/go-colorable v0.1.9/go.mod h1:u6P/XSegPjTcexA+o6vUJrdnUu04hMope9wVRipJSqc=
+github.com/mattn/go-isatty v0.0.12/go.mod h1:cbi8OIDigv2wuxKPP5vlRcQ1OAZbq2CE4Kysco4FUpU=
+github.com/mattn/go-isatty v0.0.14 h1:yVuAays6BHfxijgZPzw+3Zlu5yQgKGP2/hcQbHb7S9Y=
+github.com/mattn/go-isatty v0.0.14/go.mod h1:7GGIvUiUoEMVVmxf/4nioHXj79iQHKdU27kJ6hsGG94=
+github.com/mattn/go-zglob v0.0.3 h1:6Ry4EYsScDyt5di4OI6xw1bYhOqfE5S33Z1OPy+d+To=
+github.com/mattn/go-zglob v0.0.3/go.mod h1:9fxibJccNxU2cnpIKLRRFA7zX7qhkJIQWBb449FYHOo=
 github.com/mitchellh/hashstructure/v2 v2.0.2 h1:vGKWl0YJqUNxE8d+h8f6NJLcCJrgbhC4NcD46KavDd4=
 github.com/mitchellh/hashstructure/v2 v2.0.2/go.mod h1:MG3aRVU/N29oo/V/IhBX8GR/zz4kQkprJgF2EVszyDE=
-github.com/pierrec/lz4/v4 v4.1.22 h1:cKFw6uJDK+/gfw5BcDL0JL5aBsAFdsIT18eRtLj7VIU=
-github.com/pierrec/lz4/v4 v4.1.22/go.mod h1:gZWDp/Ze/IJXGXf23ltt2EXimqmTUXEy0GFuRQyBid4=
-github.com/pkg/errors v0.8.1/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0=
 github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
 github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
-github.com/prometheus/client_model v0.0.0-20190812154241-14fe0d1b01d4/go.mod h1:xMI15A0UPsDsEKsMN9yxemIoYk6Tm2C1GtYGdfGttqA=
-github.com/puzpuzpuz/xsync/v4 v4.2.0 h1:dlxm77dZj2c3rxq0/XNvvUKISAmovoXF4a4qM6Wvkr0=
-github.com/puzpuzpuz/xsync/v4 v4.2.0/go.mod h1:VJDmTCJMBt8igNxnkQd86r+8KUeN1quSfNKu5bLYFQo=
-github.com/rogpeppe/go-internal v1.14.1 h1:UQB4HGPB6osV0SQTLymcB4TgvyWu6ZyliaW0tI/otEQ=
-github.com/rogpeppe/go-internal v1.14.1/go.mod h1:MaRKkUm5W0goXpeCfT7UZI6fk/L7L7so1lCWt35ZSgc=
-github.com/sajari/fuzzy v1.0.0 h1:+FmwVvJErsd0d0hAPlj4CxqxUtQY/fOoY0DwX4ykpRY=
-github.com/sajari/fuzzy v1.0.0/go.mod h1:OjYR6KxoWOe9+dOlXeiCJd4dIbED4Oo8wpS89o0pwOo=
-github.com/sebdah/goldie/v2 v2.8.0 h1:dZb9wR8q5++oplmEiJT+U/5KyotVD+HNGCAc5gNr8rc=
-github.com/sebdah/goldie/v2 v2.8.0/go.mod h1:oZ9fp0+se1eapSRjfYbsV/0Hqhbuu3bJVvKI/NNtssI=
-github.com/sergi/go-diff v1.0.0/go.mod h1:0CfEIISq7TuYL3j771MWULgwwjU+GofnZX9QAmXWZgo=
-github.com/sergi/go-diff v1.3.2-0.20230802210424-5b0b94c5c0d3 h1:n661drycOFuPLCN3Uc8sB6B/s6Z4t2xvBgU1htSHuq8=
-github.com/sergi/go-diff v1.3.2-0.20230802210424-5b0b94c5c0d3/go.mod h1:A0bzQcvG0E7Rwjx0REVgAGH58e96+X0MeOfepqsbeW4=
-github.com/spf13/pflag v1.0.10 h1:4EBh2KAYBwaONj6b2Ye1GiHfwjqyROoF4RwYO+vPwFk=
-github.com/spf13/pflag v1.0.10/go.mod h1:McXfInJRrz4CZXVZOBLb0bTZqETkiAhM9Iw0y3An2Bg=
+github.com/radovskyb/watcher v1.0.7 h1:AYePLih6dpmS32vlHfhCeli8127LzkIgwJGcwwe8tUE=
+github.com/radovskyb/watcher v1.0.7/go.mod h1:78okwvY5wPdzcb1UYnip1pvrZNIVEIh/Cm+ZuvsUYIg=
+github.com/rogpeppe/go-internal v1.8.1 h1:geMPLpDpQOgVyCg5z5GoRwLHepNdb71NXb67XFkP+Eg=
+github.com/spf13/pflag v1.0.5 h1:iy+VFUOCP1a+8yFto/drg2CJ5u0yRoB7fZw3DKv/JXA=
+github.com/spf13/pflag v1.0.5/go.mod h1:McXfInJRrz4CZXVZOBLb0bTZqETkiAhM9Iw0y3An2Bg=
 github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME=
 github.com/stretchr/objx v0.4.0/go.mod h1:YvHI0jy2hoMjB+UWwv71VJQ9isScKT/TqJzVSSt89Yw=
-github.com/stretchr/objx v0.5.0/go.mod h1:Yh+to48EsGEfYuaHDzXPcE3xhTkx73EhmCGUpEOglKo=
-github.com/stretchr/objx v0.5.2 h1:xuMeJ0Sdp5ZMRXx/aWO6RZxdr3beISkG5/G/aIRr3pY=
-github.com/stretchr/objx v0.5.2/go.mod h1:FRsXN1f5AsAjCGJKqEizvkpNtU+EGNCLh3NxZ/8L+MA=
-github.com/stretchr/testify v1.3.0/go.mod h1:M5WIy9Dh21IEIfnGCwXGc5bZfKNJtfHm1UVUgZn+9EI=
-github.com/stretchr/testify v1.4.0/go.mod h1:j7eGeouHqKxXV5pUuKE4zz7dFj8WfuZ+81PSLYec5m4=
+github.com/stretchr/testify v1.5.1/go.mod h1:5W2xD1RspED5o8YsWQXVCued0rvSQ+mT+I5cxcmMvtA=
 github.com/stretchr/testify v1.7.1/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg=
+github.com/stretchr/testify v1.8.0 h1:pSgiaMZlXftHpm5L7V1+rVB+AZJydKsMxsQBIJw4PKk=
 github.com/stretchr/testify v1.8.0/go.mod h1:yNjHg4UonilssWZ8iaSj1OCr/vHnekPRkoO+kdMU+MU=
-github.com/stretchr/testify v1.8.1/go.mod h1:w2LPCIKwWwSfY2zedu0+kehJoqGctiVI29o6fzry7u4=
-github.com/stretchr/testify v1.11.1 h1:7s2iGBzp5EwR7/aIZr8ao5+dra3wiQyKjjFuvgVKu7U=
-github.com/stretchr/testify v1.11.1/go.mod h1:wZwfW3scLgRK+23gO65QZefKpKQRnfz6sD981Nm4B6U=
-github.com/u-root/u-root v0.15.1-0.20251014130006-62f7144b33da h1:Vst9Tvq3G6f6pYBvxy7coi2arDsnOZ3Mkj8MkNarSK8=
-github.com/u-root/u-root v0.15.1-0.20251014130006-62f7144b33da/go.mod h1:R49zft13memK20EgFAvmTbXBS0t29UvglnM0BCA1ldQ=
-github.com/u-root/uio v0.0.0-20240224005618-d2acac8f3701 h1:pyC9PaHYZFgEKFdlp3G8RaCKgVpHZnecvArXvPXcFkM=
-github.com/u-root/uio v0.0.0-20240224005618-d2acac8f3701/go.mod h1:P3a5rG4X7tI17Nn3aOIAYr5HbIMukwXG0urG0WuL8OA=
-github.com/ulikunitz/xz v0.5.15 h1:9DNdB5s+SgV3bQ2ApL10xRc35ck0DuIX/isZvIk+ubY=
-github.com/ulikunitz/xz v0.5.15/go.mod h1:nbz6k7qbPmH4IRqmfOplQw/tblSgqTqBwxkY0oWt/14=
-github.com/zeebo/assert v1.3.0 h1:g7C04CbJuIDKNPFHmsk4hwZDO5O+kntRxzaUoNXj+IQ=
-github.com/zeebo/assert v1.3.0/go.mod h1:Pq9JiuJQpG8JLJdtkwrJESF0Foym2/D9XMU5ciN/wJ0=
-github.com/zeebo/xxh3 v1.0.2 h1:xZmwmqxHZA8AI603jOQ0tMqmBr9lPeFwGg6d+xy9DC0=
-github.com/zeebo/xxh3 v1.0.2/go.mod h1:5NWz9Sef7zIDm2JHfFlcQvNekmcEl9ekUZQQKCYaDcA=
-go.opencensus.io v0.24.0 h1:y73uSU6J157QMP2kn2r30vwW1A2W2WFwSCGnAVxeaD0=
-go.opencensus.io v0.24.0/go.mod h1:vNK8G9p7aAivkbmorf4v+7Hgx+Zs0yY+0fOtgBfjQKo=
-go.yaml.in/yaml/v4 v4.0.0-rc.3 h1:3h1fjsh1CTAPjW7q/EMe+C8shx5d8ctzZTrLcs/j8Go=
-go.yaml.in/yaml/v4 v4.0.0-rc.3/go.mod h1:aZqd9kCMsGL7AuUv/m/PvWLdg5sjJsZ4oHDEnfPPfY0=
-golang.org/x/crypto v0.0.0-20190308221718-c2843e01d9a2/go.mod h1:djNgcEr1/C05ACkg1iLfiJU5Ep61QUkGW8qpdssI0+w=
-golang.org/x/crypto v0.0.0-20200622213623-75b288015ac9/go.mod h1:LzIPMQfyMNhhGPhUkYOs5KpL4U8rLKemX1yGLhDgUto=
-golang.org/x/exp v0.0.0-20190121172915-509febef88a4/go.mod h1:CJ0aWSM057203Lf6IL+f9T1iT9GByDxfZKAQTCR3kQA=
-golang.org/x/lint v0.0.0-20181026193005-c67002cb31c3/go.mod h1:UVdnD1Gm6xHRNCYTkRU2/jEulfH38KcIWyp/GAMgvoE=
-golang.org/x/lint v0.0.0-20190227174305-5b3e6a55c961/go.mod h1:wehouNa3lNwaWXcvxsM5YxQ5yQlVC4a0KAMCusXpPoU=
-golang.org/x/lint v0.0.0-20190313153728-d0100b6bd8b3/go.mod h1:6SW0HCj/g11FgYtHlgUYUwCkIfeOF89ocIRzGO/8vkc=
-golang.org/x/net v0.0.0-20180724234803-3673e40ba225/go.mod h1:mL1N/T3taQHkDXs73rZJwtUhF3w3ftmwwsq0BUmARs4=
-golang.org/x/net v0.0.0-20180826012351-8a410e7b638d/go.mod h1:mL1N/T3taQHkDXs73rZJwtUhF3w3ftmwwsq0BUmARs4=
-golang.org/x/net v0.0.0-20190213061140-3a22650c66bd/go.mod h1:mL1N/T3taQHkDXs73rZJwtUhF3w3ftmwwsq0BUmARs4=
-golang.org/x/net v0.0.0-20190311183353-d8887717615a/go.mod h1:t9HGtf8HONx5eT2rtn7q6eTqICYqUVnKs3thJo3Qplg=
-golang.org/x/net v0.0.0-20190404232315-eb5bcb51f2a3/go.mod h1:t9HGtf8HONx5eT2rtn7q6eTqICYqUVnKs3thJo3Qplg=
-golang.org/x/net v0.0.0-20190603091049-60506f45cf65/go.mod h1:HSz+uSET+XFnRR8LxR5pz3Of3rY3CfYBVs4xY44aLks=
-golang.org/x/net v0.0.0-20201110031124-69a78807bb2b/go.mod h1:sp8m0HH+o8qH0wwXwYZr8TS3Oi6o0r6Gce1SSxlDquU=
-golang.org/x/net v0.47.0 h1:Mx+4dIFzqraBXUugkia1OOvlD6LemFo1ALMHjrXDOhY=
-golang.org/x/net v0.47.0/go.mod h1:/jNxtkgq5yWUGYkaZGqo27cfGZ1c5Nen03aYrrKpVRU=
-golang.org/x/oauth2 v0.0.0-20180821212333-d2e6202438be/go.mod h1:N/0e6XlmueqKjAGxoOufVs8QHGRruUQn6yWY3a++T0U=
-golang.org/x/oauth2 v0.27.0 h1:da9Vo7/tDv5RH/7nZDz1eMGS/q1Vv1N/7FCrBhI9I3M=
-golang.org/x/oauth2 v0.27.0/go.mod h1:onh5ek6nERTohokkhCD/y2cV4Do3fxFHFuAejCkRWT8=
-golang.org/x/sync v0.0.0-20180314180146-1d60e4601c6f/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
-golang.org/x/sync v0.0.0-20181108010431-42b317875d0f/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
-golang.org/x/sync v0.0.0-20190423024810-112230192c58/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
-golang.org/x/sync v0.19.0 h1:vV+1eWNmZ5geRlYjzm2adRgW2/mcpevXNg50YZtPCE4=
-golang.org/x/sync v0.19.0/go.mod h1:9KTHXmSnoGruLpwFjVSX0lNNA75CykiMECbovNTZqGI=
-golang.org/x/sys v0.0.0-20180830151530-49385e6e1522/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY=
-golang.org/x/sys v0.0.0-20190215142949-d0b11bdaac8a/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY=
-golang.org/x/sys v0.0.0-20190412213103-97732733099d/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
-golang.org/x/sys v0.0.0-20200930185726-fdedc70b468f/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
-golang.org/x/sys v0.5.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
-golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
-golang.org/x/sys v0.39.0 h1:CvCKL8MeisomCi6qNZ+wbb0DN9E5AATixKsvNtMoMFk=
-golang.org/x/sys v0.39.0/go.mod h1:OgkHotnGiDImocRcuBABYBEXf8A9a87e/uXjp9XT3ks=
-golang.org/x/term v0.38.0 h1:PQ5pkm/rLO6HnxFR7N2lJHOZX6Kez5Y1gDSJla6jo7Q=
-golang.org/x/term v0.38.0/go.mod h1:bSEAKrOT1W+VSu9TSCMtoGEOUcKxOKgl3LE5QEF/xVg=
-golang.org/x/text v0.3.0/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ=
-golang.org/x/text v0.3.2/go.mod h1:bEr9sfX3Q8Zfm5fL9x+3itogRgK3+ptLWKqgva+5dAk=
-golang.org/x/text v0.3.3/go.mod h1:5Zoc/QRtKVWzQhOtBMvqHzDpF6irO9z98xDceosuGiQ=
-golang.org/x/text v0.31.0 h1:aC8ghyu4JhP8VojJ2lEHBnochRno1sgL6nEi9WGFGMM=
-golang.org/x/text v0.31.0/go.mod h1:tKRAlv61yKIjGGHX/4tP1LTbc13YSec1pxVEWXzfoeM=
-golang.org/x/tools v0.0.0-20180917221912-90fa682c2a6e/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ=
-golang.org/x/tools v0.0.0-20190114222345-bf090417da8b/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ=
-golang.org/x/tools v0.0.0-20190226205152-f727befe758c/go.mod h1:9Yl7xja0Znq3iFh3HoIrodX9oNMXvdceNzlUR8zjMvY=
-golang.org/x/tools v0.0.0-20190311212946-11955173bddd/go.mod h1:LCzVGOaR6xXOjkQ3onu1FJEFr0SW1gC7cKk1uF8kGRs=
-golang.org/x/tools v0.0.0-20190524140312-2c0ae7006135/go.mod h1:RgjU9mgBXZiqYHBnxXauZ1Gv1EHHAz9KjViQ78xBX0Q=
-golang.org/x/xerrors v0.0.0-20191204190536-9bdfabe68543/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=
-golang.org/x/xerrors v0.0.0-20220907171357-04be3eba64a2 h1:H2TDz8ibqkAF6YGhCdN3jS9O0/s90v0rJh3X/OLHEUk=
-golang.org/x/xerrors v0.0.0-20220907171357-04be3eba64a2/go.mod h1:K8+ghG5WaK9qNqU5K3HdILfMLy1f3aNYFI/wnl100a8=
-google.golang.org/api v0.114.0 h1:1xQPji6cO2E2vLiI+C/XiFAnsn1WV3mjaEwGLhi3grE=
-google.golang.org/api v0.114.0/go.mod h1:ifYI2ZsFK6/uGddGfAD5BMxlnkBqCmqHSDUVi45N5Yg=
-google.golang.org/appengine v1.1.0/go.mod h1:EbEs0AVv82hx2wNQdGPgUI5lhzA/G0D9YwlJXL52JkM=
-google.golang.org/appengine v1.4.0/go.mod h1:xpcJRLb0r/rnEns0DIKYYv+WjYCduHsrkT7/EB5XEv4=
-google.golang.org/appengine v1.6.7 h1:FZR1q0exgwxzPzp/aF+VccGrSfxfPpkBqjIIEq3ru6c=
-google.golang.org/appengine v1.6.7/go.mod h1:8WjMMxjGQR8xUklV/ARdw2HLXBOI7O7uCIDZVag1xfc=
-google.golang.org/genproto v0.0.0-20180817151627-c66870c02cf8/go.mod h1:JiN7NxoALGmiZfu7CAH4rXhgtRTLTxftemlI0sWmxmc=
-google.golang.org/genproto v0.0.0-20190819201941-24fa4b261c55/go.mod h1:DMBHOl98Agz4BDEuKkezgsaosCRResVns1a3J2ZsMNc=
-google.golang.org/genproto v0.0.0-20200526211855-cb27e3aa2013/go.mod h1:NbSheEEYHJ7i3ixzK3sjbqSGDJWnxyFXZblF3eUsNvo=
-google.golang.org/genproto v0.0.0-20230410155749-daa745c078e1 h1:KpwkzHKEF7B9Zxg18WzOa7djJ+Ha5DzthMyZYQfEn2A=
-google.golang.org/genproto v0.0.0-20230410155749-daa745c078e1/go.mod h1:nKE/iIaLqn2bQwXBg8f1g2Ylh6r5MN5CmZvuzZCgsCU=
-google.golang.org/grpc v1.19.0/go.mod h1:mqu4LbDTu4XGKhr4mRzUsmM4RtVoemTSY81AxZiDr8c=
-google.golang.org/grpc v1.23.0/go.mod h1:Y5yQAOtifL1yxbo5wqy6BxZv8vAUGQwXBOALyacEbxg=
-google.golang.org/grpc v1.25.1/go.mod h1:c3i+UQWmh7LiEpx4sFZnkU36qjEYZ0imhYfXVyQciAY=
-google.golang.org/grpc v1.27.0/go.mod h1:qbnxyOmOxrQa7FizSgH+ReBfzJrCY1pSN7KXBS8abTk=
-google.golang.org/grpc v1.33.2/go.mod h1:JMHMWHQWaTccqQQlmk3MJZS+GWXOdAesneDmEnv2fbc=
-google.golang.org/grpc v1.56.3 h1:8I4C0Yq1EjstUzUJzpcRVbuYA2mODtEmpWiQoN/b2nc=
-google.golang.org/grpc v1.56.3/go.mod h1:I9bI3vqKfayGqPUAwGdOSu7kt6oIJLixfffKrpXqQ9s=
-google.golang.org/protobuf v0.0.0-20200109180630-ec00e32a8dfd/go.mod h1:DFci5gLYBciE7Vtevhsrf46CRTquxDuWsQurQQe4oz8=
-google.golang.org/protobuf v0.0.0-20200221191635-4d8936d0db64/go.mod h1:kwYJMbMJ01Woi6D6+Kah6886xMZcty6N08ah7+eCXa0=
-google.golang.org/protobuf v0.0.0-20200228230310-ab0ca4ff8a60/go.mod h1:cfTl7dwQJ+fmap5saPgwCLgHXTUD7jkjRqWcaiX5VyM=
-google.golang.org/protobuf v1.20.1-0.20200309200217-e05f789c0967/go.mod h1:A+miEFZTKqfCUM6K7xSMQL9OKL/b6hQv+e19PK+JZNE=
-google.golang.org/protobuf v1.21.0/go.mod h1:47Nbq4nVaFHyn7ilMalzfO3qCViNmqZ2kzikPIcrTAo=
-google.golang.org/protobuf v1.22.0/go.mod h1:EGpADcykh3NcUnDUJcl1+ZksZNG86OlYog2l/sGQquU=
-google.golang.org/protobuf v1.23.0/go.mod h1:EGpADcykh3NcUnDUJcl1+ZksZNG86OlYog2l/sGQquU=
-google.golang.org/protobuf v1.23.1-0.20200526195155-81db48ad09cc/go.mod h1:EGpADcykh3NcUnDUJcl1+ZksZNG86OlYog2l/sGQquU=
-google.golang.org/protobuf v1.25.0/go.mod h1:9JNX74DMeImyA3h4bdi1ymwjUzf21/xIlbajtzgsN7c=
-google.golang.org/protobuf v1.33.0 h1:uNO2rsAINq/JlFpSdYEKIZ0uKD/R9cpdv0T+yoGwGmI=
-google.golang.org/protobuf v1.33.0/go.mod h1:c6P6GXX6sHbq/GpV6MGZEdwhWPcYBgnhAHhKbcUYpos=
+golang.org/x/sync v0.0.0-20210220032951-036812b2e83c h1:5KslGYwFpkhGh+Q16bwMP3cOontH8FOep7tGV86Y7SQ=
+golang.org/x/sync v0.0.0-20210220032951-036812b2e83c/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
+golang.org/x/sys v0.0.0-20200116001909-b77594299b42/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
+golang.org/x/sys v0.0.0-20200223170610-d5e6a3e2c0ae/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
+golang.org/x/sys v0.0.0-20210630005230-0f9fa26af87c/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
+golang.org/x/sys v0.0.0-20220715151400-c0bba94af5f8 h1:0A+M6Uqn+Eje4kHMK80dtF3JCXC4ykBgQG4Fe06QRhQ=
+golang.org/x/sys v0.0.0-20220715151400-c0bba94af5f8/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
+golang.org/x/term v0.0.0-20210927222741-03fcf44c2211 h1:JGgROgKl9N8DuW20oFS5gxc+lE67/N3FcwmBPMe7ArY=
+golang.org/x/term v0.0.0-20210927222741-03fcf44c2211/go.mod h1:jbD1KX2456YbFQfuXm/mYQcufACuNUgVhRMnK/tPxf8=
+golang.org/x/xerrors v0.0.0-20200804184101-5ec99f83aff1 h1:go1bK/D/BFZV2I8cIQd1NKEZ+0owSTG1fDTci4IqFcE=
 gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
-gopkg.in/check.v1 v1.0.0-20190902080502-41f04d3bba15 h1:YR8cESwS4TdDjEe65xsg0ogRM/Nc3DYOhEAlW+xobZo=
-gopkg.in/check.v1 v1.0.0-20190902080502-41f04d3bba15/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
+gopkg.in/check.v1 v1.0.0-20180628173108-788fd7840127 h1:qIbj1fsPNlZgppZ+VLlY7N33q108Sa+fhmuc+sWQYwY=
+gopkg.in/check.v1 v1.0.0-20180628173108-788fd7840127/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
 gopkg.in/yaml.v2 v2.2.2/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI=
-gopkg.in/yaml.v2 v2.4.0/go.mod h1:RDklbk79AGWmwhnvt/jBztapEOGDOx6ZbXqjP6csGnQ=
 gopkg.in/yaml.v3 v3.0.0-20200313102051-9f266ea9e77c/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
 gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
 gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
-honnef.co/go/tools v0.0.0-20190102054323-c2f93a96b099/go.mod h1:rf3lG4BRIbNafJWhAfAdb/ePZxsR/4RtNHQocxwk9r4=
-honnef.co/go/tools v0.0.0-20190523083050-ea95bdfd59fc/go.mod h1:rf3lG4BRIbNafJWhAfAdb/ePZxsR/4RtNHQocxwk9r4=
-mvdan.cc/sh/moreinterp v0.0.0-20251109230715-65adef8e2c5b h1:vTpx76nZDTP/BAGnnhEXYjM+8nPKe9+I86qCErBvjCw=
-mvdan.cc/sh/moreinterp v0.0.0-20251109230715-65adef8e2c5b/go.mod h1:bDyKbUYKqkFunWmxxuSPrkYpln9QZcUsqu7W128qYW4=
-mvdan.cc/sh/v3 v3.12.0 h1:ejKUR7ONP5bb+UGHGEG/k9V5+pRVIyD+LsZz7o8KHrI=
-mvdan.cc/sh/v3 v3.12.0/go.mod h1:Se6Cj17eYSn+sNooLZiEUnNNmNxg0imoYlTu4CyaGyg=
+mvdan.cc/sh/v3 v3.6.0-0.dev.0.20220704111049-a6e3029cd899 h1:nwm4t5PtLlFd/H342GP50CtYf7vyMCOZkPx3g9shO0c=
+mvdan.cc/sh/v3 v3.6.0-0.dev.0.20220704111049-a6e3029cd899/go.mod h1:1JcoyAKm1lZw/2bZje/iYKWicU/KMd0rsyJeKHnsK4E=

hash.go

@@ -1,15 +1,18 @@
 package task
 
 import (
-	"cmp"
 	"fmt"
 
 	"github.com/go-task/task/v3/internal/hash"
-	"github.com/go-task/task/v3/taskfile/ast"
+	"github.com/go-task/task/v3/taskfile"
 )
 
-func (e *Executor) GetHash(t *ast.Task) (string, error) {
-	r := cmp.Or(t.Run, e.Taskfile.Run)
+func (e *Executor) GetHash(t *taskfile.Task) (string, error) {
+	r := t.Run
+	if r == "" {
+		r = e.Taskfile.Run
+	}
+
 	var h hash.HashFunc
 	switch r {
 	case "always":

help.go

@@ -1,200 +1,104 @@
 package task
 
 import (
-	"context"
-	"encoding/json"
 	"fmt"
 	"io"
+	"log"
 	"os"
+	"sort"
 	"strings"
+	"text/tabwriter"
 
-	"github.com/Ladicle/tabwriter"
-	"golang.org/x/sync/errgroup"
-
-	"github.com/go-task/task/v3/internal/editors"
-	"github.com/go-task/task/v3/internal/fingerprint"
 	"github.com/go-task/task/v3/internal/logger"
-	"github.com/go-task/task/v3/internal/sort"
-	"github.com/go-task/task/v3/taskfile/ast"
+	"github.com/go-task/task/v3/taskfile"
 )
 
-// ListOptions collects list-related options
-type ListOptions struct {
-	ListOnlyTasksWithDescriptions bool
-	ListAllTasks                  bool
-	FormatTaskListAsJSON          bool
-	NoStatus                      bool
-	Nested                        bool
+// ListTasksWithDesc reports tasks that have a description spec.
+func (e *Executor) ListTasksWithDesc() {
+	e.printTasks(false)
 }
 
-// NewListOptions creates a new ListOptions instance
-func NewListOptions(list, listAll, listAsJson, noStatus, nested bool) ListOptions {
-	return ListOptions{
-		ListOnlyTasksWithDescriptions: list,
-		ListAllTasks:                  listAll,
-		FormatTaskListAsJSON:          listAsJson,
-		NoStatus:                      noStatus,
-		Nested:                        nested,
-	}
+// ListAllTasks reports all tasks, with or without a description spec.
+func (e *Executor) ListAllTasks() {
+	e.printTasks(true)
 }
 
-// ShouldListTasks returns true if one of the options to list tasks has been set to true
-func (o ListOptions) ShouldListTasks() bool {
-	return o.ListOnlyTasksWithDescriptions || o.ListAllTasks
-}
-
-// Filters returns the slice of FilterFunc which filters a list
-// of ast.Task according to the given ListOptions
-func (o ListOptions) Filters() []FilterFunc {
-	filters := []FilterFunc{FilterOutInternal}
-
-	if o.ListOnlyTasksWithDescriptions {
-		filters = append(filters, FilterOutNoDesc)
+func (e *Executor) printTasks(listAll bool) {
+	var tasks []*taskfile.Task
+	if listAll {
+		tasks = e.allTaskNames()
+	} else {
+		tasks = e.tasksWithDesc()
 	}
 
-	return filters
-}
-
-// ListTasks prints a list of tasks.
-// Tasks that match the given filters will be excluded from the list.
-// The function returns a boolean indicating whether tasks were found
-// and an error if one was encountered while preparing the output.
-func (e *Executor) ListTasks(o ListOptions) (bool, error) {
-	tasks, err := e.GetTaskList(o.Filters()...)
-	if err != nil {
-		return false, err
-	}
-	if o.FormatTaskListAsJSON {
-		output, err := e.ToEditorOutput(tasks, o.NoStatus, o.Nested)
-		if err != nil {
-			return false, err
-		}
-
-		encoder := json.NewEncoder(e.Stdout)
-		encoder.SetIndent("", "  ")
-		if err := encoder.Encode(output); err != nil {
-			return false, err
-		}
-
-		return len(tasks) > 0, nil
-	}
 	if len(tasks) == 0 {
-		if o.ListOnlyTasksWithDescriptions {
-			e.Logger.Outf(logger.Yellow, "task: No tasks with description available. Try --list-all to list all tasks\n")
-		} else if o.ListAllTasks {
-			e.Logger.Outf(logger.Yellow, "task: No tasks available\n")
+		if listAll {
+			e.Logger.Outf(logger.Yellow, "task: No tasks available")
+		} else {
+			e.Logger.Outf(logger.Yellow, "task: No tasks with description available. Try --list-all to list all tasks")
 		}
-		return false, nil
+		return
 	}
-	e.Logger.Outf(logger.Default, "task: Available tasks for this project:\n")
+	e.Logger.Outf(logger.Default, "task: Available tasks for this project:")
 
 	// Format in tab-separated columns with a tab stop of 8.
-	w := tabwriter.NewWriter(e.Stdout, 0, 8, 6, ' ', 0)
+	w := tabwriter.NewWriter(e.Stdout, 0, 8, 0, '\t', 0)
 	for _, task := range tasks {
-		e.Logger.FOutf(w, logger.Yellow, "* ")
-		e.Logger.FOutf(w, logger.Green, task.Task)
-		desc := strings.ReplaceAll(task.Desc, "\n", " ")
-		e.Logger.FOutf(w, logger.Default, ": \t%s", desc)
-		if len(task.Aliases) > 0 {
-			e.Logger.FOutf(w, logger.Cyan, "\t(aliases: %s)", strings.Join(task.Aliases, ", "))
-		}
-		_, _ = fmt.Fprint(w, "\n")
+		fmt.Fprintf(w, "* %s: \t%s\n", task.Name(), task.Desc)
 	}
-	if err := w.Flush(); err != nil {
-		return false, err
-	}
-	return true, nil
+	w.Flush()
 }
 
-// ListTaskNames prints only the task names in a Taskfile.
+func (e *Executor) allTaskNames() (tasks []*taskfile.Task) {
+	tasks = make([]*taskfile.Task, 0, len(e.Taskfile.Tasks))
+	for _, task := range e.Taskfile.Tasks {
+		tasks = append(tasks, task)
+	}
+	sort.Slice(tasks, func(i, j int) bool { return tasks[i].Task < tasks[j].Task })
+	return
+}
+
+func (e *Executor) tasksWithDesc() (tasks []*taskfile.Task) {
+	tasks = make([]*taskfile.Task, 0, len(e.Taskfile.Tasks))
+	for _, task := range e.Taskfile.Tasks {
+		if task.Desc != "" {
+			compiledTask, err := e.FastCompiledTask(taskfile.Call{Task: task.Task})
+			if err == nil {
+				task = compiledTask
+			}
+			tasks = append(tasks, task)
+		}
+	}
+	sort.Slice(tasks, func(i, j int) bool { return tasks[i].Task < tasks[j].Task })
+	return
+}
+
+// PrintTaskNames prints only the task names in a Taskfile.
 // Only tasks with a non-empty description are printed if allTasks is false.
 // Otherwise, all task names are printed.
-func (e *Executor) ListTaskNames(allTasks bool) error {
+func (e *Executor) ListTaskNames(allTasks bool) {
+	// if called from cmd/task.go, e.Taskfile has not yet been parsed
+	if e.Taskfile == nil {
+		if err := e.readTaskfile(); err != nil {
+			log.Fatal(err)
+			return
+		}
+	}
 	// use stdout if no output defined
 	var w io.Writer = os.Stdout
 	if e.Stdout != nil {
 		w = e.Stdout
 	}
-
-	// Sort the tasks
-	if e.TaskSorter == nil {
-		e.TaskSorter = sort.AlphaNumericWithRootTasksFirst
-	}
-
-	// Create a list of task names
-	taskNames := make([]string, 0, e.Taskfile.Tasks.Len())
-	for task := range e.Taskfile.Tasks.Values(e.TaskSorter) {
-		if (allTasks || task.Desc != "") && !task.Internal {
-			taskNames = append(taskNames, strings.TrimRight(task.Task, ":"))
-			for _, alias := range task.Aliases {
-				taskNames = append(taskNames, strings.TrimRight(alias, ":"))
-			}
+	// create a string slice from all map values (*taskfile.Task)
+	s := make([]string, 0, len(e.Taskfile.Tasks))
+	for _, t := range e.Taskfile.Tasks {
+		if allTasks || t.Desc != "" {
+			s = append(s, strings.TrimRight(t.Task, ":"))
 		}
 	}
-	for _, t := range taskNames {
+	// sort and print all task names
+	sort.Strings(s)
+	for _, t := range s {
 		fmt.Fprintln(w, t)
 	}
-	return nil
-}
-
-func (e *Executor) ToEditorOutput(tasks []*ast.Task, noStatus bool, nested bool) (*editors.Namespace, error) {
-	var g errgroup.Group
-	editorTasks := make([]editors.Task, len(tasks))
-
-	// Look over each task in parallel and turn it into an editor task
-	for i := range tasks {
-		g.Go(func() error {
-			editorTask := editors.NewTask(tasks[i])
-
-			if noStatus {
-				editorTasks[i] = editorTask
-				return nil
-			}
-
-			// Get the fingerprinting method to use
-			method := e.Taskfile.Method
-			if tasks[i].Method != "" {
-				method = tasks[i].Method
-			}
-			upToDate, err := fingerprint.IsTaskUpToDate(context.Background(), tasks[i],
-				fingerprint.WithMethod(method),
-				fingerprint.WithTempDir(e.TempDir.Fingerprint),
-				fingerprint.WithDry(e.Dry),
-				fingerprint.WithLogger(e.Logger),
-			)
-			if err != nil {
-				return err
-			}
-
-			editorTask.UpToDate = &upToDate
-			editorTasks[i] = editorTask
-			return nil
-		})
-	}
-	if err := g.Wait(); err != nil {
-		return nil, err
-	}
-
-	// Create the root namespace
-	var tasksLen int
-	if !nested {
-		tasksLen = len(editorTasks)
-	}
-	rootNamespace := &editors.Namespace{
-		Tasks:    make([]editors.Task, tasksLen),
-		Location: e.Taskfile.Location,
-	}
-
-	// Recursively add namespaces to the root namespace or if nesting is
-	// disabled add them all to the root namespace
-	for i, task := range editorTasks {
-		taskNamespacePath := strings.Split(task.Task, ast.NamespaceSeparator)
-		if nested {
-			rootNamespace.AddNamespace(taskNamespacePath, task)
-		} else {
-			rootNamespace.Tasks[i] = task
-		}
-	}
-
-	return rootNamespace, g.Wait()
 }

init.go

@@ -1,50 +1,38 @@
 package task
 
 import (
-	_ "embed"
+	"fmt"
+	"io"
 	"os"
 
-	"github.com/go-task/task/v3/errors"
 	"github.com/go-task/task/v3/internal/filepathext"
-	"github.com/go-task/task/v3/taskfile"
 )
 
-const defaultFilename = "Taskfile.yml"
+const defaultTaskfile = `# https://taskfile.dev
 
-//go:embed taskfile/templates/default.yml
-var DefaultTaskfile string
+version: '3'
 
-// InitTaskfile creates a new Taskfile at path.
-//
-// path can be either a file path or a directory path.
-// If path is a directory, path/Taskfile.yml will be created.
-//
-// The final file path is always returned and may be different from the input path.
-func InitTaskfile(path string) (string, error) {
-	info, err := os.Stat(path)
-	if err == nil && !info.IsDir() {
-		return path, errors.TaskfileAlreadyExistsError{}
+vars:
+  GREETING: Hello, World!
+
+tasks:
+  default:
+    cmds:
+      - echo "{{.GREETING}}"
+    silent: true
+`
+
+// InitTaskfile Taskfile creates a new Taskfile
+func InitTaskfile(w io.Writer, dir string) error {
+	f := filepathext.SmartJoin(dir, "Taskfile.yaml")
+
+	if _, err := os.Stat(f); err == nil {
+		return ErrTaskfileAlreadyExists
 	}
 
-	if info != nil && info.IsDir() {
-		// path was a directory, check if there is a Taskfile already
-		if hasDefaultTaskfile(path) {
-			return path, errors.TaskfileAlreadyExistsError{}
-		}
-		path = filepathext.SmartJoin(path, defaultFilename)
+	if err := os.WriteFile(f, []byte(defaultTaskfile), 0o644); err != nil {
+		return err
 	}
-
-	if err := os.WriteFile(path, []byte(DefaultTaskfile), 0o644); err != nil {
-		return path, err
-	}
-	return path, nil
-}
-
-func hasDefaultTaskfile(dir string) bool {
-	for _, name := range taskfile.DefaultTaskfiles {
-		if _, err := os.Stat(filepathext.SmartJoin(dir, name)); err == nil {
-			return true
-		}
-	}
-	return false
+	fmt.Fprintf(w, "Taskfile.yaml created in the current directory\n")
+	return nil
 }

init_test.go

@@ -1,52 +0,0 @@
-package task_test
-
-import (
-	"os"
-	"testing"
-
-	"github.com/go-task/task/v3"
-	"github.com/go-task/task/v3/internal/filepathext"
-)
-
-func TestInitDir(t *testing.T) {
-	t.Parallel()
-
-	const dir = "testdata/init"
-	file := filepathext.SmartJoin(dir, "Taskfile.yml")
-
-	_ = os.Remove(file)
-	if _, err := os.Stat(file); err == nil {
-		t.Errorf("Taskfile.yml should not exist")
-	}
-
-	if _, err := task.InitTaskfile(dir); err != nil {
-		t.Error(err)
-	}
-
-	if _, err := os.Stat(file); err != nil {
-		t.Errorf("Taskfile.yml should exist")
-	}
-
-	_ = os.Remove(file)
-}
-
-func TestInitFile(t *testing.T) {
-	t.Parallel()
-
-	const dir = "testdata/init"
-	file := filepathext.SmartJoin(dir, "Tasks.yml")
-
-	_ = os.Remove(file)
-	if _, err := os.Stat(file); err == nil {
-		t.Errorf("Tasks.yml should not exist")
-	}
-
-	if _, err := task.InitTaskfile(file); err != nil {
-		t.Error(err)
-	}
-
-	if _, err := os.Stat(file); err != nil {
-		t.Errorf("Tasks.yml should exist")
-	}
-	_ = os.Remove(file)
-}