Tasks

Tasks

Defining a task

The simplest way to define a task is through the Tasks:Task functions

Tasks:Task "compile"(function()
	print("Compiling now...")
end)

You can define dependencies:

Tasks:Task "test"({"compile"}, function()
	print("Running tests")
end)

You can also chains functions together:

Task:Task "test"(function()
	print("Running tests")
end)
	:Depends("compile")
	:Description("Compile and run tests")

You can also use the Tasks:AddTask function. This also supports chaining:

TaskRunner:AddTask("test", {"compile"}, function()
	print("running tests")
end):Description("Compile and run tests")

Predefined tasks

Some tasks have predefined functions. These normally follow the pattern Tasks::TypeName(name, options, taskDependencies)

Clean

Clean removes a directory/file from the filesystem. It is worth noting that the directory is global, so you must use fs.combine

Tasks:Clean("clean", fs.combine(CurrentDirectory, "build"))

Combine

Combines a dependency tree into one file

local sources = Dependencies(CurrentDirectory)
sources:Main "Thing.lua"
	:Depends "Another"
sources:Main "Another.lua"
	:Name "Another"

Tasks:Combine("combine", sources, "build.lua", {"clean"})

You can read more on dependencies here.