PDM 旨在成为下一代 Python 软件包管理工具。它最初是为个人兴趣而诞生的。如果你觉得 pipenv
或者
poetry
用着非常好,并不想引入一个新的包管理器,那么继续使用它们吧;但如果你发现有些东西这些
工具不支持,那么你很可能可以在 pdm
中找到。
- 一个简单且相对快速的依赖解析器,特别是对于大的二进制包发布。
- 兼容 PEP 517 的构建后端,用于构建发布包(源码格式与 wheel 格式)
- 灵活且强大的插件系统
- PEP 621 元数据格式
- 功能强大的用户脚本
- 支持从 indygreg's python-build-standalone 安装 Python。
- 像 pnpm 一样的中心化安装缓存,节省磁盘空间
Pipenv 是一个依赖管理器,它结合了 pip
和 venv
,正如其名称所暗示的。它可以从一种自定义格式文件 Pipfile.lock
或 Pipfile
中安装软件包。
然而,Pipenv 并不处理任何与构建、打包和发布相关的工作。所以它只适用于开发不可安装的应用程序(例如 Django 网站)。
如果你是一个库的开发者,无论如何你都需要 setuptools
。
Poetry 以类似于 Pipenv 的方式管理环境和依赖,它也可以从你的代码构建 .whl
文件,并且可以将轮子和源码发行版上传到 PyPI。
它有一个漂亮的用户界面,用户可以通过贡献插件来定制它。Poetry 使用 pyproject.toml
标准。但它并不遵循指定元数据应如何在 pyproject.toml
文件中表示的标准(PEP 621)。而是使用一个自定义的 [tool.poetry]
表。这部分是因为 Poetry 诞生在 PEP 621 出现之前。
Hatch 也可以管理环境(它允许每个项目有多个环境,但不允许把它们放在项目目录中),并且可以管理包(但不支持 lockfile)。Hatch 也可以用来打包一个项目(用符合 PEP 621 标准的 pyproject.toml
文件)并上传到 PyPI。
PDM 也可以像 Pipenv 那样在项目或集中的位置管理 venvs。它从一个标准化的 pyproject.toml
文件中读取项目元数据,并支持 lockfile。用户可以在插件中添加更多的功能,并将其作为一个发行版上传,以供分享。
此外,与 Poetry 和 Hatch 不同,PDM 并没有被和一个特定的构建后端绑定,你可以选择任何你喜欢的构建后端。
PDM 需要 Python 3.8 或更高版本。
像 pip 一样,PDM 也提供了一键安装脚本,用来将 PDM 安装在一个隔离的环境中。
Linux/Mac 安装命令
curl -sSL https://pdm-project.org/install-pdm.py | python3 -
Windows 安装命令
powershell -ExecutionPolicy ByPass -c "irm https://pdm-project.org/install-pdm.py | py -"
为安全起见,你应该检查 install-pdm.py
文件的正确性。
校验和文件下载地址:install-pdm.py.sha256
默认情况下,此脚本会将 PDM 安装在 Python 的用户目录下,具体位置取决于当前系统:
- Unix 上是
$HOME/.local/bin
- MacOS 上是
$HOME/Library/Python/<version>/bin
- Windows 上是
%APPDATA%\Python\Scripts
你还可以通过命令行的选项来改变安装脚本的行为:
usage: install-pdm.py [-h] [-v VERSION] [--prerelease] [--remove] [-p PATH] [-d DEP]
optional arguments:
-h, --help show this help message and exit
-v VERSION, --version VERSION | envvar: PDM_VERSION
Specify the version to be installed, or HEAD to install from the main branch
--prerelease | envvar: PDM_PRERELEASE Allow prereleases to be installed
--remove | envvar: PDM_REMOVE Remove the PDM installation
-p PATH, --path PATH | envvar: PDM_HOME Specify the location to install PDM
-d DEP, --dep DEP | envvar: PDM_DEPS Specify additional dependencies, can be given multiple times
你既可以通过直接增加选项,也可以通过设置对应的环境变量来达到这一效果。
如果你使用的是 macOS 并且安装了 homebrew
:
brew install pdm
如果你在 Windows 上使用 Scoop, 运行以下命令安装:
scoop bucket add frostming https://github.com/frostming/scoop-frostming.git
scoop install pdm
否则,强烈推荐把 pdm
安装在一个隔离环境中, 用 pipx
是最好的。
pipx install pdm
或者你可以将它安装在用户目录下:
pip install --user pdm
asdf plugin add pdm
asdf install pdm latest
初始化一个新的 PDM 项目
pdm init
按照指引回答提示的问题,一个 PDM 项目和对应的pyproject.toml
文件就创建好了。
添加依赖
pdm add requests flask
你可以在同一条命令中添加多个依赖。稍等片刻完成之后,你可以查看pdm.lock
文件看看有哪些依赖以及对应版本。
在 README.md 中加入以下 Markdown 代码,向大家展示项目正在使用 PDM:
[![pdm-managed](https://img.shields.io/endpoint?url=https%3A%2F%2Fcdn.jsdelivr.net%2Fgh%2Fpdm-project%2F.github%2Fbadge.json)](https://pdm-project.org)
Awesome PDM 这个项目收集了一些非常有用的 PDM 插件及相关资源。
本项目基于 MIT 协议开源,具体可查看 LICENSE。