mbox series

[libgpiod,v2,0/2] bindings: python: optionally include (...)

Message ID 20231012210228.101513-1-phil@gadgetoid.com
Headers show
Series bindings: python: optionally include (...) | expand

Message

Phil Howard Oct. 12, 2023, 9:02 p.m. UTC
This changeset vendors the gpiod library into the Python package, and adds
a pyproject.toml for minimum compatibility with modern Python packaging.

Why?

So that setup.py can produce an sdist that is installable irrespective of the
availability or version of a distro-supplied libgpiod.

This prevents a libgpiod pypi package install balking because the distro
libgpiod is outdated or otherwise incompatible. This happens when attempting to
install the current libgpiod from pypi onto - for example - the Debian Bookworm
based Raspberry Pi OS.

The availability of a distro agnostic package also ensures that libgpiod can be
installed via pypi into an isolated virtual environment, safely specified as a
dependency for Python packages and allows Python developers to target the newest
API version irrespective of their distro supplied libgpiod.

This is essential, since a venv is now widely *required* for user Python
projects due to recommendations in pep-688 - https://peps.python.org/pep-0668/

For Raspberry Pi this sdist can also be converted into a precompiled wheel by
piwheels [1] which is, by default, added to Raspberry Pi OS as a pip index.

How?

If "LINK_SYSTEM_LIBGPIOD=1" is not specified then the gpiod._ext C Extension is
amended to include all of the C sources for gpiod, so it can be built as a
standalone module without depending upon a shared distro library.

The gpiod sources are included by copying the lib and include directories up
to the parent module, and updating MANIFEST.in to include the source files when
an sdist is built.

The resulting source distribution can then be uploaded to pypi and from there
can be built and installed by any user with python3-dev installed.

[1] - https://www.piwheels.org/

Phil Howard (2):
  bindings: python: optionally include module in sdist
  bindings: python: add pyproject.toml, pep 518

 bindings/python/MANIFEST.in    |  4 ++
 bindings/python/pyproject.toml |  5 ++
 bindings/python/setup.py       | 95 ++++++++++++++++++++++++++++------
 3 files changed, 89 insertions(+), 15 deletions(-)
 create mode 100644 bindings/python/pyproject.toml