aiohttp_socks

aiohttp-socks

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.8
aiohttp >= 3.10.0
python-socks[asyncio] >= 2.4.3

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')
    
    ### or use ProxyConnector constructor
    # connector = ProxyConnector(
    #     proxy_type=ProxyType.SOCKS5,
    #     host='127.0.0.1',
    #     port=1080,
    #     username='user',
    #     password='password',
    #     rdns=True # default is True for socks5
    # )
    
    ### proxy chaining (since ver 0.3.3)
    # connector = ChainProxyConnector.from_urls([
    #     'socks5://user:password@127.0.0.1:1080',
    #     'socks4://127.0.0.1:1081',
    #     'http://user:password@127.0.0.1:3128',
    # ])
    async with aiohttp.ClientSession(connector=connector) as session:
        async with session.get(url) as response:
            return await response.text()

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.

Metadata

Release files for aiohttp_socks 0.10.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for aiohttp_socks 0.10.0
File	Size	Uploaded
aiohttp_socks-0.10.0.tar.gz	10.5 kB	Dec 23, 2024	Details

Built distribution (wheel)

Table of built distributions (wheels) for aiohttp_socks 0.10.0
File	Interpreter	ABI	Platform	Reset
aiohttp_socks-0.10.0-py3-none-any.whl 10.1 kB Dec 23, 2024	Python 3	none	any	Details

Total release size: 20.6 kB

Release files / aiohttp_socks-0.10.0.tar.gz

Download URL	aiohttp_socks-0.10.0.tar.gz
Size	10.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`9275c47cc7dac185c82754b70921f1ea243d093c79c7b21554c2ee6905f42379`
BLAKE2b-256 checksum How to use checksums	`5d9a385246b0f4346cb7a3d97e01ac9caf24ac9e9cd7892941b6f6dcfdd64b50`
Upload date	Dec 23, 2024
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/5.0.0 CPython/3.11.5`

Release files / aiohttp_socks-0.10.0-py3-none-any.whl

Download URL	aiohttp_socks-0.10.0-py3-none-any.whl
Size	10.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`5f60410e748e943d6a6bd50993bb6eafbff74fa68c94abcb7a9b803e0a63410d`
BLAKE2b-256 checksum How to use checksums	`828df0dad5c1e8bd0fc6fc183e73d9c15ebac3f24e49a6d6841e41162e79d589`
Upload date	Dec 23, 2024
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/5.0.0 CPython/3.11.5`