========== 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.1 (2021-02-27)

• Allow sending request with different HTTP methods (by @paulefoe)
• Migrate to GitHub Actions

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.