From 270a19a15e45154907e41e24b59fd26c96c55935 Mon Sep 17 00:00:00 2001 From: Sviatoslav Sydorenko Date: Thu, 16 Nov 2023 00:46:40 +0100 Subject: [PATCH] Add a change note for PR #893 --- CHANGES/893.misc.rst | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) create mode 100644 CHANGES/893.misc.rst diff --git a/CHANGES/893.misc.rst b/CHANGES/893.misc.rst new file mode 100644 index 000000000..1bd014e5c --- /dev/null +++ b/CHANGES/893.misc.rst @@ -0,0 +1,24 @@ +Replaced the packaging is replaced from an old-fashioned :file:`setup.py` to an +in-tree :pep:`517` build backend -- by :user:`webknjaz`. + +Whenever the end-users or downstream packagers need to build ``yarl`` from +source (a Git checkout or an sdist), they have to pass a ``config_settings`` +flag ``--build-c-extensions``. If this flag is not set, a pure-python +distribution will be built. + +Here is how this can be done with ``pip``: + +.. code-block:: console + + $ python -m pip install . --config-settings=--build-c-extensions= + +This will also work with ``-e | --editable``. + +The same can be achieved via ``pypa/build``: + +.. code-block:: console + + $ python -m pip build --config-settings=--build-c-extensions= + +Adding ``-w | --wheel`` can force ``pypa/build`` produce a wheel from source +directly, as opposed to building an ``sdist`` and then building from it.