Welcome to AutoPyBind11’s documentation!

A C++ to Python interoperability convenience tool.

AutoPyBind11 is a lightweight python based tool designed to simplify the process of generating and maintaining Python bindings for C++.

AutoPyBind11 takes C++ source code and associated, user generated, descriptor files, and produces PyBind11 binding code, which are then compiled into libraries containing a Python module representation of the provided C++.

PyBind11 is a C++ header only library that supports the binding and exposure of C++ code to Python.

This tree serves as partial documentation and a tutorial for the use of AutoPyBind11, and the source code can be found here

AutoPyBind11 is an active and ongoing effort, and as of the writing of this document, there is no extant stable version, and API/useage details are apt to change with minimal warning.

AutoPyBind11 provides as close to a complete coverage of PyBind11’s features as is possible, and more covereage is being added consistently.

Get Started:

• Installing AutoPyBind11
  • Installing via Python
  • Installing via CMake
  • CMake Integration
• AutoPyBind11 Useage
• The Descriptor File
  • Selecting C++ Objects

Advanced:

• Configuring AutoPyBind11
• Customize Output
  • Object Customization
  • Module Structure
• Clang/LLVM Compiler Options
  • From CMake:
  • From the command line:
  • From the config file:
• Keep Alive
• Python Module Structure
• Pass by Ref
• Templated Classes
  • Templated Class Names
  • Notes on Templates

Indices and tables

• Index

• Module Index

• Search Page