The v1 client libraries for InfluxDB were typically developed and maintained by
community members. For InfluxDB 3.0 users, this library is succeeded by the
lightweight `v3 client library <https://github.com/InfluxCommunity/influxdb3-python>`_.
For InfluxDB 2.0 users, look at the `v2 client library
<https://github.com/influxdata/influxdb-client-python>`_.
If there are still users of this v1 client library, and they or somebody else
are willing to keep them updated with security fixes at a minimum please reach
out on the `Community Forums <https://community.influxdata.com/>`_ or
`InfluxData Slack <https://influxdata.com/slack>`_.
InfluxDB-Python
===============
.. image:: https://travis-ci.org/influxdata/influxdb-python.svg?branch=master
:target: https://travis-ci.org/influxdata/influxdb-python
.. image:: https://readthedocs.org/projects/influxdb-python/badge/?version=latest&style
:target: http://influxdb-python.readthedocs.org/
:alt: Documentation Status
.. image:: https://img.shields.io/coveralls/influxdata/influxdb-python.svg
:target: https://coveralls.io/r/influxdata/influxdb-python
:alt: Coverage
.. image:: https://img.shields.io/pypi/v/influxdb.svg
:target: https://pypi.python.org/pypi/influxdb
:alt: PyPI Status
InfluxDB-Python is a client for interacting with InfluxDB_.
**Note: This library is for use with InfluxDB 1.x. For connecting to InfluxDB 2.x instances, please use the the** `influxdb-client-python <https://github.com/influxdata/influxdb-client-python>`_ **client.**
Development of this library is maintained by:
+-----------+-------------------------------+
| Github ID | URL |
+===========+===============================+
| @aviau | (https://github.com/aviau) |
+-----------+-------------------------------+
| @xginn8 | (https://github.com/xginn8) |
+-----------+-------------------------------+
| @sebito91 | (https://github.com/sebito91) |
+-----------+-------------------------------+
.. _readme-about:
InfluxDB is an open-source distributed time series database, find more about InfluxDB_ at https://docs.influxdata.com/influxdb/latest
.. _installation:
InfluxDB pre v1.1.0 users
-------------------------
This module is tested with InfluxDB versions: v1.2.4, v1.3.9, v1.4.3, v1.5.4, v1.6.4, and 1.7.4.
Those users still on InfluxDB v0.8.x users may still use the legacy client by importing ``from influxdb.influxdb08 import InfluxDBClient``.
Installation
------------
Install, upgrade and uninstall influxdb-python with these commands::
$ pip install influxdb
$ pip install --upgrade influxdb
$ pip uninstall influxdb
On Debian/Ubuntu, you can install it with this command::
$ sudo apt-get install python-influxdb
Dependencies
------------
The influxdb-python distribution is supported and tested on Python 2.7, 3.5, 3.6, 3.7, PyPy and PyPy3.
**Note:** Python <3.5 are currently untested. See ``.travis.yml``.
Main dependency is:
- Requests: HTTP library for human beings (http://docs.python-requests.org/)
Additional dependencies are:
- pandas: for writing from and reading to DataFrames (http://pandas.pydata.org/)
- Sphinx: Tool to create and manage the documentation (http://sphinx-doc.org/)
- Nose: to auto-discover tests (http://nose.readthedocs.org/en/latest/)
- Mock: to mock tests (https://pypi.python.org/pypi/mock)
Documentation
-------------
Documentation is available at https://influxdb-python.readthedocs.io/en/latest/.
You will need Sphinx_ installed to generate the documentation.
The documentation can be generated by running::
$ tox -e docs
Generated documentation can be found in the *docs/build/html/* directory.
Examples
--------
Here's a basic example (for more see the examples directory)::
$ python
>>> from influxdb import InfluxDBClient
>>> json_body = [
{
"measurement": "cpu_load_short",
"tags": {
"host": "server01",
"region": "us-west"
},
"time": "2009-11-10T23:00:00Z",
"fields": {
"value": 0.64
}
}
]
>>> client = InfluxDBClient('localhost', 8086, 'root', 'root', 'example')
>>> client.create_database('example')
>>> client.write_points(json_body)
>>> result = client.query('select value from cpu_load_short;')
>>> print("Result: {0}".format(result))
Testing
-------
Make sure you have tox by running the following::
$ pip install tox
To test influxdb-python with multiple version of Python, you can use Tox_::
$ tox
Support
-------
For issues with, questions about, or feedback for InfluxDB_, please look into
our community page: http://influxdb.com/community/.
We are also lurking on the following:
- #influxdb on irc.freenode.net
- #influxdb on gophers.slack.com
Development
-----------
All development is done on Github_. Use Issues_ to report
problems or submit contributions.
.. _Github: https://github.com/influxdb/influxdb-python/
.. _Issues: https://github.com/influxdb/influxdb-python/issues
Please note that we WILL get to your questions/issues/concerns as quickly as possible. We maintain many
software repositories and sometimes things may get pushed to the backburner. Please don't take offense,
we will do our best to reply as soon as possible!
Source code
-----------
The source code is currently available on Github: https://github.com/influxdata/influxdb-python
TODO
----
The TODO/Roadmap can be found in Github bug tracker: https://github.com/influxdata/influxdb-python/issues
.. _InfluxDB: https://influxdata.com/time-series-platform/influxdb/
.. _Sphinx: http://sphinx.pocoo.org/
.. _Tox: https://tox.readthedocs.org
Raw data
{
"_id": null,
"home_page": "https://github.com/influxdb/influxdb-python",
"name": "influxdb",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": null,
"author": null,
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/12/d4/4c1bd3a8f85403fad3137a7e44f7882b0366586b7c27d12713493516f1c7/influxdb-5.3.2.tar.gz",
"platform": null,
"description": "The v1 client libraries for InfluxDB were typically developed and maintained by\ncommunity members. For InfluxDB 3.0 users, this library is succeeded by the\nlightweight `v3 client library <https://github.com/InfluxCommunity/influxdb3-python>`_.\nFor InfluxDB 2.0 users, look at the `v2 client library\n<https://github.com/influxdata/influxdb-client-python>`_.\n\nIf there are still users of this v1 client library, and they or somebody else\nare willing to keep them updated with security fixes at a minimum please reach\nout on the `Community Forums <https://community.influxdata.com/>`_ or\n`InfluxData Slack <https://influxdata.com/slack>`_.\n\nInfluxDB-Python\n===============\n\n.. image:: https://travis-ci.org/influxdata/influxdb-python.svg?branch=master\n :target: https://travis-ci.org/influxdata/influxdb-python\n.. image:: https://readthedocs.org/projects/influxdb-python/badge/?version=latest&style\n :target: http://influxdb-python.readthedocs.org/\n :alt: Documentation Status\n\n.. image:: https://img.shields.io/coveralls/influxdata/influxdb-python.svg\n :target: https://coveralls.io/r/influxdata/influxdb-python\n :alt: Coverage\n\n.. image:: https://img.shields.io/pypi/v/influxdb.svg\n :target: https://pypi.python.org/pypi/influxdb\n :alt: PyPI Status\n\nInfluxDB-Python is a client for interacting with InfluxDB_.\n\n**Note: This library is for use with InfluxDB 1.x. For connecting to InfluxDB 2.x instances, please use the the** `influxdb-client-python <https://github.com/influxdata/influxdb-client-python>`_ **client.**\n\nDevelopment of this library is maintained by:\n\n+-----------+-------------------------------+\n| Github ID | URL |\n+===========+===============================+\n| @aviau | (https://github.com/aviau) |\n+-----------+-------------------------------+\n| @xginn8 | (https://github.com/xginn8) |\n+-----------+-------------------------------+\n| @sebito91 | (https://github.com/sebito91) |\n+-----------+-------------------------------+\n\n.. _readme-about:\n\nInfluxDB is an open-source distributed time series database, find more about InfluxDB_ at https://docs.influxdata.com/influxdb/latest\n\n\n.. _installation:\n\nInfluxDB pre v1.1.0 users\n-------------------------\n\nThis module is tested with InfluxDB versions: v1.2.4, v1.3.9, v1.4.3, v1.5.4, v1.6.4, and 1.7.4.\n\nThose users still on InfluxDB v0.8.x users may still use the legacy client by importing ``from influxdb.influxdb08 import InfluxDBClient``.\n\nInstallation\n------------\n\nInstall, upgrade and uninstall influxdb-python with these commands::\n\n $ pip install influxdb\n $ pip install --upgrade influxdb\n $ pip uninstall influxdb\n\nOn Debian/Ubuntu, you can install it with this command::\n\n $ sudo apt-get install python-influxdb\n\nDependencies\n------------\n\nThe influxdb-python distribution is supported and tested on Python 2.7, 3.5, 3.6, 3.7, PyPy and PyPy3.\n\n**Note:** Python <3.5 are currently untested. See ``.travis.yml``.\n\nMain dependency is:\n\n- Requests: HTTP library for human beings (http://docs.python-requests.org/)\n\n\nAdditional dependencies are:\n\n- pandas: for writing from and reading to DataFrames (http://pandas.pydata.org/)\n- Sphinx: Tool to create and manage the documentation (http://sphinx-doc.org/)\n- Nose: to auto-discover tests (http://nose.readthedocs.org/en/latest/)\n- Mock: to mock tests (https://pypi.python.org/pypi/mock)\n\n\nDocumentation\n-------------\n\nDocumentation is available at https://influxdb-python.readthedocs.io/en/latest/.\n\nYou will need Sphinx_ installed to generate the documentation.\n\nThe documentation can be generated by running::\n\n $ tox -e docs\n\n\nGenerated documentation can be found in the *docs/build/html/* directory.\n\n\nExamples\n--------\n\nHere's a basic example (for more see the examples directory)::\n\n $ python\n\n >>> from influxdb import InfluxDBClient\n\n >>> json_body = [\n {\n \"measurement\": \"cpu_load_short\",\n \"tags\": {\n \"host\": \"server01\",\n \"region\": \"us-west\"\n },\n \"time\": \"2009-11-10T23:00:00Z\",\n \"fields\": {\n \"value\": 0.64\n }\n }\n ]\n\n >>> client = InfluxDBClient('localhost', 8086, 'root', 'root', 'example')\n\n >>> client.create_database('example')\n\n >>> client.write_points(json_body)\n\n >>> result = client.query('select value from cpu_load_short;')\n\n >>> print(\"Result: {0}\".format(result))\n\n\nTesting\n-------\n\nMake sure you have tox by running the following::\n\n $ pip install tox\n\nTo test influxdb-python with multiple version of Python, you can use Tox_::\n\n $ tox\n\n\nSupport\n-------\n\nFor issues with, questions about, or feedback for InfluxDB_, please look into\nour community page: http://influxdb.com/community/.\n\nWe are also lurking on the following:\n\n- #influxdb on irc.freenode.net\n- #influxdb on gophers.slack.com\n\n\nDevelopment\n-----------\n\nAll development is done on Github_. Use Issues_ to report\nproblems or submit contributions.\n\n.. _Github: https://github.com/influxdb/influxdb-python/\n.. _Issues: https://github.com/influxdb/influxdb-python/issues\n\nPlease note that we WILL get to your questions/issues/concerns as quickly as possible. We maintain many\nsoftware repositories and sometimes things may get pushed to the backburner. Please don't take offense,\nwe will do our best to reply as soon as possible!\n\n\nSource code\n-----------\n\nThe source code is currently available on Github: https://github.com/influxdata/influxdb-python\n\n\nTODO\n----\n\nThe TODO/Roadmap can be found in Github bug tracker: https://github.com/influxdata/influxdb-python/issues\n\n\n.. _InfluxDB: https://influxdata.com/time-series-platform/influxdb/\n.. _Sphinx: http://sphinx.pocoo.org/\n.. _Tox: https://tox.readthedocs.org\n",
"bugtrack_url": null,
"license": "MIT License",
"summary": "InfluxDB client",
"version": "5.3.2",
"project_urls": {
"Homepage": "https://github.com/influxdb/influxdb-python"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "0e00d0ea35f823c46a5cd4fa80d933176d251573601d920737ce8a85df7664db",
"md5": "07ea2ab5f03ccd942ca20fd60dd9530a",
"sha256": "00d86b18a968d011b2eee39ec3b2ae941b1dcf7086bc7211e675914623caffcd"
},
"downloads": -1,
"filename": "influxdb-5.3.2-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "07ea2ab5f03ccd942ca20fd60dd9530a",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": null,
"size": 79391,
"upload_time": "2024-04-18T21:45:06",
"upload_time_iso_8601": "2024-04-18T21:45:06.471633Z",
"url": "https://files.pythonhosted.org/packages/0e/00/d0ea35f823c46a5cd4fa80d933176d251573601d920737ce8a85df7664db/influxdb-5.3.2-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "12d44c1bd3a8f85403fad3137a7e44f7882b0366586b7c27d12713493516f1c7",
"md5": "6e1b7c63785720c72b901e2a8c1aca96",
"sha256": "58c647f6043712dd86e9aee12eb4ccfbbb5415467bc9910a48aa8c74c1108970"
},
"downloads": -1,
"filename": "influxdb-5.3.2.tar.gz",
"has_sig": false,
"md5_digest": "6e1b7c63785720c72b901e2a8c1aca96",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 70792,
"upload_time": "2024-04-18T21:45:09",
"upload_time_iso_8601": "2024-04-18T21:45:09.163106Z",
"url": "https://files.pythonhosted.org/packages/12/d4/4c1bd3a8f85403fad3137a7e44f7882b0366586b7c27d12713493516f1c7/influxdb-5.3.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-18 21:45:09",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "influxdb",
"github_project": "influxdb-python",
"travis_ci": true,
"coveralls": false,
"github_actions": false,
"requirements": [],
"tox": true,
"lcname": "influxdb"
}
JSON
