Skip to main content

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)

Source distribution for scietex.gpiod-service 1.2.0
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)

Table of built distributions (wheels) for scietex.gpiod-service 1.2.0
File Interpreter ABI Platform Actions
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 log

Release 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 log

Security 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.

Select from 2 files

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 log

A 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.

Release history Release notifications | RSS feed

This release

1.2.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page