snb, abbreviation for "Shake 'N Bake", is a flexible build automation tool with caching capabilities and straightfoward rules. To use, simply run the executable in the directory containing a ShakeAndBakeFile spec or pass the directory as an argument.

Using Homebrew (darwin):

$ brew tap aemengo/snb https://github.com/aemengo/snb
$ brew update
$ brew install snb

Using Go (all platforms):

$ export PATH="$GOPATH/bin:$PATH"
$ go get -u github.com/aemengo/snb

$ cat ShakeAndBakeFile
RUN ./operation.sh ./build-artifacts

RUN echo "success!"

An example ShakeAndBakeFile looks like above. Steps are declared with RUN directive and must be terminated with a completely blank line or the end of the file. Multi-line statements are supported.

Each step is scanned for referenced files and directories. A sha1 checksum is taken after each is executed, for the aforementioned files and directories, and stored in a sqlite database in .snb/snb.db. When snb is invoked again, the step definition and checksums of referenced files and directories are compared: opting to skip any steps that completely match.

A best practice is to document the input and output artifacts of every step that you'd wish snb to track for changes.

• Each step is executed in its own bash shell, so declared environment variables and directory changes will not carry over.
• Each step is executed relative to the directory of the ShakeAndBakeFile.
• Each step is executed with all environment variables of the shell that snb is invoked in.
• Each step without any referenced files or directories will not be cached.

• Golang: 1.10+

1. cd into the root directory of the project.

2. Compile the snb library.

   $ go build .

1. Install the ginkgo test runner cli

   $ go get -u github.com/onsi/ginkgo/ginkgo

2. Execute tests

   $ ginkgo -r

Apache 2.0.

Copyright (c) 2018 Anthony Emengo