Socket
Socket
Sign inDemoInstall

ballyregan

Package Overview
Dependencies
14
Maintainers
1
Alerts
File Explorer

Install Socket

Protect your apps from supply chain attacks

Install

ballyregan

Find fetch & validate free proxies fast.

    1.0.6

Maintainers
1

Readme

Ballyregan

Find fetch & validate free proxies fast.

Package version Supported Python versions License: Apache 2.0


Ballyregan is a super fast proxy fetcher.
It provides a python package and an easy-to-use CLI to help you fetch <bFree Tested Proxies fast, and keep your privacy.


Key features:

  • Fetch free tested proxies super fast using the ProxyFetcher
  • Validate your own proxies using the ProxyValidator
  • Filter custom proxy list by protocol & anonymity using the ProxyFilterer

How does it work?

When you use the ProxyFetcher to fetch a proxy, it performs several steps:

  1. Gather all the available proxies from a list of built-in providers (each provider gathers its own and returns it to the fetcher).
  • Provider - any website that serves free proxy lists (e.g https://free-proxy-list.net).

  1. Filter all the gathered proxies by the given protocols and anonymities (if exist).
  2. Validate the filtered proxies and return them.

Note
You can write and append your own custom providers and pass them to the ProxyFetcher class as an attribute.
Every custom proxy provider must implement the IProxyProvider base interface.


Behind the scenes

Fetching a proxy is an IO bound operation that depends on the network. A common approach for this problem is performing your network requests async.
After digging a bit, and 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 can validate thousands of proxies really fast.
it to the ProxyFetcher class as an attribute.

Every custom proxy provider must implement the IProxyProvider base interface.


Install

All you need to do is install the package from pypi, and it will automatically install the CLI for you.

pip install ballyregan

Usage

📦 Package

Create a fetcher instance
from ballyregan import ProxyFetcher

# Setting the debug mode to True, defaults to False
fetcher = ProxyFetcher(debug=True)
Get one proxy
proxy = fetcher.get_one()
print(proxy)
Get multiple proxies
proxies = fetcher.get(limit=4)
print(proxies)
Get proxies by filters
from ballyregan.models import Protocols, Anonymities

proxies = fetcher.get(
  limit=4,
  protocols=[Protocols.HTTPS, Protocols.SOCKS5],
  anonymities=[Anonymities.ELITE]
)
print(proxies)

💻 CLI

Need some help?
ballyregan get --help
Get one proxy
ballyregan get
Get all proxies
ballyregan get --all
Use debug mode
ballyregan --debug get [OPTIONS]
Format output to json
ballyregan get -o json
Get proxies by limit
ballyregan get -l 4
Get proxies by filters
ballyregan get -l 4 -p https -p socks5 -a elite

📝 License

Copyright © 2022 Idan Daniel.
This project is Apache License Version 2.0 licensed.

Keywords

FAQs


Did you know?

Socket installs a GitHub app to automatically flag issues on every pull request and report the health of your dependencies. Find out what is inside your node modules and prevent malicious activity before you update the dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc