ComputerCraft Forums

ComputerCraft => Programs => APIs and Utilities => Topic started by: daelvn on Dec 02, 2018, 06:44 PM

Title: Alfons - Cross-platform task runner
Post by: daelvn on Dec 02, 2018, 06:44 PM
Alfons - Cross-platform task runner
Alfons is a very simple task runner and project manager that runs in CC and in your computer. It will find for an "Alfonsfile", which should contain global-exported functions. This can be useful for things such as generating documentation automatically, cleaning the built files, compiling others...
Writing taskfiles
You can use MoonScript or Lua to write taskfiles
-- alfons: lua
-- This header can be placed anywhere in the code, and is optional if your file has an extension.
task = function (self)
  -- self.name -> The name of this task (task)
  -- self.ltext -> The ltext library
  -- self.file -> The fs API (outside of CC, this is the bundled file.lua module)
  print self.name
end
And, in the case of MoonScript
-- alfons: moon
export task = =>
  print @name
Using Alfons
Basic usage consists in calling the Alfons script with a list of the tasks to run as arguments. Non-existing tasks will simply not be run.
alfons task_1 task_2 task_3.

Installing Alfons
You can use the installer that uses bsrocks.
pastebin run vbhNbjX4
Links
Homepage (https://alfons.daelvn.ga)
GitHub (https://github.com/daelvn/alfons)
Pastebin Installer (https://pastebin.com/vbhNbjX4)
Pastebin Wrapper (https://pastebin.com/Ry0C9j47)