📦 unit-suffix-remover (unsure)

Python CLI to stop, disable, and remove systemd .timer and .service units by suffix. 🔧🧹

🧭 How it works

flowchart TD
    A["unsure -s SUFFIX"] --> B["list *.service and *.timer in the unit dir"]
    B --> C{"name is PREFIX.SUFFIX with an optional @INSTANCE?"}
    C -- no --> B
    C -- yes --> D["collect the unit"]
    D --> E{"any unit collected?"}
    E -- no --> Y["No matching units found - exit 0"]
    E -- yes --> F{"--dry-run?"}
    F -- yes --> G["announce the removal, change nothing"]
    F -- no --> H["systemctl stop"]
    H --> I["systemctl disable"]
    I --> J["delete the unit file"]
    J --> K["systemctl daemon-reload"]
    G --> Z["exit 0"]
    K --> Z

🚀 Installation

pip install unit-suffix-remover

pip is the single supported installation path.

The package installs two identical commands: unsure (primary) and usure (kept for older documentation and scripts).

🔧 Requirements

• Python 3.10+ 🐍
• systemctl on PATH (systemd)

If systemctl is missing, the command exits with code 127 and a one‑line error instead of a traceback.

⚙️ Usage

unsure -s SUFFIX [--dry-run] [--unit-dir DIR]

• -s, --suffix: suffix of unit files to target (e.g. infinito for *.infinito.timer and *.infinito.service). Required.
• -d, --dry-run: show actions without executing them.
• --unit-dir: directory to scan. Defaults to /etc/systemd/system.

Only the exact suffix directly before @ or the extension matches:

For full options:

unsure --help

Exit codes

🧪 Development

make lint              # ruff check + ruff format --check
make format            # apply ruff format
make test              # unit + integration tests
make test-unit
make test-integration
make test-e2e          # install the package in a container and exercise the CLI

Tests run against the working tree — the Makefile puts src/ on PYTHONPATH, so no install is needed. --unit-dir lets the integration tests work on a temporary directory instead of /etc/systemd/system.

👤 Author

Developed by Kevin Veen‑Birkenbach 🌐 veen.world

📜 License

This project is licensed under the MIT License.