Async http client/server framework (asyncio)

Navigation

Project links

Statistics

View statistics for this project via Libraries.io, or by using our public dataset on Google BigQuery

Meta

License: Apache Software License (Apache 2)

Maintainer: aiohttp team <team@aiohttp.org>

Requires: Python >=3.6

Owner

organization icon aio-libs

Maintainers

Avatar for aio-libs-bot from gravatar.com aio-libs-bot Avatar for Andrew.Svetlov from gravatar.com Andrew.Svetlov Avatar for fafhrd from gravatar.com fafhrd Avatar for webknjaz from gravatar.com webknjaz

Classifiers

Project description

aiohttp logo

GitHub Actions status for master branch codecov.io status for master branch Latest PyPI package version Latest Read The Docs Discourse status 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:

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], "...")

  asyncio.run(main())

This prints:

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

Coming from requests ? Read why we need so many lines.

Server

An example using a simple server:

# 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

Communication channels

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

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

We support Stack Overflow. Please add aiohttp tag to your question there.

Requirements

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

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

Project details

Project links

Statistics

View statistics for this project via Libraries.io, or by using our public dataset on Google BigQuery

Meta

License: Apache Software License (Apache 2)

Maintainer: aiohttp team <team@aiohttp.org>

Requires: Python >=3.6

Owner

organization icon aio-libs

Maintainers

Avatar for aio-libs-bot from gravatar.com aio-libs-bot Avatar for Andrew.Svetlov from gravatar.com Andrew.Svetlov Avatar for fafhrd from gravatar.com fafhrd Avatar for webknjaz from gravatar.com webknjaz

Classifiers


Release history Release notifications | RSS feed

4.0.0a1 pre-release

4.0.0a0 pre-release

3.8.5

3.8.4

3.8.3

This version

3.8.2 yanked

3.8.1

3.8.0

3.8.0b0 pre-release

3.8.0a7 pre-release

3.7.4.post0

3.7.4

3.7.3

3.7.2

3.7.1

3.7.0

3.7.0b1 pre-release

3.7.0b0 pre-release

3.6.3

3.6.2

3.6.2a2 pre-release

3.6.2a1 pre-release

3.6.2a0 pre-release

3.6.1

3.6.1b4 pre-release

3.6.1b3 pre-release

3.6.0

3.6.0b0 pre-release

3.6.0a12 pre-release

3.6.0a11 pre-release

3.6.0a9 pre-release

3.6.0a8 pre-release

3.6.0a7 pre-release

3.6.0a6 pre-release

3.6.0a5 pre-release

3.6.0a4 pre-release

3.6.0a3 pre-release

3.6.0a2 pre-release

3.6.0a1 pre-release

3.6.0a0 pre-release

3.5.4

3.5.3

3.5.2

3.5.1

3.5.0

3.5.0b3 pre-release

3.5.0b2 pre-release

3.5.0b1 pre-release

3.5.0a1 pre-release

3.4.4

3.4.3

3.4.2

3.4.1

3.4.0

3.4.0b2 pre-release

3.4.0b1 pre-release

3.4.0a3 pre-release

3.4.0a0 pre-release

3.3.2

3.3.2a0 pre-release

3.3.1

3.3.0

3.3.0a0 pre-release

3.2.1

3.2.0

3.1.3

3.1.2

3.1.1

3.1.0

3.0.9

3.0.8

3.0.7

3.0.6

3.0.5

3.0.4

3.0.3

3.0.2

3.0.1

3.0.0

3.0.0b4 pre-release

3.0.0b3 pre-release

3.0.0b2 pre-release

3.0.0b1 pre-release

3.0.0b0 pre-release

2.3.10

2.3.9

2.3.8

2.3.7

2.3.6

2.3.5

2.3.4

2.3.3

2.3.2

2.3.2b3 pre-release

2.3.2b2 pre-release

2.3.1

2.3.1a1 pre-release

2.3.0

2.3.0a4 pre-release

2.3.0a3 pre-release

2.3.0a2 pre-release

2.3.0a1 pre-release

2.2.5

2.2.4

2.2.3

2.2.2

2.2.1

2.2.0

2.1.0

2.0.7

2.0.6

2.0.5

2.0.4

2.0.3

2.0.2

2.0.1

2.0.0

2.0.0rc1 pre-release

1.3.5

1.3.4

1.3.3

1.3.2

1.3.1

1.3.0

1.2.0

1.1.6

1.1.5

1.1.4

1.1.3

1.1.2

1.1.1

1.1.0

1.0.5

1.0.3

1.0.2

1.0.1

1.0.0

0.22.5

0.22.4

0.22.3

0.22.2

0.22.1

0.22.0

0.22.0b6 pre-release

0.22.0b5 pre-release

0.22.0b4 pre-release

0.22.0b3 pre-release

0.22.0b2 pre-release

0.22.0b1 pre-release

0.22.0b0 pre-release

0.22.0a0 pre-release

0.21.6

0.21.5

0.21.4

0.21.2

0.21.1

0.21.0

0.20.2

0.20.1

0.20.0

0.19.0

0.18.4

0.18.3

0.18.2

0.18.1

0.18.0

0.17.4

0.17.3

0.17.2

0.17.1

0.17.0

0.16.6

0.16.5

0.16.4

0.16.3

0.16.2

0.16.1

0.16.0

0.15.3

0.15.2

0.15.1

0.15.0

0.14.4

0.14.3

0.14.2

0.14.1

0.14.0

0.13.1

0.13.0

0.12.0

0.11.0

0.10.2

0.10.1

0.10.0

0.9.3

0.9.2

0.9.1

0.9.0

0.8.4

0.8.3

0.8.2

0.8.1

0.8.0

0.7.3

0.7.2

0.7.1

0.7.0

0.6.5

0.6.4

0.6.3

0.6.2

0.6.1

0.6.0

0.5.0

0.4.4

0.4.3

0.4.2

0.4.1

0.4

0.3

0.2

0.1

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

aiohttp-3.8.2.tar.gz (7.3 MB view hashes)

Uploaded source

Built Distributions

aiohttp-3.8.2-cp311-cp311-win_amd64.whl (317.1 kB view hashes)

Uploaded cp311

aiohttp-3.8.2-cp311-cp311-win32.whl (303.9 kB view hashes)

Uploaded cp311

aiohttp-3.8.2-cp311-cp311-musllinux_1_1_x86_64.whl (1.0 MB view hashes)

Uploaded cp311

aiohttp-3.8.2-cp311-cp311-musllinux_1_1_s390x.whl (1.1 MB view hashes)

Uploaded cp311

aiohttp-3.8.2-cp311-cp311-musllinux_1_1_ppc64le.whl (1.1 MB view hashes)

Uploaded cp311

aiohttp-3.8.2-cp311-cp311-musllinux_1_1_i686.whl (1.0 MB view hashes)

Uploaded cp311

aiohttp-3.8.2-cp311-cp311-musllinux_1_1_aarch64.whl (1.0 MB view hashes)

Uploaded cp311

aiohttp-3.8.2-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.0 MB view hashes)

Uploaded cp311

aiohttp-3.8.2-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl (1.1 MB view hashes)

Uploaded cp311

aiohttp-3.8.2-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl (1.0 MB view hashes)

Uploaded cp311

aiohttp-3.8.2-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (1.0 MB view hashes)

Uploaded cp311

aiohttp-3.8.2-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl (985.4 kB view hashes)

Uploaded cp311

aiohttp-3.8.2-cp311-cp311-macosx_11_0_arm64.whl (332.6 kB view hashes)

Uploaded cp311

aiohttp-3.8.2-cp311-cp311-macosx_10_9_x86_64.whl (355.1 kB view hashes)

Uploaded cp311

aiohttp-3.8.2-cp311-cp311-macosx_10_9_universal2.whl (505.3 kB view hashes)

Uploaded cp311

aiohttp-3.8.2-cp310-cp310-win_amd64.whl (319.7 kB view hashes)

Uploaded cp310

aiohttp-3.8.2-cp310-cp310-win32.whl (304.6 kB view hashes)

Uploaded cp310

aiohttp-3.8.2-cp310-cp310-musllinux_1_1_x86_64.whl (1.0 MB view hashes)

Uploaded cp310

aiohttp-3.8.2-cp310-cp310-musllinux_1_1_s390x.whl (1.1 MB view hashes)

Uploaded cp310

aiohttp-3.8.2-cp310-cp310-musllinux_1_1_ppc64le.whl (1.0 MB view hashes)

Uploaded cp310

aiohttp-3.8.2-cp310-cp310-musllinux_1_1_i686.whl (985.7 kB view hashes)

Uploaded cp310

aiohttp-3.8.2-cp310-cp310-musllinux_1_1_aarch64.whl (1.0 MB view hashes)

Uploaded cp310

aiohttp-3.8.2-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.0 MB view hashes)

Uploaded cp310

aiohttp-3.8.2-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl (1.1 MB view hashes)

Uploaded cp310

aiohttp-3.8.2-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl (1.0 MB view hashes)

Uploaded cp310

aiohttp-3.8.2-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (1.0 MB view hashes)

Uploaded cp310

aiohttp-3.8.2-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl (971.1 kB view hashes)

Uploaded cp310

aiohttp-3.8.2-cp310-cp310-macosx_11_0_arm64.whl (336.5 kB view hashes)

Uploaded cp310

aiohttp-3.8.2-cp310-cp310-macosx_10_9_x86_64.whl (358.4 kB view hashes)

Uploaded cp310

aiohttp-3.8.2-cp310-cp310-macosx_10_9_universal2.whl (512.5 kB view hashes)

Uploaded cp310

aiohttp-3.8.2-cp39-cp39-win_amd64.whl (323.5 kB view hashes)

Uploaded cp39

aiohttp-3.8.2-cp39-cp39-win32.whl (307.3 kB view hashes)

Uploaded cp39

aiohttp-3.8.2-cp39-cp39-musllinux_1_1_x86_64.whl (1.0 MB view hashes)

Uploaded cp39

aiohttp-3.8.2-cp39-cp39-musllinux_1_1_s390x.whl (1.1 MB view hashes)

Uploaded cp39

aiohttp-3.8.2-cp39-cp39-musllinux_1_1_ppc64le.whl (1.1 MB view hashes)

Uploaded cp39

aiohttp-3.8.2-cp39-cp39-musllinux_1_1_i686.whl (1.0 MB view hashes)

Uploaded cp39

aiohttp-3.8.2-cp39-cp39-musllinux_1_1_aarch64.whl (1.0 MB view hashes)

Uploaded cp39

aiohttp-3.8.2-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.0 MB view hashes)

Uploaded cp39

aiohttp-3.8.2-cp39-cp39-manylinux_2_17_s390x.manylinux2014_s390x.whl (1.1 MB view hashes)

Uploaded cp39

aiohttp-3.8.2-cp39-cp39-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl (1.0 MB view hashes)

Uploaded cp39

aiohttp-3.8.2-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (1.0 MB view hashes)

Uploaded cp39

aiohttp-3.8.2-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl (990.3 kB view hashes)

Uploaded cp39

aiohttp-3.8.2-cp39-cp39-macosx_11_0_arm64.whl (337.9 kB view hashes)

Uploaded cp39

aiohttp-3.8.2-cp39-cp39-macosx_10_9_x86_64.whl (360.7 kB view hashes)

Uploaded cp39

aiohttp-3.8.2-cp39-cp39-macosx_10_9_universal2.whl (516.1 kB view hashes)

Uploaded cp39

aiohttp-3.8.2-cp38-cp38-win_amd64.whl (324.3 kB view hashes)

Uploaded cp38

aiohttp-3.8.2-cp38-cp38-win32.whl (308.0 kB view hashes)

Uploaded cp38

aiohttp-3.8.2-cp38-cp38-musllinux_1_1_x86_64.whl (1.1 MB view hashes)

Uploaded cp38

aiohttp-3.8.2-cp38-cp38-musllinux_1_1_s390x.whl (1.2 MB view hashes)

Uploaded cp38

aiohttp-3.8.2-cp38-cp38-musllinux_1_1_ppc64le.whl (1.1 MB view hashes)

Uploaded cp38

aiohttp-3.8.2-cp38-cp38-musllinux_1_1_i686.whl (1.1 MB view hashes)

Uploaded cp38

aiohttp-3.8.2-cp38-cp38-musllinux_1_1_aarch64.whl (1.1 MB view hashes)

Uploaded cp38

aiohttp-3.8.2-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.0 MB view hashes)

Uploaded cp38

aiohttp-3.8.2-cp38-cp38-manylinux_2_17_s390x.manylinux2014_s390x.whl (1.1 MB view hashes)

Uploaded cp38

aiohttp-3.8.2-cp38-cp38-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl (1.1 MB view hashes)

Uploaded cp38

aiohttp-3.8.2-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (1.0 MB view hashes)

Uploaded cp38

aiohttp-3.8.2-cp38-cp38-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl (1.0 MB view hashes)

Uploaded cp38

aiohttp-3.8.2-cp38-cp38-macosx_11_0_arm64.whl (337.4 kB view hashes)

Uploaded cp38

aiohttp-3.8.2-cp38-cp38-macosx_10_9_x86_64.whl (359.7 kB view hashes)

Uploaded cp38

aiohttp-3.8.2-cp38-cp38-macosx_10_9_universal2.whl (514.7 kB view hashes)

Uploaded cp38

aiohttp-3.8.2-cp37-cp37m-win_amd64.whl (322.1 kB view hashes)

Uploaded cp37

aiohttp-3.8.2-cp37-cp37m-win32.whl (306.6 kB view hashes)

Uploaded cp37

aiohttp-3.8.2-cp37-cp37m-musllinux_1_1_x86_64.whl (963.8 kB view hashes)

Uploaded cp37

aiohttp-3.8.2-cp37-cp37m-musllinux_1_1_s390x.whl (1.0 MB view hashes)

Uploaded cp37

aiohttp-3.8.2-cp37-cp37m-musllinux_1_1_ppc64le.whl (984.1 kB view hashes)

Uploaded cp37

aiohttp-3.8.2-cp37-cp37m-musllinux_1_1_i686.whl (941.8 kB view hashes)

Uploaded cp37

aiohttp-3.8.2-cp37-cp37m-musllinux_1_1_aarch64.whl (968.0 kB view hashes)

Uploaded cp37

aiohttp-3.8.2-cp37-cp37m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (948.1 kB view hashes)

Uploaded cp37

aiohttp-3.8.2-cp37-cp37m-manylinux_2_17_s390x.manylinux2014_s390x.whl (1.0 MB view hashes)

Uploaded cp37

aiohttp-3.8.2-cp37-cp37m-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl (968.8 kB view hashes)

Uploaded cp37

aiohttp-3.8.2-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (952.9 kB view hashes)

Uploaded cp37

aiohttp-3.8.2-cp37-cp37m-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl (922.8 kB view hashes)

Uploaded cp37

aiohttp-3.8.2-cp37-cp37m-macosx_10_9_x86_64.whl (355.9 kB view hashes)

Uploaded cp37

aiohttp-3.8.2-cp36-cp36m-win_amd64.whl (337.4 kB view hashes)

Uploaded cp36

aiohttp-3.8.2-cp36-cp36m-win32.whl (316.7 kB view hashes)

Uploaded cp36

aiohttp-3.8.2-cp36-cp36m-musllinux_1_1_x86_64.whl (954.9 kB view hashes)

Uploaded cp36

aiohttp-3.8.2-cp36-cp36m-musllinux_1_1_s390x.whl (1.0 MB view hashes)

Uploaded cp36

aiohttp-3.8.2-cp36-cp36m-musllinux_1_1_ppc64le.whl (979.8 kB view hashes)

Uploaded cp36

aiohttp-3.8.2-cp36-cp36m-musllinux_1_1_i686.whl (933.7 kB view hashes)

Uploaded cp36

aiohttp-3.8.2-cp36-cp36m-musllinux_1_1_aarch64.whl (960.6 kB view hashes)

Uploaded cp36

aiohttp-3.8.2-cp36-cp36m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (946.0 kB view hashes)

Uploaded cp36

aiohttp-3.8.2-cp36-cp36m-manylinux_2_17_s390x.manylinux2014_s390x.whl (1.0 MB view hashes)

Uploaded cp36

aiohttp-3.8.2-cp36-cp36m-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl (965.7 kB view hashes)

Uploaded cp36

aiohttp-3.8.2-cp36-cp36m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (951.9 kB view hashes)

Uploaded cp36

aiohttp-3.8.2-cp36-cp36m-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl (922.6 kB view hashes)

Uploaded cp36

aiohttp-3.8.2-cp36-cp36m-macosx_10_9_x86_64.whl (355.8 kB view hashes)

Uploaded cp36

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page