task

• Added support for looping over dependencies (#1299, #1541 by @pd93).
• When using the "Remote Taskfiles" experiment, you are now able to use remote Taskfiles as your entrypoint.
• includes in remote Taskfiles will now also resolve correctly (#1347 by @pd93).
• When using the "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).

• 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).

• Added support for wildcards in task names (#836, #1489 by @pd93).
• Added the ability to run Taskfiles via 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).

• Fixed prompt regression on Remote Taskfiles experiment (#1486, #1487 by @pd93).

• Removed support for version: 2 schemas. See the deprecation notice on our website (#1197, #1447 by @pd93).
• Fixed a couple of issues in the JSON Schema + added a CI step to ensure it's correct (#1471, #1474, #1476 by @sirosen).
• Added Any Variables experiment proposal 2 (#1415, #1444 by @pd93).
• Updated the experiments and deprecations documentation format (#1445 by @pd93).
• Added new template function: spew, which can be used to print variables for debugging purposes (#1452 by @pd93).
• Added new template function: merge, which can be used to merge any number of map variables (#1438, #1464 by @pd93).
• Small change on the API when using as a library: call.Direct became call.Indirect (#1459 by @pd93).
• Refactored the public read and taskfile packages and introduced taskfile/ast (#1450 by @pd93).
• ast.IncludedTaskfiles renamed to ast.Includes and orderedmap package renamed to omap plus some internal refactor work (#1456 by @pd93).
• Fix zsh completion script to allow lowercase taskfile file names (#1482 by @xontab).
• Improvements on how we check the Taskfile version (#1465 by @pd93).
• Added a new ROOT_TASKFILE special variable (#1468, #1469 by @pd93).
• Fix experiment flags in .env when the --dir or --taskfile flags were used (#1478 by @pd93).

• Added support for looping over map variables with the Any Variables experiment enabled (#1435, #1437 by @pd93).
• Fixed a bug where dynamic variables were causing errors during fast compilation (#1435, #1437 by @pd93)

• Added Any Variables experiment (#1415, #1421 by @pd93).
• Updated Docusaurus to v3 (#1432 by @pd93).
• Added aliases to --json flag output (#1430, #1431 by @pd93).
• Added new CLI_FORCE special variable containing whether the --force or --force-all flags were set (#1412, #1434 by @pd93).

Merry Christmas! 🎄 🎁 🎅 🤶

• Added ability to exclude some files from sources: by using exclude: (#225, #1324 by @pd93 and @andreynering).
• The Remote Taskfiles experiment now prefers remote files over cached ones by default (#1317, #1345 by @pd93).
• Added --timeout flag to the Remote Taskfiles experiment (#1317, #1345 by @pd93).
• Fix bug where dynamic vars: and env: were being executed when they should actually be skipped by platforms: (#1273, #1377 by @andreynering).
• Fix schema.json to make silent valid in cmds that use for (#1385, #1386 by @iainvm).
• Add new --no-status flag to skip expensive status checks when running task --list --json (#1348, #1368 by @amancevice).

• Enabled the --yes flag for the Remote Taskfiles experiment (#1344 by @pd93).
• Add ability to set watch: true in a task to automatically run it in watch mode (#231, #1361 by @andreynering).
• Fixed a bug on the watch mode where paths that contained .git (like .github), for example, were also being ignored (#1356 by @butuzov).
• Fixed a nil pointer error when running a Taskfile with no contents (#1341, #1342 by @pd93).
• Added a new exit code (107) for when a Taskfile does not contain a schema version (#1342 by @pd93).
• Increased limit of maximum task calls from 100 to 1000 for now, as some people have been reaching this limit organically now that we have loops. This check exists to detect recursive calls, but will be removed in favor of a better algorithm soon (#1321, #1332).
• Fixed templating on descriptions on task --list (#1343 by @blackjid).
• Fixed a bug where precondition errors were incorrectly being printed when task execution was aborted (#1337, #1338 by @sylv-io).

• Fixed a regression where some special variables weren't being set correctly (#1331, #1334 by @pd93).

• Prep work for Remote Taskfiles (#1316 by @pd93).
• Added the Remote Taskfiles experiment as a draft (#1152, #1317 by @pd93).
• Improve performance of content checksuming on sources: by replacing md5 with XXH3 which is much faster. This is a soft breaking change because checksums will be invalidated when upgrading to this release (#1325 by @ReillyBrogan).

We're looking for feedback on Remote Taskfile on #1317. Don't hesitate to add your opinion.

If you want to say "thank you" for the work done on this tool, consider sponsoring @andreynering and @pd93 via GitHub Sponsors.

• Update to Go 1.21 (bump minimum version to 1.20) (#1302 by @pd93)
• Fix a missing a line break on log when using --watch mode (#1285, #1297 by @FilipSolich).
• Fix defer on JSON Schema (#1288 by @calvinmclean and @andreynering).
• Fix bug in usage of special variables like {{.USER_WORKING_DIR}} in combination with includes (#1046, #1205, #1250, #1293, #1312, #1274 by @andarto, #1309 by @andreynering).
• Fix bug on --status flag. Running this flag should not have side-effects: it should not update the checksum on .task, only report its status (#1305, #1307 by @visciang, #1313 by @andreynering).

NOTE: v3.29.0 was skipped because of an issue on the release process.

• Added the ability to loop over commands and tasks using for (#82, #1220 by @pd93).
• Fixed variable propagation in multi-level includes (#778, #996, #1256 by @hudclark).
• Fixed a bug where the --exit-code code flag was not returning the correct exit code when calling commands indirectly (#1266, #1270 by @pd93).
• Fixed a nil panic when a dependency was commented out or left empty (#1263 by @neomantra).

• Fix panic when a .env directory (not file) is present on current directory (#1244, #1245 by @pd93).

• Allow Taskfiles starting with lowercase characters (#947, #1221 by @pd93).
  • e.g. taskfile.yml, taskfile.yaml, taskfile.dist.yml & taskfile.dist.yaml
• Bug fixes were made to the npm installation method. (#1190, by @sounisi5011).
• Added the gentle force experiment as a draft (#1200, #1216 by @pd93).
• Added an --experiments flag to allow you to see which experiments are enabled (#1242 by @pd93).
• Added ability to specify which variables are required in a task (#1203, #1204 by @benc-uk).

• Only rewrite checksum files in .task if the checksum has changed (#1185, #1194 by @deviantintegral).
• Added experiments documentation to the website (#1198 by @pd93).
• Deprecated version: 2 schema. This will be removed in the next major release (#1197, #1198, #1199 by @pd93).
• Added a new prompt: prop to set a warning prompt to be shown before running a potential dangurous task (#100, #1163 by @MaxCheetham, Documentation).
• Added support for single command task syntax. With this change, it's now possible to declare just cmd: in a task, avoiding the more complex cmds: [] when you have only a single command for that task (#1130, #1131 by @timdp).

• Support silent: when calling another tasks (#680, #1142 by @danquah).
• Improve PowerShell completion script (#1168 by @trim21).
• Add more languages to the website menu and show translation progress percentage (#1173 by @misitebao).
• Starting on this release, official binaries for FreeBSD will be available to download (#1068 by @andreynering).
• Fix some errors being unintendedly supressed (#1134 by @clintmod).
• Fix a nil pointer error when version is omitted from a Taskfile (#1148, #1149 by @pd93).
• Fix duplicate error message when a task does not exists (#1141, #1144 by @pd93).

• Fix Fish shell completion for tasks with aliases (#1113 by @patricksjackson).
• The default branch was renamed from master to main (#1049, #1048 by @pd93).
• Fix bug where "up-to-date" logs were not being omitted for silent tasks (#546, #1107 by @danquah).
• Add .hg (Mercurial) to the list of ignored directories when using --watch (#1098 by @misery).
• More improvements to the release tool (#1096 by @pd93).
• Enforce gofumpt linter (#1099 by @pd93)
• Add --sort flag for use with --list and --list-all (#946, #1105 by @pd93).
• Task now has custom exit codes depending on the error (#1114 by @pd93).

Task now has an official extension for Visual Studio Code contributed by @pd93! 🎉 The extension is maintained in a new repository under the go-task organization. We're looking to gather feedback from the community so please give it a go and let us know what you think via a discussion, issue or on our Discord!

NOTE:
The extension requires v3.23.0 to be installed in order to work.

• The website was integrated with Crowdin to allow the community to contribute with translations! Chinese is the first language available (#1057, #1058 by @misitebao).
• Added task location data to the --json flag output (#1056 by @pd93)
• Change the name of the file generated by task --init from Taskfile.yaml to Taskfile.yml (#1062 by @misitebao).
• Added new splitArgs template function ({{splitArgs "foo bar 'foo bar baz'"}}) to ensure string is split as arguments (#1040, #1059 by @dhanusaputra).
• Fix the value of {{.CHECKSUM}} variable in status (#1076, #1080 by @pd93).
• Fixed deep copy implementation (#1072 by @pd93)
• Created a tool to assist with releases (#1086 by @pd93).

• Add a brand new --global (-g) flag that will run a Taskfile from your $HOME directory. This is useful to have automation that you can run from anywhere in your system! (Documentation, #1029 by @andreynering).
• Add ability to set error_only: true on the group output mode. This will instruct Task to only print a command output if it returned with a non-zero exit code (#664, #1022 by @jaedle).
• Fixed bug where .task/checksum file was sometimes not being created when task also declares a status: (#840, #1035 by @harelwa, #1037 by @pd93).
• Refactored and decoupled fingerprinting from the main Task executor (#1039 by @pd93).
• Fixed deadlock issue when using run: once (#715, #1025 by @theunrepentantgeek).

If Task is useful to you or your company, consider becoming a sponsor.