[](https://travis-ci.org/commx/python-rrdtool)
# python-rrdtool
Python bindings for [RRDtool](https://oss.oetiker.ch/rrdtool) for Python 2 and 3.
The bindings are based on the code of the original Python 2 bindings module for rrdtool by Hye-Shik Chang and are now shipped with the RRDtool distribution. This project is maintained separately to provide a more pythonic way to install those bindings via [PyPI](https://pypi.org).
## Features
* Native extension (written in C) for performance reasons.
* Uses library functions as exposed by librrd.
* Works with Python 2.7, 3.5 and later.
## Installation
The most convenient way to install (on POSIX-like systems) is to use pip:
pip install rrdtool
**Note:** Unless binary versions are available for your target system, the command above requires rrdtool development files (headers, libraries, dependencies) to be installed, otherwise building the module will fail.
In case you'd like to build the module on your own (regardless of whether binary versions are available for your system), you can obtain a copy of the source code and run `python setup.py install` in its destination folder to build the module.
## Usage
```python
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')
```
## Documentation
You can find the latest documentation for this project at https://pythonhosted.org/rrdtool.
## License
[GNU Lesser General Public License version 2.1](https://opensource.org/licenses/LGPL-2.1).
Raw data
{
"_id": null,
"home_page": "https://github.com/commx/python-rrdtool",
"name": "rrdtool",
"maintainer": "",
"docs_url": "https://pythonhosted.org/rrdtool/",
"requires_python": ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*, <4",
"maintainer_email": "",
"keywords": "rrdtool",
"author": "Christian Kroeger",
"author_email": "commx@commx.ws",
"download_url": "https://files.pythonhosted.org/packages/b4/33/eab59a6f9b8fcc7f3edd4cde467abad49c3683dfa628dd7abd62763647ef/rrdtool-0.1.16.tar.gz",
"platform": null,
"description": "[](https://travis-ci.org/commx/python-rrdtool)\n\n# python-rrdtool\n\nPython bindings for [RRDtool](https://oss.oetiker.ch/rrdtool) for Python 2 and 3.\n\nThe bindings are based on the code of the original Python 2 bindings module for rrdtool by Hye-Shik Chang and are now shipped with the RRDtool distribution. This project is maintained separately to provide a more pythonic way to install those bindings via [PyPI](https://pypi.org).\n\n## Features\n\n* Native extension (written in C) for performance reasons.\n* Uses library functions as exposed by librrd.\n* Works with Python 2.7, 3.5 and later.\n\n\n## Installation\n\nThe most convenient way to install (on POSIX-like systems) is to use pip:\n\n pip install rrdtool\n\n**Note:** Unless binary versions are available for your target system, the command above requires rrdtool development files (headers, libraries, dependencies) to be installed, otherwise building the module will fail.\n\nIn case you'd like to build the module on your own (regardless of whether binary versions are available for your system), you can obtain a copy of the source code and run `python setup.py install` in its destination folder to build the module.\n\n## Usage\n\n```python\nimport rrdtool\n\n# Create Round Robin Database\nrrdtool.create('test.rrd', '--start', 'now', '--step', '300', 'RRA:AVERAGE:0.5:1:1200', 'DS:temp:GAUGE:600:-273:5000')\n\n# Feed updates to the RRD\nrrdtool.update('test.rrd', 'N:32')\n```\n\n## Documentation\n\nYou can find the latest documentation for this project at https://pythonhosted.org/rrdtool.\n\n## License\n\n[GNU Lesser General Public License version 2.1](https://opensource.org/licenses/LGPL-2.1).\n\n\n",
"bugtrack_url": null,
"license": "",
"summary": "Python bindings for rrdtool",
"version": "0.1.16",
"project_urls": {
"Homepage": "https://github.com/commx/python-rrdtool"
},
"split_keywords": [
"rrdtool"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "b433eab59a6f9b8fcc7f3edd4cde467abad49c3683dfa628dd7abd62763647ef",
"md5": "bd54fbfbceec475cb00029f962f73b5c",
"sha256": "5f0aff8b3e0a0f701652fa88bf605a54be9e6b25fba52a13b67c71f7b35a1451"
},
"downloads": -1,
"filename": "rrdtool-0.1.16.tar.gz",
"has_sig": false,
"md5_digest": "bd54fbfbceec475cb00029f962f73b5c",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*, <4",
"size": 22088,
"upload_time": "2022-07-20T11:06:16",
"upload_time_iso_8601": "2022-07-20T11:06:16.981612Z",
"url": "https://files.pythonhosted.org/packages/b4/33/eab59a6f9b8fcc7f3edd4cde467abad49c3683dfa628dd7abd62763647ef/rrdtool-0.1.16.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2022-07-20 11:06:16",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "commx",
"github_project": "python-rrdtool",
"travis_ci": true,
"coveralls": false,
"github_actions": false,
"lcname": "rrdtool"
}
JSON
