Skip to main content

Proxy connector for aiohttp

Project description

aiohttp-socks

CI Coverage Status PyPI version

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

aiohttp_socks-0.10.1.tar.gz (10.4 kB view details)

Uploaded Source

Built Distribution

aiohttp_socks-0.10.1-py3-none-any.whl (10.1 kB view details)

Uploaded Python 3

File details

Details for the file aiohttp_socks-0.10.1.tar.gz.

File metadata

  • Download URL: aiohttp_socks-0.10.1.tar.gz
  • Upload date:
  • Size: 10.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.11.5

File hashes

Hashes for aiohttp_socks-0.10.1.tar.gz
Algorithm Hash digest
SHA256 49f2e1f8051f2885719beb1b77e312b5a27c3e4b60f0b045a388f194d995e068
MD5 e15d0c6ce22d316a39a6bd7b3686d418
BLAKE2b-256 25c0dfc948c2aff58db2846192d744dc889bd634b9f3cc7d0fca85ef3c7e9cd4

See more details on using hashes here.

File details

Details for the file aiohttp_socks-0.10.1-py3-none-any.whl.

File metadata

File hashes

Hashes for aiohttp_socks-0.10.1-py3-none-any.whl
Algorithm Hash digest
SHA256 6fd4d46c09f952f971a011ff446170daab8d539cf5310c0627f8423df2fb15ea
MD5 9d9cf924cb7cd212587f5c647e76d123
BLAKE2b-256 d3047ff144f7465e83cf87459ffd74688871918496acd4816507cca1af5623d3

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page