pybind11¶

This example shows how to use foga to build, test, and document pybind11, the C++ bindings library for exposing native code to Python.

The Docker image clones pybind11 at pinned commit 2889136 to keep the example reproducible.

Typical workflow¶

Start the example container:

examples/pybind11/run-in-docker.py

Once inside the container:

Validate the configuration before running any workflow:
```
foga validate
```
Build the default C++ target, then rebuild it with the release profile:
```
foga build cpp
foga build --profile release cpp
```
Run the some tests:
```
foga test
```
Build the documentation through the configured docs workflow:
```
foga docs
```

a self-contained Docker workflow for a real upstream C++/Python project
foga install provisioning default Python and system build dependencies
a lighter upstream demonstration than Arrow, while still exercising builds, tests, docs, and profiles