aiohttp-socks
![PyPI version](https://badge.fury.io/py/aiohttp-socks.svg)
The aiohttp-socks
package provides a proxy connector for aiohttp.
Supports SOCKS4(a), SOCKS5(h), HTTP (tunneling) as well as Proxy chains.
It uses python-socks for core proxy functionality.
Requirements
- Python >= 3.6
- aiohttp >= 2.3.2
- python-socks[asyncio] >= 1.0.1
Installation
pip install aiohttp_socks
Usage
aiohttp usage:
import aiohttp
from aiohttp_socks import ProxyType, ProxyConnector, ChainProxyConnector
async def fetch(url):
connector = ProxyConnector.from_url('socks5://user:password@127.0.0.1:1080')
async with aiohttp.ClientSession(connector=connector) as session:
async with session.get(url) as response:
return await response.text()
aiohttp-socks also provides open_connection
and create_connection
functions:
from aiohttp_socks import open_connection
async def fetch():
reader, writer = await open_connection(
proxy_url='socks5://user:password@127.0.0.1:1080',
host='check-host.net',
port=80
)
request = (b"GET /ip HTTP/1.1\r\n"
b"Host: check-host.net\r\n"
b"Connection: close\r\n\r\n")
writer.write(request)
return await reader.read(-1)
Why yet another SOCKS connector for aiohttp
Unlike aiosocksy, aiohttp_socks has only single point of integration with aiohttp.
This makes it easier to maintain compatibility with new aiohttp versions.