task

• Added new TASK_VERSION special variable (#990, #1014 by @ja1code).
• Fixed a bug where tasks were sometimes incorrectly marked as internal (#1007 by @pd93).
• Update to Go 1.20 (bump minimum version to 1.19) (#1010 by @pd93)
• Added environment variable FORCE_COLOR support to force color output. Usefull for environments without TTY (#1003 by @automation-stack)

• Improve behavior and performance of status checking when using the timestamp mode (#976, #977 by @aminya).
• Performance optimizations were made for large Taskfiles (#982 by @pd93).
• Add ability to configure options for the set and shopt builtins (#908, #929 by @pd93, Documentation).
• Add new platforms: attribute to task and cmd, so it's now possible to choose in which platforms that given task or command will be run on. Possible values are operating system (GOOS), architecture (GOARCH) or a combination of the two. Example: platforms: [linux], platforms: [amd64] or platforms: [linux/amd64]. Other platforms will be skipped (#978, #980 by @leaanthony).

I hope everyone had a great Christmas 🎄 and I wish all an incredible 2023 as well 🌟 🎆

This release includes mostly small bug fixes, but it also included support to the brand new --json flag.

• Small bug fix: closing Taskfile.yml once we're done reading it (#963, #964 by @HeCorr).
• Fixes a bug in v2 that caused a panic when using a Taskfile_{{OS}}.yml file (#961, #971 by @pd93).
• Fixed a bug where watch intervals set in the Taskfile were not being respected (#969, #970 by @pd93)
• Add --json flag (alias -j) with the intent to improve support for code editors and add room to other possible integrations. This is basic for now, but we plan to add more info in the near future (#936 by @davidalpert, #764).

• Installation via npm now supports pnpm as well (go-task/go-npm#2, go-task/go-npm#3).
• It's now possible to run Taskfiles from subdirectories! A new USER_WORKING_DIR special variable was added to add even more flexibility for monorepos (#289, #920).
• Add task-level dotenv support (#389, #904).
• It's now possible to use global level variables on includes (#942, #943).
• The website got a brand new translation to Chinese by @DeronW. Thanks!

Special thanks to @pd93 for working on 3 of the topics above. Some other important contributions in recent releases were from him as well.

Also, thanks @appwrite for sponsoring Task as part of their OSS Fund Program.

• Show aliases on task --list --silent (task --ls). This means that aliases will be completed by the completion scripts (#919).
• Tasks in the root Taskfile will now be displayed first in --list/--list-all output (#806, #890).
• It's now possible to call a default task in an included Taskfile by using just the namespace. For example: docs:default is now automatically aliased to docs (#661, #815).

• Add a "Did you mean ...?" suggestion when a task does not exits another one with a similar name is found (#867, #880).
• Now YAML parse errors will print which Taskfile failed to parse (#885, #887).
• Add ability to set aliases for tasks and namespaces (#268, #340, #879).
• Improvements to Fish shell completion (#897).
• Added ability to set a different watch interval by setting interval: '500ms' or using the --interval=500ms flag (#813, #865).
• Add colored output to --list, --list-all and --summary flags (#845, #874).
• Fix unexpected behavior where label: was being shown instead of the task name on --list (#603, #877).

• Add npm as new installation method: npm i -g @go-task/cli (#870, #871, npm package).
• Add support to marking tasks and includes as internal, which will hide them from --list and --list-all (#818).

• Fix error when using variable in env: introduced in the previous release (#858, #866).
• Fix handling of CLI_ARGS (--) in Bash completion (#863).
• On zsh completion, add ability to replace --list-all with --list as already possible on the Bash completion (#861).

• Add new special variables ROOT_DIR and TASKFILE_DIR. This was a highly requested feature (#215, #857, Documentation).
• Follow symlinks on sources (#826, #831).
• Improvements and fixes to Bash completion (#835, #844).

• Always resolve relative include paths relative to the including Taskfile (#822, #823).
• Fix ZSH and PowerShell completions to consider all tasks instead of just the public ones (those with descriptions) (#803).

• 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, #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).
• Starting on this release, ARM architecture binaries are been released to Snap as well (#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, mvdan/sh#884, mvdan/sh#893).

• Added -n as an alias to --dry (#776, #777).
• Fix behavior of interrupt (SIGINT, SIGTERM) signals. Task will now give time for the processes running to do cleanup work (#458, #479, #728).
• Add new --exit-code (-x) flag that will pass-through the exit form the command being ran (#755).

• Fixed bug where, on Windows, variables were ending with \r because we were only removing the final \n but not \r\n (#717).

• The --list and --list-all flags can now be combined with the --silent flag to print the task names only, without their description (#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, #623, #656).
• Add ability to specify vars when including a Taskfile. Check out the documentation for more information (#677).

• 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 for more information (#647, #651).
• Add Taskfile.dist.yml and Taskfile.dist.yaml to the supported file name list. Check out the documentation for more information (#498, #666).

• A new --list-all (alias -a) flag is now available. It's similar to the existing --list (-l) but prints all tasks, even those without a description (#383, #401).
• It's now possible to schedule cleanup commands to run once a task finishes with the defer: keyword (Documentation, #475, #626).
• Remove long deprecated and undocumented $ variable prefix and ^ command prefix (#642, #644, #645).
• Add support for .yaml extension (as an alternative to .yml). This was requested multiple times throughout the years. Enjoy! (#183, #184, #369, #584, #621).
• Fixed error when computing a variable when the task directory do not exist yet (#481, #579).

• Upgrade mvdan/sh which contains a fix a for a important regression on Windows (#619, mvdan/sh#768, mvdan/sh#769).

• Add logging in verbose mode for when a task starts and finishes (#533, #588).
• Fix an issue with preconditions and context errors (#597, #598).
• Quote each {{.CLI_ARGS}} argument to prevent one with spaces to become many (#613).
• Fix nil pointer when cmd: was left empty (#612, #614).
• Upgrade mvdan/sh which contains two relevant fixes:
  • Fix quote of empty strings in shellQuote (#609, mvdan/sh#763).
  • Fix issue of wrong environment variable being picked when there's another very similar one (#586, mvdan/sh#745).
• Install shell completions automatically when installing via Homebrew (#264, #592, go-task/homebrew-tap#2).

• 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, mvdan/sh#737, Documentation)
• In this version mvdan.cc/sh was upgraded with some small fixes and features
  • The read -p flag is now supported (#314, mvdan/sh#551, mvdan/sh#772)
  • The pwd -P and pwd -L flags are now supported (#553, mvdan/sh#724, mvdan/sh#728)
  • The $GID environment variable is now correctly being set (#561, mvdan/sh#723)

• Add interactive: true setting to improve support for interactive CLI apps (#217, #563).
• Fix some nil errors (#534, #573).
• Add ability to declare an included Taskfile as optional (#519, #552).
• Add support for including Taskfiles in the home directory by using ~ (#539, #557).