Mustbuild

Mustbuild is a friendly fork of Justbuild. It is maintained as a patch series. This fork introduces extensions that mainly focus on improving usability while being fully compatible with existing Justbuild projects.

Some of those extensions are:

• A new preprocessor that supports language extensions
• Improved target descriptions
• Interactive progress reporting
• Non-verbose command line output
• Single binary for all subcommands

Example

In an empty directory, create a file named TARGETS with the following content:

{
  // Target 'helloworld' based on built-in rule 'generic'
  helloworld: {
    type: 'generic',
    cmds: 'echo Hello World > out.txt',
    outs: 'out.txt',
  },
}

Build the helloworld target and print the output file out.txt:

$ must build helloworld -P out.txt
INFO: Requested target is [["@","","","helloworld"],{}]
INFO: Discovered 1 actions, 0 trees, 0 blobs
INFO: Processed 1 actions, 0 cache hits.
INFO: Artifacts built, logical paths are:
        out.txt [557db03de997c86a4a028e1ebd3a1ceb225be238:12:f]
Hello World

Tutorial

The tutorial consists of a set of example projects with extensive descriptions. It is recommended to look at these projects in order.

1. Plain project
2. Minimal C++ project
3. Advanced C++ project
   1. Adding binary and shell tests
   2. Importing external libraries
   3. Using cross-compilation

Installing

Obtain and install Mustbuild from the latest bundled releases or build it from source. For more details, please see the build guide.