systemd-client 0.1.0__tar.gz

systemd_client-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,32 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  id-token: write
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Install build tools
+        run: uv pip install --system build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

systemd_client-0.1.0/.github/workflows/tests.yml

@@ -0,0 +1,34 @@
+name: Tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Install dependencies
+        run: uv pip install --system -e ".[dev]"
+
+      - name: Lint
+        run: ruff check src/ tests/
+
+      - name: Tests
+        run: pytest tests/ -v --tb=short

systemd_client-0.1.0/.gitignore

@@ -0,0 +1,18 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+.eggs/
+*.egg
+.venv/
+venv/
+.pytest_cache/
+.ruff_cache/
+.pyright/
+htmlcov/
+.coverage
+*.so
+.claude/
+.agents/

systemd_client-0.1.0/LICENSE

@@ -0,0 +1,11 @@
+GNU LESSER GENERAL PUBLIC LICENSE
+Version 2.1, February 1999
+
+Copyright (C) 1991, 1999 Free Software Foundation, Inc.
+51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
+
+Everyone is permitted to copy and distribute verbatim copies
+of this license document, but changing it is not allowed.
+
+This is the GNU Lesser General Public License version 2.1.
+For the full license text, see: https://www.gnu.org/licenses/lgpl-2.1.html

systemd_client-0.1.0/PKG-INFO

@@ -0,0 +1,140 @@
+Metadata-Version: 2.4
+Name: systemd-client
+Version: 0.1.0
+Summary: High-level Python client for systemd user services: unit management, journal reading, sync + async
+Project-URL: Homepage, https://github.com/kalexnolasco/systemd-client
+Project-URL: Repository, https://github.com/kalexnolasco/systemd-client
+Project-URL: Issues, https://github.com/kalexnolasco/systemd-client/issues
+Author: kalexnolasco
+License-Expression: LGPL-2.1-or-later
+License-File: LICENSE
+Keywords: dbus,journalctl,linux,service,systemctl,systemd
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: GNU Lesser General Public License v2 or later (LGPLv2+)
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: System :: Systems Administration
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Provides-Extra: all
+Requires-Dist: dasbus>=1.7; extra == 'all'
+Requires-Dist: pydantic>=2.0; extra == 'all'
+Provides-Extra: dbus
+Requires-Dist: dasbus>=1.7; extra == 'dbus'
+Provides-Extra: dev
+Requires-Dist: coverage>=7.0; extra == 'dev'
+Requires-Dist: pyright>=1.1; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.8; extra == 'dev'
+Provides-Extra: pydantic
+Requires-Dist: pydantic>=2.0; extra == 'pydantic'
+Description-Content-Type: text/markdown
+
+# systemd-client — High-Level Python Client for systemd User Services
+
+<div align="center">
+
+![Module](https://img.shields.io/badge/Module-systemd--client-blue?style=for-the-badge)
+![Version](https://img.shields.io/badge/Version-0.1.0-green?style=for-the-badge)
+![Python](https://img.shields.io/badge/Python-3.11%20|%203.12%20|%203.13%20|%203.14-yellow?style=for-the-badge&logo=python)
+![License](https://img.shields.io/badge/License-LGPL--2.1-orange?style=for-the-badge)
+![systemd](https://img.shields.io/badge/systemd-user%20space-grey?style=for-the-badge&logo=linux&logoColor=white)
+
+**Unified async + sync Python API for systemd unit management and journal reading**
+
+**API unificada async + sync en Python para gestion de unidades systemd y lectura del journal**
+
+---
+
+### Choose Your Language / Elige tu idioma
+
+<p align="center">
+  <a href="README.en.md">
+    <img src="https://img.shields.io/badge/English-Documentation-blue?style=for-the-badge&logo=markdown" alt="English Documentation" height="50">
+  </a>
+  &nbsp;&nbsp;&nbsp;
+  <a href="README.es.md">
+    <img src="https://img.shields.io/badge/Espa%C3%B1ol-Documentaci%C3%B3n-red?style=for-the-badge&logo=markdown" alt="Spanish Documentation" height="50">
+  </a>
+</p>
+
+---
+
+### Architecture Overview
+
+```mermaid
+graph TD
+    subgraph APP["🐍 Your Application"]
+        SYNC["SystemdClient<br/>Synchronous API"]
+        ASYNC["AsyncSystemdClient<br/>Async API"]
+    end
+
+    subgraph BACKENDS["⚙️ Backends"]
+        SUB["🖥️ SubprocessBackend<br/>systemctl --user"]
+        DBUS["🔌 DBusBackend<br/>dasbus (optional)"]
+    end
+
+    subgraph JOURNAL["📋 Journal Reader"]
+        JR["AsyncJournalReader<br/>journalctl --user --output=json"]
+    end
+
+    subgraph SYSTEMD["🐧 systemd (user session)"]
+        UNITS[("🔧 User Units<br/>services, timers, sockets")]
+        JRNL[("📜 Journal<br/>log entries")]
+    end
+
+    SYNC --> ASYNC
+    ASYNC --> SUB
+    ASYNC --> DBUS
+    ASYNC --> JR
+    SUB --> UNITS
+    DBUS --> UNITS
+    JR --> JRNL
+
+    style APP fill:#d0ebff,stroke:#1971c2,stroke-width:2px
+    style BACKENDS fill:#b2f2bb,stroke:#2f9e44,stroke-width:2px
+    style JOURNAL fill:#f3d9fa,stroke:#9c36b5,stroke-width:2px
+    style SYSTEMD fill:#fff3bf,stroke:#f08c00,stroke-width:2px
+    style SYNC fill:#d0ebff,stroke:#1971c2,stroke-width:2px
+    style ASYNC fill:#d0ebff,stroke:#1971c2,stroke-width:2px
+    style SUB fill:#b2f2bb,stroke:#2f9e44,stroke-width:2px
+    style DBUS fill:#b2f2bb,stroke:#2f9e44,stroke-width:2px
+    style JR fill:#f3d9fa,stroke:#9c36b5,stroke-width:2px
+    style UNITS fill:#fff3bf,stroke:#f08c00
+    style JRNL fill:#fff3bf,stroke:#f08c00
+```
+
+### Quick Start
+
+```bash
+# Install
+pip install systemd-client
+
+# Install with DBus backend support
+pip install systemd-client[dbus]
+
+# Install with Pydantic models
+pip install systemd-client[all]
+```
+
+```python
+from systemd_client import SystemdClient
+
+client = SystemdClient()
+for unit in client.list_units(unit_type="service"):
+    print(f"{unit.name}: {unit.active_state}")
+```
+
+---
+
+**systemd-client** · [github.com/kalexnolasco/systemd-client](https://github.com/kalexnolasco/systemd-client)
+
+&copy; 2026 kalexnolasco
+
+</div>