From 43d84560e5685738901322d5109bb4667c0f428c Mon Sep 17 00:00:00 2001 From: Andrey Nering Date: Mon, 8 Apr 2024 22:12:11 -0300 Subject: [PATCH] v3.36.0 --- CHANGELOG.md | 2 +- cmd/release/main.go | 2 +- package-lock.json | 2 +- package.json | 2 +- website/docs/changelog.mdx | 20 +++++++ .../{api_reference.md => api_reference.mdx} | 16 ++++++ .../{changelog.md => changelog.mdx} | 46 ++++++++++++++++ .../{community.md => community.mdx} | 0 .../{contributing.md => contributing.mdx} | 28 +++++----- .../{deprecations.md => deprecations.mdx} | 0 .../{template.md => template.mdx} | 0 ...rsion_2_schema.md => version_2_schema.mdx} | 4 +- .../versioned_docs/version-latest/donate.md | 52 ------------------- .../experiments/any_variables.mdx | 4 +- .../{experiments.md => experiments.mdx} | 0 .../{gentle_force.md => gentle_force.mdx} | 10 ++-- ...mote_taskfiles.md => remote_taskfiles.mdx} | 21 ++------ .../experiments/{template.md => template.mdx} | 4 +- .../version-latest/{faq.md => faq.mdx} | 4 +- .../{installation.md => installation.mdx} | 14 ++--- .../{integrations.md => integrations.mdx} | 2 +- .../version-latest/{intro.md => intro.mdx} | 10 ++-- .../{releasing.md => releasing.mdx} | 4 +- .../{styleguide.md => styleguide.mdx} | 0 ...file_versions.md => taskfile_versions.mdx} | 4 +- .../{translate.md => translate.mdx} | 4 +- .../version-latest/{usage.md => usage.mdx} | 41 ++++++++++++++- 27 files changed, 176 insertions(+), 120 deletions(-) rename website/versioned_docs/version-latest/{api_reference.md => api_reference.mdx} (97%) rename website/versioned_docs/version-latest/{changelog.md => changelog.mdx} (94%) rename website/versioned_docs/version-latest/{community.md => community.mdx} (100%) rename website/versioned_docs/version-latest/{contributing.md => contributing.mdx} (88%) rename website/versioned_docs/version-latest/deprecations/{deprecations.md => deprecations.mdx} (100%) rename website/versioned_docs/version-latest/deprecations/{template.md => template.mdx} (100%) rename website/versioned_docs/version-latest/deprecations/{version_2_schema.md => version_2_schema.mdx} (95%) delete mode 100644 website/versioned_docs/version-latest/donate.md rename website/versioned_docs/version-latest/experiments/{experiments.md => experiments.mdx} (100%) rename website/versioned_docs/version-latest/experiments/{gentle_force.md => gentle_force.mdx} (84%) rename website/versioned_docs/version-latest/experiments/{remote_taskfiles.md => remote_taskfiles.mdx} (87%) rename website/versioned_docs/version-latest/experiments/{template.md => template.mdx} (94%) rename website/versioned_docs/version-latest/{faq.md => faq.mdx} (97%) rename website/versioned_docs/version-latest/{installation.md => installation.mdx} (96%) rename website/versioned_docs/version-latest/{integrations.md => integrations.mdx} (97%) rename website/versioned_docs/version-latest/{intro.md => intro.mdx} (92%) rename website/versioned_docs/version-latest/{releasing.md => releasing.mdx} (97%) rename website/versioned_docs/version-latest/{styleguide.md => styleguide.mdx} (100%) rename website/versioned_docs/version-latest/{taskfile_versions.md => taskfile_versions.mdx} (98%) rename website/versioned_docs/version-latest/{translate.md => translate.mdx} (92%) rename website/versioned_docs/version-latest/{usage.md => usage.mdx} (98%) diff --git a/CHANGELOG.md b/CHANGELOG.md index 398382a691..28cb95e066 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,6 +1,6 @@ # Changelog -## Unreleased +## v3.36.0 - 2024-04-08 - Added support for [looping over dependencies](https://taskfile.dev/usage/#looping-over-dependencies) diff --git a/cmd/release/main.go b/cmd/release/main.go index 15a5b6f9fb..d2f959ba82 100644 --- a/cmd/release/main.go +++ b/cmd/release/main.go @@ -15,7 +15,7 @@ import ( const ( changelogSource = "CHANGELOG.md" - changelogTarget = "website/docs/changelog.md" + changelogTarget = "website/docs/changelog.mdx" docsSource = "website/docs" docsTarget = "website/versioned_docs/version-latest" ) diff --git a/package-lock.json b/package-lock.json index 1257281dc2..883a977a33 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,6 +1,6 @@ { "name": "@go-task/cli", - "version": "3.35.1", + "version": "3.36.0", "lockfileVersion": 2, "requires": true, "packages": { diff --git a/package.json b/package.json index 47fdffcdeb..351a9ef512 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "@go-task/cli", - "version": "3.35.1", + "version": "3.36.0", "description": "A task runner / simpler Make alternative written in Go", "scripts": { "postinstall": "go-npm install", diff --git a/website/docs/changelog.mdx b/website/docs/changelog.mdx index eb0e635924..71b4559b0c 100644 --- a/website/docs/changelog.mdx +++ b/website/docs/changelog.mdx @@ -5,6 +5,26 @@ sidebar_position: 14 # Changelog +## v3.36.0 - 2024-04-08 + +- Added support for + [looping over dependencies](https://taskfile.dev/usage/#looping-over-dependencies) + (#1299, #1541 by @pd93). +- When using the + "[Remote Taskfiles](https://taskfile.dev/experiments/remote-taskfiles/)" + experiment, you are now able to use + [remote Taskfiles as your entrypoint](https://taskfile.dev/experiments/remote-taskfiles/#root-remote-taskfiles). + - `includes` in remote Taskfiles will now also resolve correctly (#1347 by + @pd93). +- When using the + "[Any Variables](https://taskfile.dev/experiments/any-variables/)" + experiments, templating is now supported in collection-type variables (#1477, + #1511, #1526 by @pd93). +- Fixed a bug where variables being passed to an included Taskfile were not + available when defining global variables (#1503, #1533 by @pd93). +- Improved support to customized colors by allowing 8-bit colors and multiple + ANSI attributes (#1576 by @pd93). + ## v3.35.1 - 2024-03-04 - Fixed a bug where the `TASKFILE_DIR` variable was sometimes incorrect (#1522, diff --git a/website/versioned_docs/version-latest/api_reference.md b/website/versioned_docs/version-latest/api_reference.mdx similarity index 97% rename from website/versioned_docs/version-latest/api_reference.md rename to website/versioned_docs/version-latest/api_reference.mdx index a53b7cf6d2..2981222683 100644 --- a/website/versioned_docs/version-latest/api_reference.md +++ b/website/versioned_docs/version-latest/api_reference.mdx @@ -130,6 +130,7 @@ There are some special variables that is available on the templating system: | `TASK` | The name of the current task. | | `ROOT_TASKFILE` | The absolute path of the root Taskfile. | | `ROOT_DIR` | The absolute path of the root Taskfile directory. | +| `TASKFILE` | The absolute path of the included Taskfile. | | `TASKFILE_DIR` | The absolute path of the included Taskfile directory. | | `USER_WORKING_DIR` | The absolute path of the directory `task` was called from. | | `CHECKSUM` | The checksum of the files listed in `sources`. Only available within the `status` prop and if method is set to `checksum`. | @@ -153,6 +154,17 @@ Some environment variables can be overridden to adjust Task behavior. | `TASK_COLOR_RED` | `31` | Color used for red. | | `FORCE_COLOR` | | Force color output usage. | +All color variables are [ANSI color codes][ansi]. You can specify multiple codes +separated by a semicolon. For example: `31;1` will make the text bold and red. +Task also supports 8-bit color (256 colors). You can specify these colors by +using the sequence `38;2;R:G:B` for foreground colors and `48;2;R:G:B` for +background colors where `R`, `G` and `B` should be replaced with values between +0 and 255. + +For convenience, we allow foreground colors to be specified using shorthand, +comma-separated syntax: `R,G,B`. For example, `255,0,0` is equivalent to +`38;2;255:0:0`. + ## Taskfile Schema | Attribute | Type | Default | Description | @@ -372,3 +384,7 @@ tasks: | Attribute | Type | Default | Description | | --------- | ---------- | ------- | -------------------------------------------------------------------------------------------------- | | `vars` | `[]string` | | List of variable or environment variable names that must be set if this task is to execute and run | + +{/* prettier-ignore-start */} +[ansi]: https://en.wikipedia.org/wiki/ANSI_escape_code +{/* prettier-ignore-end */} diff --git a/website/versioned_docs/version-latest/changelog.md b/website/versioned_docs/version-latest/changelog.mdx similarity index 94% rename from website/versioned_docs/version-latest/changelog.md rename to website/versioned_docs/version-latest/changelog.mdx index 33701df714..71b4559b0c 100644 --- a/website/versioned_docs/version-latest/changelog.md +++ b/website/versioned_docs/version-latest/changelog.mdx @@ -5,6 +5,52 @@ sidebar_position: 14 # Changelog +## v3.36.0 - 2024-04-08 + +- Added support for + [looping over dependencies](https://taskfile.dev/usage/#looping-over-dependencies) + (#1299, #1541 by @pd93). +- When using the + "[Remote Taskfiles](https://taskfile.dev/experiments/remote-taskfiles/)" + experiment, you are now able to use + [remote Taskfiles as your entrypoint](https://taskfile.dev/experiments/remote-taskfiles/#root-remote-taskfiles). + - `includes` in remote Taskfiles will now also resolve correctly (#1347 by + @pd93). +- When using the + "[Any Variables](https://taskfile.dev/experiments/any-variables/)" + experiments, templating is now supported in collection-type variables (#1477, + #1511, #1526 by @pd93). +- Fixed a bug where variables being passed to an included Taskfile were not + available when defining global variables (#1503, #1533 by @pd93). +- Improved support to customized colors by allowing 8-bit colors and multiple + ANSI attributes (#1576 by @pd93). + +## v3.35.1 - 2024-03-04 + +- Fixed a bug where the `TASKFILE_DIR` variable was sometimes incorrect (#1522, + #1523 by @pd93). +- Added a new `TASKFILE` special variable that holds the root Taskfile path + (#1523 by @pd93). +- Fixed various issues related to running a Taskfile from a subdirectory (#1529, + #1530 by @pd93). + +## v3.35.0 - 2024-02-28 + +- Added support for + [wildcards in task names](https://taskfile.dev/usage/#wildcard-arguments) + (#836, #1489 by @pd93). +- Added the ability to + [run Taskfiles via stdin](https://taskfile.dev/usage/#reading-a-taskfile-from-stdin) + (#655, #1483 by @pd93). +- Bumped minimum Go version to 1.21 (#1500 by @pd93). +- Fixed bug related to the `--list` flag (#1509, #1512 by @pd93, #1514, #1520 by + @pd93). +- Add mention on the documentation to the fact that the variable declaration + order is respected (#1510 by @kirkrodrigues). +- Improved style guide docs (#1495 by @iwittkau). +- Removed duplicated entry for `requires` on the API docs (#1491 by + @teatimeguest). + ## v3.34.1 - 2024-01-27 - Fixed prompt regression on diff --git a/website/versioned_docs/version-latest/community.md b/website/versioned_docs/version-latest/community.mdx similarity index 100% rename from website/versioned_docs/version-latest/community.md rename to website/versioned_docs/version-latest/community.mdx diff --git a/website/versioned_docs/version-latest/contributing.md b/website/versioned_docs/version-latest/contributing.mdx similarity index 88% rename from website/versioned_docs/version-latest/contributing.md rename to website/versioned_docs/version-latest/contributing.mdx index dbe15e6cda..8a86d37638 100644 --- a/website/versioned_docs/version-latest/contributing.md +++ b/website/versioned_docs/version-latest/contributing.mdx @@ -72,21 +72,21 @@ install the extension. Task uses [Docusaurus][docusaurus] to host a documentation server. The code for this is located in the core Task repository. This can be setup and run locally -by using `task docs` (requires `nodejs` & `yarn`). All content is written in -Markdown and is located in the `docs/docs` directory. All Markdown documents +by using `task website` (requires `nodejs` & `yarn`). All content is written in +Markdown and is located in the `website/docs` directory. All Markdown documents should have an 80 character line wrap limit (enforced by Prettier). -When making a change, consider whether a change to the [Usage -Guide](/usage) is necessary. This document contains descriptions and -examples of how to use Task features. If you're adding a new feature, try to -find an appropriate place to add a new section. If you're updating an existing -feature, ensure that the documentation and any examples are up-to-date. Ensure -that any examples follow the [Taskfile Styleguide](/styleguide). +When making a change, consider whether a change to the [Usage Guide](/usage) is +necessary. This document contains descriptions and examples of how to use Task +features. If you're adding a new feature, try to find an appropriate place to +add a new section. If you're updating an existing feature, ensure that the +documentation and any examples are up-to-date. Ensure that any examples follow +the [Taskfile Styleguide](/styleguide). If you added a new field, command or flag, ensure that you add it to the -[API Reference](/api). New fields also need to be added to the -[JSON Schema][json-schema]. The descriptions for fields in the API reference and -the schema should match. +[API Reference](/api). New fields also need to be added to the [JSON +Schema][json-schema]. The descriptions for fields in the API reference and the +schema should match. ### Writing tests @@ -147,7 +147,7 @@ If you have questions, feel free to ask them in the `#help` forum channel on our --- - +{/* prettier-ignore-start */} [task]: https://github.com/go-task/task [vscode-task]: https://github.com/go-task/vscode-task [go]: https://go.dev @@ -157,11 +157,11 @@ If you have questions, feel free to ask them in the `#help` forum channel on our [nodejs]: https://nodejs.org/en/ [yarn]: https://yarnpkg.com/ [docusaurus]: https://docusaurus.io -[json-schema]: https://github.com/go-task/task/blob/main/docs/static/schema.json +[json-schema]: https://github.com/go-task/task/blob/main/website/static/schema.json [task-open-issues]: https://github.com/go-task/task/issues [vscode-task-open-issues]: https://github.com/go-task/vscode-task/issues [good-first-issue]: https://github.com/go-task/task/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22 [discord-server]: https://discord.gg/6TY36E39UK [discussion]: https://github.com/go-task/task/discussions [conventional-commits]: https://www.conventionalcommits.org - +{/* prettier-ignore-end */} diff --git a/website/versioned_docs/version-latest/deprecations/deprecations.md b/website/versioned_docs/version-latest/deprecations/deprecations.mdx similarity index 100% rename from website/versioned_docs/version-latest/deprecations/deprecations.md rename to website/versioned_docs/version-latest/deprecations/deprecations.mdx diff --git a/website/versioned_docs/version-latest/deprecations/template.md b/website/versioned_docs/version-latest/deprecations/template.mdx similarity index 100% rename from website/versioned_docs/version-latest/deprecations/template.md rename to website/versioned_docs/version-latest/deprecations/template.mdx diff --git a/website/versioned_docs/version-latest/deprecations/version_2_schema.md b/website/versioned_docs/version-latest/deprecations/version_2_schema.mdx similarity index 95% rename from website/versioned_docs/version-latest/deprecations/version_2_schema.md rename to website/versioned_docs/version-latest/deprecations/version_2_schema.mdx index 7ed1b85d6a..1011e5c971 100644 --- a/website/versioned_docs/version-latest/deprecations/version_2_schema.md +++ b/website/versioned_docs/version-latest/deprecations/version_2_schema.mdx @@ -26,8 +26,8 @@ main branch. To use a more recent version of Task, you will need to ensure that your Taskfile uses the version 3 schema instead. A list of changes between version 2 and version 3 are available in the [Task v3 Release Notes][v3.0.0]. - +{/* prettier-ignore-start */} [v3.0.0]: https://github.com/go-task/task/releases/tag/v3.0.0 [v3.33.0]: https://github.com/go-task/task/releases/tag/v3.33.0 [deprecation-notice]: https://github.com/go-task/task/issues/1197 - +{/* prettier-ignore-end */} diff --git a/website/versioned_docs/version-latest/donate.md b/website/versioned_docs/version-latest/donate.md deleted file mode 100644 index 108a92506f..0000000000 --- a/website/versioned_docs/version-latest/donate.md +++ /dev/null @@ -1,52 +0,0 @@ ---- -slug: /donate/ -sidebar_position: 16 ---- - -# Donate - -If you find this project useful, you can consider donating by using one of the -channels listed below. - -This is just a way of saying "thank you", it won't give you any benefits like -higher priority on issues or something similar. - -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 50/50 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) - -## Open Collective - -If you prefer [Open Collective](https://opencollective.com/task) you can donate -by using these links: - -- [$2 per month](https://opencollective.com/task/contribute/backer-4034/checkout) -- [$5 per month](https://opencollective.com/task/contribute/supporter-8404/checkout) -- [$20 per month](https://opencollective.com/task/contribute/sponsor-4035/checkout) -- [$50 per month](https://opencollective.com/task/contribute/sponsor-28775/checkout) -- [Custom value - One-time donation option supported](https://opencollective.com/task/donate) - -## PayPal - -You can donate to [@andreynering] via PayPal as well: - -- [Any value - One-time donation](https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=GSVDU63RKG45A¤cy_code=USD&source=url) - -## PIX (Brazil only) - -And if you're Brazilian, you can also donate to [@andreynering] via PIX by -[using this QR Code](/img/pix.png). - - -[@andreynering]: https://github.com/andreynering - diff --git a/website/versioned_docs/version-latest/experiments/any_variables.mdx b/website/versioned_docs/version-latest/experiments/any_variables.mdx index bb292e8628..be768d10df 100644 --- a/website/versioned_docs/version-latest/experiments/any_variables.mdx +++ b/website/versioned_docs/version-latest/experiments/any_variables.mdx @@ -340,7 +340,7 @@ When looping over a map we also make an additional `{{.KEY}}` variable availabe that holds the string value of the map key. Remember that maps are unordered, so the order in which the items are looped over is random. - +{/* prettier-ignore-start */} [enabling-experiments]: /experiments/#enabling-experiments [slim-sprig]: https://go-task.github.io/slim-sprig/ - +{/* prettier-ignore-end */} diff --git a/website/versioned_docs/version-latest/experiments/experiments.md b/website/versioned_docs/version-latest/experiments/experiments.mdx similarity index 100% rename from website/versioned_docs/version-latest/experiments/experiments.md rename to website/versioned_docs/version-latest/experiments/experiments.mdx diff --git a/website/versioned_docs/version-latest/experiments/gentle_force.md b/website/versioned_docs/version-latest/experiments/gentle_force.mdx similarity index 84% rename from website/versioned_docs/version-latest/experiments/gentle_force.md rename to website/versioned_docs/version-latest/experiments/gentle_force.mdx index d468770c65..ab3d52d3b2 100644 --- a/website/versioned_docs/version-latest/experiments/gentle_force.md +++ b/website/versioned_docs/version-latest/experiments/gentle_force.mdx @@ -22,9 +22,9 @@ This experiment breaks the following functionality: :::info -To enable this experiment, set the environment variable: `TASK_X_FORCE=1`. Check -out [our guide to enabling experiments ][enabling-experiments] for more -information. +To enable this experiment, set the environment variable: +`TASK_X_GENTLE_FORCE=1`. Check out [our guide to enabling experiments +][enabling-experiments] for more information. ::: @@ -44,6 +44,6 @@ should replace all uses of the `--force` flag with `--force-all`. Alternatively, if you want to adopt the new behavior, you can continue to use the `--force` flag as you do now! - +{/* prettier-ignore-start */} [enabling-experiments]: /experiments/#enabling-experiments - +{/* prettier-ignore-end */} diff --git a/website/versioned_docs/version-latest/experiments/remote_taskfiles.md b/website/versioned_docs/version-latest/experiments/remote_taskfiles.mdx similarity index 87% rename from website/versioned_docs/version-latest/experiments/remote_taskfiles.md rename to website/versioned_docs/version-latest/experiments/remote_taskfiles.mdx index 852be8e5ea..742b451c67 100644 --- a/website/versioned_docs/version-latest/experiments/remote_taskfiles.md +++ b/website/versioned_docs/version-latest/experiments/remote_taskfiles.mdx @@ -48,16 +48,6 @@ tasks: and you run `task my-remote-namespace:hello`, it will print the text: "Hello from the remote Taskfile!" to your console. -## Root remote Taskfiles - -You can also specify a remote Taskfile as the entrypoint for Task by using the -`--taskfile` flag. This means you don't need to have any Taskfile defined -locally at all. For example: - -```shell -task --taskfile https://taskfile.dev hello -``` - ## Security Running commands from sources that you do not control is always a potential @@ -90,10 +80,9 @@ flag. Before enabling this flag, you should: Task currently supports both `http` and `https` URLs. However, the `http` requests will not execute by default unless you run the task with the `--insecure` flag. This is to protect you from accidentally running a remote -Taskfile that is hosted on and unencrypted connection. Sources that are not -protected by TLS are vulnerable to [man-in-the-middle -attacks][man-in-the-middle-attacks] and should be avoided unless you know what -you are doing. +Taskfile that is via an unencrypted connection. Sources that are not protected +by TLS are vulnerable to [man-in-the-middle attacks][man-in-the-middle-attacks] +and should be avoided unless you know what you are doing. ## Caching & Running Offline @@ -109,7 +98,7 @@ and look for a cached copy instead. This timeout can be configured by setting the `--timeout` flag and specifying a duration. For example, `--timeout 5s` will set the timeout to 5 seconds. - +{/* prettier-ignore-start */} [enabling-experiments]: /experiments/#enabling-experiments [man-in-the-middle-attacks]: https://en.wikipedia.org/wiki/Man-in-the-middle_attack - +{/* prettier-ignore-end */} diff --git a/website/versioned_docs/version-latest/experiments/template.md b/website/versioned_docs/version-latest/experiments/template.mdx similarity index 94% rename from website/versioned_docs/version-latest/experiments/template.md rename to website/versioned_docs/version-latest/experiments/template.mdx index 37ac99877c..fca9a527c2 100644 --- a/website/versioned_docs/version-latest/experiments/template.md +++ b/website/versioned_docs/version-latest/experiments/template.mdx @@ -37,6 +37,6 @@ information. \{Short explanation of how users should migrate to the new behavior\} - +{/* prettier-ignore-start */} [enabling-experiments]: /experiments/#enabling-experiments - +{/* prettier-ignore-end */} diff --git a/website/versioned_docs/version-latest/faq.md b/website/versioned_docs/version-latest/faq.mdx similarity index 97% rename from website/versioned_docs/version-latest/faq.md rename to website/versioned_docs/version-latest/faq.mdx index 6a8a96e6b7..4eb8403436 100644 --- a/website/versioned_docs/version-latest/faq.md +++ b/website/versioned_docs/version-latest/faq.mdx @@ -95,7 +95,7 @@ this work. Constructive comments and contributions are very welcome! - [mvdan/sh#93](https://github.com/mvdan/sh/issues/93) - [mvdan/sh#97](https://github.com/mvdan/sh/issues/97) - +{/* prettier-ignore-start */} [git-bash]: https://gitforwindows.org/ [wsl]: https://learn.microsoft.com/en-us/windows/wsl/install - +{/* prettier-ignore-end */} diff --git a/website/versioned_docs/version-latest/installation.md b/website/versioned_docs/version-latest/installation.mdx similarity index 96% rename from website/versioned_docs/version-latest/installation.md rename to website/versioned_docs/version-latest/installation.mdx index c9fc489e7c..ac5e063df0 100644 --- a/website/versioned_docs/version-latest/installation.md +++ b/website/versioned_docs/version-latest/installation.mdx @@ -29,23 +29,23 @@ so you also have that option if you prefer: brew install go-task ``` -### Tea +### pkgx -If you're on macOS or Linux and have [tea][tea] installed, getting Task is as +If you're on macOS or Linux and have [pkgx](https://pkgx.sh/) installed, getting Task is as simple as running: ```shell -tea task +pkgx task ``` -or, if you have tea’s magic enabled: +or, if you have pkgx integration enabled: ```shell task ``` This installation method is community owned. After a new release of Task, they -are automatically released by tea in a minimum of time. +are automatically released by pkgx in a minimum of time. ### Snap @@ -290,7 +290,7 @@ Add the line and save the file: Invoke-Expression -Command path/to/task.ps1 ``` - +{/* prettier-ignore-start */} [go]: https://golang.org/ [snapcraft]: https://snapcraft.io/task [homebrew]: https://brew.sh/ @@ -300,4 +300,4 @@ Invoke-Expression -Command path/to/task.ps1 [choco]: https://chocolatey.org/ [scoop]: https://scoop.sh/ [tea]: https://tea.xyz/ - +{/* prettier-ignore-end */} diff --git a/website/versioned_docs/version-latest/integrations.md b/website/versioned_docs/version-latest/integrations.mdx similarity index 97% rename from website/versioned_docs/version-latest/integrations.md rename to website/versioned_docs/version-latest/integrations.mdx index 2e15da29d7..3f2364c80e 100644 --- a/website/versioned_docs/version-latest/integrations.md +++ b/website/versioned_docs/version-latest/integrations.mdx @@ -32,7 +32,7 @@ To get autocompletion and validation for your Taskfile, see the This was initially created by @KROSF in [this Gist](https://gist.github.com/KROSF/c5435acf590acd632f71bb720f685895) and is now officially maintained in -[this file](https://github.com/go-task/task/blob/main/docs/static/schema.json) +[this file](https://github.com/go-task/task/blob/main/website/static/schema.json) and made available at https://taskfile.dev/schema.json. This schema can be used to validate Taskfiles and provide autocompletion in many code editors: diff --git a/website/versioned_docs/version-latest/intro.md b/website/versioned_docs/version-latest/intro.mdx similarity index 92% rename from website/versioned_docs/version-latest/intro.md rename to website/versioned_docs/version-latest/intro.mdx index 72151db0c0..8996ab3a48 100644 --- a/website/versioned_docs/version-latest/intro.md +++ b/website/versioned_docs/version-latest/intro.mdx @@ -2,13 +2,13 @@ slug: / sidebar_position: 1 title: Home +hide_title: true --- -# Task -
- +
+
Task is a task runner / build tool that aims to be simpler and easier to use than, for example, [GNU Make][make]. @@ -50,7 +50,7 @@ guide to check the full schema documentation and Task features. of files haven't changed since last run (based either on its timestamp or content). - +{/* prettier-ignore-start */} [make]: https://www.gnu.org/software/make/ [go]: https://go.dev/ [yaml]: http://yaml.org/ @@ -58,4 +58,4 @@ guide to check the full schema documentation and Task features. [snapcraft]: https://snapcraft.io/ [scoop]: https://scoop.sh/ [sh]: https://github.com/mvdan/sh - +{/* prettier-ignore-end */} diff --git a/website/versioned_docs/version-latest/releasing.md b/website/versioned_docs/version-latest/releasing.mdx similarity index 97% rename from website/versioned_docs/version-latest/releasing.md rename to website/versioned_docs/version-latest/releasing.mdx index 0db6ef8b5c..b22143521f 100644 --- a/website/versioned_docs/version-latest/releasing.md +++ b/website/versioned_docs/version-latest/releasing.mdx @@ -61,7 +61,7 @@ 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. - +{/* prettier-ignore-start */} [goreleaser]: https://goreleaser.com/ [homebrewtap]: https://github.com/go-task/homebrew-tap [gotaskrb]: https://github.com/go-task/homebrew-tap/blob/main/Formula/go-task.rb @@ -69,4 +69,4 @@ If you think its Task version is outdated, open an issue to let us know. [snappackage]: https://github.com/go-task/snap [snapcraftyaml]: https://github.com/go-task/snap/blob/main/snap/snapcraft.yaml#L2 [snapcraftdashboard]: https://snapcraft.io/task/releases - +{/* prettier-ignore-end */} diff --git a/website/versioned_docs/version-latest/styleguide.md b/website/versioned_docs/version-latest/styleguide.mdx similarity index 100% rename from website/versioned_docs/version-latest/styleguide.md rename to website/versioned_docs/version-latest/styleguide.mdx diff --git a/website/versioned_docs/version-latest/taskfile_versions.md b/website/versioned_docs/version-latest/taskfile_versions.mdx similarity index 98% rename from website/versioned_docs/version-latest/taskfile_versions.md rename to website/versioned_docs/version-latest/taskfile_versions.mdx index 989e17c278..0b08072645 100644 --- a/website/versioned_docs/version-latest/taskfile_versions.md +++ b/website/versioned_docs/version-latest/taskfile_versions.mdx @@ -255,9 +255,9 @@ The variable priority order was also different: 3. Task variables 4. `Taskvars.yml` variables - +{/* prettier-ignore-start */} [deprecate-version-2-schema]: /deprecations/version-2-schema/ [output]: /usage#output-syntax [ignore_errors]: /usage#ignore-errors [includes]: /usage#including-other-taskfiles - +{/* prettier-ignore-end */} diff --git a/website/versioned_docs/version-latest/translate.md b/website/versioned_docs/version-latest/translate.mdx similarity index 92% rename from website/versioned_docs/version-latest/translate.md rename to website/versioned_docs/version-latest/translate.mdx index 47f39b35a3..d45961d725 100644 --- a/website/versioned_docs/version-latest/translate.md +++ b/website/versioned_docs/version-latest/translate.mdx @@ -16,7 +16,7 @@ translations, please ask for access on the [#translations channel on our Discord server][discord]. If a given language is not being shown to Crowdin yet, just ask and we can configure it. - +{/* prettier-ignore-start */} [crowdin]: https://crowdin.com/project/taskfile [discord]: https://discord.gg/6TY36E39UK - +{/* prettier-ignore-end */} diff --git a/website/versioned_docs/version-latest/usage.md b/website/versioned_docs/version-latest/usage.mdx similarity index 98% rename from website/versioned_docs/version-latest/usage.md rename to website/versioned_docs/version-latest/usage.mdx index 7d1f1d73fe..cea5a9507e 100644 --- a/website/versioned_docs/version-latest/usage.md +++ b/website/versioned_docs/version-latest/usage.mdx @@ -1197,6 +1197,43 @@ tasks: - echo 'bar' ``` +### Looping over dependencies + +All of the above looping techniques can also be applied to the `deps` property. +This allows you to combine loops with concurrency: + +```yaml +version: '3' + +tasks: + default: + deps: + - for: [foo, bar] + task: my-task + vars: + FILE: '{{.ITEM}}' + + my-task: + cmds: + - echo '{{.FILE}}' +``` + +It is important to note that as `deps` are run in parallel, the order in which +the iterations are run is not guaranteed and the output may vary. For example, +the output of the above example may be either: + +```shell +foo +bar +``` + +or + +```shell +bar +foo +``` + ## Forwarding CLI arguments to commands If `--` is given in the CLI, all following parameters are added to a special @@ -1917,6 +1954,6 @@ if called by another task, either directly or as a dependency. ::: - +{/* prettier-ignore-start */} [gotemplate]: https://golang.org/pkg/text/template/ - +{/* prettier-ignore-end */}