httpx-socks 0.3.1

Proxy (HTTP, SOCKS) transports for httpx

httpx-socks

The httpx-socks package provides proxy transports for httpx client. SOCKS4(a), SOCKS5, HTTP (tunneling) proxy supported. It uses python-socks for core proxy functionality.

Requirements

• Python >= 3.6
• httpx >= 0.13.3
• python-socks[asyncio,trio,curio] >= 1.1.0

Installation

only sync proxy support:

pip install httpx-socks

to include optional asyncio support (it requires async-timeout):

pip install httpx-socks[asyncio]

to include optional trio support:

pip install httpx-socks[trio]

to include optional curio support:

pip install httpx-socks[curio]

Usage

sync transport

import httpx
from httpx_socks import SyncProxyTransport

def fetch(url):
    transport = SyncProxyTransport.from_url('socks5://user:password@127.0.0.1:1080')
    with httpx.Client(transport=transport) as client:
        res = client.get(url)
        return res.text

async transport (asyncio, trio, curio)

import httpx
from httpx_socks import AsyncProxyTransport

async def fetch(url):
    transport = AsyncProxyTransport.from_url('socks5://user:password@127.0.0.1:1080')
    async with httpx.AsyncClient(transport=transport) as client:
        res = await client.get(url)
        return res.text