A simple wrapper for Requests to randomly select proxies
Project description
PyProxyRoulette
The pyproxyroulette library is a wrapper for the Requests library. The wrapper applies a random proxy to each request and ensures that the proxy is working and swaps it out when needed. Additionally, the wrapper tries to detect if a request has been blocked by the requested web-host. Blocked requests are repeated with different proxy servers.
Installation
As pyproxyroulette is not yet listed on the pypi repository you can install it as following using pip:
pip install git+https://github.com/Tortuginator/pyproxyroulette.git
Example Wrapper Usage
from pyproxyroulette import ProxyRoulette
pr = ProxyRoulette()
pr.get("http://github.com")
The functions get
, post
,option
,put
,delete
and head
form the requests library are wrapped and callable through the wrapper.
It is generally only recommended to call and use idempotent methods as requests which timeout can be registered by the server, despite not returning in time. Hence it is only recommended to use the GET
methods in production environments.
Initialisation parameters
pr = ProxyRoulette(debug_mode=False,
max_retries=5,
max_timeout=15,
func_proxy_validator=defaults.proxy_is_working,
func_proxy_response_validator=defaults.proxy_response_validator)
Parameter | Description |
---|---|
debug_mode | Activated, it prints additional internal information. Used for debugging |
max_retries | Number of retries with different proxies when a request fails |
max_timeout | Timeout until a request is assumed to have failed |
func_proxy_validator | Function, that can check if a specific (ip,port) combination is valid and working |
func_proxy_response_validator | Function, which checks if a request has been blocked by inspecting the response. A blocked request will lead to repetition of the request using a different proxy |
Add your own proxies to the system
It is possible to add functions to the system, which are called on a regular basis and return pairs of IP,PORT to be used in the proxy roulette. A proxy pool update function has to return a list of IP,PORT pairs. A default function is used to populate the proxy pool if no explicit function is defined. A explicit custom defined function can be added as follows:
from pyproxyroulette import ProxyRoulette
@ProxyRoulette.proxy_pool_updater
def my_cool_proxy_obtaining_function():
return [("172.0.0.1",80)]
pr = ProxyRoulette()
pr.get("http://some.url")
Example Decorator Usage
WARNING: USE THE DECORATOR ONLY FOR SINGLE-THREADED APPLICATIONS
import requests
from pyproxyroulette import ProxyRoulette
pr = ProxyRoulette()
@pr.proxify()
def foo_bar():
requests.get("http://github.com")
requests.post("http://github.com/login",data = {"username":"foo","password":"bar"})
Using the @pr.proxify()
decorator above the declaration of a function, will apply pyproxyroulette to all requests made by the requests library in that specific function. In multi-threaded applications, the library can be used as it uses threading.Lock()
to ensure a thread safety. So instead of the decorator the usual function pr.get(...)
aso. are applicable.
When the decorator while being used detects the usage of threads, it will raise a Exception. The exception can be completely disabled by setting pr.acknowledge_decorator_restrictions = True
. By default the value is set to False.
WARNING: Use the decorator ONLY when your application uses the requests library in only ONE thread and when the the requests library is referred to as requests
in the function. Using a different name for the library than 'requests' will prevent the wrapper from applying the proxy to the requests.
Disclaimer
THIS SOFTWARE IS PROVIDED ''AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE CONTRIBUTOR(S) BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for pyproxyroulette-0.4.3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | f7d88aa2f62129ee8fe3af8f529a18fd3ed3d17807d244d4bef4427fc6ee1b6c |
|
MD5 | 9e9f5888b01ba7d4002d4aef54001bf5 |
|
BLAKE2b-256 | b828488045593bae214eafa9f03b6b3f5a9d2c764d5dbbf0878ff6fdcc03c0da |