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.