pybind11 — Seamless operability between C++11 and Python

• About this project
  • Core features
  • Goodies
  • Supported compilers
• First steps
  • Compiling the test cases
  • Creating bindings for a simple function
  • Keyword arguments
  • Default arguments
  • Supported data types
• Object-oriented code
  • Creating bindings for a custom type
  • Keyword and default arguments
  • Binding lambda functions
  • Instance and static fields
  • Inheritance
  • Overloaded methods
  • Enumerations and internal types
• Advanced topics
  • Exporting constants and mutable objects
  • Operator overloading
  • Callbacks and passing anonymous functions
  • Overriding virtual functions in Python
  • General notes regarding convenience macros
  • Global Interpreter Lock (GIL)
  • Passing STL data structures
  • Binding sequence data types, iterators, the slicing protocol, etc.
  • Return value policies
  • Additional call policies
  • Implicit type conversions
  • Unique pointers
  • Smart pointers
  • Custom constructors
  • Catching and throwing exceptions
  • Treating STL data structures as opaque objects
  • Transparent conversion of dense and sparse Eigen data types
  • Buffer protocol
  • NumPy support
  • Vectorizing functions
  • Functions taking Python objects as arguments
  • Default arguments revisited
  • Binding functions that accept arbitrary numbers of arguments and keywords arguments
  • Partitioning code over multiple extension modules
  • Pickling support
  • Generating documentation using Sphinx
• Build systems
  • Building with setuptools
  • Building with cppimport
  • Building with CMake
• Benchmark
  • Setup
  • Compilation time
  • Module size
• Limitations
• Frequently asked questions
  • “ImportError: dynamic module does not define init function”
  • “Symbol not found: __Py_ZeroStruct / _PyInstanceMethod_Type”
  • The Python interpreter immediately crashes when importing my module
  • CMake doesn’t detect the right Python version
  • Limitations involving reference arguments
  • How can I reduce the build time?
  • How can I create smaller binaries?
  • Working with ancient Visual Studio 2009 builds on Windows
• Reference
  • Macros
  • Convenience classes for arbitrary Python types
  • Convenience classes for specific Python types
  • Passing extra arguments to the def function
• Changelog
  • Breaking changes queued for v2.0.0 (Not yet released)
  • 1.8.1 (July 12, 2016)
  • 1.8.0 (June 14, 2016)
  • 1.7 (April 30, 2016)
  • 1.6 (April 30, 2016)
  • 1.5 (April 21, 2016)
  • 1.4 (April 7, 2016)
  • 1.3 (March 8, 2016)
  • 1.2 (February 7, 2016)
  • 1.1 (December 7, 2015)
  • 1.0 (October 15, 2015)