mirrors/poky
1
0
Fork 0
mirror of https://git.yoctoproject.org/poky synced 2026-04-21 12:32:15 +02:00
Code Issues Packages Projects Releases Wiki Activity

docs: update setuptools3 class

Browse Source 
Add notes to inform about the new `wheel` behavior of the
setuptools3.bbclass.

(From yocto-docs rev: 4f19c8218f7c960d1ad0288d76d5394b6595c3f1)

Signed-off-by: Tim Orling <tim.orling@konsulko.com>
Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Tim Orling
2022-02-27 20:04:06 -08:00
committed by Richard Purdie
parent 0447aace57
commit 99a5b42d5c
1 changed files with 20 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

22
documentation/ref-manual/classes.rst
View File

@@ -2386,8 +2386,26 @@ the Simple DirectMedia Layer (SDL) library.
=======================
The ``setuptools3`` class supports Python version 3.x extensions that
use build systems based on ``setuptools``. If your recipe uses these
build systems, the recipe needs to inherit the ``setuptools3`` class.
use build systems based on ``setuptools`` (e.g. only have a ``setup.py`` and
have not migrated to the official ``pyproject.toml`` format). If your recipe
uses these build systems, the recipe needs to inherit the ``setuptools3`` class.
.. note::
The ``setuptools3`` class ``do_compile()`` task now calls
``setup.py bdist_wheel`` to build the ``wheel`` binary archive format
(See `PEP-427 <https://www.python.org/dev/peps/pep-0427/>`__).
A consequence of this is that legacy software still using deprecated
``distutils`` from the Python standard library cannot be packaged as
``wheels``. A common solution is the replace
``from distutils.core import setup`` with ``from setuptools import setup``.
.. note::
The ``setuptools3`` class ``do_install()`` task now calls ``pip install``
to install the ``wheel`` binary archive. In current versions of
``setuptools`` the legacy ``setup.py install`` method is deprecated.
.. _ref-classes-setuptools3-base: