README.md

Justbuild

justbuild is a generic build system supporting multi-repository builds. A peculiarity of the tool is the separation between global names and physical location on the one hand, and logical paths used for actions and installation on the other hand (sometimes referred to as "staging"). The language-specific information to translate high-level concepts (libraries, binaries) into individual compile action is taken from user-defined rules described by functional expressions.

Getting Started

• The most simple way to build the just binary from scratch is python3 ./bin/bootstrap.py. For more details see the installation guide.

• Tutorial

  • Getting Started
  • Hello World
  • Third-party dependencies
  • Debugging
  • Tests
  • Targets versus FILE, GLOB, and TREE
  • Ensuring reproducibility
  • Using protobuf
  • How to create a single-node remote execution service
  • Dependency management using Target-level Cache as a Service
  • Cross compiling and testing cross-compiled targets

Documentation

• Overview
• Build Configurations
• Multi-Repository Builds
• Expression Language
• Built-in Rules
• User-Defined Rules
• Documentation Strings
• Cache Pragma and Testing
• Anonymous Targets
• Target-Level Caching
• Garbage Collection
• Symbolic links
• Execution properties