README.md

wox

wox is a highly flexible recipe build system, inspired by make. wox is also based on learning from other build systems inspired by make such as knit.

wox is designed to provide all the power and flexibility of arbitrary recipe-based builds, while at the same time addressing make's shortcomings.

features

• build scripts are written in wren, and declaratively export a set of recipes
• recipes with multiple outputs are supported
• better change detection with virtual targets
• detect changes in recipe steps when cache is enabled (-k)
• multithreaded recipe building by default

see a real example

import "wox" for W, R

var TARGET = "./hello"

var cc = W.cliopt("-cc", "gcc")
var cflags = ["-Wall", "-std=c11"]

var srcs = W.glob("./*.c")
var objs = W.exts_replace(srcs, ".c", ".o")
var src_obj_pairs = W.zip(srcs, objs)

var obj_recipes = src_obj_pairs.map { |x|
    return W.recipe(x[1], [x[0]], [x[1]], 
        [ R.c("%(cc) %(W.join(cflags)) -c %(x[0]) -o %(x[1])") ]
    )
}.toList

var main_recipe = W.recipe("main", objs, [TARGET], 
    [ R.c("%(cc) %(W.join(cflags)) %(W.join(objs)) -o %(TARGET)") ]
)
var clean_recipe = W.virtual_recipe("clean", [],
    [ R.c("rm -f %(W.join(objs)) %(TARGET)") ]
)
var all_recipe = W.meta_recipe("all", [main_recipe])

var BUILD_RECIPES = obj_recipes + [main_recipe, clean_recipe, all_recipe]

class Build {
    static recipes { BUILD_RECIPES }
    static default_recipe { "all" }
}

build

the recommended way to build is with redbuild.

redbuild build

alternatively, build using the D toolchain:

cd src
dub build -b release

usage

generally, wox can be called similarly to make:

wox [options] [targets...]

additionally, to list targets:

wox -l

to build as a dry run:

wox -n

faq

can't find a way to build footprint somefile.ext:V

wox expects you to refer to local paths with ./somefile.ext to be explicit about the fact that they are paths and not virtual recipe names. the :V indicates that wox is treating that name as a virtual target, and it should instead infer :F for a local file if it begins with ./.