decman/DEVELOPMENT.md

Commands used in development

Before committing ensure all tests pass and format files.

Running

Run decman as root to test all changes:

sudo uv run --all-packages decman

Python shell

Running a python shell with all the packages.

sudo uv run --all-packages python
sudo uv run --exact --package decman python

Testing

Run all unit tests (-s disables output capturing, needed for PTY test):

uv run --package decman pytest -s tests/
uv run --package decman-pacman pytest plugins/decman-pacman/tests/
uv run --package decman-systemd pytest plugins/decman-systemd/tests/
uv run --package decman-flatpak pytest plugins/decman-flatpak/tests/

Formatting

Format all files:

uv run ruff format

Linting

Run lints:

uv run ruff check

Apply fixes:

uv run ruff check --fix

Installing the example plugin

uv pip install -e example/plugin/

Uninstalling:

uv pip uninstall decman-plugin-example

Making the plugin available/unavailable:

touch /tmp/example_plugin_available
rm /tmp/example_plugin_available