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.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')
    
    ### or use ProxyConnector constructor
    # connector = ProxyConnector(
    #     proxy_type=ProxyType.SOCKS5,
    #     host='127.0.0.1',
    #     port=1080,
    #     username='user',
    #     password='password',
    #     rdns=True
    # )
    
    ### 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()

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.

Metadata

Release files for aiohttp_socks 0.8.3

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.8.3
File	Size	Uploaded
aiohttp_socks-0.8.3.tar.gz	8.5 kB	Sep 6, 2023	Details

Built distribution (wheel)

Table of built distributions (wheels) for aiohttp_socks 0.8.3
File	Interpreter	ABI	Platform	Reset
aiohttp_socks-0.8.3-py3-none-any.whl 9.5 kB Sep 6, 2023	Python 3	none	any	Details

Total release size: 18.0 kB

Release files / aiohttp_socks-0.8.3.tar.gz

Download URL	aiohttp_socks-0.8.3.tar.gz
Size	8.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`6aab528f669e0873018fd37773b833a2e2ba284243be672817fa401bc7941ec6`
BLAKE2b-256 checksum How to use checksums	`d7e2b1ffee497938f4fff54e59590172f79a9aee8b106154e8aafc020865245a`
Upload date	Sep 6, 2023
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.3.0 pkginfo/1.7.0 requests/2.25.1 setuptools/58.0.4 requests-toolbelt/0.9.1 tqdm/4.56.2 CPython/3.7.11`

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

Download URL	aiohttp_socks-0.8.3-py3-none-any.whl
Size	9.5 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`04bed72d21561f5ae8199da1cf845bede27c6b6ba42a0ab7e8f71f7e00e9a23a`
BLAKE2b-256 checksum How to use checksums	`760cdcefc88a9f1f43d6508d43a525d12d64f42aa4a971f3c6af9b416c0ecb1b`
Upload date	Sep 6, 2023
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.3.0 pkginfo/1.7.0 requests/2.25.1 setuptools/58.0.4 requests-toolbelt/0.9.1 tqdm/4.56.2 CPython/3.7.11`