Skip to content

cgroupspy 0.3.0

Latest

Choose a tag to compare

@rjcloudsigma rjcloudsigma released this 29 Oct 18:58
· 4 commits to master since this release
2ba3c1a

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 / V2Node APIs 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.