Examples

The example set has two distinct jobs:

• the tutorial track teaches foga incrementally, starting from the smallest useful config and adding one concept at a time

• the real-world examples show foga working against larger or more realistic repositories, including upstream checkouts and mixed Python/C++ workflows

Choose an example path

Start with the tutorial examples when you are learning the configuration model and want a sequence you can read in order.

Jump to the real-world examples when you already understand the basics and want to see how foga maps onto a more complete repository shape.

Tutorial track

• Tutorial examples: the guided path through incremental adoption, from a pure Python project to mixed Python/C++ builds, testing, and profiles

Real-world references

• arrow: Apache Arrow in Docker with system dependencies, a native CMake build, Python installs, pytest, and Sphinx docs.

• numpy: NumPy in Docker with a separate Meson native build, Python packaging, pytest, and docs.

• pybind11: pybind11 in Docker with native builds, tests, docs, and profile-driven C++ builds.

• qupled: a full repository already using foga across its workflows.