scietex.gpiod_service
scietex.gpiod_service is a scietex.service
worker that owns the host's GPIO lines through
libgpiod v2.
It requests the lines the API tells it to, keeps them requested, and exposes their values over Valkey. Configuration is delivered by the API and applied live — changing a line's direction or bias does not restart the worker.
Install
pip install scietex.gpiod_service
Requires Python 3.13+, Linux, and libgpiod v2 (gpiod~=2.5.0).
Run
start-gpiod-service --conf-dir /etc/scietex
| Flag | Environment | Default |
|---|---|---|
--conf-dir |
SCIETEX_CONFIG_DIR |
auto-resolved (see below) |
--service-name |
SCIETEX_SERVICE_NAME |
GPIODService |
--logging-level |
SCIETEX_LOGGING_LEVEL |
INFO |
On first run the service creates <conf-dir>/gpiod/gpiod.yml with defaults.
With no chips configured it logs waiting for remote configuration and keeps
running; the API then delivers the real configuration.
--service-name must match the managed service name registered in the API — it
is what discriminates the Valkey config key. Run exactly one worker per
installation.
Documentation
| Page | Contents |
|---|---|
| Overview | What the service does and how it fits together |
| Configuration | The gpio section schema, gpiod.yml, and the 0.1.x incompatibility |
| Operations | Service name, live re-apply vs restart, telemetry, container access |
Development
uv sync --all-extras
uv run tox # format, lint, type, py314
uv run tox -e py314 # tests only
See AGENTS.md for repo conventions.
License
MIT
Metadata
Release files for scietex.gpiod-service 1.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| scietex_gpiod_service-1.2.0.tar.gz | 29.1 kB | With provenance | Details for scietex_gpiod_service-1.2.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| scietex_gpiod_service-1.2.0-py3-none-any.whl | Python 3 | none | any | Details for scietex_gpiod_service-1.2.0-py3-none-any.whl |
Total release size: 50.9 kB
Release files / scietex_gpiod_service-1.2.0.tar.gz
| Download URL | scietex_gpiod_service-1.2.0.tar.gz |
|---|---|
| Size | 29.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
937c478f53fbc6f161ae9da469f65e6d4f8af9658a30ff047b782d5b5aab6d00
|
|
BLAKE2b-256 checksum How to use checksums |
ded98944c4004cda7828d3edf08836f7dc923c10cb42c96a1ff9abfd504f2bc7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 1, 2026.
Transparency logRelease files / scietex_gpiod_service-1.2.0-py3-none-any.whl
| Download URL | scietex_gpiod_service-1.2.0-py3-none-any.whl |
|---|---|
| Size | 21.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
9f0b532a5d54bc0702c27f92da085c1273a92eeddb96e9f2282562bc5ab9e535
|
|
BLAKE2b-256 checksum How to use checksums |
c17da62bc37adce23996e2c5d7ac670e1260e56fccc336084b734041247d8366
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 1, 2026.
Transparency logSecurity for scietex.gpiod-service 1.2.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for scietex_gpiod_service-1.2.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 1, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.