Skip to content

doc/getting_started: Document distro packages#1796

Open
pamolloy wants to merge 1 commit intolabgrid-project:masterfrom
pamolloy:document-distro-pkgs
Open

doc/getting_started: Document distro packages#1796
pamolloy wants to merge 1 commit intolabgrid-project:masterfrom
pamolloy:document-distro-pkgs

Conversation

@pamolloy
Copy link
Copy Markdown

@pamolloy pamolloy commented Jan 8, 2026

Distro packages are can create users/groups, install systemd service files, and install udev rules. They also can deal with distro specifics like uaccess vs. plugdev. Despite those benefits they present challenges related to dependency management.

As the author of the Fedora Copr package I have done some basic testing. I was able to run both services, acquire a place and access a console. I tried the Debian package as well, but did not test it extensively.

Note that in both cases dependencies (most importantly gRPC) are older than required by pyproject.toml.

Distro packages are can create users/groups, install systemd service
files, and install udev rules. They also can deal with distro specifics
like uaccess vs. plugdev. Despite those benefits they present challenges
related to dependency management.

Signed-off-by: Philip Molloy <philip@philipmolloy.com>
@codecov
Copy link
Copy Markdown

codecov bot commented Jan 14, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 45.1%. Comparing base (cb7b04f) to head (fdd892a).
⚠️ Report is 4 commits behind head on master.
✅ All tests successful. No failed tests found.

Additional details and impacted files
@@          Coverage Diff           @@
##           master   #1796   +/-   ##
======================================
  Coverage    45.1%   45.1%           
======================================
  Files         172     172           
  Lines       13617   13617           
======================================
  Hits         6143    6143           
  Misses       7474    7474           
Flag Coverage Δ
3.10 45.1% <ø> (ø)
3.11 45.1% <ø> (ø)
3.12 45.1% <ø> (ø)
3.13 45.0% <ø> (ø)
3.14 45.0% <ø> (ø)
3.9 45.1% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

@jluebbe
Copy link
Copy Markdown
Member

jluebbe commented Jan 14, 2026

labgrid has a lot of dependencies, so I'm very skeptical if we should recommend using distro-packaged versions. Supporting all these version combinations seems almost impossible.

We could add a warning that you'd be expected to reproduce any issues via pipx or in a venv before opening issues.

@pamolloy
Copy link
Copy Markdown
Author

labgrid has a lot of dependencies, so I'm very skeptical if we should recommend using distro-packaged versions. Supporting all these version combinations seems almost impossible.

We could add a warning that you'd be expected to reproduce any issues via pipx or in a venv before opening issues.

Absolutely, and I'll add links for one to documentation explaining how to file bugs for the corresponding distro.

Comment thread doc/getting_started.rst
Labgrid is packaged for the following Linux distributions:

- [Debian Sid](https://packages.debian.org/sid/python3-labgrid)
- [Debian Forky](https://packages.debian.org/forky/python3-labgrid)
Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants