PDM-Backend

PDM-Backend is a build backend that supports the latest packaging standards, which includes:

• PEP 517 Build backend API
• PEP 621 Project metadata
• PEP 660 Editable build backend

Quick start

To use it as PEP 517 build backend, edit your pyproject.toml as below:

[build-system]
requires = ["pdm-backend"]
build-backend = "pdm.backend"

It is recommended to use PDM to manage your project, which will automatically generate the above configuration for you.

Write the project metadata in pyproject.toml in PEP 621 format:

[project]
name = "my-project"
version = "0.1.0"
description = "A project built with PDM-Backend"
authors = [{name = "John Doe", email="[email protected]"}]
dependencies = ["requests"]
requires-python = ">=3.9"
readme = "README.md"
license = "MIT"

Then run the build command to build the project as wheel and sdist:

PDMbuild

pdm build

python -m build
# Or
pyproject-build

Read the corresponding documentation sections for more details:

• Metadata for how to write the project metadata
• Build configuration for customizing the build process.

Migrate from pdm-pep517

pdm-backend is the successor of pdm-pep517. If you are using the latter for your project, read the migration guide to migrate to pdm-backend.

Sponsors

Thanks to all the individuals and organizations who sponsor PDM project!