Skip to content
forked from aio-libs/aiohttp

Asynchronous HTTP client/server framework for asyncio and Python

License

Notifications You must be signed in to change notification settings

felixxm/aiohttp

This branch is 3314 commits behind aio-libs/aiohttp:master.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Aug 3, 2022
013e45f · Aug 3, 2022
Aug 3, 2022
Aug 3, 2022
Jul 29, 2022
Aug 3, 2022
Jan 30, 2022
Aug 3, 2022
Aug 3, 2022
Apr 4, 2022
Oct 29, 2021
Apr 13, 2018
Aug 28, 2021
Jan 14, 2019
Jul 13, 2022
Oct 28, 2020
Oct 29, 2021
Oct 29, 2021
Jul 13, 2019
Oct 23, 2021
Jun 14, 2022
Oct 6, 2021
Dec 14, 2021
Mar 20, 2018
Dec 28, 2021
Jul 24, 2022
Oct 20, 2021
Feb 9, 2022
Jun 18, 2018
Jun 12, 2022
May 13, 2022
Nov 2, 2021
Aug 3, 2022
Dec 13, 2021

Repository files navigation

Async http client/server framework

aiohttp logo


GitHub Actions status for master branch codecov.io status for master branch Latest PyPI package version Downloads count 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

External links

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. 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

About

Asynchronous HTTP client/server framework for asyncio and Python

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 97.4%
  • Cython 2.2%
  • Makefile 0.3%
  • Gherkin 0.1%
  • Dockerfile 0.0%
  • C 0.0%