aiohttp是一个为Python提供异步HTTP 客户端/服务端编程,基于asyncio(Python用于支持异步编程的标准库)的异步库。

核心功能:

aiohttp库安装:

$ pip install aiohttp

你可能还想安装更快的cchardet库来代替chardet进行解码: $ pip install cchardet

对于更快的客户端API DNS解析方案,aiodns是个很好的选择,极力推荐: $ pip install aiodns

快速开始:

客户端例子:

import aiohttp
import asyncio
import async_timeout

async def fetch(session, url):
    with async_timeout.timeout(10):
        async with session.get(url) as response:
            return await response.text()

async def main():
    async with aiohttp.ClientSession() as session:
        html = await fetch(session, 'http://python.org')
        print(html)

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

服务端例子:

from aiohttp import web

async def handle(request):
    name = request.match_info.get('name', "Anonymous")
    text = "Hello, " + name
    return web.Response(text=text)

app = web.Application()
app.router.add_get('/', handle)
app.router.add_get('/{name}', handle)

web.run_app(app)

注意:

这篇文档的所有例子都是利用 async/await 语法来完成的,此语法介绍请看PEP 492,此语法仅Python 3.5+有效。 如果你使用的是Python 3.4, 请将await替换成yield from,将async 替换成带有 @corotine装饰器的def. 比如:

async def coro(...):
    ret = await f()

应替换为:

@asyncio.coroutine
def coro(...):
   ret = yield from f()

服务端指南:

Polls tutorial

源码:

该项目托管在Github.

如果你发现了一个bug或有一些改善的建议请随时提交

该库使用Travis进行持续集成。

程序依赖:

  • Python 3.4.2+

  • chardet

  • multidict

  • async_timeout

  • yarl

  • 可选更快的cchardet代替chardet

可通过下面命令的安装:

$ pip install cchardet

可选aiodns进行DNS快速解析。极力推荐。 $ pip install aiodns

交流渠道:

aio-libs 谷歌交流群: https://groups.google.com/forum/#!forum/aio-libs

随时在这里交流你的问题和想法。

gitter 聊天 https://gitter.im/aio-libs/Lobby

我们还支持Stack Overflow. 在你的问题上添加aiohttp标签即可。

贡献

请在写一个PR前阅读下贡献须知

作者和授权

aiohttp 大部分由 Nikolay Kim 和 Andrew Svetlov编写.

使用 Apache 2 授权并可随意使用。

随时在GitHub上提交PR来改善此项目。

对后续不再兼容的更改所采用的策略

一般的更改aiohttp 保持向后兼容.

在废弃某些公开API(方法,类,函数参数等.)后仍保证可以使用这些被废弃的API至少一年半的时间直到某新版本完全弃用。

所有废弃的东西都会反映在文档中并给出已废弃提示。

有时我们会因一些必须要做的理由而打破某些我们定的规则。大多数原因是有只能通过修改主要API解决的BUG出现,但我们会尽可能不让这种事情发生。

目录:

打开此链接看完整的目录。


书籍推荐