CppWG

cppwg is a C++ wrapper generator for Python. It reads your C++ source code, together with a YAML config file, and emits pybind11 wrapper code. Using the YAML config file, you describe what parts of your C++ project to expose to Python rather than writing pybind11 wrappers directly.

Contents

• Installation
  • Pre-requisites
  • Installing cppwg
• First steps
  • Shapes example
  • Command-line usage
  • Tips
• Configuration
  • Basics
  • Includes
  • Templates
  • Inheritance
  • Exceptions
  • Reference
• Custom generators
  • Hooks
  • Injecting wrapper code
  • Injecting headers
• Python packages
  • How it works
  • Layouts
  • One subpackage per module
  • Splitting one shared extension into subpackages
  • Hand-written code
  • Options
  • Command-line usage