From 85ccb17283ce9f13867f5ab3635ff3db2b618754 Mon Sep 17 00:00:00 2001 From: task-bot <106601941+task-bot@users.noreply.github.com> Date: Sat, 14 Jan 2023 20:36:12 +0000 Subject: [PATCH] deploy: 73aba36309e9c68bf47d97df10ab920c06a94706 --- 404.html | 4 ++-- api/index.html | 4 ++-- ...f2afb.b58bb21d.js => 935f2afb.9ba8eab5.js} | 2 +- assets/js/9beb87c2.8d78f7b9.js | 1 + assets/js/9beb87c2.d141bca5.js | 1 - ...n.42fd07f1.js => runtime~main.ff999274.js} | 2 +- changelog/index.html | 20 ++++++++++++++----- community/index.html | 4 ++-- contributing/index.html | 4 ++-- donate/index.html | 4 ++-- faq/index.html | 4 ++-- index.html | 4 ++-- installation/index.html | 4 ++-- releasing/index.html | 4 ++-- search/index.html | 4 ++-- styleguide/index.html | 4 ++-- taskfile-versions/index.html | 4 ++-- usage/index.html | 4 ++-- 18 files changed, 44 insertions(+), 34 deletions(-) rename assets/js/{935f2afb.b58bb21d.js => 935f2afb.9ba8eab5.js} (96%) create mode 100644 assets/js/9beb87c2.8d78f7b9.js delete mode 100644 assets/js/9beb87c2.d141bca5.js rename assets/js/{runtime~main.42fd07f1.js => runtime~main.ff999274.js} (98%) diff --git a/404.html b/404.html index 23a06d26..948e2ae8 100644 --- a/404.html +++ b/404.html @@ -11,13 +11,13 @@ - +
Skip to main content

Page Not Found

We could not find what you were looking for.

Please contact the owner of the site that linked you to the original URL and let them know their link is broken.

- + \ No newline at end of file diff --git a/api/index.html b/api/index.html index b825f30b..5616bd93 100644 --- a/api/index.html +++ b/api/index.html @@ -11,7 +11,7 @@ - + @@ -21,7 +21,7 @@ variable

ShortFlagTypecmds and everything else will be set to their default values:

tasks:
  foo: echo "foo"

  foobar:
    - echo "foo"
    - echo "bar"

  baz:
    cmd: echo "baz"

Dependency​

AttributeTypeDefaultDescription
taskstringThe task to be execute as a dependency.
varsmap[string]VariableOptional 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):

tasks:
  foo:
    deps: [foo, bar]

Command​

AttributeTypeDefaultDescription
cmdstringThe shell command to be executed.
silentboolfalseSkips some output for this command. Note that STDOUT and STDERR of the commands will still be redirected.
taskstringSet this to trigger execution of another task instead of running a command. This cannot be set together with cmd.
varsmap[string]VariableOptional additional variables to be passed to the referenced task. Only relevant when setting task instead of cmd.
ignore_errorboolfalseContinue execution if errors happen while executing the command.
deferstringAlternative 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.
platforms[]stringAll platformsSpecifies which platforms the command should be run on. Valid GOOS and GOARCH values allowed. Command will be skipped otherwise.
set[]stringSpecify options for the set builtin.
shopt[]stringSpecify option for the shopt builtin.
info

If given as a a string, the value will be assigned to cmd:

tasks:
  foo:
    cmds:
      - echo "foo"
      - echo "bar"

Variable​

AttributeTypeDefaultDescription
itselfstringA static value that will be set to the variable.
shstringA shell command. The output (STDOUT) will be assigned to the variable.
info

Static and dynamic variables have different syntaxes, like below:

vars:
  STATIC: static
  DYNAMIC:
    sh: echo "dynamic"

Precondition​

AttributeTypeDefaultDescription
shstringCommand to be executed. If a non-zero exit code is returned, the task errors without executing its commands.
msgstringOptional 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:

tasks:
  foo:
    precondition: test -f Taskfile.yml
- + \ No newline at end of file diff --git a/assets/js/935f2afb.b58bb21d.js b/assets/js/935f2afb.9ba8eab5.js similarity index 96% rename from assets/js/935f2afb.b58bb21d.js rename to assets/js/935f2afb.9ba8eab5.js index 71c4a646..b903b4e9 100644 --- a/assets/js/935f2afb.b58bb21d.js +++ b/assets/js/935f2afb.9ba8eab5.js @@ -1 +1 @@ -"use strict";(self.webpackChunktaskfile_dev=self.webpackChunktaskfile_dev||[]).push([[53],{1109:function(e){e.exports=JSON.parse('{"pluginId":"default","version":"current","label":"Next","banner":null,"badge":false,"noIndex":false,"className":"docs-version-current","isLast":true,"docsSidebars":{"tutorialSidebar":[{"type":"link","label":"Home","href":"/","docId":"intro"},{"type":"link","label":"Installation","href":"/installation/","docId":"installation"},{"type":"link","label":"Usage","href":"/usage/","docId":"usage"},{"type":"link","label":"API Reference","href":"/api/","docId":"api_reference"},{"type":"link","label":"FAQ","href":"/faq/","docId":"faq"},{"type":"link","label":"Styleguide","href":"/styleguide/","docId":"styleguide"},{"type":"link","label":"Changelog","href":"/changelog/","docId":"changelog"},{"type":"link","label":"Community","href":"/community/","docId":"community"},{"type":"link","label":"Contributing","href":"/contributing/","docId":"contributing"},{"type":"link","label":"Releasing","href":"/releasing/","docId":"releasing"},{"type":"link","label":"Taskfile Versions","href":"/taskfile-versions/","docId":"taskfile_versions"},{"type":"link","label":"Donate","href":"/donate/","docId":"donate"},{"type":"link","label":"Chinese | \u4e2d\u56fd\u4eba","href":"https://task-zh.readthedocs.io/zh_CN/latest/"},{"type":"html","value":"
"}]},"docs":{"api_reference":{"id":"api_reference","title":"API Reference","description":"CLI","sidebar":"tutorialSidebar"},"changelog":{"id":"changelog","title":"Changelog","description":"v3.19.1 - 2022-12-31","sidebar":"tutorialSidebar"},"community":{"id":"community","title":"Community","description":"Some of the work to improve the Task ecosystem is done by the community, be","sidebar":"tutorialSidebar"},"contributing":{"id":"contributing","title":"Contributing","description":"Contributions to Task are very welcome, but we ask that you read this document","sidebar":"tutorialSidebar"},"donate":{"id":"donate","title":"Donate","description":"If you find this project useful, you can consider donating by using one of the","sidebar":"tutorialSidebar"},"faq":{"id":"faq","title":"FAQ","description":"This page contains a list of frequently asked questions about Task.","sidebar":"tutorialSidebar"},"installation":{"id":"installation","title":"Installation","description":"Task offers many installation methods. Check out the available methods below.","sidebar":"tutorialSidebar"},"intro":{"id":"intro","title":"Home","description":"Task is a task runner / build tool that aims to be simpler and easier to use","sidebar":"tutorialSidebar"},"releasing":{"id":"releasing","title":"Releasing","description":"The release process of Task is done with the help of","sidebar":"tutorialSidebar"},"styleguide":{"id":"styleguide","title":"Styleguide","description":"This is the official Task styleguide for Taskfile.yml files. This guide","sidebar":"tutorialSidebar"},"taskfile_versions":{"id":"taskfile_versions","title":"Taskfile Versions","description":"The Taskfile syntax and features changed with time. This document explains what","sidebar":"tutorialSidebar"},"usage":{"id":"usage","title":"Usage","description":"Getting started","sidebar":"tutorialSidebar"}}}')}}]); \ No newline at end of file +"use strict";(self.webpackChunktaskfile_dev=self.webpackChunktaskfile_dev||[]).push([[53],{1109:function(e){e.exports=JSON.parse('{"pluginId":"default","version":"current","label":"Next","banner":null,"badge":false,"noIndex":false,"className":"docs-version-current","isLast":true,"docsSidebars":{"tutorialSidebar":[{"type":"link","label":"Home","href":"/","docId":"intro"},{"type":"link","label":"Installation","href":"/installation/","docId":"installation"},{"type":"link","label":"Usage","href":"/usage/","docId":"usage"},{"type":"link","label":"API Reference","href":"/api/","docId":"api_reference"},{"type":"link","label":"FAQ","href":"/faq/","docId":"faq"},{"type":"link","label":"Styleguide","href":"/styleguide/","docId":"styleguide"},{"type":"link","label":"Changelog","href":"/changelog/","docId":"changelog"},{"type":"link","label":"Community","href":"/community/","docId":"community"},{"type":"link","label":"Contributing","href":"/contributing/","docId":"contributing"},{"type":"link","label":"Releasing","href":"/releasing/","docId":"releasing"},{"type":"link","label":"Taskfile Versions","href":"/taskfile-versions/","docId":"taskfile_versions"},{"type":"link","label":"Donate","href":"/donate/","docId":"donate"},{"type":"link","label":"Chinese | \u4e2d\u56fd\u4eba","href":"https://task-zh.readthedocs.io/zh_CN/latest/"},{"type":"html","value":"
"}]},"docs":{"api_reference":{"id":"api_reference","title":"API Reference","description":"CLI","sidebar":"tutorialSidebar"},"changelog":{"id":"changelog","title":"Changelog","description":"v3.20.0 - 2023-01-14","sidebar":"tutorialSidebar"},"community":{"id":"community","title":"Community","description":"Some of the work to improve the Task ecosystem is done by the community, be","sidebar":"tutorialSidebar"},"contributing":{"id":"contributing","title":"Contributing","description":"Contributions to Task are very welcome, but we ask that you read this document","sidebar":"tutorialSidebar"},"donate":{"id":"donate","title":"Donate","description":"If you find this project useful, you can consider donating by using one of the","sidebar":"tutorialSidebar"},"faq":{"id":"faq","title":"FAQ","description":"This page contains a list of frequently asked questions about Task.","sidebar":"tutorialSidebar"},"installation":{"id":"installation","title":"Installation","description":"Task offers many installation methods. Check out the available methods below.","sidebar":"tutorialSidebar"},"intro":{"id":"intro","title":"Home","description":"Task is a task runner / build tool that aims to be simpler and easier to use","sidebar":"tutorialSidebar"},"releasing":{"id":"releasing","title":"Releasing","description":"The release process of Task is done with the help of","sidebar":"tutorialSidebar"},"styleguide":{"id":"styleguide","title":"Styleguide","description":"This is the official Task styleguide for Taskfile.yml files. This guide","sidebar":"tutorialSidebar"},"taskfile_versions":{"id":"taskfile_versions","title":"Taskfile Versions","description":"The Taskfile syntax and features changed with time. This document explains what","sidebar":"tutorialSidebar"},"usage":{"id":"usage","title":"Usage","description":"Getting started","sidebar":"tutorialSidebar"}}}')}}]); \ No newline at end of file diff --git a/assets/js/9beb87c2.8d78f7b9.js b/assets/js/9beb87c2.8d78f7b9.js new file mode 100644 index 00000000..e6d07fc2 --- /dev/null +++ b/assets/js/9beb87c2.8d78f7b9.js @@ -0,0 +1 @@ +"use strict";(self.webpackChunktaskfile_dev=self.webpackChunktaskfile_dev||[]).push([[34],{3905:function(t,e,a){a.d(e,{Zo:function(){return k},kt:function(){return d}});var i=a(7294);function n(t,e,a){return e in t?Object.defineProperty(t,e,{value:a,enumerable:!0,configurable:!0,writable:!0}):t[e]=a,t}function l(t,e){var a=Object.keys(t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(t);e&&(i=i.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),a.push.apply(a,i)}return a}function s(t){for(var e=1;e=0||(n[a]=t[a]);return n}(t,e);if(Object.getOwnPropertySymbols){var l=Object.getOwnPropertySymbols(t);for(i=0;i=0||Object.prototype.propertyIsEnumerable.call(t,a)&&(n[a]=t[a])}return n}var o=i.createContext({}),p=function(t){var e=i.useContext(o),a=e;return t&&(a="function"==typeof t?t(e):s(s({},e),t)),a},k=function(t){var e=p(t.components);return i.createElement(o.Provider,{value:e},t.children)},m="mdxType",u={inlineCode:"code",wrapper:function(t){var e=t.children;return i.createElement(i.Fragment,{},e)}},h=i.forwardRef((function(t,e){var a=t.components,n=t.mdxType,l=t.originalType,o=t.parentName,k=r(t,["components","mdxType","originalType","parentName"]),m=p(a),h=n,d=m["".concat(o,".").concat(h)]||m[h]||u[h]||l;return a?i.createElement(d,s(s({ref:e},k),{},{components:a})):i.createElement(d,s({ref:e},k))}));function d(t,e){var a=arguments,n=e&&e.mdxType;if("string"==typeof t||n){var l=a.length,s=new Array(l);s[0]=h;var r={};for(var o in e)hasOwnProperty.call(e,o)&&(r[o]=e[o]);r.originalType=t,r[m]="string"==typeof t?t:n,s[1]=r;for(var p=2;p=0||(l[a]=t[a]);return l}(t,e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(t);for(i=0;i=0||Object.prototype.propertyIsEnumerable.call(t,a)&&(l[a]=t[a])}return l}var o=i.createContext({}),p=function(t){var e=i.useContext(o),a=e;return t&&(a="function"==typeof t?t(e):s(s({},e),t)),a},k=function(t){var e=p(t.components);return i.createElement(o.Provider,{value:e},t.children)},u="mdxType",m={inlineCode:"code",wrapper:function(t){var e=t.children;return i.createElement(i.Fragment,{},e)}},h=i.forwardRef((function(t,e){var a=t.components,l=t.mdxType,n=t.originalType,o=t.parentName,k=r(t,["components","mdxType","originalType","parentName"]),u=p(a),h=l,d=u["".concat(o,".").concat(h)]||u[h]||m[h]||n;return a?i.createElement(d,s(s({ref:e},k),{},{components:a})):i.createElement(d,s({ref:e},k))}));function d(t,e){var a=arguments,l=e&&e.mdxType;if("string"==typeof t||l){var n=a.length,s=new Array(n);s[0]=h;var r={};for(var o in e)hasOwnProperty.call(e,o)&&(r[o]=e[o]);r.originalType=t,r[u]="string"==typeof t?t:l,s[1]=r;for(var p=2;p=o)&&Object.keys(u.O).every((function(e){return u.O[e](n[i])}))?n.splice(i--,1):(c=!1,o0&&e[d-1][2]>o;d--)e[d]=e[d-1];e[d]=[n,r,o]},u.n=function(e){var t=e&&e.__esModule?function(){return e.default}:function(){return e};return u.d(t,{a:t}),t},n=Object.getPrototypeOf?function(e){return Object.getPrototypeOf(e)}:function(e){return e.__proto__},u.t=function(e,r){if(1&r&&(e=this(e)),8&r)return e;if("object"==typeof e&&e){if(4&r&&e.__esModule)return e;if(16&r&&"function"==typeof e.then)return e}var o=Object.create(null);u.r(o);var f={};t=t||[null,n({}),n([]),n(n)];for(var c=2&r&&e;"object"==typeof c&&!~t.indexOf(c);c=n(c))Object.getOwnPropertyNames(c).forEach((function(t){f[t]=function(){return e[t]}}));return f.default=function(){return e},u.d(o,f),o},u.d=function(e,t){for(var n in t)u.o(t,n)&&!u.o(e,n)&&Object.defineProperty(e,n,{enumerable:!0,get:t[n]})},u.f={},u.e=function(e){return Promise.all(Object.keys(u.f).reduce((function(t,n){return u.f[n](e,t),t}),[]))},u.u=function(e){return"assets/js/"+({34:"9beb87c2",53:"935f2afb",80:"4d54d076",133:"f1d66b0d",217:"3b8c55ea",514:"1be78505",552:"0afd354a",582:"f7fd502c",595:"d0766b26",648:"3c140c84",671:"0e384e19",705:"7d415946",713:"1c56b476",827:"6476eba6",836:"0480b142",880:"5ef0e9d6",918:"17896441",920:"1a4e3797"}[e]||e)+"."+{34:"d141bca5",53:"b58bb21d",80:"20f3396f",133:"6862b446",217:"4890eded",514:"c3290964",552:"e8bad103",582:"941e9bd2",595:"c5627647",648:"b629b889",671:"649e4736",705:"6bf3701e",713:"8ebae59e",780:"b979b06f",827:"756bbc7c",836:"098568bb",880:"bc3ff7f3",894:"4bf7d380",918:"22a90ead",920:"0724cc4c",945:"3694633c",972:"f5c2bd8c"}[e]+".js"},u.miniCssF=function(e){},u.g=function(){if("object"==typeof globalThis)return globalThis;try{return this||new Function("return this")()}catch(e){if("object"==typeof window)return window}}(),u.o=function(e,t){return Object.prototype.hasOwnProperty.call(e,t)},r={},o="taskfile-dev:",u.l=function(e,t,n,f){if(r[e])r[e].push(t);else{var c,i;if(void 0!==n)for(var a=document.getElementsByTagName("script"),d=0;d=o)&&Object.keys(u.O).every((function(e){return u.O[e](n[i])}))?n.splice(i--,1):(c=!1,o0&&e[d-1][2]>o;d--)e[d]=e[d-1];e[d]=[n,r,o]},u.n=function(e){var t=e&&e.__esModule?function(){return e.default}:function(){return e};return u.d(t,{a:t}),t},n=Object.getPrototypeOf?function(e){return Object.getPrototypeOf(e)}:function(e){return e.__proto__},u.t=function(e,r){if(1&r&&(e=this(e)),8&r)return e;if("object"==typeof e&&e){if(4&r&&e.__esModule)return e;if(16&r&&"function"==typeof e.then)return e}var o=Object.create(null);u.r(o);var f={};t=t||[null,n({}),n([]),n(n)];for(var c=2&r&&e;"object"==typeof c&&!~t.indexOf(c);c=n(c))Object.getOwnPropertyNames(c).forEach((function(t){f[t]=function(){return e[t]}}));return f.default=function(){return e},u.d(o,f),o},u.d=function(e,t){for(var n in t)u.o(t,n)&&!u.o(e,n)&&Object.defineProperty(e,n,{enumerable:!0,get:t[n]})},u.f={},u.e=function(e){return Promise.all(Object.keys(u.f).reduce((function(t,n){return u.f[n](e,t),t}),[]))},u.u=function(e){return"assets/js/"+({34:"9beb87c2",53:"935f2afb",80:"4d54d076",133:"f1d66b0d",217:"3b8c55ea",514:"1be78505",552:"0afd354a",582:"f7fd502c",595:"d0766b26",648:"3c140c84",671:"0e384e19",705:"7d415946",713:"1c56b476",827:"6476eba6",836:"0480b142",880:"5ef0e9d6",918:"17896441",920:"1a4e3797"}[e]||e)+"."+{34:"8d78f7b9",53:"9ba8eab5",80:"20f3396f",133:"6862b446",217:"4890eded",514:"c3290964",552:"e8bad103",582:"941e9bd2",595:"c5627647",648:"b629b889",671:"649e4736",705:"6bf3701e",713:"8ebae59e",780:"b979b06f",827:"756bbc7c",836:"098568bb",880:"bc3ff7f3",894:"4bf7d380",918:"22a90ead",920:"0724cc4c",945:"3694633c",972:"f5c2bd8c"}[e]+".js"},u.miniCssF=function(e){},u.g=function(){if("object"==typeof globalThis)return globalThis;try{return this||new Function("return this")()}catch(e){if("object"==typeof window)return window}}(),u.o=function(e,t){return Object.prototype.hasOwnProperty.call(e,t)},r={},o="taskfile-dev:",u.l=function(e,t,n,f){if(r[e])r[e].push(t);else{var c,i;if(void 0!==n)for(var a=document.getElementsByTagName("script"),d=0;d -Changelog | Task +Changelog | Task @@ -11,12 +11,22 @@ - +
-

Changelog

v3.19.1 - 2022-12-31​

- +).

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 (#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 for making this pretty easy. To check the source code, just take a look at the 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

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 document, since it describes in depth what changed for this version.

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
+ \ No newline at end of file diff --git a/community/index.html b/community/index.html index eb70a595..cd6ab273 100644 --- a/community/index.html +++ b/community/index.html @@ -11,7 +11,7 @@ - + @@ -39,7 +39,7 @@ by reported bugs and answered questions.

If you know something that is missing in this document, please submit a pull request.

- + \ No newline at end of file diff --git a/contributing/index.html b/contributing/index.html index a1670cbd..490df8b9 100644 --- a/contributing/index.html +++ b/contributing/index.html @@ -11,7 +11,7 @@ - + @@ -64,7 +64,7 @@ simpler issues that are ideal for first time contributions.

All kinds of c feature. You can also contribute by upvoting/commenting on issues, helping to answer questions or contributing to other community projects.

I'm stuck, where can I get help?

If you have questions, feel free to ask them in the #help channel on our Discord server.

- + \ No newline at end of file diff --git a/donate/index.html b/donate/index.html index b8c66cca..3da8b408 100644 --- a/donate/index.html +++ b/donate/index.html @@ -11,7 +11,7 @@ - + @@ -25,7 +25,7 @@ Suspect businesses (gambling, casinos, etc) won't be allowed, though.

Open Collective​

If you prefer Open Collective you can donate by using these links:

PayPal​

You can donate to @andreynering via PayPal as well:

PIX (Brazil only)​

And if you're Brazilian, you can also donate to @andreynering via PIX by using this QR Code.

- + \ No newline at end of file diff --git a/faq/index.html b/faq/index.html index b1643924..77db748e 100644 --- a/faq/index.html +++ b/faq/index.html @@ -11,7 +11,7 @@ - + @@ -28,7 +28,7 @@ around this limitation using one of the following methods:

  • Use the
  • Use a shell on Windows that supports these commands as builtins, such as Git Bash or WSL.

We want to make improvements to this part of Task and the issues below track this work. Constructive comments and contributions are very welcome!

- + \ No newline at end of file diff --git a/index.html b/index.html index e5fbbc5a..d752b27b 100644 --- a/index.html +++ b/index.html @@ -11,7 +11,7 @@ - + @@ -28,7 +28,7 @@ to install on your CI script and you're ready to use Task as part of your C Task also supports Windows thanks to this shell interpreter for Go.
  • Great for code generation: you can easily prevent a task from running if a given set of files haven't changed since last run (based either on its timestamp or content).

    • Gold Sponsors​

    Appwrite
    Appwrite
    - + \ No newline at end of file diff --git a/installation/index.html b/installation/index.html index 8f2a877c..fea0616e 100644 --- a/installation/index.html +++ b/installation/index.html @@ -11,7 +11,7 @@ - + @@ -45,7 +45,7 @@ default.

    - 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 properly installed and setup.

    You can easily install the latest release globally by running:

    go install github.com/go-task/task/v3/cmd/task@latest

    Or you can install into another directory:

    env GOBIN=/bin go install github.com/go-task/task/v3/cmd/task@latest

    If using Go 1.15 or earlier, instead use:

    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 instead, which is faster and more stable, since it'll just download the latest released binary.

    Setup completions​

    Download the autocompletion file corresponding to your shell.

    All completions are available on the Task repository.

    Bash​

    First, ensure that you installed bash-completion using your package manager.

    Make the completion file executable:

    chmod +x path/to/task.bash

    After, add this to your ~/.bash_profile:

    source path/to/task.bash

    ZSH​

    Put the _task file somewhere in your $FPATH:

    mv path/to/_task /usr/local/share/zsh/site-functions/_task

    Ensure that the following is present in your ~/.zshrc:

    autoload -U compinit
    compinit -i

    ZSH version 5.7 or later is recommended.

    Fish​

    Move the task.fish completion script:

    mv path/to/task.fish ~/.config/fish/completions/task.fish

    PowerShell​

    Open your profile script with:

    mkdir -Path (Split-Path -Parent $profile) -ErrorAction SilentlyContinue
    notepad $profile

    Add the line and save the file:

    Invoke-Expression -Command path/to/task.ps1
    - + \ No newline at end of file diff --git a/releasing/index.html b/releasing/index.html index ced8430d..88264844 100644 --- a/releasing/index.html +++ b/releasing/index.html @@ -11,7 +11,7 @@ - + @@ -34,7 +34,7 @@ If you think its Task version is outdated, open an issue to let us know.

    of updating versions there by editing this file. If you think its Task version is outdated, open an issue to let us know.

    - + \ No newline at end of file diff --git a/search/index.html b/search/index.html index fc8bc1b3..a271999c 100644 --- a/search/index.html +++ b/search/index.html @@ -11,13 +11,13 @@ - +

    Search the documentation

    - + \ No newline at end of file diff --git a/styleguide/index.html b/styleguide/index.html index da984f92..c11a5d36 100644 --- a/styleguide/index.html +++ b/styleguide/index.html @@ -11,7 +11,7 @@ - + @@ -24,7 +24,7 @@ need or want to. Also, feel free to open issues or pull requests with improvements to this guide.

    Use Taskfile.yml and not taskfile.yml​

    # bad
    taskfile.yml


    # good
    Taskfile.yml

    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.

    # bad
    tasks:
        foo:
            cmds:
                - echo 'foo'


    # good
    tasks:
      foo:
        cmds:
          - echo 'foo'

    Separate with spaces the mains sections​

    # bad
    version: '3'
    includes:
      docker: ./docker/Taskfile.yml
    output: prefixed
    vars:
      FOO: bar
    env:
      BAR: baz
    tasks:
      # ...


    # good
    version: '3'

    includes:
      docker: ./docker/Taskfile.yml

    output: prefixed

    vars:
      FOO: bar

    env:
      BAR: baz

    tasks:
      # ...

    Add spaces between tasks​

    # bad
    version: '3'

    tasks:
      foo:
        cmds:
          - echo 'foo'
      bar:
        cmds:
          - echo 'bar'
      baz:
        cmds:
          - echo 'baz'


    # good
    version: '3'

    tasks:
      foo:
        cmds:
          - echo 'foo'

      bar:
        cmds:
          - echo 'bar'

      baz:
        cmds:
          - echo 'baz'

    Use upper-case variable names​

    # bad
    version: '3'

    vars:
      binary_name: myapp

    tasks:
      build:
        cmds:
          - go build -o {{.binary_name}} .


    # good
    version: '3'

    vars:
      BINARY_NAME: myapp

    tasks:
      build:
        cmds:
          - go build -o {{.BINARY_NAME}} .

    Don't wrap vars in spaces when templating​

    # bad
    version: '3'

    tasks:
      greet:
        cmds:
          - echo '{{ .MESSAGE }}'


    # good
    version: '3'

    tasks:
      greet:
        cmds:
          - echo '{{.MESSAGE}}'

    This convention is also used by most people for any Go templating.

    Separate task name words with a dash​

    # bad
    version: '3'

    tasks:
      do_something_fancy:
        cmds:
          - echo 'Do something'


    # good
    version: '3'

    tasks:
      do-something-fancy:
        cmds:
          - echo 'Do something'

    Use colon for task namespacing​

    # good
    version: '3'

    tasks:
      docker:build:
        cmds:
          - docker ...

      docker:run:
        cmds:
          - docker-compose ...

    This is also done automatically when using included Taskfiles.

    - + \ No newline at end of file diff --git a/taskfile-versions/index.html b/taskfile-versions/index.html index 68d4b7a8..30cf15c1 100644 --- a/taskfile-versions/index.html +++ b/taskfile-versions/index.html @@ -11,7 +11,7 @@ - + @@ -39,7 +39,7 @@ included Taskfile will run:
    - + \ No newline at end of file diff --git a/usage/index.html b/usage/index.html index 14b3a3a3..f347de9b 100644 --- a/usage/index.html +++ b/usage/index.html @@ -11,7 +11,7 @@ - + @@ -197,7 +197,7 @@ and run the task again. This requires the sources attribute to be g so task knows which files to watch.

    The default watch interval is 5 seconds, but it's possible to change it by either setting interval: '500ms' in the root of the Taskfile passing it as an argument like --interval=500ms.

    - + \ No newline at end of file