- Add new
platforms:
attribute totask
andcmd
, 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]
orplatforms: [linux/amd64]
. Other platforms will be skipped (#978, #980 by @leaanthony).
- 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!
- 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 todocs
(#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
andTASKFILE_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 theTASK_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
andTASK_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, #769).
- 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
andTaskfile.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 exiting--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).
- Fix quote of empty strings in
- 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
andpwd -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)
- The
- 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).
- Add official support to Apple M1 (#564, #567).
- Our official Homebrew tap will support more platforms, including Apple M1
- Add
run:
setting to control if tasks should run multiple times or not. Available options arealways
(the default),when_changed
(if a variable modified the task) andonce
(run only once no matter what). This is a long time requested feature. Enjoy! (#53, #359).
- Allow using both
sources:
andstatus:
in the same task (#411, #427, #477). - Small optimization and bug fix: don't compute variables if not needed for
dotenv:
(#517).
- Add support for the
NO_COLOR
environment variable. (#459, fatih/color#137). - Fix bug where sources were not considering the right directory
in
--watch
mode (#484, #485).
- On watch, report which file failed to read (#472).
- Do not try to catch SIGKILL signal, which are not actually possible (#476).
- Improve version reporting when building Task from source using Go Modules (#462, #473).
- 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).
- A JSON Schema was published here and is automatically being used by some editors like Visual Studio Code (#135).
- Print task name before the command in the log output (#398).
- Add support for delegating CLI arguments to commands with
--
and a specialCLI_ARGS
variable (#327). - Add a
--concurrency
(alias-C
) flag, to limit the number of tasks that run concurrently. This is useful for heavy workloads. (#345).
- Improve performance of
--list
and--summary
by skipping running shell variables for these flags (#332). - Fixed a bug where an environment in a Taskfile was not always overridable by the system environment (#425).
- Fixed environment from .env files not being available as variables (#379).
- The install script is now working for ARM platforms (#428).
- Fixed some bugs and regressions regarding dynamic variables and directories (#426).
- The slim-sprig package was updated with the upstream sprig.
- Fix the
.task
directory being created in the task directory instead of the Taskfile directory (#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). - The watch feature (via the
--watch
flag) got a few different bug fixes and should be more stable now (#423, #365).
- Fix a bug when the checksum up-to-date resolution is used by a task
with a custom
label:
attribute (#412). - Starting from this release, we're releasing official ARMv6 and ARM64 binaries for Linux (#375, #418).
- Task now respects the order of declaration of included Taskfiles when evaluating variables declaring by them (#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).
- Allow use as a library by moving the required packages out of the
internal
directory (#358). - Do not error if a specified dotenv file does not exist (#378, #385).
- Fix panic when you have empty tasks in your Taskfile (#338, #362).
- On
v3
, all CLI variables will be considered global variables (#336, #341) - Add support to
.env
like files (#324, #356). - Add
label:
to task so you can override the task name in the logs (#321, #337). - Refactor how variables work on version 3 (#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). - Implement short task syntax (#194, #240).
- Added option to make included Taskfile run commands on its own directory (#260, #144)
- Taskfiles in version 1 are not supported anymore (#237).
- Added global
method:
option. With this option, you can set a default method to all tasks in a Taskfile (#246). - Changed default method from
timestamp
tochecksum
(#246). - New magic variables are now available when using
status:
:.TIMESTAMP
which contains the greatest modification date from the files listed insources:
, and.CHECKSUM
, which contains a checksum of all files listed instatus:
. This is useful for manual checking when using external, or even remote, artifacts when usingstatus:
(#216). - We're now using slim-sprig instead of sprig, which allowed a file size reduction of about 22% (#219).
- We now use some colors on Task output to better distinguish message types - commands are green, errors are red, etc (#207).
- Fix error code for the
--help
flag (#300, #330). - Print version to stdout instead of stderr (#299, #329).
- Supress
context
errors when using the--watch
flag (#313, #317). - Support templating on description (#276, #283).
- Add
--parallel
flag (alias-p
) to run tasks given by the command line in parallel (#266). - Fixed bug where calling the
task
CLI only informing global vars would not execute thedefault
task. - Add hability to silent all tasks by adding
silent: true
a the root of the Taskfile.
- Fix error being raised when
exit 0
was called (#251).
- Fixed panic bug when assigning a global variable (#229, #243).
- A task with
method: checksum
will now re-run if generated files are deleted (#228, #238).
- Fixed some bugs regarding minor version checks on
version:
. - Add
preconditions:
to task (#205). - Create directory informed on
dir:
if it doesn't exist (#209, #211). - We now have a
--taskfile
flag (alias-t
), which can be used to run another Taskfile (other than the defaultTaskfile.yml
) (#221). - It's now possible to install Task using Homebrew on Linux (go-task/homebrew-tap#1).
- Reverted YAML upgrade due issues with CRLF on Windows (#201, go-yaml/yaml#450).
- Allow setting global variables through the CLI (#192).
- Fixed some issues with interactive command line tools, where sometimes the output were not being shown, and similar issues (#114, #190, #200).
- Upgraded go-yaml/yaml from v2 to v3.
- 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 to use the new taskfile.dev domain on scripts from now on.
- Fixed to the ZSH completion (#182).
- Add
--summary
flag along withsummary:
task attribute (#180).
- Allow calling a task of the root Taskfile from an included Taskfile
by prefixing it with
:
(#161, #172), - Add flag to override the
output
option (#173); - Fix bug where Task was persisting the new checksum on the disk when the Dry Mode is enabled (#166);
- Fix file timestamp issue when the file name has spaces (#176);
- Mitigating path expanding issues on Windows (#170).
- On Windows, Task can now be installed using Scoop (#152);
- Fixed issue with file/directory globing (#153);
- Added ability to globally set environment variables ( #138, #159 ).
- 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).
- Added support for 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
- Fix suggestion to use
task --init
not being shown anymore (when aTaskfile.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)
- Add a
ignore_error
option to task and command (#123) - Add a dry run mode (
--dry
flag) (#126)
- 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
- Fix merging of YAML anchors (#112)
- Fixes panic on
task --list
Version 2.0.0 is here, with a new Taskfile format.
Please, make sure to read the Taskfile versions document, since it describes in depth what changed for this version.
- New Taskfile version 2 (go-task#77)
- Possibility to have global variables in the
Taskfile.yml
instead ofTaskvars.yml
(go-task#66) - Small improvements and fixes
- 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.
- 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)
- 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)
- Allow use of YAML for dynamic variables instead of $ prefix
VAR: {sh: echo Hello}
instead ofVAR: $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
- 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)
- 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
andsources
attributes (#26)
- 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
anderrgroup
packages (this will make other tasks to be cancelled, if one returned an error)
- 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)
- 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)
- Add LICENSE file