pdm-backend
The build backend used by PDM that supports latest packaging standards
Why this rank:Strong adoptionRecent releaseHealthy release cadence
Description
# PDM-Backend The build backend used by [PDM] that supports latest packaging standards. [](https://pypi.org/project/pdm-backend) [](https://github.com/pdm-project/pdm-backend/actions/workflows/ci.yml) [](https://results.pre-commit.ci/latest/github/pdm-project/pdm-backend/main) [](https://pdm-project.org) This is the backend for [PDM] projects that is fully-compatible with [PEP 517] spec, but you can also use it alone. It reads the metadata of [PEP 621] format and coverts it to [Core metadata]. [pep 517]: https://www.python.org/dev/peps/pep-0517/ [pep 621]: https://www.python.org/dev/peps/pep-0621/ [Core metadata]: https://packaging.python.org/specifications/core-metadata/ [PDM]: https://pdm-project.org ## Links - [Documentation](https://backend.pdm-project.org) - [Changelog](https://github.com/pdm-project/pdm-backend/releases) - [PDM Documentation][PDM] - [PyPI](https://pypi.org/project/pdm-backend) - [Discord](https://discord.gg/Phn8smztpv) > **NOTE** > This project has been renamed from `pdm-pep517` and the old project lives in the [legacy] branch. [legacy]: https://github.com/pdm-project/pdm-backend/tree/legacy ## Sponsors <p align="center"> <a href="https://cdn.jsdelivr.net/gh/pdm-project/sponsors/sponsors.svg"> <img src="https://cdn.jsdelivr.net/gh/pdm-project/sponsors/sponsors.svg"/> </a> </p> ## License This project is licensed under [MIT license](/LICENSE).
Release History
| Version | Changes | Urgency | Date |
|---|---|---|---|
| 2.4.9 | *No significant changes* ##### [View changes on GitHub](https://github.com/pdm-project/pdm-backend/compare/2.4.8...2.4.9) | High | 6/5/2026 |
| 2.4.8 | Imported from PyPI (2.4.8) | Low | 4/21/2026 |
| 2.4.7 | ### đ Features - Allow user to override wheel with multiple plat tags - by @trim21 in https://github.com/pdm-project/pdm-backend/issues/298 [<samp>(263a5)</samp>](https://github.com/pdm-project/pdm-backend/commit/263a598) ### đģ Chores - Switch dev-dependencies to dependency-groups - by @frostming [<samp>(9572d)</samp>](https://github.com/pdm-project/pdm-backend/commit/9572dc4) ##### [View changes on GitHub] | Low | 1/29/2026 |
| 2.4.6 | ### đ Bug Fixes - Env for calling Python applications - by @paugier and @frostming in https://github.com/pdm-project/pdm-backend/issues/295 [<samp>(743fd)</samp>](https://github.com/pdm-project/pdm-backend/commit/743fd55) - No warning emitting in case of SCM error when fallback_version is used. Fixes #293 - by @frostming in https://github.com/pdm-project/pdm-backend/issues/293 [<samp>(e7dbb)</samp>](https://github.com/pdm-project/pdm-backend/commit/e7d | Low | 11/11/2025 |
| 2.4.5 | ### đ Bug Fixes - Override Git config core.abbrev when reading version from SCM - by @ziyao233 in https://github.com/pdm-project/pdm-backend/issues/286 [<samp>(60d94)</samp>](https://github.com/pdm-project/pdm-backend/commit/60d94c8) - Support a SOURCE_DATE_EPOCH prior to 1980 - by @branchvincent in https://github.com/pdm-project/pdm-backend/issues/288 [<samp>(daf1e)</samp>](https://github.com/pdm-project/pdm-backend/commit/daf1e07) ##### | Low | 7/3/2025 |
| 2.4.4 | ### đ Features - Improve diagnostic caused by git incorrectly parsing paths on MSYS2. - by @cr1901 in https://github.com/pdm-project/pdm-backend/issues/267 [<samp>(23807)</samp>](https://github.com/pdm-project/pdm-backend/commit/23807de) - Out-of-box stubs package support - by @trim21 in https://github.com/pdm-project/pdm-backend/issues/280 [<samp>(9a988)</samp>](https://github.com/pdm-project/pdm-backend/commit/9a9884a) ### đ Docum | Low | 4/7/2025 |
| 2.4.3 | ### đģ Chores - Bump validate-pyproject to 0.9.0 - by @henryiii in https://github.com/pdm-project/pdm-backend/issues/265 [<samp>(23484)</samp>](https://github.com/pdm-project/pdm-backend/commit/2348482) - Update dependencies - by @frostming [<samp>(7f7dd)</samp>](https://github.com/pdm-project/pdm-backend/commit/7f7dd51) - Update badge - by @frostming [<samp>(6fdd4)</samp>](https://github.com/pdm-project/pdm-backend/commit/6fdd494) - Migrate | Low | 10/23/2024 |
| 2.4.2 | ### đ Features - Use fallback_version for source = "call" - by @frostming in https://github.com/pdm-project/pdm-backend/issues/264 [<samp>(16562)</samp>](https://github.com/pdm-project/pdm-backend/commit/1656230) ### đ Bug Fixes - Update to pyproject_metadata 0.9.0b5 - by @henryiii in https://github.com/pdm-project/pdm-backend/issues/263 [<samp>(67fb7)</samp>](https://github.com/pdm-project/pdm-backend/commit/67fb709) ##### | Low | 10/10/2024 |
| 2.4.1 | ### đ Bug Fixes - Can't format requirements when converting to setup.py - by @frostming [<samp>(856d8)</samp>](https://github.com/pdm-project/pdm-backend/commit/856d849) - Update to pyproject_metadata 0.9.0b4 - by @frostming [<samp>(88c3f)</samp>](https://github.com/pdm-project/pdm-backend/commit/88c3f44) ##### [View changes on GitHub](https://github.com/pdm-project/pdm-backend/compare/2.4.0...2.4.1) | Low | 9/21/2024 |
| 2.4.0 | ### đ Features - Accept context as the second argument to version_format function - by @frostming in https://github.com/pdm-project/pdm-backend/issues/258 [<samp>(708aa)</samp>](https://github.com/pdm-project/pdm-backend/commit/708aa3f) - Update pyproject-metadata to support latest version of PEP 639 - by @frostming in https://github.com/pdm-project/pdm-backend/issues/259 [<samp>(6c48d)</samp>](https://github.com/pdm-project/pdm-backend/commit/6c48d72) | Low | 9/20/2024 |
| 2.3.3 | ### đ Bug Fixes - Pdm_build.py added twice in sdist file. Fixes #250 - by @frostming in https://github.com/pdm-project/pdm-backend/issues/250 [<samp>(3dd6d)</samp>](https://github.com/pdm-project/pdm-backend/commit/3dd6d78) ##### [View changes on GitHub](https://github.com/pdm-project/pdm-backend/compare/2.3.2...2.3.3) | Low | 7/16/2024 |
| 2.3.2 | ### đ Bug Fixes - Detect src layout only if it exists and included by build config - by @frostming [<samp>(9466c)</samp>](https://github.com/pdm-project/pdm-backend/commit/9466c66) - Use compatible is_relative_to for Python 3.8 - by @frostming [<samp>(30c46)</samp>](https://github.com/pdm-project/pdm-backend/commit/30c4614) ### đ Documentation - Update the logo url - by @frostming [<samp>(fd5ef)</samp>](https:/ | Low | 7/5/2024 |
| 2.3.1 | ### đ Bug Fixes - Handle unexpected hg repo when parse scm version - by @huxuan in https://github.com/pdm-project/pdm-backend/issues/237 [<samp>(d6fec)</samp>](https://github.com/pdm-project/pdm-backend/commit/d6feccf) - Treat PDM_BUILD_SCM_VERSION empty string as unset - by @ryukinix in https://github.com/pdm-project/pdm-backend/issues/238 [<samp>(596f1)</samp>](https://github.com/pdm-project/pdm-backend/commit/596f1dc) - Honor the current working dir | Low | 6/19/2024 |
| 2.3.0 | ### đ Features - Remove support for python 3.7 and older - by @frostming in https://github.com/pdm-project/pdm-backend/issues/232 [<samp>(32e3a)</samp>](https://github.com/pdm-project/pdm-backend/commit/32e3a33) - Add `tag_filter` as a way to pre-filter tags - by @mezuzza in https://github.com/pdm-project/pdm-backend/issues/225 [<samp>(9915c)</samp>](https://github.com/pdm-project/pdm-backend/commit/9915cb6) ### đ Bug Fixes - Error | Low | 4/30/2024 |
| 2.2.1 | ### đ Features - Add parameter `--build-number` to wheel builder - by @0xfabioo and **Frost Ming** in https://github.com/pdm-project/pdm-backend/issues/229 [<samp>(d7d15)</samp>](https://github.com/pdm-project/pdm-backend/commit/d7d15fb) - Bump pyproject-metadata to 0.8.0 - by @frostming in https://github.com/pdm-project/pdm-backend/issues/231 [<samp>(5f538)</samp>](https://github.com/pdm-project/pdm-backend/commit/5f53873) ##### &nb | Low | 4/18/2024 |
| 2.2.0 | ### đ Features - Don't add '+editable' to the editable version - by @frostming [<samp>(e6fcd)</samp>](https://github.com/pdm-project/pdm-backend/commit/e6fcd5f) - Custom version format for source="scm" - by @frostming in https://github.com/pdm-project/pdm-backend/issues/217 [<samp>(4f20c)</samp>](https://github.com/pdm-project/pdm-backend/commit/4f20cfd) - Fallback_version config for scm version - by @frostming [<samp>(8b8ab)</samp>](https: | Low | 4/14/2024 |
| 2.1.8 | ### đ Bug Fixes - Can't include nested data files in built wheel - by @frostming [<samp>(ad7de)</samp>](https://github.com/pdm-project/pdm-backend/commit/ad7de09) ### đ Documentation - Correct pep number - by @xzmeng in https://github.com/pdm-project/pdm-backend/issues/201 [<samp>(fa372)</samp>](https://github.com/pdm-project/pdm-backend/commit/fa3723b) ### đģ Chores - Update domain name - by @frostm | Low | 12/27/2023 |
| 2.1.7 | ### đ Bug Fixes - Rename tag-pattern to tag_regex in the docs - by @rudeigerc in https://github.com/pdm-project/pdm-backend/issues/193 [<samp>(e9665)</samp>](https://github.com/pdm-project/pdm-backend/commit/e966544) - Copytree handle existing dirs - by @frostming in https://github.com/pdm-project/pdm-backend/issues/199 [<samp>(8a64b)</samp>](https://github.com/pdm-project/pdm-backend/commit/8a64b0a) - Normalize the dist info name in the wheel -& | Low | 10/8/2023 |
| 2.1.6 | ### đ Bug Fixes - Path to uri expansion in dependency string - by @frostming [<samp>(dfd22)</samp>](https://github.com/pdm-project/pdm-backend/commit/dfd22b3) ##### [View changes on GitHub](https://github.com/pdm-project/pdm-backend/compare/2.1.5...2.1.6) | Low | 8/29/2023 |
| 2.1.5 | ### đ Bug Fixes - Don't quote project root in file:// urls Fix #190 - by @frostming in https://github.com/pdm-project/pdm-backend/issues/190 [<samp>(353dc)</samp>](https://github.com/pdm-project/pdm-backend/commit/353dcf2) - Write version to file doesn't work for editable installs Fixes #192 - by @frostming in https://github.com/pdm-project/pdm-backend/issues/192 [<samp>(abd55)</samp>](https://github.com/pdm-project/pdm-backend/commit/abd5537) ##### & | Low | 8/9/2023 |
| 2.1.4 | ### đ Bug Fixes - Write version file for sdist build as well - by @frostming [<samp>(2add9)</samp>](https://github.com/pdm-project/pdm-backend/commit/2add9f1) ##### [View changes on GitHub](https://github.com/pdm-project/pdm-backend/compare/2.1.3...2.1.4) | Low | 7/13/2023 |
| 2.1.3 | ### đ Bug Fixes - Remove duplicate files when building wheel - by @frostming [<samp>(c8f70)</samp>](https://github.com/pdm-project/pdm-backend/commit/c8f70dd) ##### [View changes on GitHub](https://github.com/pdm-project/pdm-backend/compare/2.1.2...2.1.3) | Low | 7/12/2023 |
| 2.1.2 | ### đ Bug Fixes - Fix file permissions to 644 for wheel Fix #187 - by @frostming in https://github.com/pdm-project/pdm-backend/issues/187 [<samp>(f5fd0)</samp>](https://github.com/pdm-project/pdm-backend/commit/f5fd0e5) ##### [View changes on GitHub](https://github.com/pdm-project/pdm-backend/compare/2.1.1...2.1.2) | Low | 6/27/2023 |
| 2.1.1 | ### đ Bug Fixes - Pdm-backend should not normalize names in project metadata - by @frostming in https://github.com/pdm-project/pdm-backend/issues/186 [<samp>(4476f)</samp>](https://github.com/pdm-project/pdm-backend/commit/4476f86) ##### [View changes on GitHub](https://github.com/pdm-project/pdm-backend/compare/2.1.0...2.1.1) | Low | 6/26/2023 |
| 2.1.0 | ### đ Features - Change the default build dir to a pdm-specific one - by @frostming [<samp>(a7473)</samp>](https://github.com/pdm-project/pdm-backend/commit/a74734d) - Allow to include files in wheel .data directory - by @frostming in https://github.com/pdm-project/pdm-backend/issues/182 [<samp>(ad408)</samp>](https://github.com/pdm-project/pdm-backend/commit/ad4087c) ### đ Bug Fixes - Scm versionning fails when package is not top- | Low | 6/8/2023 |
| 2.0.7 | ### đ Bug Fixes - Convert boolean value to lowercase in Root-Is-Purelib Close #165 - by @frostming in https://github.com/pdm-project/pdm-backend/issues/165 [<samp>(93b69)</samp>](https://github.com/pdm-project/pdm-backend/commit/93b6906) - PDM_BUILD_NO_CLEAN handling is incorrect Fix #166 - by @frostming in https://github.com/pdm-project/pdm-backend/issues/166 [<samp>(c61f6)</samp>](https://github.com/pdm-project/pdm-backend/commit/c61f67d) ##### & | Low | 5/15/2023 |
| 2.0.6 | ### đ Bug Fixes - Write lowercase "true" since installer hardcodes it - by @frostming [<samp>(df7f2)</samp>](https://github.com/pdm-project/pdm-backend/commit/df7f2c4) ##### [View changes on GitHub](https://github.com/pdm-project/pdm-backend/compare/1.1.3...2.0.6) | Low | 4/10/2023 |
| 2.0.5 | ### đ Bug Fixes - Use posix path as the relpath - by @frostming [<samp>(d9218)</samp>](https://github.com/pdm-project/pdm-backend/commit/d9218f2) ##### [View changes on GitHub](https://github.com/pdm-project/pdm-backend/compare/2.0.4...2.0.5) | Low | 2/28/2023 |
| 2.0.4 | ### đ Bug Fixes - Fix a bug when building sdist, the version is not frozen Closing #157 - by @frostming in https://github.com/pdm-project/pdm-backend/issues/157 [<samp>(86184)</samp>](https://github.com/pdm-project/pdm-backend/commit/861841a) ##### [View changes on GitHub](https://github.com/pdm-project/pdm-backend/compare/2.0.3...2.0.4) | Low | 2/28/2023 |
| 2.0.3 | ### đ Bug Fixes - Missing files in editable wheel - by @frostming in https://github.com/pdm-project/pdm-backend/issues/155 [<samp>(4dc3c)</samp>](https://github.com/pdm-project/pdm-backend/commit/4dc3cd0) - Normalize the distribution names as the standard - by @frostming in https://github.com/pdm-project/pdm-backend/issues/156 [<samp>(df720)</samp>](https://github.com/pdm-project/pdm-backend/commit/df720d2) ##### [View changes | Low | 2/27/2023 |
| 2.0.2 | ### đ Bug Fixes - Fix an issue the files in build directory are not collected when src layout is used - by @frostming in https://github.com/pdm-project/pdm-backend/issues/152 [<samp>(7686b)</samp>](https://github.com/pdm-project/pdm-backend/commit/7686b12) ##### [View changes on GitHub](https://github.com/pdm-project/pdm-backend/compare/2.0.1...2.0.2) | Low | 2/7/2023 |
| 2.0.1 | ### đ Features - Support overriding sdist mtime with SOURCE_DATE_EPOCH Resolve #149 - by @frostming in https://github.com/pdm-project/pdm-backend/issues/149 [<samp>(d94fb)</samp>](https://github.com/pdm-project/pdm-backend/commit/d94fb2c) ### đ Bug Fixes - A crash issue when using static version metadata Close #150 - by @frostming in https://github.com/pdm-project/pdm-backend/issues/150 [<samp>(59f61)</samp>](https://github.c | Low | 2/7/2023 |
| 2.0.0 | ### đ Features - Rename the package to `pdm-backend` - by @frostming [<samp>(79d10)</samp>](https://github.com/pdm-project/pdm-backend/commit/79d1077) - Rewrite the builders to support build hooks - by @frostming [<samp>(9d5d5)</samp>](https://github.com/pdm-project/pdm-backend/commit/9d5d5a4) - Rename the is_enabled hook to pdm_build_hook_enabled - by @frostming [<samp>(4729b)</samp>](https://github.com/pdm-project/pdm-backend/commit/4729b | Low | 2/3/2023 |
| 1.1.1 | ## What's Changed * chore: update vendored packaging to 23 by @frostming in https://github.com/pdm-project/pdm-backend/pull/147 **Full Changelog**: https://github.com/pdm-project/pdm-backend/compare/1.1.0...1.1.1 | Low | 1/30/2023 |
| 1.1.0 | ## What's Changed * fix: raise an error if dynamic version config is missing by @frostming in https://github.com/pdm-project/pdm-backend/pull/142 * feat: support specifying zipinfo date via env var by @frostming in https://github.com/pdm-project/pdm-backend/pull/144 **Full Changelog**: https://github.com/pdm-project/pdm-backend/compare/1.0.6...1.1.0 | Low | 1/30/2023 |
| 2.0.0a4 | ### đ Features - Update vendored packaging to 22.0 - by @frostming in https://github.com/pdm-project/pdm-backend/issues/135 [<samp>(5bee4)</samp>](https://github.com/pdm-project/pdm-backend/commit/5bee400) - Associate builder to the context object - by @frostming in https://github.com/pdm-project/pdm-backend/issues/136 [<samp>(2986d)</samp>](https://github.com/pdm-project/pdm-backend/commit/2986dc6) - Add a shortcut to get hook config - | Low | 12/14/2022 |
| 2.0.0a3 | ### đ Features - Rename the is_enabled hook to pdm_build_hook_enabled - by @frostming [<samp>(4729b)</samp>](https://github.com/pdm-project/pdm-backend/commit/4729bd1) ### đ Bug Fixes - Always call hook in the generated setup.py - by @frostming [<samp>(67db6)</samp>](https://github.com/pdm-project/pdm-backend/commit/67db615) ##### [View changes on GitHub](https://github.com/pdm-project/pdm-backend/c | Low | 11/30/2022 |
| 2.0.0a2 | ### đ Bug Fixes - Run setup.py after initialization - by @frostming [<samp>(edcd8)</samp>](https://github.com/pdm-project/pdm-backend/commit/edcd802) ##### [View changes on GitHub](https://github.com/pdm-project/pdm-backend/compare/2.0.0a1...2.0.0a2) | Low | 11/29/2022 |
| 2.0.0a1 | ### đ Features - Rename the package to `pdm-backend` - by @frostming [<samp>(79d10)</samp>](https://github.com/pdm-project/pdm-backend/commit/79d1077) - Rewrite the builders to support build hooks - by @frostming [<samp>(9d5d5)</samp>](https://github.com/pdm-project/pdm-backend/commit/9d5d5a4) ##### [View changes on GitHub](https://github.com/pdm-project/pdm-backend/compare/1.0.6...2.0.0a1) | Low | 11/29/2022 |
| 1.0.6 | ## What's Changed * [pre-commit.ci] pre-commit autoupdate by @pre-commit-ci in https://github.com/pdm-project/pdm-pep517/pull/128 * Add setuptools to dev dependencies by @frenzymadness in https://github.com/pdm-project/pdm-pep517/pull/131 * feat: Honor the metadata_directory passed to build_wheel by @frostming in https://github.com/pdm-project/pdm-pep517/pull/132 ## New Contributors * @frenzymadness made their first contribution in https://github.com/pdm-project/pdm-pep517/pull/131 **F | Low | 11/24/2022 |
| 1.0.5 | ## What's Changed * README.md: Fix Dynamic Version example by @hosiet in https://github.com/pdm-project/pdm-pep517/pull/115 * Support license files located in subdirectories by @crai0 in https://github.com/pdm-project/pdm-pep517/pull/119 * fix: update implementation of PEP 639 by @frostming in https://github.com/pdm-project/pdm-pep517/pull/120 * [pre-commit.ci] pre-commit autoupdate by @pre-commit-ci in https://github.com/pdm-project/pdm-pep517/pull/121 * feat: expand vars in req url by @fr | Low | 10/24/2022 |
| 1.0.4 | ## What's Changed * [pre-commit.ci] pre-commit autoupdate by @pre-commit-ci in https://github.com/pdm-project/pdm-pep517/pull/113 * fix: allow overriding files in wheel by @frostming in https://github.com/pdm-project/pdm-pep517/pull/114 **Full Changelog**: https://github.com/pdm-project/pdm-pep517/compare/1.0.3...1.0.4 | Low | 8/6/2022 |
| 1.0.2 | ## What's Changed * fix: handle reuse spec projects by @CharString in https://github.com/pdm-project/pdm-pep517/pull/105 * [pre-commit.ci] pre-commit autoupdate by @pre-commit-ci in https://github.com/pdm-project/pdm-pep517/pull/103 ## New Contributors * @CharString made their first contribution in https://github.com/pdm-project/pdm-pep517/pull/105 **Full Changelog**: https://github.com/pdm-project/pdm-pep517/compare/1.0.1...1.0.2 | Low | 7/18/2022 |
| 1.0.1 | ## What's Changed * docs: Document writing SCM version to file by @pawamoy in https://github.com/pdm-project/pdm-pep517/pull/100 * docs: dynamic version uses tool.pdm.version, not tool.pdm.build.version by @Nothing4You in https://github.com/pdm-project/pdm-pep517/pull/101 ## New Contributors * @pawamoy made their first contribution in https://github.com/pdm-project/pdm-pep517/pull/100 * @Nothing4You made their first contribution in https://github.com/pdm-project/pdm-pep517/pull/101 **F | Low | 7/3/2022 |
| 1.0.0 | ### Bug Fixes - Emit `UserWarning` for deprecated settings. ### Features & Improvements - Allow writing dynamic version from `scm` source to a file. [#94](https://github.com/frostming/pdm-pep517/issues/94) - The dynamic version table fields are renamed: `{from = ...}` to `{source = "file", path = ...}` and `{use_scm = true}` to `{source = "scm"}`. [#95](https://github.com/frostming/pdm-pep517/issues/95) - Support custom build script, a script containing a function named `build` that t | Low | 6/25/2022 |
Dependencies & License Audit
Loading dependencies...
Similar Packages
More from pypi
markitdownUtility tool for converting various files to Markdown
fastapiFastAPI framework, high performance, easy to learn, fast to code, ready for production
djangoA high-level Python web framework that encourages rapid development and clean, pragmatic design.
flaskA simple framework for building complex web applications.
More in Frameworks
spec_driven_developSpec-Driven Develop is a platform-agnostic AI agent skill that automates the pre-development workflow for large-scale complex tasks. It is not a framework, not a runtime, not a package manager â it is
deer-flowAn open-source long-horizon SuperAgent harness that researches, codes, and creates. With the help of sandboxes, memories, tools, skill, subagents and message gateway, it handles different levels of ta
tqdmFast, Extensible Progress Meter
simBuild, deploy, and orchestrate AI agents. Sim is the central intelligence layer for your AI workforce.