bob-build 0.1.1

The ergonomic Ninja-based build system.

Bob the Builder

The ergonomic Ninja-based build system.

🏃 Getting Started  ·  ⌨️ CLI  ·  🎯 Goals  ·  🙏 Acknowledgements

Getting Started

uv tool install git+https://github.com/bob-hq/bob --with git+https://github.com/bob-hq/bob-std 

See the tour!

CLI

You can try these out in the tour as well.

# Build the project in the current directory (you should have a Bobfile).
bob build
# Clean the outputs of Bob.
bob clean
# Build with a specific config.
bob build -c DEBUG=n
# Build with a specific config in a separate build directory, so both consecutive builds are blazingly fast.
bob build -c DEBUG=y --builddir build-debug
# More options, including options passed to Ninja (after --).
bob build --clean -j 4 -- -v
# Create a compile_commands.json.
bob compdb -c DEBUG=n

Goals

Sorted by priority:

• Writing Bobfiles, writing plugins and rules, and composing Bobfiles should all be easy and feel Pythonic.
• Type safety should allow for a smooth editing experience and easy-to-debug errors.
• Plugins should be close to the actual commands rather than lock you in to a specific paradigm.
• Speed should be fast.

Acknowledgements

• Bake
• Kbuild
• Ninja's configure.py
• Thanks to everyone who helped design Bob, in particular Noam Raz.