diff options
author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-29 04:20:41 +0000 |
---|---|---|
committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-29 04:20:41 +0000 |
commit | b49f1524e250764592ff132af8fb0d39182620f7 (patch) | |
tree | a2c4da0c1bfc3be79c9b80180d8958804e91a07d /docs/differences.rst | |
parent | Initial commit. (diff) | |
download | python-build-b49f1524e250764592ff132af8fb0d39182620f7.tar.xz python-build-b49f1524e250764592ff132af8fb0d39182620f7.zip |
Adding upstream version 0.9.0.upstream/0.9.0upstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'docs/differences.rst')
-rw-r--r-- | docs/differences.rst | 30 |
1 files changed, 30 insertions, 0 deletions
diff --git a/docs/differences.rst b/docs/differences.rst new file mode 100644 index 0000000..6fbc401 --- /dev/null +++ b/docs/differences.rst @@ -0,0 +1,30 @@ +============================ +Differences from other tools +============================ + +``pep517.build`` +---------------- + +build implements a CLI tailored to end users. + +``pep517.build`` contained a proof-of-concept of a :pep:`517` +frontend. It *"implement[ed] essentially the simplest possible frontend +tool, to exercise and illustrate how the core functionality can be +used"*. It has since been `deprecated and is scheduled for removal`_. + +``setup.py sdist bdist_wheel`` +------------------------------ + +build is roughly the equivalent of ``setup.py sdist bdist_wheel`` but +with :pep:`517` support, allowing use with projects that don't use setuptools. + +.. _deprecated and is scheduled for removal: https://github.com/pypa/pep517/pull/83 + +Custom Behaviors +---------------- + +Fallback Backend +^^^^^^^^^^^^^^^^ + +As recommended in :pep:`517`, if no backend is specified, ``build`` will +fallback to ``setuptools.build_meta:__legacy__``. |