conan-py-build
A PEP 517 build backend that uses Conan to build Python C/C++ extensions.
Documentation · PyPI · Examples
Install
pip install conan-py-build
Quick start
[!NOTE] The steps below use CMake, but the backend is build-system agnostic — it works with anything Conan can drive. For a Meson version, see basic-meson-pybind11.
- Set
conan-py-buildas your build backend:
[build-system]
requires = ["conan-py-build"]
build-backend = "conan_py_build.build"
[project]
name = "mypackage"
version = "0.1.0"
- Add a
conanfile.pywith your C++ dependencies:
from conan import ConanFile
from conan.tools.cmake import CMake, cmake_layout
class MyPackageConan(ConanFile):
settings = "os", "compiler", "build_type", "arch"
generators = "CMakeToolchain", "CMakeDeps"
def layout(self):
cmake_layout(self)
def requirements(self):
self.requires("fmt/12.1.0")
def build(self):
cmake = CMake(self)
cmake.configure()
cmake.build()
def package(self):
cmake = CMake(self)
cmake.install()
- Your
CMakeLists.txtmust install the extension into the package directory so it ends up in the wheel:
install(TARGETS _core DESTINATION mypackage)
- Build:
pip wheel . -w dist/ -vvv
See the documentation for the full getting started guide, configuration, profiles, dynamic versioning, and more.
Examples
See the examples/ directory:
- basic —
fmtextension, recipe viaconanfile-path - basic-pybind11 — pybind11 +
fmt, dynamic version, PEP 639 - basic-meson-pybind11 — pybind11 +
fmtbuilt with Meson instead of CMake - basic-nanobind — nanobind +
fmt,extra-profilefor C++17 - external-sources — pybind11, C++ dep fetched in
source() - cibw-example — pybind11 + cibuildwheel
License
MIT — see LICENSE.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file conan_py_build-0.6.0.tar.gz.
File metadata
- Download URL: conan_py_build-0.6.0.tar.gz
- Upload date:
- Size: 21.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5ccba1076a30a9f1aef630a69305b74de02e54a9b492f3b397c1b299e57987d5
|
|
| MD5 |
056b2b1ed3763d0b6ab9aadb187c5b00
|
|
| BLAKE2b-256 |
c9babdb41a2bcc0028bffb6dce196c21d88e97ac3555316de8beff7090a0a525
|
Provenance
The following attestation bundles were made for conan_py_build-0.6.0.tar.gz:
Publisher:
release.yml on conan-io/conan-py-build
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
conan_py_build-0.6.0.tar.gz -
Subject digest:
5ccba1076a30a9f1aef630a69305b74de02e54a9b492f3b397c1b299e57987d5 - Sigstore transparency entry: 2189750401
- Sigstore integration time:
-
Permalink:
conan-io/conan-py-build@48d6bad8f39260cd13bda75051040ecafa51bd83 -
Branch / Tag:
refs/tags/v0.6.0 - Owner: https://github.com/conan-io
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@48d6bad8f39260cd13bda75051040ecafa51bd83 -
Trigger Event:
release
-
Statement type:
File details
Details for the file conan_py_build-0.6.0-py3-none-any.whl.
File metadata
- Download URL: conan_py_build-0.6.0-py3-none-any.whl
- Upload date:
- Size: 13.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
cb66ffbbadedd10ba1c05dab203af371d51012d9d1eb5a49ef9067f5f03079c7
|
|
| MD5 |
e239f9c2ad228a5688e5f6adb756d4ca
|
|
| BLAKE2b-256 |
26190f1e487411fbc82d78caa56312d4eaa060cd8949c4d16c235ba5740123e8
|
Provenance
The following attestation bundles were made for conan_py_build-0.6.0-py3-none-any.whl:
Publisher:
release.yml on conan-io/conan-py-build
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
conan_py_build-0.6.0-py3-none-any.whl -
Subject digest:
cb66ffbbadedd10ba1c05dab203af371d51012d9d1eb5a49ef9067f5f03079c7 - Sigstore transparency entry: 2189750423
- Sigstore integration time:
-
Permalink:
conan-io/conan-py-build@48d6bad8f39260cd13bda75051040ecafa51bd83 -
Branch / Tag:
refs/tags/v0.6.0 - Owner: https://github.com/conan-io
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@48d6bad8f39260cd13bda75051040ecafa51bd83 -
Trigger Event:
release
-
Statement type:
