Find fetch & validate free proxies fast.
Ballyregan is a package & CLI that allows you to fetch free tested proxies really fast!
Key features:
- Fetch free tested proxies super fast with ProxyFetcher
- Validate your own proxies with ProxyValidator
- Filter custom proxy list by protocol & anonymity with ProxyFilterer
When you use the ProxyFetcher to fetch a proxy, it performs several steps:
- Gather all the available proxies from a list of built in providers (each provider gathers it's own and returns it to the fetcher).
-
Provider - any website that serves free proxy lists (e.g https://free-proxy-list.net).
- Filter all the gathered proxies by the given protocols and anonymities (if exist).
- Validate the filtered proxies and return them.
Note
You can write and append your own custom providers and pass it to the ProxyFetcher class as attribute.
Every custom proxy provider must implement the IProxyProvider base interface.
Fetching a proxy is an IO bound operation which depends on network. A common approach for this problem is performing your network requests async.
After digging a bit, testing Threads, Greenlets and async operations, we decided to go the async way.
To perform async http requests, ballyregan uses aiohttp and asyncio,
as "asyncio is often a perfect fit for IO-bound and high-level structured network code." (from asyncio docs).
By using the power of async http requests, ballyregan is able to validate thousands of proxies really fast.
pip install ballyregan
from ballyregan import ProxyFetcher
# Setting the debug mode to True, defaults to False
fetcher = ProxyFetcher(debug=True)
proxy = fetcher.get_one()
print(proxy)
proxies = fetcher.get(limit=4)
print(proxies)
from ballyregan.models import Protocols, Anonymities
proxies = fetcher.get(
limit=4,
protocols=[Protocols.HTTPS, Protocols.SOCKS5],
anonymities=[Anonymities.ELITE]
)
print(proxies)
ballyregan get --all
ballyregan get
ballyregan --debug get [OPTIONS]
ballyregan get -o json
bellyregan get -l 4
bellyregan get -l 4 -p https -p socks5 -a elite
👤 Idan Daniel
- Github: @idandaniel
Give a ⭐️ if this project helped you!
Copyright © 2022 Idan Daniel.
This project is Apache License Version 2.0 licensed.