Running other Tasks
When developing a task, you may find the need to run another task. To do this, we have provided you with a DSL you can use to call any task. The Task DSL is very similar to the Command DSL, but designed to delegate to the task run
command for you.
The DSL
The DSL is a sequence of chained methods that will always start with task()
and end with .run()
. The run
method tells the DSL that you are finished chaining methods and that the task should be executed. Here is the simplest possible example:
This would run a task.cfc
in the current working directory and the output would be flushed to the console.
Here are all the possible DSL methods that we'll unpack below:
task()
This is required to be the first method you call. It creates an instance of the TaskDSL
class and returns it. It accepts a single parameter called taskFile
which is the path of the task CFC you wish to run. Just like the task run
command, you can supply a full path or a relative path. The .cfc
extension is also optional. If you don't pass in a task CFC name, it defaults to task
.
target()
Use this method to override the default task target of run
.
params()
This method is used to pass parameters to your command. You can pass named or positional parameters to this method, and they will be pass along to the command in the same fashion. There is no need to escape parameter values like you would when running a command manually from the shell.
Named parameters
Positional parameters
Using argumentCollection
flags()
Just like when running a task manually, flags are an optional shortcut for specifying boolean parameters. Pass in each flag as a separate argument. It is not necessary to include the --
prior to the value, but it will still work.
inWorkingDirectory()
Control the working directory that the task runs in if you don't want it to be the current working directory of the shell.
run()
Your DSL should always end with a run
method. This executes the task. By default, the output will be sent to the console, however you can capture it by specifying returnOutput
as true
.
If you want to help debug the exact task that is being passed along to the shell for executing, set the echo
parameter to true
and the task will be echoed out prior to execution. The echoed text is not part of what gets returned.
Handling Exceptions
If a task encounters an error or returns a non-zero exit code, the Task DSL will throw an exception. if you want to ignore failing tasks or rethrow an exception of your own design, you may place the task in a try/catch. The exit code of the task may be accessed via:
The
${exitCode}
environment variableThe
errorcode
property of the exception if theerror()
method was usedCalling
getExitCode()
on the Task DSL object