https://github.com/gusutabopb/aioinflux

Asynchronous Python client for InfluxDB
https://github.com/gusutabopb/aioinflux

aiohttp asyncio databases influxdb

Last synced: about 2 months ago
JSON representation

Asynchronous Python client for InfluxDB

• Host: GitHub
• URL: https://github.com/gusutabopb/aioinflux
• Owner: gusutabopb
• License: mit
• Archived: true
• Created: 2017-06-06T04:19:14.000Z (about 7 years ago)
• Default Branch: master
• Last Pushed: 2023-08-05T06:01:48.000Z (11 months ago)
• Last Synced: 2024-04-30T21:38:31.833Z (about 2 months ago)
• Topics: aiohttp, asyncio, databases, influxdb
• Language: Python
• Size: 344 KB
• Stars: 159
• Watchers: 12
• Forks: 31
• Open Issues: 12
• Metadata Files:
  • Readme: README.rst
  • Changelog: CHANGELOG.md
  • License: LICENSE

Lists

• awesome-asyncio - aioinflux - InfluxDB client built on top of aiohttp. (Database Drivers)
• awesome-stars - gusutabopb/aioinflux - Asynchronous Python client for InfluxDB (Python)

README

        
aioinflux

=========

.. image:: https://img.shields.io/circleci/project/github/gusutabopb/aioinflux/master.svg

   :target: https://circleci.com/gh/gusutabopb/aioinflux

   :alt: CI status

.. image:: https://img.shields.io/codecov/c/github/gusutabopb/aioinflux.svg

   :target: https://codecov.io/gh/gusutabopb/aioinflux

   :alt: Coverage

.. image:: https://img.shields.io/pypi/v/aioinflux.svg

   :target: https://pypi.python.org/pypi/aioinflux

   :alt: PyPI package

.. image:: https://img.shields.io/pypi/pyversions/aioinflux.svg

   :target: https://pypi.python.org/pypi/aioinflux

   :alt: Supported Python versions

.. image:: https://readthedocs.org/projects/aioinflux/badge/?version=stable

   :target: https://aioinflux.readthedocs.io/en/stable/?badge=stable

   :alt: Documentation status

| **🚨This project is archived and unmantained.🚨**

| **For InfluxDB v2+ support, please use the official Python client library.**

|

Asynchronous Python client for `InfluxDB`_. Built on top of

`aiohttp`_ and `asyncio`_.

Aioinflux is an alternative to the official InfluxDB Python client.

Aioinflux supports interacting with InfluxDB in a non-blocking way by using `aiohttp`_.

It also supports writing and querying of `Pandas`_ dataframes,

among other handy functionality.

.. _Pandas: http://pandas.pydata.org/

.. _InfluxDB: http://influxdata.com/

.. _asyncio: https://docs.python.org/3/library/asyncio.html

.. _aiohttp: https://github.com/aio-libs/aiohttp

Please refer to the `documentation`_ for more details.

Installation

------------

Python 3.6+ is required.

You also need to have access to a running instance of InfluxDB.

.. code:: bash

   pip install aioinflux

Quick start

-----------

This sums most of what you can do with ``aioinflux``:

.. code:: python

    import asyncio

    from aioinflux import InfluxDBClient

    point = {

        'time': '2009-11-10T23:00:00Z',

        'measurement': 'cpu_load_short',

        'tags': {'host': 'server01',

                 'region': 'us-west'},

        'fields': {'value': 0.64}

    }

    async def main():

        async with InfluxDBClient(db='testdb') as client:

           await client.create_database(db='testdb')

           await client.write(point)

           resp = await client.query('SELECT value FROM cpu_load_short')

           print(resp)

    asyncio.get_event_loop().run_until_complete(main())

See the `documentation`_ for more detailed usage.

.. _documentation: http://aioinflux.readthedocs.io/en/stable/