A PEP 517 backend for PDM that supports PEP 621 metadata
Project description
PDM-PEP517
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.
Use as PEP 517 build backend
Edit your pyproject.toml as follows:
[build-system]
requires = ["pdm-pep517"]
build-backend = "pdm.pep517.api"
Tool specific settings
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]
# Specify where the Python packages live.
package-dir = "src"
# File patterns to include, the paths are relative to the project root.
includes = []
# File patterns to exclude, the paths are relative to the project root.
excludes = []
# File patterns to include in source distribution and exclude in wheel distribution.
source-includes = []
# An extra script to populate the arguments of `setup()`, one can build C extensions with this script.
build = "build.py"
# Override the Is-Purelib value in the wheel.
is-purelib = true
# Change the editable-backend: path(default) or editables
editable-backend = "editables"
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.
Supported config settings
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.
License
This project is licensed under MIT license.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file pdm-pep517-0.12.3.tar.gz.
File metadata
- Download URL: pdm-pep517-0.12.3.tar.gz
- Upload date:
- Size: 291.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.0 CPython/3.8.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 117bfb1619b86beb34fe009b8d41acacf790d1fc5240ccc11f6cada151d46887 |
|
| MD5 | 3b922af984b222e1b25d56f954c56a45 |
|
| BLAKE2b-256 | cd295ccfe04da3d1c138e464a05244640d83f88881f99f7733391b7944aed994 |
Provenance
File details
Details for the file pdm_pep517-0.12.3-py3-none-any.whl.
File metadata
- Download URL: pdm_pep517-0.12.3-py3-none-any.whl
- Upload date:
- Size: 302.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.0 CPython/3.8.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | c03760e32eeca43da01ffa6c6911cd8c9acb5f232dff1454dd470f4533b80b60 |
|
| MD5 | ecbd47f3e67af40ff62b413e3b31fe9a |
|
| BLAKE2b-256 | e2c23667a4ff953a0a20c67a1a436eb2c68d98876a803f7be342826b75cec59c |
