MyNixOS website logo
Description

A declarative make-like interpreter.

Grow is a well-defined replacement for Makefiles and the like to build complex hierarchies of files with minimal effort.

Like many Makefile-like tools, Grow depends on the notion of timestamps to determine whether a file should be recompiled or not. Grow is much simpler than those, though, and I might argue way easier to use as well.

On startup, Grow will look for a file named Seed in the current directory, and evaluate the grow expressions contained within.

For example, here is a simple Seed file to compile a single C file into an executable.

tee $$arg:in {
  all = ($main:seq "All done !"):in $execs
  execs = hook ld [main] [main.o] :in $objects
  objects = hook cc [main.o] [main.c]
}

Notice the hook function ? It is the Grow primitive that calls an external program to perform actual tasks.

In Grow, hooks are expected to only accept files as their arguments, so we have to write the wrapper scripts cc and ld that accept arguments in the form "destination... source...". They are pretty trivial to write since they only involve renaming variables and swapping arguments.

Here are sample cc and ld scripts to show you there is nothing magical about them :

#!/bin/bash
obj="$1" ; shift ; src="$1"
gcc -c "$src" -o "$obj"
#!/bin/bash
bin="$1" ; shift ; obj="$1"
gcc "$obj" -o "$bin"

In grow, instead of writing recipes in the configuration, we just declare hooks and then write the appropriate wrapper scripts to call compilers with the correct flags and arguments.

Metadata

Version

1.1.0.3

License

Unknown

Platforms (75)

    Darwin
    FreeBSD
    Genode
    GHCJS
    Linux
    MMIXware
    NetBSD
    none
    OpenBSD
    Redox
    Solaris
    WASI
    Windows
Show all
  • aarch64-darwin
  • aarch64-genode
  • aarch64-linux
  • aarch64-netbsd
  • aarch64-none
  • aarch64_be-none
  • arm-none
  • armv5tel-linux
  • armv6l-linux
  • armv6l-netbsd
  • armv6l-none
  • armv7a-darwin
  • armv7a-linux
  • armv7a-netbsd
  • armv7l-linux
  • armv7l-netbsd
  • avr-none
  • i686-cygwin
  • i686-darwin
  • i686-freebsd
  • i686-genode
  • i686-linux
  • i686-netbsd
  • i686-none
  • i686-openbsd
  • i686-windows
  • javascript-ghcjs
  • loongarch64-linux
  • m68k-linux
  • m68k-netbsd
  • m68k-none
  • microblaze-linux
  • microblaze-none
  • microblazeel-linux
  • microblazeel-none
  • mips-linux
  • mips-none
  • mips64-linux
  • mips64-none
  • mips64el-linux
  • mipsel-linux
  • mipsel-netbsd
  • mmix-mmixware
  • msp430-none
  • or1k-none
  • powerpc-netbsd
  • powerpc-none
  • powerpc64-linux
  • powerpc64le-linux
  • powerpcle-none
  • riscv32-linux
  • riscv32-netbsd
  • riscv32-none
  • riscv64-linux
  • riscv64-netbsd
  • riscv64-none
  • rx-none
  • s390-linux
  • s390-none
  • s390x-linux
  • s390x-none
  • vc4-none
  • wasm32-wasi
  • wasm64-wasi
  • x86_64-cygwin
  • x86_64-darwin
  • x86_64-freebsd
  • x86_64-genode
  • x86_64-linux
  • x86_64-netbsd
  • x86_64-none
  • x86_64-openbsd
  • x86_64-redox
  • x86_64-solaris
  • x86_64-windows