lr-dmx-tester 0.0.3

RPC client helpers for DMX tester firmware

dmx-tester-rpc

Python package for communicating with DMX tester firmware over the RPC serial interface.

Install for development

python -m venv .venv
source .venv/bin/activate
python -m pip install -e .[dev]

Run the CLI

After installation, the package exposes a dmx_tester command:

source .venv/bin/activate
dmx_tester --help
dmx_tester /dev/ttyACM1 latency --n-reports 3
dmx_tester 1050266122 send --data-val 0x12 --data-len 24

Build distributables

source .venv/bin/activate
python -m build

Upload to PyPI

source .venv/bin/activate
python -m twine upload dist/*

GitLab tag release

GitLab CI publishes this package automatically when a tag matches:

python-v<MAJOR>.<MINOR>.<PATCH>

Example:

git tag python-v1.2.3
git push origin python-v1.2.3

For tag builds, CI sets the package version to the tag value without the python-v prefix (for example, python-v1.2.3 -> 1.2.3) and uploads to pypi.org.

Publishing uses PyPI Trusted Publisher (OIDC) from GitLab CI/CD, so no long-lived PyPI token is stored in CI variables.

Configure Trusted Publisher once in PyPI for this project:

• Go to the project on pypi.org and open Publishing.
• Add a GitLab CI/CD trusted publisher for this repository/tag workflow.
• Ensure the project is owned/managed by the bofh69 PyPI account.

The CI pipeline runs a Trusted Publisher preflight job before the actual publish step, so tag pipelines fail early with a clear configuration error if OIDC trust is not set up correctly.

PyPI does not allow re-uploading the same package name/version files. If a publish already happened for a version, create and push a new python-v... tag.

Run with PyPy

pypy3 -m venv .venv-pypy
source .venv-pypy/bin/activate
python -m pip install -e .
python -c "from dmx_tester import RpcClient, DmxCommands; print('ok')"

License

This package is licensed under the MIT License. See the LICENSE file.