Async http client/server framework (asyncio)

Navigation

Verified details

These details have been verified by PyPI
Owner
organization icon aio-libs
Maintainers
Avatar for Andrew.Svetlov from gravatar.com Andrew.Svetlov Avatar for bdraco from gravatar.com bdraco Avatar for Dreamsorcerer from gravatar.com Dreamsorcerer Avatar for fafhrd from gravatar.com fafhrd Avatar for webknjaz from gravatar.com webknjaz

Unverified details

These details have not been verified by PyPI
Project links
Meta
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 Matrix Room — #aio-libs:matrix.org Matrix Space — #aio-libs-space:matrix.org

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 middleware and pluggable 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 Discussions: https://github.com/aio-libs/aiohttp/discussions

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 aiodns library (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

Verified details

These details have been verified by PyPI
Owner
organization icon aio-libs
Maintainers
Avatar for Andrew.Svetlov from gravatar.com Andrew.Svetlov Avatar for bdraco from gravatar.com bdraco Avatar for Dreamsorcerer from gravatar.com Dreamsorcerer Avatar for fafhrd from gravatar.com fafhrd Avatar for webknjaz from gravatar.com webknjaz

Unverified details

These details have not been verified by PyPI
Project links
Meta
Classifiers

Release history Release notifications | RSS feed

4.0.0a1 pre-release yanked

Reason this release was yanked:

It confuses people who expect the highest pre-release to be the newest one. This has been built from a years-old version of the master branch.

4.0.0a0 pre-release yanked

Reason this release was yanked:

It confuses people who expect the highest pre-release to be the newest one. This has been built from a years-old version of the master branch.

3.11.0rc1 pre-release

3.11.0rc0 pre-release

3.11.0b5 pre-release

3.11.0b4 pre-release

3.11.0b3 pre-release

3.11.0b2 pre-release

3.11.0b1 pre-release

3.11.0b0 pre-release

3.10.10

3.10.9

3.10.8

3.10.7

3.10.6

3.10.6rc2 pre-release

3.10.6rc1 pre-release

3.10.6rc0 pre-release

3.10.5

3.10.4

3.10.3

3.10.2

3.10.1

3.10.0

3.10.0rc0 pre-release

3.10.0b1 pre-release

3.9.5

3.9.4

3.9.4rc0 pre-release

3.9.3

This version

3.9.2

3.9.1

3.9.0

3.9.0rc0 pre-release

3.9.0b1 pre-release

3.9.0b0 pre-release

3.8.6

3.8.5

3.8.4

3.8.3

3.8.2 yanked

Reason this release was yanked:

This version includes overly restrictive multidict upper boundary disallowing multidict v6+. The previous patch version didn't have that and this is now causing dependency resolution problems for the users who have an "incompatible" version pinned. This is not really necessary anymore and will be addressed in the next release v3.8.3 https://github.com/aio-libs/aiohttp/pull/6950

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.9.2.tar.gz (7.5 MB view hashes)

Uploaded Source

Built Distributions

aiohttp-3.9.2-cp312-cp312-win_amd64.whl (363.4 kB view hashes)

Uploaded CPython 3.12 Windows x86-64

aiohttp-3.9.2-cp312-cp312-win32.whl (342.2 kB view hashes)

Uploaded CPython 3.12 Windows x86

aiohttp-3.9.2-cp312-cp312-musllinux_1_1_x86_64.whl (1.3 MB view hashes)

Uploaded CPython 3.12 musllinux: musl 1.1+ x86-64

aiohttp-3.9.2-cp312-cp312-musllinux_1_1_s390x.whl (1.4 MB view hashes)

Uploaded CPython 3.12 musllinux: musl 1.1+ s390x

aiohttp-3.9.2-cp312-cp312-musllinux_1_1_ppc64le.whl (1.3 MB view hashes)

Uploaded CPython 3.12 musllinux: musl 1.1+ ppc64le

aiohttp-3.9.2-cp312-cp312-musllinux_1_1_i686.whl (1.3 MB view hashes)

Uploaded CPython 3.12 musllinux: musl 1.1+ i686

aiohttp-3.9.2-cp312-cp312-musllinux_1_1_aarch64.whl (1.3 MB view hashes)

Uploaded CPython 3.12 musllinux: musl 1.1+ ARM64

aiohttp-3.9.2-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.3 MB view hashes)

Uploaded CPython 3.12 manylinux: glibc 2.17+ x86-64

aiohttp-3.9.2-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl (1.4 MB view hashes)

Uploaded CPython 3.12 manylinux: glibc 2.17+ s390x

aiohttp-3.9.2-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl (1.4 MB view hashes)

Uploaded CPython 3.12 manylinux: glibc 2.17+ ppc64le

aiohttp-3.9.2-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (1.3 MB view hashes)

Uploaded CPython 3.12 manylinux: glibc 2.17+ ARM64

aiohttp-3.9.2-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl (1.3 MB view hashes)

Uploaded CPython 3.12 manylinux: glibc 2.17+ i686 manylinux: glibc 2.5+ i686

aiohttp-3.9.2-cp312-cp312-macosx_11_0_arm64.whl (389.4 kB view hashes)

Uploaded CPython 3.12 macOS 11.0+ ARM64

aiohttp-3.9.2-cp312-cp312-macosx_10_9_x86_64.whl (393.4 kB view hashes)

Uploaded CPython 3.12 macOS 10.9+ x86-64

aiohttp-3.9.2-cp312-cp312-macosx_10_9_universal2.whl (592.2 kB view hashes)

Uploaded CPython 3.12 macOS 10.9+ universal2 (ARM64, x86-64)

aiohttp-3.9.2-cp311-cp311-win_amd64.whl (365.3 kB view hashes)

Uploaded CPython 3.11 Windows x86-64

aiohttp-3.9.2-cp311-cp311-win32.whl (345.2 kB view hashes)

Uploaded CPython 3.11 Windows x86

aiohttp-3.9.2-cp311-cp311-musllinux_1_1_x86_64.whl (1.3 MB view hashes)

Uploaded CPython 3.11 musllinux: musl 1.1+ x86-64

aiohttp-3.9.2-cp311-cp311-musllinux_1_1_s390x.whl (1.4 MB view hashes)

Uploaded CPython 3.11 musllinux: musl 1.1+ s390x

aiohttp-3.9.2-cp311-cp311-musllinux_1_1_ppc64le.whl (1.3 MB view hashes)

Uploaded CPython 3.11 musllinux: musl 1.1+ ppc64le

aiohttp-3.9.2-cp311-cp311-musllinux_1_1_i686.whl (1.3 MB view hashes)

Uploaded CPython 3.11 musllinux: musl 1.1+ i686

aiohttp-3.9.2-cp311-cp311-musllinux_1_1_aarch64.whl (1.3 MB view hashes)

Uploaded CPython 3.11 musllinux: musl 1.1+ ARM64

aiohttp-3.9.2-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.3 MB view hashes)

Uploaded CPython 3.11 manylinux: glibc 2.17+ x86-64

aiohttp-3.9.2-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl (1.4 MB view hashes)

Uploaded CPython 3.11 manylinux: glibc 2.17+ s390x

aiohttp-3.9.2-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl (1.3 MB view hashes)

Uploaded CPython 3.11 manylinux: glibc 2.17+ ppc64le

aiohttp-3.9.2-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (1.3 MB view hashes)

Uploaded CPython 3.11 manylinux: glibc 2.17+ ARM64

aiohttp-3.9.2-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl (1.3 MB view hashes)

Uploaded CPython 3.11 manylinux: glibc 2.17+ i686 manylinux: glibc 2.5+ i686

aiohttp-3.9.2-cp311-cp311-macosx_11_0_arm64.whl (387.4 kB view hashes)

Uploaded CPython 3.11 macOS 11.0+ ARM64

aiohttp-3.9.2-cp311-cp311-macosx_10_9_x86_64.whl (398.1 kB view hashes)

Uploaded CPython 3.11 macOS 10.9+ x86-64

aiohttp-3.9.2-cp311-cp311-macosx_10_9_universal2.whl (594.7 kB view hashes)

Uploaded CPython 3.11 macOS 10.9+ universal2 (ARM64, x86-64)

aiohttp-3.9.2-cp310-cp310-win_amd64.whl (365.2 kB view hashes)

Uploaded CPython 3.10 Windows x86-64

aiohttp-3.9.2-cp310-cp310-win32.whl (345.9 kB view hashes)

Uploaded CPython 3.10 Windows x86

aiohttp-3.9.2-cp310-cp310-musllinux_1_1_x86_64.whl (1.2 MB view hashes)

Uploaded CPython 3.10 musllinux: musl 1.1+ x86-64

aiohttp-3.9.2-cp310-cp310-musllinux_1_1_s390x.whl (1.3 MB view hashes)

Uploaded CPython 3.10 musllinux: musl 1.1+ s390x

aiohttp-3.9.2-cp310-cp310-musllinux_1_1_ppc64le.whl (1.3 MB view hashes)

Uploaded CPython 3.10 musllinux: musl 1.1+ ppc64le

aiohttp-3.9.2-cp310-cp310-musllinux_1_1_i686.whl (1.2 MB view hashes)

Uploaded CPython 3.10 musllinux: musl 1.1+ i686

aiohttp-3.9.2-cp310-cp310-musllinux_1_1_aarch64.whl (1.2 MB view hashes)

Uploaded CPython 3.10 musllinux: musl 1.1+ ARM64

aiohttp-3.9.2-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.2 MB view hashes)

Uploaded CPython 3.10 manylinux: glibc 2.17+ x86-64

aiohttp-3.9.2-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl (1.3 MB view hashes)

Uploaded CPython 3.10 manylinux: glibc 2.17+ s390x

aiohttp-3.9.2-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl (1.3 MB view hashes)

Uploaded CPython 3.10 manylinux: glibc 2.17+ ppc64le

aiohttp-3.9.2-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (1.2 MB view hashes)

Uploaded CPython 3.10 manylinux: glibc 2.17+ ARM64

aiohttp-3.9.2-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl (1.2 MB view hashes)

Uploaded CPython 3.10 manylinux: glibc 2.17+ i686 manylinux: glibc 2.5+ i686

aiohttp-3.9.2-cp310-cp310-macosx_11_0_arm64.whl (387.0 kB view hashes)

Uploaded CPython 3.10 macOS 11.0+ ARM64

aiohttp-3.9.2-cp310-cp310-macosx_10_9_x86_64.whl (397.6 kB view hashes)

Uploaded CPython 3.10 macOS 10.9+ x86-64

aiohttp-3.9.2-cp310-cp310-macosx_10_9_universal2.whl (593.9 kB view hashes)

Uploaded CPython 3.10 macOS 10.9+ universal2 (ARM64, x86-64)

aiohttp-3.9.2-cp39-cp39-win_amd64.whl (366.0 kB view hashes)

Uploaded CPython 3.9 Windows x86-64

aiohttp-3.9.2-cp39-cp39-win32.whl (346.6 kB view hashes)

Uploaded CPython 3.9 Windows x86

aiohttp-3.9.2-cp39-cp39-musllinux_1_1_x86_64.whl (1.2 MB view hashes)

Uploaded CPython 3.9 musllinux: musl 1.1+ x86-64

aiohttp-3.9.2-cp39-cp39-musllinux_1_1_s390x.whl (1.3 MB view hashes)

Uploaded CPython 3.9 musllinux: musl 1.1+ s390x

aiohttp-3.9.2-cp39-cp39-musllinux_1_1_ppc64le.whl (1.3 MB view hashes)

Uploaded CPython 3.9 musllinux: musl 1.1+ ppc64le

aiohttp-3.9.2-cp39-cp39-musllinux_1_1_i686.whl (1.2 MB view hashes)

Uploaded CPython 3.9 musllinux: musl 1.1+ i686

aiohttp-3.9.2-cp39-cp39-musllinux_1_1_aarch64.whl (1.3 MB view hashes)

Uploaded CPython 3.9 musllinux: musl 1.1+ ARM64

aiohttp-3.9.2-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.2 MB view hashes)

Uploaded CPython 3.9 manylinux: glibc 2.17+ x86-64

aiohttp-3.9.2-cp39-cp39-manylinux_2_17_s390x.manylinux2014_s390x.whl (1.3 MB view hashes)

Uploaded CPython 3.9 manylinux: glibc 2.17+ s390x

aiohttp-3.9.2-cp39-cp39-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl (1.3 MB view hashes)

Uploaded CPython 3.9 manylinux: glibc 2.17+ ppc64le

aiohttp-3.9.2-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (1.2 MB view hashes)

Uploaded CPython 3.9 manylinux: glibc 2.17+ ARM64

aiohttp-3.9.2-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl (1.2 MB view hashes)

Uploaded CPython 3.9 manylinux: glibc 2.17+ i686 manylinux: glibc 2.5+ i686

aiohttp-3.9.2-cp39-cp39-macosx_11_0_arm64.whl (387.8 kB view hashes)

Uploaded CPython 3.9 macOS 11.0+ ARM64

aiohttp-3.9.2-cp39-cp39-macosx_10_9_x86_64.whl (398.4 kB view hashes)

Uploaded CPython 3.9 macOS 10.9+ x86-64

aiohttp-3.9.2-cp39-cp39-macosx_10_9_universal2.whl (595.7 kB view hashes)

Uploaded CPython 3.9 macOS 10.9+ universal2 (ARM64, x86-64)

aiohttp-3.9.2-cp38-cp38-win_amd64.whl (367.6 kB view hashes)

Uploaded CPython 3.8 Windows x86-64

aiohttp-3.9.2-cp38-cp38-win32.whl (347.7 kB view hashes)

Uploaded CPython 3.8 Windows x86

aiohttp-3.9.2-cp38-cp38-musllinux_1_1_x86_64.whl (1.3 MB view hashes)

Uploaded CPython 3.8 musllinux: musl 1.1+ x86-64

aiohttp-3.9.2-cp38-cp38-musllinux_1_1_s390x.whl (1.4 MB view hashes)

Uploaded CPython 3.8 musllinux: musl 1.1+ s390x

aiohttp-3.9.2-cp38-cp38-musllinux_1_1_ppc64le.whl (1.3 MB view hashes)

Uploaded CPython 3.8 musllinux: musl 1.1+ ppc64le

aiohttp-3.9.2-cp38-cp38-musllinux_1_1_i686.whl (1.3 MB view hashes)

Uploaded CPython 3.8 musllinux: musl 1.1+ i686

aiohttp-3.9.2-cp38-cp38-musllinux_1_1_aarch64.whl (1.3 MB view hashes)

Uploaded CPython 3.8 musllinux: musl 1.1+ ARM64

aiohttp-3.9.2-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.3 MB view hashes)

Uploaded CPython 3.8 manylinux: glibc 2.17+ x86-64

aiohttp-3.9.2-cp38-cp38-manylinux_2_17_s390x.manylinux2014_s390x.whl (1.3 MB view hashes)

Uploaded CPython 3.8 manylinux: glibc 2.17+ s390x

aiohttp-3.9.2-cp38-cp38-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl (1.3 MB view hashes)

Uploaded CPython 3.8 manylinux: glibc 2.17+ ppc64le

aiohttp-3.9.2-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (1.3 MB view hashes)

Uploaded CPython 3.8 manylinux: glibc 2.17+ ARM64

aiohttp-3.9.2-cp38-cp38-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl (1.2 MB view hashes)

Uploaded CPython 3.8 manylinux: glibc 2.17+ i686 manylinux: glibc 2.5+ i686

aiohttp-3.9.2-cp38-cp38-macosx_11_0_arm64.whl (389.0 kB view hashes)

Uploaded CPython 3.8 macOS 11.0+ ARM64

aiohttp-3.9.2-cp38-cp38-macosx_10_9_x86_64.whl (399.6 kB view hashes)

Uploaded CPython 3.8 macOS 10.9+ x86-64

aiohttp-3.9.2-cp38-cp38-macosx_10_9_universal2.whl (598.0 kB view hashes)

Uploaded CPython 3.8 macOS 10.9+ universal2 (ARM64, x86-64)

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