Skip to main content
Version: 0.3.0

Quick Start

A simple use case on how to use bob's rebuild feature.

Start in a fresh directory

mkdir bobplay
cd bobplay

Create a file book.md.

Also create a file called bob.yaml in the same directory and add the following content:

build:
build:
input: book.md
cmd: |-
cat book.md > book
target: book

Add this line to book.md.

A long long time ago...

Now call

bob build

This will execute the cmd and therefore create the file book.

Call bob build again and see that it doesn't have work todo.

Now change the content of book.md

A long long time ago in a galaxy far,
far away....

Give bob build another chance.

Now the checksum of the input has changed and therfore the cmd is executed again.

Let's delete the target

rm book

and call bob build again. You can see that it takes the target from the cache. Bob checks the targets checksum , in case of a invalid target it is loaded from the cache.

In case you wan't to ignore input changes and the cache altogether you can trigger a complete rebuild using

bob build --no-cache

That's it, you have seen the basic mechanics of bob's build system.