Repository navigation
cgroupspy 0.3.0 adds native cgroup v2 support while retaining the existing cgroup v1 API and Python 2.7 / Python 3.6+ runtime contract.
New capabilities
- Explicit, read-only-by-default
V2Tree/V2NodeAPIs for CPU, memory, cpuset, pids and I/O, with native units and unlimited values. - Namespace-aware mount discovery, combined v1 controller views, current libvirt thread-layout support, read-only v1 views, snapshot refresh and exact grouped paths.
- Explicit delegated writers, independent command records, contextual partial-write errors, process/thread membership and lifecycle/pressure inspection.
- Safety and correctness fixes for device permissions, subgroup paths, tree lifecycle, throttle filenames, statistics parsing and inherited descriptors.
Compatibility and documentation
Existing v1 types, units, paths, constructor defaults and -1/None behavior are retained. Unsafe paths and malformed device/OOM commands are intentionally rejected. V2 values are explicit and are not silently substituted into legacy calculations.
Read the changelog, v2 API guide, and upgrade notes.
Verification
- 134 tests on each of Python 2.7 and Python 3.6–3.15.
- Actual Linux v2 CPU throttling, resource command round trips, effective CPU masks, freeze events, process batches and partial failures; v1 tasks/procs command tests in a temporary named hierarchy.
- Source and universal-wheel builds, strict metadata checks, source-archive tests, installed-wheel imports and legacy release-wheel installation.
- Runtime statement coverage: 92% in the local Python 3.14 run; CodeQL checks pass.
Turlo's private GitLab source and deployment remain unverified. Production adoption should include its own compatibility tests. GitHub distribution assets are available below; PyPI publication requires the project's publishing credentials and has not been performed.
Passing release-commit CI includes all configured interpreter, distribution and Linux integration jobs.
Install this release
python -m pip install "https://github.com/cloudsigma/cgroupspy/releases/download/v0.3.0/cgroupspy-0.3.0-py2.py3-none-any.whl"The source archive includes tests and documentation. SHA256SUMS covers both distribution files.