Metadata-Version: 2.1
Name: prometheus_async
Version: 18.2.0
Summary: Async helpers for prometheus_client.
Home-page: https://prometheus-async.readthedocs.io/
Author: Hynek Schlawack
Author-email: hs@ox.cx
Maintainer: Hynek Schlawack
Maintainer-email: hs@ox.cx
License: Apache License, Version 2.0
Description: ================
        prometheus_async
        ================
        
        .. image:: https://img.shields.io/pypi/v/prometheus_async.svg
           :target: https://pypi.org/project/prometheus_async/
           :alt: PyPI
        
        .. image:: https://readthedocs.org/projects/attrs/badge/?version=stable
           :target: http://attrs.readthedocs.io/en/stable/?badge=stable
           :alt: Documentation Status
        
        .. image:: https://travis-ci.org/hynek/prometheus_async.svg?branch=master
           :target: https://travis-ci.org/hynek/prometheus_async
           :alt: CI status
        
        .. image:: https://codecov.io/github/hynek/prometheus_async/branch/master/graph/badge.svg
           :target: https://codecov.io/github/hynek/prometheus_async
           :alt: Test Coverage
        
        .. image:: https://img.shields.io/badge/code%20style-black-000000.svg
           :target: https://github.com/ambv/black
           :alt: Code style: black
        
        .. teaser-begin
        
        ``prometheus_async`` adds support for asynchronous frameworks to the official `Python client`_ for the Prometheus_ metrics and monitoring system.
        
        Currently asyncio_ (Python 3.5+, PyPy3) and Twisted_ (Python 2.7, 3.5+, PyPy) are supported.
        
        
        It works by wrapping the metrics from the official client:
        
        .. code-block:: python
        
           import asyncio
        
           from aiohttp import web
           from prometheus_client import Histogram
           from prometheus_async.aio import time
        
           REQ_TIME = Histogram("req_time_seconds", "time spent in requests")
        
           @time(REQ_TIME)
           async def req(request):
               await asyncio.sleep(1)
               return web.Response(body=b"hello")
        
        
        Even for *synchronous* applications, the metrics exposure methods can be useful since they are more powerful than the one shipped with the official client.
        For that, helper functions have been added that run them in separate threads (asyncio-only for the time being).
        
        The source code is hosted on GitHub_ and the documentation on `Read The Docs`_.
        
        
        .. _asyncio: https://docs.python.org/3/library/asyncio.html
        .. _`Python client`: https://github.com/prometheus/client_python
        .. _Prometheus: https://prometheus.io/
        .. _Twisted: https://twistedmatrix.com/
        .. _GitHub: https://github.com/hynek/prometheus_async
        .. _`Read The Docs`: https://prometheus-async.readthedocs.io/
        
        
        Release Information
        ===================
        
        18.2.0 (2018-05-29)
        -------------------
        
        
        Backward-incompatible changes:
        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
        
        *none*
        
        
        Deprecations:
        ^^^^^^^^^^^^^
        
        - Passing a *loop* argument to ``prometheus_async.aio.start_http_server()`` is a no-op and raises a ``DeprecationWarning`` now.
        
        
        Changes:
        ^^^^^^^^
        
        - Port to ``aiohttp``'s application runner APIs to avoid those pesky deprecation warnings.
          As a consequence, the *loop* argument has been removed from internal APIs and became a no-op in public APIs.
        
        `Full changelog <https://prometheus-async.readthedocs.io/en/stable/changelog.html>`_.
        
        Credits
        =======
        
        ``prometheus_async`` is written and maintained by `Hynek Schlawack <https://hynek.me/>`_.
        
        The development is kindly supported by `Variomedia AG <https://www.variomedia.de/>`_.
        
        Other contributors can be found in `GitHub's overview <https://github.com/hynek/prometheus_async/graphs/contributors>`_.
        
Keywords: metrics,prometheus,twisted,asyncio
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=2.7, !=3.0, !=3.1, !=3.2, !=3.3, !=3.4
Provides-Extra: aiohttp
Provides-Extra: docs
Provides-Extra: dev
Provides-Extra: tests
Provides-Extra: consul
Provides-Extra: twisted
