# cppwg

Automatically generate [pybind11](https://pybind11.readthedocs.io/) Python
wrapper code for C++ projects.

cppwg reads your C++ source together with a YAML configuration file and emits the
pybind11 registration code for the classes, free functions, and template
instantiations you select — so you describe *what* to expose in config rather
than hand-writing wrapper code.

```{toctree}
:maxdepth: 2
:caption: Contents

getting-started
configuration
custom-generators
tips
api
```

## Quick links

- [Getting started](getting-started.md) — install, run, and a full worked example.
- [Configuration reference](configuration.md) — every config option, with types
  and defaults.
- [Custom generators](custom-generators.md) — inject hand-written binding code.
- [Tips & recipes](tips.md) — build behaviour, discovery, and troubleshooting.
- [API reference](api.rst) — autogenerated from the source docstrings.

## Indices

- {ref}`genindex`
- {ref}`modindex`
- {ref}`search`