v2.29.72026-11-06
Bug Fixes
- Upgrade hishel to support version 2 or greater. (#3995)
v2.29.62026-11-05
Bug Fixes
- Fix the uv mode failing when pyproject.toml or uv.lock cannot be renamed, as happens when they are bind mounts in a container, by falling back to restoring their content in place. (#3292)
- Percent-encode the source username and password in the index URLs passed to uv, so use_uv works with credentials that contain characters like #, / or %. (#3974)
- Honor local wheel and sdist paths in pylock.toml, preferring them over URLs while preserving explicit artifact filenames. (#3975)
- Fix the Python range pdm derives from a pythonversion marker that compares against a three-part version, such as pythonversion >= "3.8.1". (#3978)
- Save prompted credentials only after a successful package upload response. (#3982)
- Keep the version from pyproject.toml or setup.cfg when a later setup.cfg or setup.py sets none, instead of resetting it to 0.0.0 while parsing project files. (#3983)
- Allow pdm config to set an explicitly provided empty string value instead of treating it as a read operation. (#3984)
- Fix PEP 582 setup for Bash-compatible shells when the installation path contains an apostrophe. (#3986)
- Remove the downloaded archive after pdm python install installs an interpreter, instead of leaving it in the temporary directory. (#3988)
- Quote Poetry platform constraints verbatim instead of using repr() when converting them to environment markers, so they stay valid under stricter marker string parsing. (#3993)
Documentation
- Fix two dead links in the project and template usage docs. (#3976)
Miscellany
- Publish releases with pypa/gh-action-pypi-publish to attach PEP 740 provenance attestations on PyPI. (#3979)
v2.29.52026-10-30
Bug Fixes
- Preserve archive subdirectories when writing or exporting pylock.toml. (#3964)
- Preserve extras and environment markers on local, URL, Git, and workspace file requirements when translating dependencies for uv. (#3965)
- Preserve Git source subdirectories and encoded refs when generating, reusing, and reading uv lockfiles. (#3966)
- Allow sorting installed packages by optional metadata such as homepage when some values are missing or unknown. (#3967)
- Fill the Homepage in pdm show from the Homepage Project-URL, and stop pdm show failing on a Project-URL that contains a comma. (#3968)
- Quote the activation script path that pdm venv activate prints for PowerShell, so Invoke-Expression (pdm venv activate) works when the path contains spaces or apostrophes. (#3970)
- On Windows, quote the extra arguments of a shell script, and the {args} placeholder in it, for cmd.exe instead of with POSIX single quotes. (#3971)
- Omit missing package versions when exporting to pylock.toml. (#3972)
- Fill the Homepage in pdm list from the Homepage Project-URL when Home-page is missing or unknown. (#3973)
v2.29.42026-10-27
Features & Improvements
- Allow specifying lock.format in pyproject.toml via the [tool.pdm.lock] table. (#3958)
Bug Fixes
- Import a requirements file that starts with a UTF-8 BOM, which failed with a RequirementError. (#3937)
- Treat a Pipfile version without an operator, such as requests = "2.31.0", as an exact == pin when importing, like pipenv does, instead of failing with an invalid specifier error. (#3939)
- Preserve Poetry include entries targeting both source and wheel distributions when importing a project. (#3941)
- Preserve version and description when importing Flit projects with a src/ layout or an annotated version. (#3942)
- Require certifi>=2026.10.19, which removes the emSign ECC Root CA - G3 root whose eMudhra intermediates had their private keys compromised. (#3944)
- pdm outdated no longer lists a package whose installed version is newer than the latest one found on the index, such as an installed pre-release or local build. (#3945)
- Fix pdm lock --check reporting an outdated lockfile when a group is declared in both [dependency-groups] and [tool.pdm.dev-dependencies]. (#3947)
- Show the license from License-Expression (PEP 639) in pdm show and pdm list --fields licenses. (#3948)
- Stop pdm lock from excluding packages from a lock target when another target shares its OS and architecture, e.g. manylinux and musllinux. (#3950)
- Fix a crash when a pythonversion marker compares against a wildcard version such as pythonversion == "3.*". (#3951)
- Send License-Expression and License-File with the upload in pdm publish, so PyPI shows the license of PEP 639 packages. (#3952)
- Preserve the subdirectory fragment in source archive requirements when resolving dependencies and serializing requirement URLs. (#3954)
- Preserve archive hashes when reading pylock.toml so they remain available for exports. (#3956)
- Fix detection of responses served from the HTTP cache, so cached downloads and index pages are reported as cached again. (#3961)
Dependencies
- Install the download dependencies of pbs-installer so Python installation works with its latest releases. (#3959)
- Upgrade unearth to >=0.19 and migrate the HTTP client from httpx to httpx2. pdm.models.session.PDMPyPIClient and the transports in pdm.pytest are now built on httpx2, so plugins interacting with them should import httpx2 instead of httpx. (#3962)
v2.29.32026-10-19
Features & Improvements
- Add the --venv option to pdm outdated, like the other commands that read the installed packages. (#3904)
Bug Fixes
- Fix isolated PEP 517 builds skipping packages that are only visible via the host venv's --system-site-packages. (#3895)
- Fix pdm import of Poetry projects dropping optional dependencies whose extras entry is spelled differently, and importing optional dependencies with multiple constraints as required ones. (#3899)
- Keep the plain requirement in pdm export when the same package is also locked with extras under a narrower marker, so it is no longer missing from requirements.txt on the other platforms. (#3900)
- Fix python_version <= "X.Y" markers excluding the patch releases of X.Y, so pdm install skipped such dependencies. (#3902)
- Fix environment variables set by one task of a composite script, via env or env_file, leaking into the tasks that run after it. (#3903)
- Convert flit's comma-separated keywords and obsolete dev-requires into valid PEP 621 fields when importing a flit project. (#3907)
- Import custom Pipfile package categories, such as [docs], as dependency groups instead of dropping them. (#3909)
- Keep editable requirements in [tool.pdm.dev-dependencies] on pdm import, so the written [dependency-groups] table stays valid per PEP 735. (#3910)
- Keep Poetry's develop = true as an editable requirement when importing dependency groups. (#3913)
- Fix pdm import of the project's own Poetry pyproject.toml writing each dependency group to both [tool.pdm.dev-dependencies] and [dependency-groups]. (#3915)
- Import Pipfile packages declared with a file URL, such as {file = "https://..."}, as URL requirements instead of dropping the URL. (#3918)
- Preserve Poetry platform restrictions as environment markers when importing dependencies. (#3920)
- Read an exclude-newer timestamp without a UTC offset as UTC, so pdm lock no longer fails with a TypeError comparing naive and aware datetimes. (#3922)
- Do not write empty dependency groups, such as dev = [] from an empty [dev-packages] table, when importing from another format. (#3925)
- Strip every leading and trailing ., ` and - when pdm init derives the project name from the directory, so a folder like demo no longer produces the invalid name demo_. (#3927)
- pdm init now writes project.license as a license expression string instead of a {text = ...} table, and no longer rewrites an existing {file = ...} table or license expression into a value the build backend rejects. (#3929)
- Read the inline metadata of a script that starts with a UTF-8 BOM, which pdm run ignored. (#3931)
- Convert a space-separated Poetry version constraint such as >=1.0 <2.0 like the comma-separated form instead of aborting the import. (#3934)
- Resolve relative path entries in a Pipfile against the directory of the Pipfile` when importing, instead of the current working directory. (#3935)
Documentation
- Document what to cache and which install command to use when running PDM on CI platforms other than GitHub Actions. (#2472)
v2.29.22026-09-17
Bug Fixes
- Fix writing lock files specified as bare relative filenames with pdm lock --lockfile. (#3891)
- Preserve local paths containing spaces and their extras and environment markers when importing requirements files. (#3894)
Documentation
- List the install-pdm.py options the script actually accepts. (#3889)
v2.29.12026-09-14
Features & Improvements
- Explain missing lockfile groups and provide group-selection recovery guidance when installing, syncing, or updating groups. (#2682)
- Allow package-specific overrides for exclude-newer resolution limits. (#3809)
Bug Fixes
- Keep the separating comma out of the operator and accept a v prefix when converting Poetry version constraints. (#3860)
- Escape glob characters in the virtualenv lookup prefix, so a project whose directory name contains [ or ] can find its own virtualenv. (#3869)
- Write pyproject.toml and lockfiles atomically to prevent interrupted writes from truncating them. (#3870)
- Resolve the workspace root before making member paths relative, so a root given as a relative path or reached through a symlink no longer raises ValueError. (#3874)
- Replace the destination of an atomic write instead of unlinking it first, so an interrupted write can no longer destroy pyproject.toml or the lockfile. (#3878)
- Report the version part that could not be read, instead of blaming a postrelease for every parse failure. (#3880)
- Keep quoted local paths that contain ` - ` when parsing requirements files. (#3885)
Documentation
- Clarify dependency command effects on project declarations, lock metadata, and installed packages in the guide and CLI help. (#2681)
v2.29.02026-08-29
Features & Improvements
- Export editable local dependencies with relative paths in requirements files. (#3294)
- Extend pdm run with --env, --env-file and --working-dir options to set or override the corresponding script options dynamically. (#3829)
Bug Fixes
- Restrict a locked package to the platform it was resolved for when it doesn't belong to every lock target, so pdm lock --platform ... --append no longer adds entries that get installed on the other targets. (#3261)
- Keep Poetry include entries restricted to the sdist format when importing, writing them to tool.pdm.build.source-includes instead of dropping them. (#3854)
- Accept --no-verify-ssl on pdm publish, which was misspelled as --no-very-ssl. The old spelling keeps working as an alias. (#3857)
- Convert Poetry tilde constraints with fewer than three components to the bounds Poetry means: ~1.2 becomes <1.3 rather than <2.0, and ~1 no longer produces an invalid ~=1 specifier that aborts the import. (#3858)
- Keep the separating comma out of the operator and accept a v prefix when converting Poetry version constraints. (#3860)
- Keep importing a Poetry project when an author or maintainer entry does not fit the Name <email> pattern. (#3861)
- Skip requires-python when a Pipfile [requires] table has no python version, instead of writing >=None. (#3862)
- Leave the version and description empty instead of aborting when a flit module cannot be parsed. (#3864)
- Respect dependency group selection options when exporting to pylock.toml, producing a single-use lock file that contains only the selected packages. (#3866)
v2.28.22026-08-18
Bug Fixes
- Keep environment inspection working for Python 3.9 targets when PDM uses dep-logic 0.7 or newer. (#3838)
- Cache the update check timestamp even when the version lookup fails, so that pdm no longer appears to hang on every command when PyPI is unreachable. (#3840)
- Don't crash with an IndexError when listing scripts and one of them is blank. A blank script is now listed as <BLANK_SCRIPT>. (#3842)
- Keep the whole template URL when pdm new is given an ssh:// or credentialed Git URL, instead of truncating it at the userinfo @. (#3843)
- Strip comments preceded by any whitespace, not only a plain space, when importing a requirements.txt file. (#3844)
- Match --trusted-host on host and port when importing a requirements.txt file, and keep the port when exporting one. (#3845)
- Expand a ~ prefix in the venv.location config so pdm venv list/remove/activate/purge find virtualenvs created under it. (#3847)
- Convert a Poetry caret constraint on a 0.x version to the upper bound Poetry documents, so ^0.2.3 becomes <0.3.0 and ^0.0.3 becomes <0.0.4 instead of <1.0.0. (#3848)
- Fill in a placeholder project.name and project.version for the pyproject.toml generated for uv, so pdm lock/pdm install work with use_uv on a project that declares neither. (#3849)
- Resolve nested requirement paths relative to remote requirements file URLs. (#3850)
v2.28.12026-08-11
Features & Improvements
- Defer command action and Python installer imports until their corresponding runtime paths execute. (#3673)
- Add {run_cwd} placeholder for scripts to reference the original working directory. (#3734)
- Add opt-in canonical lock input freshness via tool.pdm.resolution.lock_inputs while retaining sticky lockfile behavior and legacy hash fallback for existing lock files. (#3821)
- Integrate argcomplete for simplified command-line completion scripts. (#3823)
Bug Fixes
- Keep workspace members in their explicitly declared dependency groups instead of adding them to `default in the lockfile. (#3816)
- Keep the cached parsed version intact when stripping the local segment in comparable_version(). (#3817)
- Make use_uv support adding local files. (#3822)
- Add a Poetry optional dependency to every extra that lists it when importing, instead of only the first one. (#3831)
- Do not write null values into the generated pyproject.toml when importing a flit project that omits author-email/maintainer-email or sets only one of include and exclude in [tool.flit.sdist]`. (#3832)
Miscellany
- Add Python 3.15 preview version to the CI matrix. (#3827)