cppwg

Automatically generate pybind11 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.

Contents

• Getting started
  • Installation
  • Command-line usage
  • A worked example
• Configuration reference
  • Option inheritance
  • Package options
  • Module options
  • Class options
  • Common options
  • Selecting what to wrap
  • Template instantiations
  • Excluding members
  • Includes
  • Cross-module and cross-package inheritance
  • Excluding inherited overrides
  • Exceptions
• Custom generators
  • Hooks
  • Injecting .def code
  • Declaring the headers your code needs
• Tips & recipes
• API reference
  • Generator
  • Config model
  • Parsers
  • Writers
  • Custom generators

Quick links

• Getting started — install, run, and a full worked example.

• Configuration reference — every config option, with types and defaults.

• Custom generators — inject hand-written binding code.

• Tips & recipes — build behaviour, discovery, and troubleshooting.

• API reference — autogenerated from the source docstrings.

Indices

• Index

• Module Index

• Search Page