Metadata-Version: 2.1
Name: aiohttp-sse-client
Version: 0.2.0
Summary: A Server-Sent Event python client base on aiohttp
Home-page: https://github.com/rtfol/aiohttp-sse-client
Author: Jason Hu
Author-email: awaregit@gmail.com
License: Apache License 2.0
Keywords: aiohttp_sse_client
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
License-File: LICENSE
License-File: AUTHORS.rst

==========
SSE Client
==========


.. image:: https://img.shields.io/pypi/v/aiohttp_sse_client.svg
        :target: https://pypi.python.org/pypi/aiohttp_sse_client

.. image:: https://img.shields.io/travis/com/rtfol/aiohttp-sse-client.svg
        :target: https://travis-ci.com/rtfol/aiohttp-sse-client

.. image:: https://readthedocs.org/projects/aiohttp-sse-client/badge/?version=latest
        :target: https://aiohttp-sse-client.readthedocs.io/en/latest/?badge=latest
        :alt: Documentation Status

.. image:: https://pyup.io/repos/github/rtfol/aiohttp-sse-client/shield.svg
     :target: https://pyup.io/repos/github/rtfol/aiohttp-sse-client/
     :alt: Updates


A Server-Sent Event python client base on aiohttp, provides a simple interface to process `Server-Sent Event <https://www.w3.org/TR/eventsource>`_.

* Free software: Apache Software License 2.0
* Documentation: https://aiohttp-sse-client.readthedocs.io.


Features
--------

* Full asyncio support
* Easy to integrate with other aiohttp based project
* Auto-reconnect for network issue
* Support python 3.6 and above

Usage
--------
.. code-block:: python

    from aiohttp_sse_client import client as sse_client

    async with sse_client.EventSource(
        'https://stream.wikimedia.org/v2/stream/recentchange'
    ) as event_source:
        try:
            async for event in event_source:
                print(event)
        except ConnectionError:
            pass

Credits
-------

This project was inspired by `aiosseclient <https://github.com/ebraminio/aiosseclient>`_,
`sseclient <https://github.com/btubbs/sseclient>`_, and `sseclient-py <https://github.com/mpetazzoni/sseclient>`_.

This package was created with Cookiecutter_ and the `audreyr/cookiecutter-pypackage`_ project template.

.. _Cookiecutter: https://github.com/audreyr/cookiecutter
.. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage


=======
History
=======

0.2.0 (2020-10-20)
------------------

**Breaking Changes**

* Drop Python 3.5 support
* Add Python 3.8 support

**Non functional changes**

* Clarify the license (Apache Software License 2.0), thanks @fabaff
* Update dependency packages


0.1.7 (2020-03-30)
------------------

* Allow passing kwargs without specifying headers

0.1.6 (2019-08-06)
------------------

* Fix Unicode NULL handling in event id field

0.1.5 (2019-08-06)
------------------

* Fix last id reconnection (by @Ronserruya)

0.1.4 (2018-10-04)
------------------

* Switch to Apache Software License 2.0

0.1.3 (2018-10-03)
------------------

* Change the error handling, better fit the live specification.

0.1.2 (2018-10-03)
------------------

* Implement auto-reconnect feature.

0.1.1 (2018-10-02)
------------------

* First release on PyPI.
