{"author":"Wenzel Jakob","author_email":"wenzel.jakob@epfl.ch","bugtrack_url":null,"classifiers":["Development Status :: 5 - Production/Stable","Intended Audience :: Developers","License :: OSI Approved :: BSD License","Programming Language :: C++","Programming Language :: Python :: 3 :: Only","Programming Language :: Python :: 3.10","Programming Language :: Python :: 3.11","Programming Language :: Python :: 3.12","Programming Language :: Python :: 3.13","Programming Language :: Python :: 3.7","Programming Language :: Python :: 3.8","Programming Language :: Python :: 3.9","Programming Language :: Python :: Implementation :: CPython","Programming Language :: Python :: Implementation :: PyPy","Topic :: Software Development :: Libraries :: Python Modules","Topic :: Utilities"],"description":".. figure:: https://github.com/pybind/pybind11/raw/master/docs/pybind11-logo.png\n :alt: pybind11 logo\n\n**pybind11 — Seamless operability between C++11 and Python**\n\n|Latest Documentation Status| |Stable Documentation Status| |Gitter chat| |GitHub Discussions| |CI| |Build status|\n\n|Repology| |PyPI package| |Conda-forge| |Python Versions|\n\n`Setuptools example `_\n• `Scikit-build example `_\n• `CMake example `_\n\n.. start\n\n\n**pybind11** is a lightweight header-only library that exposes C++ types\nin Python and vice versa, mainly to create Python bindings of existing\nC++ code. Its goals and syntax are similar to the excellent\n`Boost.Python `_\nlibrary by David Abrahams: to minimize boilerplate code in traditional\nextension modules by inferring type information using compile-time\nintrospection.\n\nThe main issue with Boost.Python—and the reason for creating such a\nsimilar project—is Boost. Boost is an enormously large and complex suite\nof utility libraries that works with almost every C++ compiler in\nexistence. This compatibility has its cost: arcane template tricks and\nworkarounds are necessary to support the oldest and buggiest of compiler\nspecimens. Now that C++11-compatible compilers are widely available,\nthis heavy machinery has become an excessively large and unnecessary\ndependency.\n\nThink of this library as a tiny self-contained version of Boost.Python\nwith everything stripped away that isn't relevant for binding\ngeneration. Without comments, the core header files only require ~4K\nlines of code and depend on Python (3.7+, or PyPy) and the C++\nstandard library. This compact implementation was possible thanks to\nsome C++11 language features (specifically: tuples, lambda functions and\nvariadic templates). Since its creation, this library has grown beyond\nBoost.Python in many ways, leading to dramatically simpler binding code in many\ncommon situations.\n\nTutorial and reference documentation is provided at\n`pybind11.readthedocs.io `_.\nA PDF version of the manual is available\n`here `_.\nAnd the source code is always available at\n`github.com/pybind/pybind11 `_.\n\n\nCore features\n-------------\n\n\npybind11 can map the following core C++ features to Python:\n\n- Functions accepting and returning custom data structures per value,\n reference, or pointer\n- Instance methods and static methods\n- Overloaded functions\n- Instance attributes and static attributes\n- Arbitrary exception types\n- Enumerations\n- Callbacks\n- Iterators and ranges\n- Custom operators\n- Single and multiple inheritance\n- STL data structures\n- Smart pointers with reference counting like ``std::shared_ptr``\n- Internal references with correct reference counting\n- C++ classes with virtual (and pure virtual) methods can be extended\n in Python\n- Integrated NumPy support (NumPy 2 requires pybind11 2.12+)\n\nGoodies\n-------\n\nIn addition to the core functionality, pybind11 provides some extra\ngoodies:\n\n- Python 3.7+, and PyPy3 7.3 are supported with an implementation-agnostic\n interface (pybind11 2.9 was the last version to support Python 2 and 3.5).\n\n- It is possible to bind C++11 lambda functions with captured\n variables. The lambda capture data is stored inside the resulting\n Python function object.\n\n- pybind11 uses C++11 move constructors and move assignment operators\n whenever possible to efficiently transfer custom data types.\n\n- It's easy to expose the internal storage of custom data types through\n Pythons' buffer protocols. This is handy e.g. for fast conversion\n between C++ matrix classes like Eigen and NumPy without expensive\n copy operations.\n\n- pybind11 can automatically vectorize functions so that they are\n transparently applied to all entries of one or more NumPy array\n arguments.\n\n- Python's slice-based access and assignment operations can be\n supported with just a few lines of code.\n\n- Everything is contained in just a few header files; there is no need\n to link against any additional libraries.\n\n- Binaries are generally smaller by a factor of at least 2 compared to\n equivalent bindings generated by Boost.Python. A recent pybind11\n conversion of PyRosetta, an enormous Boost.Python binding project,\n `reported `_\n a binary size reduction of **5.4x** and compile time reduction by\n **5.8x**.\n\n- Function signatures are precomputed at compile time (using\n ``constexpr``), leading to smaller binaries.\n\n- With little extra effort, C++ types can be pickled and unpickled\n similar to regular Python objects.\n\nSupported compilers\n-------------------\n\n1. Clang/LLVM 3.3 or newer (for Apple Xcode's clang, this is 5.0.0 or\n newer)\n2. GCC 4.8 or newer\n3. Microsoft Visual Studio 2017 or newer\n4. Intel classic C++ compiler 18 or newer (ICC 20.2 tested in CI)\n5. Cygwin/GCC (previously tested on 2.5.1)\n6. NVCC (CUDA 11.0 tested in CI)\n7. NVIDIA PGI (20.9 tested in CI)\n\nAbout\n-----\n\nThis project was created by `Wenzel\nJakob `_. Significant features and/or\nimprovements to the code were contributed by Jonas Adler, Lori A. Burns,\nSylvain Corlay, Eric Cousineau, Aaron Gokaslan, Ralf Grosse-Kunstleve, Trent Houliston, Axel\nHuebl, @hulucc, Yannick Jadoul, Sergey Lyskov, Johan Mabille, Tomasz Miąsko,\nDean Moldovan, Ben Pritchard, Jason Rhinelander, Boris Schäling, Pim\nSchellart, Henry Schreiner, Ivan Smirnov, Boris Staletic, and Patrick Stewart.\n\nWe thank Google for a generous financial contribution to the continuous\nintegration infrastructure used by this project.\n\n\nContributing\n~~~~~~~~~~~~\n\nSee the `contributing\nguide `_\nfor information on building and contributing to pybind11.\n\nLicense\n~~~~~~~\n\npybind11 is provided under a BSD-style license that can be found in the\n`LICENSE `_\nfile. By using, distributing, or contributing to this project, you agree\nto the terms and conditions of this license.\n\n.. |Latest Documentation Status| image:: https://readthedocs.org/projects/pybind11/badge?version=latest\n :target: http://pybind11.readthedocs.org/en/latest\n.. |Stable Documentation Status| image:: https://img.shields.io/badge/docs-stable-blue.svg\n :target: http://pybind11.readthedocs.org/en/stable\n.. |Gitter chat| image:: https://img.shields.io/gitter/room/gitterHQ/gitter.svg\n :target: https://gitter.im/pybind/Lobby\n.. |CI| image:: https://github.com/pybind/pybind11/workflows/CI/badge.svg\n :target: https://github.com/pybind/pybind11/actions\n.. |Build status| image:: https://ci.appveyor.com/api/projects/status/riaj54pn4h08xy40?svg=true\n :target: https://ci.appveyor.com/project/wjakob/pybind11\n.. |PyPI package| image:: https://img.shields.io/pypi/v/pybind11.svg\n :target: https://pypi.org/project/pybind11/\n.. |Conda-forge| image:: https://img.shields.io/conda/vn/conda-forge/pybind11.svg\n :target: https://github.com/conda-forge/pybind11-feedstock\n.. |Repology| image:: https://repology.org/badge/latest-versions/python:pybind11.svg\n :target: https://repology.org/project/python:pybind11/versions\n.. |Python Versions| image:: https://img.shields.io/pypi/pyversions/pybind11.svg\n :target: https://pypi.org/project/pybind11/\n.. |GitHub Discussions| image:: https://img.shields.io/static/v1?label=Discussions&message=Ask&color=blue&logo=github\n :target: https://github.com/pybind/pybind11/discussions\n","description_content_type":"text/x-rst","docs_url":null,"download_url":"https://github.com/pybind/pybind11/tarball/v2.13.6","downloads":{"last_day":-1,"last_month":-1,"last_week":-1},"dynamic":null,"home_page":"https://github.com/pybind/pybind11","keywords":"C++11, Python bindings","license":"BSD","license_expression":null,"license_files":null,"maintainer":null,"maintainer_email":null,"name":"pybind11","package_url":"https://pypi.org/project/pybind11/","platform":null,"project_url":"https://pypi.org/project/pybind11/","project_urls":{"Bug Tracker":"https://github.com/pybind/pybind11/issues","Changelog":"https://pybind11.readthedocs.io/en/latest/changelog.html","Chat":"https://gitter.im/pybind/Lobby","Discussions":"https://github.com/pybind/pybind11/discussions","Documentation":"https://pybind11.readthedocs.io/","Download":"https://github.com/pybind/pybind11/tarball/v2.13.6","Homepage":"https://github.com/pybind/pybind11"},"provides_extra":["global"],"release_url":"https://pypi.org/project/pybind11/2.13.6/","requires_dist":["pybind11-global==2.13.6; extra == \"global\""],"requires_python":">=3.7","summary":"Seamless operability between C++11 and Python","version":"2.13.6","yanked":false,"yanked_reason":null}

Package search

pybind11

project_urls

Dependencies

All package metadata

Releases