Metadata-Version: 2.1
Name: requests-anon
Version: 0.1.0
Summary: Execute HTTPS requests to a server using anonymous proxies.
Author: Nicolò Boschi
Author-email: boschi1997@gmail.com
Requires-Python: >=3.9,<4.0
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: requests[socks] (>=2.32.3,<3.0.0)
Description-Content-Type: text/markdown

# `requests-anon`

Execute HTTPS requests to a server using anonymous proxies.
The intended usage is to by-pass server's IP Blocking while scraping data from API or webpages.
It's important to note that using anonymous proxies is **risky**, **unsafe** and will cause **credentials leaks**.

## Installation

```bash
pip install requests-anon
```

## Usage

```python
import requests
from requests_anon import request_with_anon_proxy_unsafe

# this one will contact the server directly
response = requests.get("https://google.com")
# this one will contact the server using an anonymous proxy 
response = request_with_anon_proxy_unsafe("get", "https://google.com")
```

## Considerations

The library gets socks5 free proxies from [https://advanced.name/freeproxy](https://advanced.name/freeproxy).
It tries to use the first proxy available, if it fails, it tries the next one; therefore the **latency will be higher** than using a single proxy or no proxy at all.

## Contributing
Any contribution is welcome! Please open a PR with your changes.
