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,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,25 +0,0 @@
-{
-  "$schema": "https://docs.renovatebot.com/renovate-schema.json",
-  "extends": [
-    "config:recommended",
-    "group:allNonMajor",
-    "schedule:weekly",
-    ":semanticCommitTypeAll(chore)"
-  ],
-  "mode": "full",
-  "addLabels":["area: dependencies"],
-  "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@v7
-        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@v7
-        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@v7
-        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@v7
-        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@v7
-        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@v7
-        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@v7
-        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@v7
-        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@v7
-        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@v7
-        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,69 +6,19 @@ on:
     tags:
       - v*
     branches:
-      - main
+      - master
 
 jobs:
   lint:
-    name: Lint
-    strategy:
-      matrix:
-        go-version: [1.23.x, 1.24.x]
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/setup-go@v5
+      - uses: actions/setup-go@v3
         with:
-          go-version: ${{matrix.go-version}}
+          go-version: 1.18.x
 
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v3
 
       - name: golangci-lint
-        uses: golangci/golangci-lint-action@v8
+        uses: golangci/golangci-lint-action@v3
         with:
-          version: v2.1.0
-
-  lint-jsonschema:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/setup-python@v5
-        with:
-          python-version: 3.12
-
-      - uses: actions/checkout@v4
-
-      - name: install check-jsonschema
-        run: python -m pip install 'check-jsonschema==0.27.3'
-
-      - name: check-jsonschema (metaschema)
-        run: check-jsonschema --check-metaschema website/static/schema.json
-  check_doc:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - name: Get changed files in the docs folder
-        id: changed-files-specific
-        uses: tj-actions/changed-files@v46
-        with:
-          files: website/versioned_docs/**
-
-      - uses: actions/github-script@v7
-        if: steps.changed-files-specific.outputs.any_changed == 'true'
-        with:
-          script: |
-            core.setFailed('website/versioned_docs has changed. Instead you need to update the docs in the website/docs folder.')
-  check_schema:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - name: Get changed files in the docs folder
-        id: changed-files-specific
-        uses: tj-actions/changed-files@v46
-        with:
-          files: |
-            website/static/schema.json
-            website/static/schema-taskrc.json
-      - uses: actions/github-script@v7
-        if: steps.changed-files-specific.outputs.any_changed == 'true'
-        with:
-          script: |
-            core.setFailed('schema.json or schema-taskrc.json has changed. Instead you need to update next-schema.json or next-schema-taskrc.json.')
+          version: v1.46.1

.github/workflows/release-nightly.yml

@@ -1,29 +0,0 @@
-name: Realease nightly
-
-on:
-  workflow_dispatch:
-  schedule:
-    - cron: 0 0 * * *
-jobs:
-  goreleaser:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-
-      - name: Set up Go
-        uses: actions/setup-go@v5
-        with:
-          go-version: 1.24.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}}

.github/workflows/release.yml

@@ -3,28 +3,24 @@ name: goreleaser
 on:
   push:
     tags:
-      - 'v*'
+      - '*'
 
 jobs:
   goreleaser:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
+        uses: actions/checkout@v3
 
       - name: Set up Go
-        uses: actions/setup-go@v5
+        uses: actions/setup-go@v3
         with:
-          go-version: 1.24.x
+          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}}

.github/workflows/test.yml

@@ -6,25 +6,25 @@ on:
     tags:
       - v*
     branches:
-      - main
+      - master
 
 jobs:
   test:
     name: Test
     strategy:
       matrix:
-        go-version: [1.23.x, 1.24.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@v5
+        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@v4
+        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,74 +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
-    file_name_template: '{{.ProjectName}}_{{.Os}}_{{.Arch}}'
+    file_name_template: "{{.ProjectName}}_{{.Os}}_{{.Arch}}"
     contents:
       - src: completion/bash/task.bash
         dst: /etc/bash_completion.d/task
@@ -82,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"
@@ -95,43 +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: 'chore/task-{{.Version}}'
-      pull_request:
-        enabled: true
-        draft: false
-        check_boxes: true
-        base:
-          owner: microsoft
-          name: winget-pkgs
-          branch: master

.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:

.nvmrc

@@ -1 +0,0 @@
-22.18.0

.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,17 +0,0 @@
-{
-  "yaml.schemas": {
-    "./website/static/schema.json": [
-      "Taskfile.yml",
-      "tmp/**/*.yml"
-    ]
-  },
-  "search.exclude": {
-    "**/versioned_docs": true,
-    "**/versioned_sidesbars": true,
-    "**/i18n": true
-  },
-  "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/static/img/logo.svg" width="200px" height="200px" />
+    <img src="docs/static/img/logo.svg" width="200px" height="200px" />
   </a>
 
   <h1>Task</h1>
@@ -10,18 +10,6 @@
   </p>
 
   <p>
-    <a href="https://taskfile.dev/installation/">Installation</a> | <a href="https://taskfile.dev/usage/">Documentation</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/static/img/devowl.io.svg" height="100px" title="devowl.io" />
-        </a>
-      </td>
-    </tr>
-  </table>
 </div>

Taskfile.yml

@@ -1,13 +1,16 @@
 version: '3'
 
 includes:
-  website:
-    aliases: [w, docs, d]
-    taskfile: ./website
-    dir: ./website
+  docs:
+    taskfile: ./docs
+    dir: ./docs
 
 vars:
-  BIN: "{{.ROOT_DIR}}/bin"
+  GIT_COMMIT:
+    sh: git log -n 1 --format=%h
+
+  GO_PACKAGES:
+    sh: go list ./...
 
 env:
   CGO_ENABLED: '0'
@@ -18,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
@@ -79,151 +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]
-    sources:
-      - "**/*.go"
-      - "testdata/**/*"
+    deps: [install]
     cmds:
-      - go test ./...
+      - go test {{catLines .GO_PACKAGES}}
 
-  test:watch:
-    desc: Runs test suite with watch tests included
-    deps: [sleepit:build]
+  test:signals:
+    desc: Runs test suite with signals tests included
+    deps: [install, sleepit:build]
     cmds:
-      - go test ./... -tags 'watch'
+      - go test {{catLines .GO_PACKAGES}} -tags signals
 
-  test:all:
-    desc: Runs test suite with signals and watch tests included
-    deps: [sleepit:build]
-    cmds:
-      - go test -tags 'signals watch' ./...
-
-  goreleaser:test:
+  test-release:
     desc: Tests release process without publishing
     cmds:
-      - goreleaser --snapshot --clean
+      - goreleaser --snapshot --rm-dist
 
-  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
-        - Publish the package to NPM with `task npm:publish`
-        - 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
-
-  npm:publish:
-    desc: Publish release to npm
-    cmds:
-      - npm publish --access=public
+      - 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,195 +0,0 @@
-package main
-
-import (
-	"fmt"
-	"os"
-	"os/exec"
-	"regexp"
-	"strings"
-	"time"
-
-	"github.com/Masterminds/semver/v3"
-	"github.com/otiai10/copy"
-	"github.com/spf13/pflag"
-
-	"github.com/go-task/task/v3/errors"
-)
-
-const (
-	changelogSource    = "CHANGELOG.md"
-	changelogTarget    = "website/docs/changelog.mdx"
-	docsSource         = "website/docs"
-	docsTarget         = "website/versioned_docs/version-latest"
-	schemaSource       = "website/static/next-schema.json"
-	schemaTarget       = "website/static/schema.json"
-	schemaTaskrcSource = "website/static/next-schema-taskrc.json"
-	schemaTaskrcTarget = "website/static/schema-taskrc.json"
-)
-
-var (
-	changelogReleaseRegex = regexp.MustCompile(`## Unreleased`)
-	versionRegex          = regexp.MustCompile(`(?m)^  "version": "\d+\.\d+\.\d+",$`)
-)
-
-// 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()
-	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("internal/version/version.txt", version); err != nil {
-		return err
-	}
-
-	if err := setJSONVersion("package.json", version); err != nil {
-		return err
-	}
-
-	if err := setJSONVersion("package-lock.json", version); err != nil {
-		return err
-	}
-
-	if err := docs(); err != nil {
-		return err
-	}
-
-	if err := schema(); err != nil {
-		return err
-	}
-
-	return nil
-}
-
-func getVersion() (*semver.Version, error) {
-	cmd := exec.Command("git", "describe", "--tags", "--abbrev=0")
-	b, err := cmd.Output()
-	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
-	}
-
-	// Add the frontmatter to the changelog
-	changelog = fmt.Sprintf("---\n%s\n---\n\n%s", frontmatter, changelog)
-
-	// Write the changelog to the target file
-	return os.WriteFile(changelogTarget, []byte(changelog), 0o644)
-}
-
-func setVersionFile(fileName string, version *semver.Version) error {
-	return os.WriteFile(fileName, []byte(version.String()+"\n"), 0o644)
-}
-
-func setJSONVersion(fileName string, version *semver.Version) error {
-	// Read the JSON file
-	b, err := os.ReadFile(fileName)
-	if err != nil {
-		return err
-	}
-
-	// Replace the version
-	new := versionRegex.ReplaceAllString(string(b), fmt.Sprintf(`  "version": "%s",`, version.String()))
-
-	// Write the JSON file
-	return os.WriteFile(fileName, []byte(new), 0o644)
-}
-
-func docs() error {
-	if err := os.RemoveAll(docsTarget); err != nil {
-		return err
-	}
-	if err := copy.Copy(docsSource, docsTarget); err != nil {
-		return err
-	}
-	return nil
-}
-
-func schema() error {
-	if err := copy.Copy(schemaSource, schemaTarget); err != nil {
-		return err
-	}
-	if err := copy.Copy(schemaTaskrcSource, schemaTaskrcTarget); err != nil {
-		return err
-	}
-	return nil
-}

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,227 +3,265 @@ package main
 import (
 	"context"
 	"fmt"
+	"log"
 	"os"
 	"path/filepath"
+	"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"
-	"github.com/go-task/task/v3/taskfile/ast"
 )
 
+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 {
-			l.Errf(logger.Red, "%v\n", err)
-			os.Exit(err.TaskExitCode())
-		}
-		if err, ok := err.(errors.TaskError); ok {
-			l.Errf(logger.Red, "%v\n", err)
-			os.Exit(err.Code())
-		}
-		l.Errf(logger.Red, "%v\n", err)
-		os.Exit(errors.CodeUnknown)
-	}
-	os.Exit(errors.CodeOk)
-}
+	log.SetFlags(0)
+	log.SetOutput(os.Stderr)
 
-func run() error {
-	log := &logger.Logger{
-		Stdout:  os.Stdout,
-		Stderr:  os.Stderr,
-		Verbose: flags.Verbose,
-		Color:   flags.Color,
+	pflag.Usage = func() {
+		log.Print(usage)
+		pflag.PrintDefaults()
 	}
 
-	if err := flags.Validate(); err != nil {
-		return err
+	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 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))
+		return
+	}
+
+	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
+	}
+
+	if err := e.Setup(); err != nil {
+		log.Fatal(err)
+	}
+	v, err := e.Taskfile.ParsedVersion()
+	if err != nil {
+		log.Fatal(err)
+		return
+	}
+
+	if list {
+		e.ListTasksWithDesc()
+		return
+	}
+
+	if listAll {
+		e.ListAllTasks()
+		return
+	}
+
+	var (
+		calls   []taskfile.Call
+		globals *taskfile.Vars
+	)
+
+	tasksAndVars, cliArgs, err := getArgs()
+	if err != nil {
+		log.Fatal(err)
+	}
+
+	if v >= 3.0 {
+		calls, globals = args.ParseV3(tasksAndVars...)
+	} else {
+		calls, globals = args.ParseV2(tasksAndVars...)
+	}
+
+	globals.Set("CLI_ARGS", taskfile.Var{Static: cliArgs})
+	e.Taskfile.Vars.Merge(globals)
+
+	if !watch {
+		e.InterceptInterruptSignals()
+	}
+
+	ctx := context.Background()
+
+	if status {
+		if err := e.Status(ctx, calls...); err != nil {
+			log.Fatal(err)
+		}
+		return
+	}
+
+	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())
 			}
-			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
+		os.Exit(1)
 	}
-
-	if flags.Completion != "" {
-		script, err := task.Completion(flags.Completion)
-		if err != nil {
-			return err
-		}
-		fmt.Println(script)
-		return nil
-	}
-
-	if err := experiments.Validate(); err != nil {
-		log.Warnf("%s\n", err.Error())
-	}
-
-	// Create a new root node for the given entrypoint
-	node, err := taskfile.NewRootNode(
-		flags.Entrypoint,
-		flags.Dir,
-		flags.Insecure,
-	)
-	if err != nil {
-		return err
-	}
-
-	tempDir, err := task.NewTempDir(node.Dir())
-	if err != nil {
-		return err
-	}
-
-	reader := taskfile.NewReader(
-		flags.WithFlags(),
-		taskfile.WithTempDir(tempDir.Remote),
-		taskfile.WithDebugFunc(func(s string) {
-			log.VerboseOutf(logger.Magenta, s)
-		}),
-		taskfile.WithPromptFunc(func(s string) error {
-			return log.Prompt(logger.Yellow, s, "n", "y", "yes")
-		}),
-	)
-
-	ctx, cf := context.WithTimeout(context.Background(), flags.Timeout)
-	defer cf()
-	graph, err := reader.Read(ctx, node)
-	if err != nil {
-		if errors.Is(err, context.DeadlineExceeded) {
-			return &errors.TaskfileNetworkTimeoutError{URI: node.Location(), Timeout: flags.Timeout}
-		}
-		return err
-	}
-
-	executor, err := task.NewExecutor(graph,
-		flags.WithFlags(),
-		task.WithDir(node.Dir()),
-		task.WithTempDir(tempDir),
-	)
-	if err != nil {
-		return err
-	}
-
-	// If the download flag is specified, we should stop execution as soon as
-	// taskfile is downloaded
-	if flags.Download {
-		return nil
-	}
-
-	if flags.ClearCache {
-		cachePath := filepath.Join(executor.TempDir.Remote, "remote")
-		return os.RemoveAll(cachePath)
-	}
-
-	listOptions := task.NewListOptions(
-		flags.List,
-		flags.ListAll,
-		flags.ListJson,
-		flags.NoStatus,
-	)
-	if listOptions.ShouldListTasks() {
-		if flags.Silent {
-			return executor.ListTaskNames(flags.ListAll)
-		}
-		foundTasks, err := executor.ListTasks(listOptions)
-		if err != nil {
-			return err
-		}
-		if !foundTasks {
-			os.Exit(errors.CodeUnknown)
-		}
-		return nil
-	}
-
-	// Parse the remaining arguments
-	cliArgsPreDash, cliArgsPostDash, err := args.Get()
-	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"})
-	}
-
-	cliArgsPostDashQuoted, err := args.ToQuotedString(cliArgsPostDash)
-	if err != nil {
-		return err
-	}
-	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})
-	executor.Taskfile.Vars.Merge(globals, nil)
-
-	if !flags.Watch {
-		executor.InterceptInterruptSignals()
-	}
-
-	ctx = context.Background()
-
-	if flags.Status {
-		return executor.Status(ctx, calls...)
-	}
-
-	return executor.Run(ctx, calls...)
+}
+
+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
 }

cmd/tmp/main.go

@@ -1,38 +0,0 @@
-package main
-
-import (
-	"context"
-	"fmt"
-	"net/http"
-	"time"
-)
-
-func main() {
-	ctx, cancel := context.WithTimeout(context.Background(), time.Millisecond)
-	defer cancel()
-	if err := run(ctx); err != nil {
-		fmt.Println(ctx.Err())
-		fmt.Println(err)
-	}
-}
-
-func run(ctx context.Context) error {
-	req, err := http.NewRequest("GET", "https://taskfile.dev/schema.json", nil)
-	if err != nil {
-		fmt.Println(1)
-		return err
-	}
-
-	resp, err := http.DefaultClient.Do(req.WithContext(ctx))
-	if err != nil {
-		if ctx.Err() != nil {
-			fmt.Println(2)
-			return err
-		}
-		fmt.Println(3)
-		return err
-	}
-	defer resp.Body.Close()
-
-	return nil
-}

compiler.go

@@ -1,225 +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
-			if !evaluateShVars && newVar.Value == nil {
-				result.Set(k, ast.Var{Value: ""})
-				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})
-				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/fish/task.fish

@@ -1,41 +1,16 @@
-set -l GO_TASK_PROGNAME task
+set GO_TASK_PROGNAME task
 
-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*\(.*\)\s*(\(aliases.*\))/\1\t\2\t\3/' -e 's/\* \(.*\):\s*\(.*\)/\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)"
 
+
 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'

completion/ps/task.ps1

@@ -1,28 +1,10 @@
-using namespace System.Management.Automation
-
-Register-ArgumentCompleter -CommandName task -ScriptBlock {
-	param($commandName, $parameterName, $wordToComplete, $commandAst, $fakeBoundParameters)
-
-	if ($commandName.StartsWith('-')) {
-		$completions = @(
-			[CompletionResult]::new('--list-all ', '--list-all ', [CompletionResultType]::ParameterName, 'list all tasks'),
-			[CompletionResult]::new('--color ', '--color', [CompletionResultType]::ParameterName, '--color'),
-			[CompletionResult]::new('--concurrency=', '--concurrency=', [CompletionResultType]::ParameterName, 'concurrency'),
-			[CompletionResult]::new('--interval=', '--interval=', [CompletionResultType]::ParameterName, 'interval'),
-			[CompletionResult]::new('--output=interleaved ', '--output=interleaved', [CompletionResultType]::ParameterName, '--output='),
-			[CompletionResult]::new('--output=group ', '--output=group', [CompletionResultType]::ParameterName, '--output='),
-			[CompletionResult]::new('--output=prefixed ', '--output=prefixed', [CompletionResultType]::ParameterName, '--output='),
-			[CompletionResult]::new('--dry ', '--dry', [CompletionResultType]::ParameterName, '--dry'),
-			[CompletionResult]::new('--force ', '--force', [CompletionResultType]::ParameterName, '--force'),
-			[CompletionResult]::new('--parallel ', '--parallel', [CompletionResultType]::ParameterName, '--parallel'),
-			[CompletionResult]::new('--silent ', '--silent', [CompletionResultType]::ParameterName, '--silent'),
-			[CompletionResult]::new('--status ', '--status', [CompletionResultType]::ParameterName, '--status'),
-			[CompletionResult]::new('--verbose ', '--verbose', [CompletionResultType]::ParameterName, '--verbose'),
-			[CompletionResult]::new('--watch ', '--watch', [CompletionResultType]::ParameterName, '--watch')
-		)
-
-		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,8 +1,7 @@
 #compdef task
-compdef _task task
-typeset -A opt_args
 
-_GO_TASK_COMPLETION_LIST_OPTION="${GO_TASK_COMPLETION_LIST_OPTION:---list-all}"
+local context state state_descr line
+typeset -A opt_args
 
 # Listing commands from Taskfile.yml
 function __task_list() {
@@ -11,15 +10,13 @@ function __task_list() {
     local taskfile item task desc
 
     cmd=(task)
-    taskfile=${(Qv)opt_args[(i)-t|--taskfile]}
-    taskfile=${taskfile//\~/$HOME}
-
+    taskfile="${(v)opt_args[(i)-t|--taskfile]}"
 
     if [[ -n "$taskfile" && -f "$taskfile" ]]; then
         enabled=1
         cmd+=(--taskfile "$taskfile")
     else
-        for taskfile in {T,t}askfile{,.dist}.{yaml,yml}; do
+        for taskfile in Taskfile{,.dist}.{yaml,yml}; do
             if [[ -f "$taskfile" ]]; then
                 enabled=1
                 break
@@ -30,7 +27,7 @@ function __task_list() {
     (( enabled )) || return 0
 
     scripts=()
-    for item in "${(@)${(f)$("${cmd[@]}" $_GO_TASK_COMPLETION_LIST_OPTION)}[2,-1]#\* }"; do
+    for item in "${(@)${(f)$("${cmd[@]}" --list-all)}[2,-1]#\* }"; do
         task="${item%%:[[:space:]]*}"
         desc="${item##[^[:space:]]##[[:space:]]##}"
         scripts+=( "${task//:/\\:}:$desc" )
@@ -38,33 +35,26 @@ function __task_list() {
     _describe 'Task to run' scripts
 }
 
-_task() {
-    _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.yml]' \
-            '(-*)'{-h,--help}'[show help]' \
-            '(-*)--version[show version and exit]' \
-            '*: :__task_list'
-}
-
-# 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

@@ -7,7 +7,6 @@
 # Generated files
 .docusaurus
 .cache-loader
-i18n
 
 # Misc
 .DS_Store

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

@@ -3,8 +3,3 @@ andreynering:
   title: Maintainer of Task
   url: https://github.com/andreynering
   image_url: https://github.com/andreynering.png
-pd93:
-  name: Pete Davison
-  title: Maintainer of Task
-  url: https://github.com/pd93
-  image_url: https://github.com/pd93.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

@@ -1,6 +1,6 @@
 ---
 slug: /donate/
-hide_table_of_contents: true
+sidebar_position: 9
 ---
 
 # Donate
@@ -11,25 +11,10 @@ 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.
 
-Companies who donate at least $50/month will be featured as a "Gold Sponsor" in
-the website homepage and on the GitHub repository README. Make contact with
-[@andreynering] with the logo you want to be shown. Suspect businesses
-(gambling, casinos, etc) won't be allowed, though.
-
-## GitHub Sponsors
-
-The preferred way to donate to the maintainers is via GitHub Sponsors. Just use
-the following links to do your donation. We suggest a equal weight split to each
-maintainer of the total amount you plan to donate to the project.
-
-- [@andreynering](https://github.com/sponsors/andreynering)
-- [@pd93](https://github.com/sponsors/pd93)
-- [@vmaerten](https://github.com/sponsors/vmaerten)
-
 ## Open Collective
 
-If you prefer [Open Collective](https://opencollective.com/task) you can donate
-by using these links:
+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)
@@ -37,17 +22,15 @@ by using these links:
 - [$50 per month](https://opencollective.com/task/contribute/sponsor-28775/checkout)
 - [Custom value - One-time donation option supported](https://opencollective.com/task/donate)
 
-## PayPal
+## GitHub Sponsors
 
-You can donate to [@andreynering] via PayPal as well:
+- [@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)
 
-And if you're Brazilian, you can also donate to [@andreynering] via PIX by
+If you're Brazilian, you can donate any value by
 [using this QR Code](/img/pix.png).
-
-<!-- prettier-ignore-start -->
-[@andreynering]: https://github.com/andreynering
-<!-- prettier-ignore-end -->

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,30 +1,44 @@
 ---
 slug: /styleguide/
-sidebar_position: 11
+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.
 
@@ -43,7 +57,7 @@ tasks:
       - echo 'foo'
 ```
 
-## Separate the main sections with empty lines
+## Separate with spaces the mains sections
 
 ```yaml
 # bad
@@ -77,7 +91,7 @@ tasks:
   # ...
 ```
 
-## Separate tasks with empty lines
+## Add spaces between tasks
 
 ```yaml
 # bad
@@ -112,7 +126,7 @@ tasks:
       - echo 'baz'
 ```
 
-## Use only uppercase letters for variable names
+## Use upper-case variable names
 
 ```yaml
 # bad
@@ -139,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
@@ -160,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
@@ -184,7 +197,7 @@ tasks:
       - echo 'Do something'
 ```
 
-## Use a colon to separate the task namespace and name
+## Use colon for task namespacing
 
 ```yaml
 # good
@@ -201,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

@@ -2,10 +2,6 @@
   "name": "taskfile-dev",
   "version": "0.0.0",
   "private": true,
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/go-task/task"
-  },
   "scripts": {
     "docusaurus": "docusaurus",
     "start": "docusaurus start",
@@ -18,26 +14,17 @@
     "write-heading-ids": "docusaurus write-heading-ids"
   },
   "dependencies": {
-    "@docusaurus/core": "^3.5.2",
-    "@docusaurus/preset-classic": "^3.5.2",
-    "@mdx-js/react": "^3.0.0",
-    "clsx": "^2.0.0",
-    "prism-react-renderer": "^2.1.0",
+    "@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": "^19.0.0",
-    "react-dom": "^19.0.0",
-    "remark-gfm": "^4.0.0",
-    "remark-github": "^12.0.0"
+    "react": "^17.0.2",
+    "react-dom": "^17.0.2"
   },
   "devDependencies": {
-    "@docusaurus/module-type-aliases": "^3.5.2",
-    "@docusaurus/tsconfig": "^3.5.2",
-    "@docusaurus/types": "^3.5.2",
-    "@types/react": "^19.0.0",
-    "typescript": "^5.3.3"
-  },
-  "engines": {
-    "node": ">=18.0"
+    "@docusaurus/module-type-aliases": "2.0.0-beta.20"
   },
   "browserslist": {
     "production": [

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/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,138 +0,0 @@
-package errors
-
-import (
-	"bytes"
-	"cmp"
-	"errors"
-	"fmt"
-	"regexp"
-	"strings"
-
-	"github.com/fatih/color"
-	"gopkg.in/yaml.v3"
-)
-
-var typeErrorRegex = regexp.MustCompile(`line \d+: (.*)`)
-
-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", extractTypeErrorMessage(message)))
-				}
-			} else {
-				fmt.Fprintln(buf, color.RedString("err:  %s", extractTypeErrorMessage(te.Errors[0])))
-			}
-		} 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
-}
-
-func extractTypeErrorMessage(message string) string {
-	matches := typeErrorRegex.FindStringSubmatch(message)
-	if len(matches) == 2 {
-		return matches[1]
-	}
-	return message
-}

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,204 +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()
-}
-
-// 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 {
-	var vars []string
-	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,210 +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
-}
-
-func (err TaskfileNotFoundError) Error() string {
-	var walkText string
-	if err.Walk {
-		walkText = " (or any of the parent directories)"
-	}
-	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,422 +0,0 @@
-package task
-
-import (
-	"context"
-	"io"
-	"os"
-	"path/filepath"
-	"sync"
-	"time"
-
-	"github.com/puzpuzpuz/xsync/v3"
-	"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
-		TempDir     *TempDir
-		Force       bool
-		ForceAll    bool
-		Watch       bool
-		Verbose     bool
-		Silent      bool
-		AssumeYes   bool
-		AssumeTerm  bool // Used for testing
-		Dry         bool
-		Summary     bool
-		Parallel    bool
-		Color       bool
-		Concurrency int
-		Interval    time.Duration
-
-		// 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
-
-		concurrencySemaphore chan struct{}
-		taskCallCount        map[string]*int32
-		mkdirMutexMap        map[string]*sync.Mutex
-		executionHashes      map[string]context.Context
-		executionHashesMutex sync.Mutex
-		watchedDirs          *xsync.MapOf[string, bool]
-	}
-)
-
-// NewExecutor creates a new [Executor] and applies the given functional options
-// to it.
-func NewExecutor(graph *ast.TaskfileGraph, opts ...ExecutorOption) (*Executor, error) {
-	tf, err := graph.Merge()
-	if err != nil {
-		return nil, err
-	}
-	e := &Executor{
-		Taskfile:             tf,
-		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...)
-	if err := e.setup(); err != nil {
-		return nil, err
-	}
-	return e, nil
-}
-
-// 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) {
-	absDir, err := filepath.Abs(o.dir)
-	if err != nil {
-		e.Dir = o.dir
-		return
-	}
-	e.Dir = absDir
-}
-
-// 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
-}
-
-// 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
-}
-
-// 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
-}

executor_setup.go

@@ -1,202 +0,0 @@
-package task
-
-import (
-	"context"
-	"fmt"
-	"os"
-	"slices"
-	"sync"
-
-	"github.com/Masterminds/semver/v3"
-	"github.com/sajari/fuzzy"
-
-	"github.com/go-task/task/v3/errors"
-	"github.com/go-task/task/v3/internal/logger"
-	"github.com/go-task/task/v3/internal/output"
-	"github.com/go-task/task/v3/internal/version"
-	"github.com/go-task/task/v3/taskfile"
-	"github.com/go-task/task/v3/taskfile/ast"
-)
-
-func (e *Executor) setup() error {
-	e.setupLogger()
-	e.setupFuzzyModel()
-	e.setupStdFiles()
-	if err := e.setupOutput(); err != nil {
-		return err
-	}
-	if err := e.setupCompiler(); err != nil {
-		return err
-	}
-	if err := e.readDotEnvFiles(); err != nil {
-		return err
-	}
-	if err := e.doVersionChecks(); err != nil {
-		return err
-	}
-	e.setupDefaults()
-	e.setupConcurrencyState()
-	return nil
-}
-
-func (e *Executor) setupFuzzyModel() {
-	if e.Taskfile == nil {
-		return
-	}
-
-	model := fuzzy.NewModel()
-	model.SetThreshold(1) // because we want to build grammar based on every task name
-
-	var words []string
-	for name, task := range e.Taskfile.Tasks.All(nil) {
-		if task.Internal {
-			continue
-		}
-		words = append(words, name)
-		words = slices.Concat(words, task.Aliases)
-	}
-
-	model.Train(words)
-	e.fuzzyModel = model
-}
-
-func (e *Executor) setupStdFiles() {
-	if e.Stdin == nil {
-		e.Stdin = os.Stdin
-	}
-	if e.Stdout == nil {
-		e.Stdout = os.Stdout
-	}
-	if e.Stderr == nil {
-		e.Stderr = os.Stderr
-	}
-}
-
-func (e *Executor) setupLogger() {
-	e.Logger = &logger.Logger{
-		Stdin:      e.Stdin,
-		Stdout:     e.Stdout,
-		Stderr:     e.Stderr,
-		Verbose:    e.Verbose,
-		Color:      e.Color,
-		AssumeYes:  e.AssumeYes,
-		AssumeTerm: e.AssumeTerm,
-	}
-}
-
-func (e *Executor) setupOutput() error {
-	if !e.OutputStyle.IsSet() {
-		e.OutputStyle = e.Taskfile.Output
-	}
-
-	var err error
-	e.Output, err = output.BuildFor(&e.OutputStyle, e.Logger)
-	return err
-}
-
-func (e *Executor) setupCompiler() error {
-	if e.UserWorkingDir == "" {
-		var err error
-		e.UserWorkingDir, err = os.Getwd()
-		if err != nil {
-			return err
-		}
-	}
-
-	e.Compiler = &Compiler{
-		Dir:            e.Dir,
-		Entrypoint:     e.Taskfile.Location,
-		UserWorkingDir: e.UserWorkingDir,
-		TaskfileEnv:    e.Taskfile.Env,
-		TaskfileVars:   e.Taskfile.Vars,
-		Logger:         e.Logger,
-	}
-	return nil
-}
-
-func (e *Executor) readDotEnvFiles() error {
-	if e.Taskfile == nil || len(e.Taskfile.Dotenv) == 0 {
-		return nil
-	}
-
-	if e.Taskfile.Version.LessThan(ast.V3) {
-		return nil
-	}
-
-	vars, err := e.Compiler.GetTaskfileVariables()
-	if err != nil {
-		return err
-	}
-
-	env, err := taskfile.Dotenv(vars, e.Taskfile, e.Dir)
-	if err != nil {
-		return err
-	}
-
-	for k, v := range env.All() {
-		if _, ok := e.Taskfile.Env.Get(k); !ok {
-			e.Taskfile.Env.Set(k, v)
-		}
-	}
-	return err
-}
-
-func (e *Executor) setupDefaults() {
-	if e.Taskfile.Method == "" {
-		e.Taskfile.Method = "checksum"
-	}
-	if e.Taskfile.Run == "" {
-		e.Taskfile.Run = "always"
-	}
-}
-
-func (e *Executor) setupConcurrencyState() {
-	e.executionHashes = make(map[string]context.Context)
-
-	e.taskCallCount = make(map[string]*int32, e.Taskfile.Tasks.Len())
-	e.mkdirMutexMap = make(map[string]*sync.Mutex, e.Taskfile.Tasks.Len())
-	for k := range e.Taskfile.Tasks.Keys(nil) {
-		e.taskCallCount[k] = new(int32)
-		e.mkdirMutexMap[k] = &sync.Mutex{}
-	}
-
-	if e.Concurrency > 0 {
-		e.concurrencySemaphore = make(chan struct{}, e.Concurrency)
-	}
-}
-
-func (e *Executor) doVersionChecks() error {
-	if !e.EnableVersionCheck {
-		return nil
-	}
-	// Copy the version to avoid modifying the original
-	schemaVersion := &semver.Version{}
-	*schemaVersion = *e.Taskfile.Version
-
-	// Error if the Taskfile uses a schema version below v3
-	if schemaVersion.LessThan(ast.V3) {
-		return &errors.TaskfileVersionCheckError{
-			URI:           e.Taskfile.Location,
-			SchemaVersion: schemaVersion,
-			Message:       `no longer supported. Please use v3 or above`,
-		}
-	}
-
-	// Get the current version of Task
-	// If we can't parse the version (e.g. when its "devel"), then ignore the current version checks
-	currentVersion, err := semver.NewVersion(version.GetVersion())
-	if err != nil {
-		return nil
-	}
-
-	// Error if the Taskfile uses a schema version above the current version of Task
-	if schemaVersion.GreaterThan(currentVersion) {
-		return &errors.TaskfileVersionCheckError{
-			URI:           e.Taskfile.Location,
-			SchemaVersion: schemaVersion,
-			Message:       fmt.Sprintf(`is greater than the current version of Task (%s)`, currentVersion.String()),
-		}
-	}
-
-	return nil
-}

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,91 +0,0 @@
-package experiments
-
-import (
-	"fmt"
-	"os"
-	"path/filepath"
-	"strings"
-
-	"github.com/joho/godotenv"
-
-	"github.com/go-task/task/v3/taskrc"
-)
-
-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) {
-	// Read any .env files
-	readDotEnv(dir)
-
-	// Create a node for the Task config reader
-	node, _ := taskrc.NewNode("", dir)
-
-	// Read the Task config file
-	reader := taskrc.NewReader()
-	config, _ := reader.Read(node)
-
-	// 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,268 +0,0 @@
-package task_test
-
-import (
-	"bytes"
-	"context"
-	"path/filepath"
-	"slices"
-	"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"
-	"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
-		nodeDir         string
-		nodeEntrypoint  string
-		nodeInsecure    bool
-		readerOpts      []taskfile.ReaderOption
-		executorOpts    []task.ExecutorOption
-		listOptions     task.ListOptions
-		wantReaderError bool
-		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{},
-		nodeDir: ".",
-		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
-		ctx := context.Background()
-
-		// Create a new root node for the given entrypoint
-		node, err := taskfile.NewRootNode(
-			tt.nodeEntrypoint,
-			tt.nodeDir,
-			tt.nodeInsecure,
-		)
-		require.NoError(t, err)
-
-		// Create a golden fixture file for the output
-		g := goldie.New(t,
-			goldie.WithFixtureDir(filepath.Join(node.Dir(), "testdata")),
-		)
-
-		// Set up a temporary directory for the taskfile reader and task executor
-		tempDir, err := task.NewTempDir(node.Dir())
-		require.NoError(t, err)
-		tt.readerOpts = append(tt.readerOpts, taskfile.WithTempDir(tempDir.Remote))
-
-		// Set up the taskfile reader
-		reader := taskfile.NewReader(tt.readerOpts...)
-		graph, err := reader.Read(ctx, node)
-		if tt.wantReaderError {
-			require.Error(t, err)
-			tt.writeFixtureErrReader(t, g, err)
-			tt.writeFixtureBuffer(t, g, buf)
-			return
-		} else {
-			require.NoError(t, err)
-		}
-
-		executorOpts := slices.Concat(
-			// Apply the node directory and temp directory to the executor options
-			// by default, but allow them to by overridden by the test options
-			[]task.ExecutorOption{
-				task.WithDir(node.Dir()),
-				task.WithTempDir(tempDir),
-			},
-			// Apply the executor options from the test
-			tt.executorOpts,
-			// Force the input/output streams to be set to the test buffer
-			[]task.ExecutorOption{
-				task.WithStdout(&buf),
-				task.WithStderr(&buf),
-			},
-		)
-
-		// Set up the task executor
-		executor, err := task.NewExecutor(graph, executorOpts...)
-		if 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 := executor.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,
-		WithNodeDir("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,
-		WithNodeDir("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,
-		WithNodeDir("testdata/list_mixed_desc"),
-		WithListOptions(task.ListOptions{
-			ListOnlyTasksWithDescriptions: true,
-		}),
-	)
-}
-
-func TestListDescInterpolation(t *testing.T) {
-	t.Parallel()
-
-	NewFormatterTest(t,
-		WithNodeDir("testdata/list_desc_interpolation"),
-		WithListOptions(task.ListOptions{
-			ListOnlyTasksWithDescriptions: true,
-		}),
-	)
-}
-
-func TestJsonListFormat(t *testing.T) {
-	t.Parallel()
-
-	NewFormatterTest(t,
-		WithNodeDir("testdata/json_list_format"),
-		WithListOptions(task.ListOptions{
-			FormatTaskListAsJSON: true,
-		}),
-		WithFixtureTemplating(),
-	)
-}

go.mod

@@ -1,61 +1,27 @@
 module github.com/go-task/task/v3
 
-go 1.23.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-git/go-billy/v5 v5.6.2
-	github.com/go-git/go-git/v5 v5.16.2
-	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/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/otiai10/copy v1.14.1
-	github.com/puzpuzpuz/xsync/v3 v3.5.1
-	github.com/sajari/fuzzy v1.0.0
-	github.com/sebdah/goldie/v2 v2.7.1
-	github.com/spf13/pflag v1.0.7
-	github.com/stretchr/testify v1.10.0
-	github.com/zeebo/xxh3 v1.0.2
-	golang.org/x/sync v0.16.0
-	golang.org/x/term v0.33.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.12.0
+	mvdan.cc/sh/v3 v3.6.0-0.dev.0.20220704111049-a6e3029cd899
 )
 
 require (
-	dario.cat/mergo v1.0.0 // indirect
-	github.com/Microsoft/go-winio v0.6.2 // indirect
-	github.com/ProtonMail/go-crypto v1.1.6 // indirect
-	github.com/cloudflare/circl v1.6.1 // indirect
-	github.com/cyphar/filepath-securejoin v0.4.1 // indirect
-	github.com/dlclark/regexp2 v1.11.5 // indirect
-	github.com/emirpasic/gods v1.18.1 // indirect
-	github.com/go-git/gcfg v1.5.1-0.20230307220236-3a3c6141e376 // indirect
-	github.com/golang/groupcache v0.0.0-20241129210726-2c02b8208cf8 // indirect
-	github.com/jbenet/go-context v0.0.0-20150711004518-d14ea06fba99 // indirect
-	github.com/kevinburke/ssh_config v1.2.0 // indirect
-	github.com/klauspost/cpuid/v2 v2.2.7 // indirect
-	github.com/mattn/go-colorable v0.1.13 // indirect
-	github.com/mattn/go-isatty v0.0.20 // indirect
-	github.com/otiai10/mint v1.6.3 // indirect
-	github.com/pjbgf/sha1cd v0.3.2 // 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/skeema/knownhosts v1.3.1 // indirect
-	github.com/stretchr/objx v0.5.2 // indirect
-	github.com/xanzy/ssh-agent v0.3.3 // indirect
-	golang.org/x/crypto v0.37.0 // indirect
-	golang.org/x/net v0.39.0 // indirect
-	golang.org/x/sys v0.34.0 // indirect
-	gopkg.in/warnings.v0 v0.1.2 // 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,177 +1,55 @@
-dario.cat/mergo v1.0.0 h1:AGCNq9Evsj31mOgNPcLyXc+4PNABt905YmuqPYYpBWk=
-dario.cat/mergo v1.0.0/go.mod h1:uNxQE+84aUszobStD9th8a29P2fMDhsBdgRYvZOxGmk=
-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/Microsoft/go-winio v0.5.2/go.mod h1:WpS1mjBmmwHBEWmogvA2mj8546UReBk4v8QkMxJ6pZY=
-github.com/Microsoft/go-winio v0.6.2 h1:F2VQgta7ecxGYO8k3ZZz3RS8fVIXVxONVUPlNERoyfY=
-github.com/Microsoft/go-winio v0.6.2/go.mod h1:yd8OoFMLzJbo9gZq8j5qaps8bJ9aShtEA8Ipt1oGCvU=
-github.com/ProtonMail/go-crypto v1.1.6 h1:ZcV+Ropw6Qn0AX9brlQLAUXfqLBc7Bl+f/DmNxpLfdw=
-github.com/ProtonMail/go-crypto v1.1.6/go.mod h1:rA3QumHc/FZ8pAHreoekgiAbzpNsfQAosU5td4SnOrE=
-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.19.0 h1:Im+SLRgT8maArxv81mULDWN8oKxkzboH07CHesxElq4=
-github.com/alecthomas/chroma/v2 v2.19.0/go.mod h1:RVX6AvYm4VfYe/zsk7mjHueLDZor3aWCNE14TFlepBk=
-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.4.0 h1:GhI2A8MACjfegCPVq9f1FLvIBS+DrQ2KQBFZP1iFzXc=
-github.com/alecthomas/repr v0.4.0/go.mod h1:Fr0507jx4eOXV7AlPV6AVZLYrLIuIeSOWtW57eE/O/4=
-github.com/anmitsu/go-shlex v0.0.0-20200514113438-38f4b401e2be h1:9AeTilPcZAjCFIImctFaOjnTIavg87rW78vTPkQqLI8=
-github.com/anmitsu/go-shlex v0.0.0-20200514113438-38f4b401e2be/go.mod h1:ySMOLuWl6zY27l47sB3qLNK6tF2fkHG55UZxx8oIVo4=
-github.com/armon/go-socks5 v0.0.0-20160902184237-e75332964ef5 h1:0CwZNZbxp69SHPdPJAN/hZIm0C4OItdklCFmMRWYpio=
-github.com/armon/go-socks5 v0.0.0-20160902184237-e75332964ef5/go.mod h1:wHh0iHkYZB8zMSxRWpUBQtwG5a7fFgvEO+odwuTv2gs=
-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/cloudflare/circl v1.6.1 h1:zqIqSPIndyBh1bjLVVDHMPpVKqp8Su/V+6MeDzzQBQ0=
-github.com/cloudflare/circl v1.6.1/go.mod h1:uddAzsPgqdMAYatqJ0lsjX1oECcQLIlRpzZh3pJrofs=
-github.com/creack/pty v1.1.24 h1:bJrF4RRfyJnbTJqzRLHzcGaZK1NeM5kTC9jGgovnR1s=
-github.com/creack/pty v1.1.24/go.mod h1:08sCNb52WyoAwi2QDyzUCTgcvVFhUzewun7wtTfvcwE=
-github.com/cyphar/filepath-securejoin v0.4.1 h1:JyxxyPEaktOD+GAnqIqTf9A8tHyAG22rowi7HkoSU1s=
-github.com/cyphar/filepath-securejoin v0.4.1/go.mod h1:Sdj7gXlvMcPZsbhwhQ33GguGLDGQL7h7bg04C/+u9jI=
+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/elazarl/goproxy v1.7.2 h1:Y2o6urb7Eule09PjlhQRGNsqRfPmYI3KKQLFpCAV3+o=
-github.com/elazarl/goproxy v1.7.2/go.mod h1:82vkLNir0ALaW14Rc399OTTjyNREgmdL2cVoIbS6XaE=
-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/emirpasic/gods v1.18.1 h1:FXtiHYKDGKCW2KzwZKx0iC0PQmdlorYgdFG9jPXJ1Bc=
-github.com/emirpasic/gods v1.18.1/go.mod h1:8tpGGwCnJ5H4r6BWwaV6OrWmMoPhUl5jm/FMNAnJvWQ=
-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/gliderlabs/ssh v0.3.8 h1:a4YXD1V7xMF9g5nTkdfnja3Sxy1PVDCj1Zg4Wb8vY6c=
-github.com/gliderlabs/ssh v0.3.8/go.mod h1:xYoytBv1sV0aL3CavoDuJIQNURXkkfPA/wxQ1pL1fAU=
-github.com/go-git/gcfg v1.5.1-0.20230307220236-3a3c6141e376 h1:+zs/tPmkDkHx3U66DAb0lQFJrpS6731Oaa12ikc+DiI=
-github.com/go-git/gcfg v1.5.1-0.20230307220236-3a3c6141e376/go.mod h1:an3vInlBmSxCcxctByoQdvwPiA7DTK7jaaFDBTtu0ic=
-github.com/go-git/go-billy/v5 v5.6.2 h1:6Q86EsPXMa7c3YZ3aLAQsMA0VlWmy43r6FHqa/UNbRM=
-github.com/go-git/go-billy/v5 v5.6.2/go.mod h1:rcFC2rAsp/erv7CMz9GczHcuD0D32fWzH+MJAU+jaUU=
-github.com/go-git/go-git-fixtures/v4 v4.3.2-0.20231010084843-55a94097c399 h1:eMje31YglSBqCdIqdhKBW8lokaMrL3uTkpGYlE2OOT4=
-github.com/go-git/go-git-fixtures/v4 v4.3.2-0.20231010084843-55a94097c399/go.mod h1:1OCfN199q1Jm3HZlxleg+Dw/mwps2Wbk9frAWm+4FII=
-github.com/go-git/go-git/v5 v5.16.2 h1:fT6ZIOjE5iEnkzKyxTHK1W4HGAsPhqEqiSAssSO77hM=
-github.com/go-git/go-git/v5 v5.16.2/go.mod h1:4Ge4alE/5gPs30F2H1esi2gPd69R0C39lolkucHBOp8=
-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/groupcache v0.0.0-20241129210726-2c02b8208cf8 h1:f+oWsMOmNPc8JmEHVZIycC7hBoQxHH9pNKQORJNozsQ=
-github.com/golang/groupcache v0.0.0-20241129210726-2c02b8208cf8/go.mod h1:wcDNUvekVysuuOpQKo3191zZyTpiI6se1N1ULghS0sw=
-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/uuid v1.6.0 h1:NIvaJDMOsjHA8n1jAhLSgzrAzy1Hgr+hNrb57e+94F0=
-github.com/google/uuid v1.6.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo=
-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/jbenet/go-context v0.0.0-20150711004518-d14ea06fba99 h1:BQSFePA1RWJOlocH6Fxy8MmwDt+yVQYULKfN0RoTN8A=
-github.com/jbenet/go-context v0.0.0-20150711004518-d14ea06fba99/go.mod h1:1lJo3i6rXxKeerYnT8Nvf0QmHCRC1n8sfWVwXF2Frvo=
-github.com/joho/godotenv v1.5.1 h1:7eLL/+HRGLY0ldzfGMeQkb7vMd0as4CfYvUVzLqw0N0=
-github.com/joho/godotenv v1.5.1/go.mod h1:f4LDr5Voq0i2e/R5DDNOoa2zzDfwtkZa6DnEwAbqwq4=
-github.com/kevinburke/ssh_config v1.2.0 h1:x584FjTGwHzMwvHx18PXxbBVzfnxogHaAReU4gf13a4=
-github.com/kevinburke/ssh_config v1.2.0/go.mod h1:CT57kijsi8u/K/BOFA39wgDQJ9CxiF4nAY/ojJ6r6mM=
-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/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.13 h1:fFA4WZxdEF4tXPZVKMLwD8oUnCTTo08duU7wxecdEvA=
-github.com/mattn/go-colorable v0.1.13/go.mod h1:7S9/ev0klgBDR4GtXTXX8a3vIGJpMovkB8vQcUbaXHg=
-github.com/mattn/go-isatty v0.0.16/go.mod h1:kYGgaQfpe5nmfYZH+SKPsOc2e4SrIfOl2e/yFXSvRLM=
-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/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/onsi/gomega v1.34.1 h1:EUMJIKUjM8sKjYbtxQI9A4z2o+rruxnzNvpknOXie6k=
-github.com/onsi/gomega v1.34.1/go.mod h1:kU1QgUvBDLXBJq618Xvm2LUX6rSAfRaFRTcdOeDLwwY=
-github.com/otiai10/copy v1.14.1 h1:5/7E6qsUMBaH5AnQ0sSLzzTg1oTECmcCmT6lvF45Na8=
-github.com/otiai10/copy v1.14.1/go.mod h1:oQwrEDDOci3IM8dJF0d8+jnbfPDllW6vUjNc3DoZm9I=
-github.com/otiai10/mint v1.6.3 h1:87qsV/aw1F5as1eH1zS/yqHY85ANKVMgkDrf9rcxbQs=
-github.com/otiai10/mint v1.6.3/go.mod h1:MJm72SBthJjz8qhefc4z1PYEieWmy8Bku7CjcAqyUSM=
-github.com/pjbgf/sha1cd v0.3.2 h1:a9wb0bp1oC2TGwStyn0Umc/IGKQnEgF0vVaZ8QF8eo4=
-github.com/pjbgf/sha1cd v0.3.2/go.mod h1:zQWigSxVmsHEZow5qaLtPYxpcKMMQpa09ixqBxuCS6A=
-github.com/pkg/errors v0.8.1/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0=
-github.com/pkg/errors v0.9.1 h1:FEBLx1zS214owpjy7qsBeixbURkuhQAwrK5UwLGTwt4=
-github.com/pkg/errors v0.9.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/puzpuzpuz/xsync/v3 v3.5.1 h1:GJYJZwO6IdxN/IKbneznS6yPkVC+c3zyY/j19c++5Fg=
-github.com/puzpuzpuz/xsync/v3 v3.5.1/go.mod h1:VjzYrABPabuM4KyBh1Ftq6u8nhwY5tBPKP9jpmh0nnA=
-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.7.1 h1:PkBHymaYdtvEkZV7TmyqKxdmn5/Vcj+8TpATWZjnG5E=
-github.com/sebdah/goldie/v2 v2.7.1/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/sirupsen/logrus v1.7.0/go.mod h1:yWOB1SBYBC5VeMP7gHvWumXLIWorT60ONWic61uBYv0=
-github.com/skeema/knownhosts v1.3.1 h1:X2osQ+RAjK76shCbvhHHHVl3ZlgDm8apHEHFqRjnBY8=
-github.com/skeema/knownhosts v1.3.1/go.mod h1:r7KTdC8l4uxWRyK2TpQZ/1o5HaSzh06ePQNxPwTcfiY=
-github.com/spf13/pflag v1.0.7 h1:vN6T9TfwStFPFM5XzjsvmzZkLuaLX+HS+0SeFLRgU6M=
-github.com/spf13/pflag v1.0.7/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.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.2.2/go.mod h1:a8OnRcib4nhh0OaRAV+Yts87kKdq0PP7pXfy6kDkUVs=
-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.10.0 h1:Xv5erBjTwe/5IxqUQTdXv5kgmIvbHo3QQyRwhJsOfJA=
-github.com/stretchr/testify v1.10.0/go.mod h1:r2ic/lqez/lEtzL7wO/rwa5dbSLXVDPFyf8C91i36aY=
-github.com/xanzy/ssh-agent v0.3.3 h1:+/15pJfg/RsTxqYcX6fHqOXZwwMP+2VyYWJeWM2qQFM=
-github.com/xanzy/ssh-agent v0.3.3/go.mod h1:6dzNDKs0J9rVPHPhaGCukekBHKqfl+L3KghI1Bc68Uw=
-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=
-golang.org/x/crypto v0.0.0-20220622213112-05595931fe9d/go.mod h1:IxCIyHEi3zRg3s0A5j5BB6A9Jmi73HwBIUl50j+osU4=
-golang.org/x/crypto v0.37.0 h1:kJNSjF/Xp7kU0iB2Z+9viTPMW4EqqsrywMXLJOOsXSE=
-golang.org/x/crypto v0.37.0/go.mod h1:vg+k43peMZ0pUMhYmVAWysMK35e6ioLh3wB8ZCAfbVc=
-golang.org/x/exp v0.0.0-20240719175910-8a7402abbf56 h1:2dVuKD2vS7b0QIHQbpyTISPd0LeHDbnYEryqj5Q1ug8=
-golang.org/x/exp v0.0.0-20240719175910-8a7402abbf56/go.mod h1:M4RDyNAINzryxdtnbRXRL/OHtkFuWGRjvuhBJpk2IlY=
-golang.org/x/net v0.0.0-20211112202133-69e39bad7dc2/go.mod h1:9nx3DQGgdP8bBQD5qxJ1jj9UTztislL4KSBs9R2vV5Y=
-golang.org/x/net v0.39.0 h1:ZCu7HMWDxpXpaiKdhzIfaltL9Lp31x/3fCP11bc6/fY=
-golang.org/x/net v0.39.0/go.mod h1:X7NRbYVEA+ewNkCNyJ513WmMdQ3BineSwVtN2zD/d+E=
-golang.org/x/sync v0.16.0 h1:ycBJEhp9p4vXvUZNszeOq0kGTPghopOL8q0fq3vstxw=
-golang.org/x/sync v0.16.0/go.mod h1:1dzgHSNfp02xaA81J2MS99Qcpr2w7fw1gpm99rleRqA=
-golang.org/x/sys v0.0.0-20191026070338-33540a1f6037/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
-golang.org/x/sys v0.0.0-20201119102817-f84b799fce68/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
-golang.org/x/sys v0.0.0-20210124154548-22da62e12c0c/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
-golang.org/x/sys v0.0.0-20210423082822-04245dca01da/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
-golang.org/x/sys v0.0.0-20210615035016-665e8c7367d1/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
+github.com/stretchr/objx v0.4.0/go.mod h1:YvHI0jy2hoMjB+UWwv71VJQ9isScKT/TqJzVSSt89Yw=
+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=
+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/sys v0.0.0-20220811171246-fbc7d0a398ab/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
-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.34.0 h1:H5Y5sJ2L2JRdyv7ROF1he/lPdvFsd0mJHFw2ThKHxLA=
-golang.org/x/sys v0.34.0/go.mod h1:BJP2sWEmIv4KK5OTEluFJCKSidICx8ciO85XgH3Ak8k=
-golang.org/x/term v0.0.0-20201126162022-7de9c90e9dd1/go.mod h1:bj7SfCRtBDWHUb9snDiAeCFNEtKQo2Wmx5Cou7ajbmo=
-golang.org/x/term v0.33.0 h1:NuFncQrRcaRvVmgRkvM3j/F00gWIAlcmlB8ACEKmGIg=
-golang.org/x/term v0.33.0/go.mod h1:s18+ql9tYWp1IfpV9DmCtQDDSRBUjKaw9M1eAv5UeF0=
-golang.org/x/text v0.3.6/go.mod h1:5Zoc/QRtKVWzQhOtBMvqHzDpF6irO9z98xDceosuGiQ=
-golang.org/x/text v0.24.0 h1:dd5Bzh4yt5KYA8f9CJHCP4FB4D51c2c6JvN37xJJkJ0=
-golang.org/x/text v0.24.0/go.mod h1:L8rBsPeo2pSS+xqN0d5u2ikmjtmoJbDBT1b7nHvFCdU=
-golang.org/x/tools v0.0.0-20180917221912-90fa682c2a6e/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ=
+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/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
-gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c h1:Hei/4ADfdWqJk1ZMxUNpqntNwaWcugrBjAiHlqqRiVk=
-gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c/go.mod h1:JHkPIbrfpd72SG/EVd6muEfDQjcINNoR0C8j2r3qZ4Q=
-gopkg.in/warnings.v0 v0.1.2 h1:wFXVbFY8DY5/xOe1ECiWdKCzZlxgshcYVNkBHstARME=
-gopkg.in/warnings.v0 v0.1.2/go.mod h1:jksf8JmL6Qr/oQM2OXTHunEvvTAsrWBLb6OOjuVWRNI=
+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=
-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,189 +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
+// 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 bool) ListOptions {
-	return ListOptions{
-		ListOnlyTasksWithDescriptions: list,
-		ListAllTasks:                  listAll,
-		FormatTaskListAsJSON:          listAsJson,
-		NoStatus:                      noStatus,
-	}
+// 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)
-		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) (*editors.Taskfile, error) {
-	o := &editors.Taskfile{
-		Tasks:    make([]editors.Task, len(tasks)),
-		Location: e.Taskfile.Location,
-	}
-	var g errgroup.Group
-	for i := range tasks {
-		aliases := []string{}
-		if len(tasks[i].Aliases) > 0 {
-			aliases = tasks[i].Aliases
-		}
-		g.Go(func() error {
-			o.Tasks[i] = editors.Task{
-				Name:     tasks[i].Name(),
-				Task:     tasks[i].Task,
-				Desc:     tasks[i].Desc,
-				Summary:  tasks[i].Summary,
-				Aliases:  aliases,
-				UpToDate: false,
-				Location: &editors.Location{
-					Line:     tasks[i].Location.Line,
-					Column:   tasks[i].Location.Column,
-					Taskfile: tasks[i].Location.Taskfile,
-				},
-			}
-
-			if noStatus {
-				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
-			}
-
-			o.Tasks[i].UpToDate = upToDate
-
-			return nil
-		})
-	}
-	return o, g.Wait()
 }