4 releases (2 stable)

1.2.0 Jan 28, 2024
1.1.0 Oct 17, 2023
1.0.0 Mar 6, 2018
0.8.1 Oct 15, 2023
0.7.5 Oct 15, 2023

#188 in Build Utils

35 downloads per month

MIT license

65KB
1.5K SLoC

Maid is a task runner / build tool that aims to be simpler and easier to use than, for example, GNU Make. Tasks are stored in a file called maidfile using the TOML syntax.

Quick Start

See the installation section for how to install just on your computer. Try running maid --version to make sure that it's installed correctly.

Once maid is installed and working, create a file named maidfile in the root of your project with the following contents:

[tasks.hello]
info = "this is a comment"
script = "echo 'hello world'"

Running maid with no arguments shows a list of tasks in the maidfile:

~ $ maid
? Select a task to run:
> hello (this is a comment)
[↑↓ to move, enter to select, type to filter]

For more commands, check out maid --help

Installation

Pre-built binaries for Linux, MacOS, and Windows can be found on the releases page.

Building

  • Clone the project git clone https://github.com/exact-labs/maid.git
  • Open a terminal in the project folder
  • Check if you have cargo (Rust's package manager) installed, just type in cargo
  • If cargo is installed, run cargo build --release
  • Put the executable into one of your PATH entries
    • Linux: usually /bin/ or /usr/bin/
    • Windows: C:\Windows\System32 is good for it but don't use windows

Dependencies

~29–48MB
~841K SLoC