Yet another PEP 517 backend.
This is the backend for PDM projects, while you can also use it alone. It reads the metadata of PEP 621 format and coverts it to Core metadata.
Edit your pyproject.toml
as follows:
[build-system]
requires = ["pdm-pep517"]
build-backend = "pdm.pep517.api"
Besides of the standard fields specified in PEP 621, PDM-PEP517 honors some other settings to change the build behavior. They should be defined under [tool.pdm]
table:
[tool.pdm]
package-dir = "src" # Similar to setuptools package_dir option
includes = [] # File patterns to include, the paths are relative to the project root.
excludes = [] # File patterns to exclude, the paths are relative to the project root.
source-includes = [] # File patterns to include in source distribution and exclude in wheel distribution
You don't have to specify all of them, PDM-PEP517 can also derive these fields smartly, based on some best practices of Python packaging.
pdm-pep517
allows passing config_settings
to modify the build behavior. It use the same option convention as python setup.py bdist_wheel
.
--python-tag
Override the python implementation compatibility tag(e.g. cp37, py3, pp3)
--py-limited-api
Python tag (cp32|cp33|cpNN) for abi3 wheel tag
--plat-name
Override the platform name(e.g. win_amd64, manylinux2010_x86_64)
For example, you can supply these options with build:
python -m build --sdist --wheel --outdir dist/ --config-setting="--python-tag=cp37" --config-setting="--plat-name=win_amd64"
pip
doesn't support passing config_settings
yet, please stick to build
as the recommended frontend.
This project is licensed under MIT license.