4008a3114d
Upgrade architecture + 5.0 Bot API (#469) * Moved `methods`, `types` and `client` to root package * Removed update handler from routers to dispatcher * Reworked events propagation mechanism to handlers * Reworked inner middlewares logic (very small change) * Updated to Bot API 5.0 * Initial migration from MkDocs to Sphinx + config for readthedocs
2.4 KiB
Aiohttp session
AiohttpSession represents a wrapper-class around ClientSession from aiohttp{target=_blank}
Currently AiohttpSession is a default session used in aiogram.Bot
Usage example
from aiogram import Bot
from aiogram.client.session.aiohttp import AiohttpSession
session = AiohttpSession()
Bot('token', session=session)
Proxy requests in AiohttpSession
In order to use AiohttpSession with proxy connector you have to install aiohttp-socks{target=_blank}
Binding session to bot:
from aiogram import Bot
from aiogram.client.session.aiohttp import AiohttpSession
session = AiohttpSession(proxy="protocol://host:port/")
Bot(token="bot token", session=session)
!!! note "Protocols" Only following protocols are supported: http(tunneling), socks4(a), socks5 as aiohttp_socks documentation claims.
Authorization
Proxy authorization credentials can be specified in proxy URL or come as an instance of aiohttp.BasicAuth containing
login and password.
Consider examples:
from aiogram.client.session.aiohttp import BasicAuth
from aiogram.client.session.aiohttp import AiohttpSession
auth = BasicAuth(login="user", password="password")
session = AiohttpSession(proxy=("protocol://host:port", auth))
# or simply include your basic auth credential in URL
session = AiohttpSession(proxy="protocol://user:password@host:port")
!!! note "Credential priorities"
Aiogram prefers BasicAuth over username and password in URL, so
if proxy URL contains login and password and BasicAuth object is passed at the same time
aiogram will use login and password from BasicAuth instance.
Proxy chains
Since aiohttp-socks supports proxy chains, you're able to use them in aiogram
Example of chain proxies:
from aiogram.client.session.aiohttp import BasicAuth
from aiogram.client.session.aiohttp import AiohttpSession
auth = BasicAuth(login="user", password="password")
session = AiohttpSession(
proxy={"protocol0://host0:port0",
"protocol1://user:password@host1:port1",
("protocol2://host2:port2", auth), } # can be any iterable if not set
)
Location
from aiogram.api.client.session.aiohttp import AiohttpSession