Github url

aiohttp

by aio-libs

aio-libs /aiohttp

Asynchronous HTTP client/server framework for asyncio and Python

9.9K Stars 1.4K Forks Last release: 9 months ago (v3.6.2) Apache License 2.0 6.9K Commits 213 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

==================================

Async http client/server framework

.. image:: https://raw.githubusercontent.com/aio-libs/aiohttp/master/docs/\_static/aiohttp-icon-128x128.png :height: 64px :width: 64px :alt: aiohttp logo

|

.. image:: https://dev.azure.com/aio-libs/aiohttp/_apis/build/status/CI?branchName=master :target: https://dev.azure.com/aio-libs/aiohttp/_build :align: right :alt: Azure Pipelines status for master branch

.. image:: https://codecov.io/gh/aio-libs/aiohttp/branch/master/graph/badge.svg :target: https://codecov.io/gh/aio-libs/aiohttp :alt: codecov.io status for master branch

.. image:: https://badge.fury.io/py/aiohttp.svg :target: https://pypi.org/project/aiohttp :alt: Latest PyPI package version

.. image:: https://readthedocs.org/projects/aiohttp/badge/?version=latest :target: https://docs.aiohttp.org/ :alt: Latest Read The Docs

.. image:: https://img.shields.io/discourse/status?server=https%3A%2F%2Faio-libs.discourse.group :target: https://aio-libs.discourse.group :alt: Discourse status

.. image:: https://badges.gitter.im/Join%20Chat.svg :target: https://gitter.im/aio-libs/Lobby :alt: Chat on Gitter

Key Features

  • Supports both client and server side of HTTP protocol.
  • Supports both client and server Web-Sockets out-of-the-box and avoids Callback Hell.
  • Provides Web-server with middlewares and plugable routing.

Getting started

Client

To get something from the web:

.. code-block:: python

import aiohttp import asyncio

async def main():

async with aiohttp.ClientSession() as session: async with session.get('http://python.org') as response: print("Status:", response.status) print("Content-type:", response.headers['content-type']) html = await response.text() print("Body:", html[:15], "...")

loop = asyncio.get_event_loop() loop.run_until_complete(main())

This prints:

.. code-block::

Status: 200 Content-type: text/html; charset=utf-8 Body: ...

Comming from

requests <https:></https:>

_ ? Read

why we need so many lines <https:></https:>

_.

Server

An example using a simple server:

.. code-block:: python

# examples/server\_simple.py from aiohttp import web async def handle(request): name = request.match\_info.get('name', "Anonymous") text = "Hello, " + name return web.Response(text=text) async def wshandle(request): ws = web.WebSocketResponse() await ws.prepare(request) async for msg in ws: if msg.type == web.WSMsgType.text: await ws.send\_str("Hello, {}".format(msg.data)) elif msg.type == web.WSMsgType.binary: await ws.send\_bytes(msg.data) elif msg.type == web.WSMsgType.close: break return ws app = web.Application() app.add\_routes([web.get('/', handle), web.get('/echo', wshandle), web.get('/{name}', handle)]) if \_\_name\_\_ == '\_\_main\_\_': web.run\_app(app)

Documentation

https://aiohttp.readthedocs.io/

Demos

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

External links

  • Third party libraries<http:></http:>
    _
  • Built with aiohttp<http:></http:>
    _
  • Powered by aiohttp<http:></http:>
    _

Feel free to make a Pull Request for adding your link to these pages!

Communication channels

aio-libs discourse group: https://aio-libs.discourse.group

gitter chat https://gitter.im/aio-libs/Lobby

We support

Stack Overflow<https:></https:>

_. Please add aiohttp tag to your question there.

Requirements

  • Python >= 3.5.3
  • async-timeout_
  • attrs_
  • chardet_
  • multidict_
  • yarl_

Optionally you may install the cChardet_ and aiodns_ libraries (highly recommended for sake of speed).

.. _chardet: https://pypi.python.org/pypi/chardet .. _aiodns: https://pypi.python.org/pypi/aiodns .. _attrs: https://github.com/python-attrs/attrs .. _multidict: https://pypi.python.org/pypi/multidict .. _yarl: https://pypi.python.org/pypi/yarl .. _async-timeout: https://pypi.python.org/pypi/async_timeout .. _cChardet: https://pypi.python.org/pypi/cchardet

License

aiohttp

is offered under the Apache 2 license.

Keepsafe

The aiohttp community would like to thank Keepsafe (https://www.getkeepsafe.com) for its support in the early days of the project.

Source code

The latest developer version is available in a GitHub repository: https://github.com/aio-libs/aiohttp

Benchmarks

If you are interested in efficiency, the AsyncIO community maintains a list of benchmarks on the official wiki: https://github.com/python/asyncio/wiki/Benchmarks

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.