在项目中使用了pyproject.toml
文件后,你可以利用pip
来构建和安装模块。这种方法不仅适用于纯Python项目,也适用于包含扩展模块的项目。pip
会自动识别pyproject.toml
文件,并使用里面指定的构建系统(如setuptools
)来构建项目。
构建项目
如果你只想构建项目(例如,生成轮文件 .whl
),而不立即安装,你可以在项目的根目录下执行以下命令:
bash
pip wheel .
这会构建项目并生成一个轮文件(.whl
),通常存放在dist/
目录下。这个轮文件是一个包的二进制分发格式,包含了安装包所需的所有文件。
安装项目
如果你想构建并安装项目到你的Python环境中,可以使用以下命令:
bash
pip install .
这个命令会从当前目录(.
指的是当前目录)构建并安装包。如果你的项目包含C扩展,pip
会自动处理编译这些扩展所需的步骤。
使用build
工具
除了pip
之外,Python生态系统还提供了一个名为build
的独立工具,它专门用于构建Python项目。首先,你需要确保安装了build
工具:
bash
pip install build
然后,你可以在项目的根目录下使用以下命令来构建项目:
bash
python -m build
这个命令会生成轮文件和源码包,通常也存放在dist/
目录下。与pip wheel .
类似,这种方法不会自动安装包,但你可以随后使用pip
来安装生成的轮文件。
注意
- 在构建和安装之前,请确保你的环境中安装了所有必要的编译工具,比如C编译器(如
gcc
或clang
),以及Python开发头文件。 - 如果你的项目依赖于特定的Python版本,请确保你使用的是正确版本的
pip
和Python环境。
通过以上步骤,你可以使用pyproject.toml
来配置项目,并利用pip
或build
工具来构建和安装Python扩展模块。