rrdtool-bindings

Python bindings from RRDtool, packaged to work with modern Python packaging tools.

Spiritual successor to python-rrdtool, which has not been updated since 2022 and the GitHub project was archived in 2023. It failed to install/compile via uv or pdm on recent Fedora releases, so this project was born.

Supported Python versions: 3.10+

Installation

This package compiles the bindings, so it requires the following dependencies:

• Debian/Ubuntu: apt-get install -y gcc librrd-dev python3-dev
• Fedora/Red Hat: dnf install -y gcc rrdtool-devel python3-devel

Then run:

pip install rrdtool-bindings

Usage

Example from the RRDtool documentation.

import rrdtool

# Create Round Robin Database
rrdtool.create('test.rrd', '--start', 'now', '--step', '300', 'RRA:AVERAGE:0.5:1:1200', 'DS:temp:GAUGE:600:-273:5000')

# Feed updates to the RRD
rrdtool.update('test.rrd', 'N:32')

See rrdpython and tests/test_bindings.py for more examples.

History

v0.5.0 - 2025-11-10

• Add support for Python 3.14.
• Drop support for end-of-life Python 3.9.
• Add Linux platform check prior to check for Debian 13.

v0.4.0 - 2025-09-15

• Fix for Debian 13 (Trixie).

v0.3.1 - 2025-04-07

• Update change history in README.

v0.3.0 - 2025-04-07

• Update supported Python versions.

v0.2.0 - 2024-05-31

Initial release.

Uses the C code from 5JAN24.

Contributing

Changes to the C code should be submitted upstream, then copied to this repository.

This project uses uv, so you will need that installed first. Then fork/clone the repository and run uv sync. Wheels can be compiled locally via uv build.

just is used as a task runner for convenience, but it is optional, any of the commands in Justfile can be ran by hand.