Poetry PEP 517 Build Backend
Project description
Poetry Core
A PEP 517 build backend implementation developed for Poetry. This project is intended to be a light weight, fully compliant, self-contained package allowing PEP 517 compatible build frontends to build Poetry managed projects.
Usage
In most cases, the usage of this package is transparent to the end-user as it is either made use by Poetry itself
or a PEP 517 frontend (eg: pip
).
In order to enable the use poetry-core
as your build backend, the following snippet must be present in your
project's pyproject.toml
file.
[build-system]
requires = ["poetry-core"]
build-backend = "poetry.core.masonry.api"
Once this is present, a PEP 517 frontend like pip
can build and install your project from source without the need
for Poetry or any of it's dependencies.
# install to current environment
pip install /path/to/poetry/managed/project
# build a wheel package
pip wheel /path/to/poetry/managed/project
Why is this required?
Prior to the release of version 1.1.0
, Poetry was a build as a project management tool that included a PEP 517
build backend. This was inefficient and time consuming in majority cases a PEP 517 build was required. For example,
both pip
and tox
(with isolated builds) would install Poetry and all dependencies it required. Most of these
dependencies are not required when the objective is to simply build either a source or binary distribution of your
project.
In order to improve the above situation, poetry-core
was created. Shared functionality pertaining to PEP 517 build
backends, including reading lock file, pyproject.toml
and building wheel/sdist, were implemented in this package. This
makes PEP 517 builds extremely fast for Poetry managed packages.
Project details
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
Hashes for quara-poetry-core-next-1.1.0a6.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 6afc987f8d45baa6931b1720a7c5986e3367c69e21a9845de31d38f26f05f56c |
|
MD5 | d592bd299edb464a6406c62938a979c8 |
|
BLAKE2b-256 | d69f4d87de420573a47de9bfe957813a89fc3215341678cba85f79697c6a7153 |
Hashes for quara_poetry_core_next-1.1.0a6-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | df2cec2aa6fa6154172dfd84bb92a40a6fbaf4c0d70638953336356d1e4c9000 |
|
MD5 | 47a9a953790e103aa29a69e80eda5e9e |
|
BLAKE2b-256 | d60922ab2fe8e8263f5a17cb5fd44e690f713e0ac0e1a5bbabd1e2295bb143e4 |