pdm-backend
The build backend used by PDM that supports latest packaging standards
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.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
azure-core-tracing-opentelemetryMicrosoft Azure Azure Core OpenTelemetry plugin Library for Pythonazure-template_0.1.0b6187637