aioprox

aioprox – Asynchronous proxy manager for Python. Fetch, test, and filter HTTP/SOCKS proxies with optional latency measurement and support for custom sources.

Project Overview

aioprox is designed for developers who need a reliable, asynchronous proxy management tool in Python. It allows you to quickly fetch proxies from multiple sources, test them concurrently, and optionally measure latency to select the fastest proxies. Whether you want a single random live proxy or a fully sorted list of working proxies, aioprox makes it easy. You can also supply your own proxy lists via a file, URL, or Python list.

Features

• Fetch proxies from multiple built-in sources or user-supplied sources (URL, file, or list).
• Test proxies asynchronously for availability.
• Optional latency measurement to find the fastest proxies.
• Retrieve a single random live proxy or a full list of working proxies.
• Supports HTTP, SOCKS4, and SOCKS5 proxies.
• Concurrency control for fast testing of large proxy lists.
• Easy to integrate in both scripts and larger Python projects.

Installation

pip install aiohttp aiohttp_socks

Then clone or download aioprox.py into your project.

Usage

1. Using a Built-in Source

from aioprox import Proxy

# Initialize with built-in source
p = Proxy(proxy_type="http", source="monosans")

# Get all live proxies
proxies = p.get_good_proxies()
print(proxies)

# Get a single random live proxy
random_proxy = p.get_random_proxy()
print(f"Random proxy: {random_proxy}")

2. Measuring Latency

# Enable latency measurement
p = Proxy(proxy_type="http", source="monosans", latency=True)

# Get proxies sorted by latency
proxies = p.get_good_proxies()

# Get the fastest proxy
fastest_proxy = p.get_random_proxy()
print(proxies)
print(f"Fastest proxy: {fastest_proxy}")

3. Using a Custom List of Proxies

custom_list = [
    "123.45.67.89:8080",
    "98.76.54.32:1080",
]

p = Proxy(proxy_type="http", custom_source=custom_list, latency=True)
proxies = p.get_good_proxies()
print(proxies)

4. Using a Custom URL or File

# From a URL
p = Proxy(proxy_type="socks5", custom_source="https://example.com/proxylist.txt")
proxies = p.get_good_proxies()
print(proxies)

# From a local file
p = Proxy(proxy_type="http", custom_source="proxies.txt")
proxies = p.get_good_proxies()
print(proxies)

Supported Proxy Types

• HTTP
• SOCKS4
• SOCKS5

Concurrency

By default, proxy testing uses a concurrency of 50. You can adjust it when creating the Proxy object:

p = Proxy(proxy_type="http", source="monosans", concurrency=100)

Error Handling

• Failed proxy sources print informative messages.
• Dead proxies are automatically filtered out.
• Latency measurement is optional; if not enabled, only live/dead status is returned.

Example Output

[{'proxy': '123.45.67.89:8080', 'latency': 0.234},
 {'proxy': '98.76.54.32:1080', 'latency': 0.421}]
Fastest proxy: 123.45.67.89:8080