Skip to content

Changelog

v0.9.2

Hotfix release with TUI improvements and bug fixes.

TUI Improvements

  • Mouse support: click to select units, scroll wheel to navigate, click on tabs
  • Professional layout: 3 tabs (Dashboard, Timers, Help), actions panel, health gauge
  • Type filters: F1=All, F2=Services, F3=Timers, F4=Sockets, F5=Failed
  • Search: press / to filter units by name
  • Journal panel: integrated at bottom of dashboard with auto-refresh every 2s
  • Full message display: journal entries show complete text with word wrap

Bug Fixes

  • Unit name decoding: systemd \xNN hex escaping now decoded to readable names (e.g., app-git\x2dannex → app-git-annex)
  • loginctl parsing: use --no-legend text output instead of --output=json (not supported on all systemd versions)
  • Mouse tracking: enable ANSI mouse escape sequences on TUI start
  • Gauge colors: fixed white background on health gauge
  • Table highlight: manual row highlighting with cyan background (DrawCmd.table limitation)

Documentation

  • 7 new guide pages (builders, transient, resources, analyze, notify, sessions, TUI)
  • 3 new API reference pages (builders, analyze, notify)
  • 7 new example scripts (16-22)
  • CONTRIBUTING.md with dev setup and architecture
  • Status bumped to Beta

v0.9.1

Complete documentation overhaul with 13 guide pages, 9 API references, 22 examples, CONTRIBUTING.md, Beta status.

v0.9.0

Interactive TUI powered by Ratatui (Rust rendering engine).

  • systemd-client tui — launch interactive dashboard
  • Real-time unit list with color-coded states
  • Keyboard-driven operations (start/stop/restart/enable/disable)
  • Journal viewer per unit
  • Scope toggle (user/system)
  • Auto-refresh every 2 seconds
  • Optional dependency: pip install systemd-client[tui]

v0.8.0

Environment + Session Management — complete systemd control.

  • show_environment() / set_environment() / unset_environment()
  • list_sessions() / list_users() / terminate_session() / lock_session()
  • New models: SessionInfo, UserInfo
  • CLI: show-environment, set-environment, unset-environment, list-sessions, list-users

v0.7.0

sd_notify + Power Management

  • SystemdNotifier: pure Python sd_notify implementation (READY, STATUS, WATCHDOG, etc.)
  • poweroff(), reboot(), suspend(), hibernate()
  • CLI: poweroff, reboot, suspend, hibernate

v0.6.0

systemd-analyze — boot analysis and security scoring.

  • analyze_blame() / analyze_security() / analyze_verify() / analyze_critical_chain()
  • New models: BlameEntry, SecurityAnalysis, SecurityIssue
  • CLI: analyze-blame, analyze-security, analyze-verify

v0.5.0

Resource Control + Monitoring

  • set_property() / get_resource_usage() / list_timers() / list_sockets()
  • list_dependencies() / kill()
  • New models: ResourceUsage, TimerInfo, SocketInfo
  • CLI: resources, list-timers, list-sockets, list-dependencies, kill

v0.4.0

Transient Units — systemd-run from Python.

  • run() / run_on_calendar() for one-off and scheduled commands
  • New model: TransientResult
  • CLI: run CMD [--wait][--on-calendar] [--property K=V]

v0.3.0

Unit File Builder — Create systemd unit files programmatically from Python.

New Features

  • ServiceBuilder — Fluent builder for .service unit files with full directive support
  • TimerBuilder — Builder for .timer units (OnCalendar, OnBootSec, Persistent)
  • SocketBuilder — Builder for .socket units (ListenStream, ListenDatagram, Accept)
  • PathBuilder — Builder for .path units (PathChanged, PathModified, DirectoryNotEmpty)
  • client.install(unit_file) — Write unit files to the correct directory based on scope
  • client.uninstall(unit_name) — Remove installed unit files and drop-in directories
  • client.edit(unit_name, overrides) — Create drop-in override files
  • UnitFile model — Frozen dataclass for generated unit files (name, content, unit_type)
  • ServiceType enum — simple, forking, oneshot, notify, exec, dbus, idle
  • RestartPolicy enum — no, on-success, on-failure, on-abnormal, on-watchdog, on-abort, always
  • Template support — Create template units with @ syntax (ServiceBuilder("app", template=True))
  • Validation — Builders validate required fields before building (ExecStart, time triggers, etc.)

CLI

  • create-service — Generate .service files from flags, optionally install
  • create-timer — Generate .timer files from flags, optionally install
  • install UNIT --from-file PATH — Install a unit file from disk
  • uninstall UNIT — Remove an installed unit file

New Exceptions

  • UnitFileValidationError — Raised when builder validation fails
  • UnitFileInstallError — Raised when install/uninstall operations fail

Stats

  • 199 tests (up from 149), all passing
  • Zero new dependencies

v0.2.0

Major feature release: system scope, new operations, context managers, and bug fixes.

New Features

  • System scope support: SystemdScope.USER / SystemdScope.SYSTEM parameter on clients, journal, and CLI (--scope system)
  • Context manager protocol: async with AsyncSystemdClient() and with SystemdClient() for proper resource cleanup
  • list_unit_files(): List all installed unit files (including disabled/masked), equivalent to systemctl list-unit-files
  • cat(): Show unit file content, equivalent to systemctl cat
  • reset_failed(): Reset failed state for a unit or all units
  • try_restart(): Restart only if the unit is currently active
  • reload_or_restart(): Reload if supported, otherwise restart
  • Batch operations: start_units(), stop_units(), restart_units() for operating on multiple units at once
  • --no-block mode: Fire-and-forget operations that return immediately without waiting
  • UnitFileInfo model: New frozen dataclass for unit file information (name, state, preset)
  • __repr__ on clients: Shows backend and scope for easier debugging
  • Coverage in CI: Test coverage reporting with 80% minimum threshold

Bug Fixes

  • Fix _safe_int for exit codes: ExecMainStatus=0 (success) was incorrectly returned as None. PID=0 remains None.
  • DBus backend timestamps: get_unit_status() now reads ActiveEnterTimestamp, ActiveExitTimestamp, InactiveEnterTimestamp, InactiveExitTimestamp
  • DBus backend exec_main_status: Now correctly reads and returns the exit code

CLI

  • New --scope user|system global flag
  • New subcommands: list-unit-files, cat, reset-failed
  • New operations: try-restart, reload-or-restart
  • --no-block flag for start/stop/restart/reload operations
  • Batch support: pass multiple unit names to start/stop/restart (e.g., systemd-client start a.service b.service)

Breaking Changes

  • Backend constructors now accept scope parameter
  • JournalQuery has a new scope field
  • Minimum version bumped to 0.2.0

Internal

  • Generic run_sync() with proper TypeVar typing
  • AbstractBackend.close() method for resource cleanup
  • 149 unit tests (up from 89)

v0.1.2

  • Add MkDocs documentation site with Material theme
  • Fix Key Features rendering on docs homepage
  • Add Documentation URL to PyPI metadata

v0.1.1

  • Fix README rendering on PyPI (replace Mermaid with ASCII diagram, add dynamic badges)
  • Lint fixes (ruff autofix)

v0.1.0

Initial release.

  • SystemdClient and AsyncSystemdClient with full unit management API
  • Subprocess backend (default, zero dependencies)
  • D-Bus backend via dasbus (optional)
  • Journal reader with query filters and real-time follow
  • Frozen dataclass models: UnitInfo, UnitStatus, JournalEntry, EnableResult
  • StrEnum types: ActiveState, LoadState, UnitFileState, SubState, UnitType, JournalPriority, BackendType
  • Exception hierarchy with SystemdClientError base
  • CLI with table and JSON output
  • Optional Pydantic model variants
  • PEP 561 typed package
  • 89 unit tests
  • 15 copy-paste examples