معرفی شرکت ها
froxy-1.0.5
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
Hide your IP with free proxies using Froxy
| ویژگی | مقدار |
|---|---|
| سیستم عامل | - |
| نام فایل | froxy-1.0.5 |
| نام | froxy |
| نسخه کتابخانه | 1.0.5 |
| نگهدارنده | [] |
| ایمیل نگهدارنده | [] |
| نویسنده | Matheus Felipe |
| ایمیل نویسنده | matheusfelipeog@protonmail.com |
| آدرس صفحه اصلی | https://github.com/matheusfelipeog/froxy |
| آدرس اینترنتی | https://pypi.org/project/froxy/ |
| مجوز | MIT License |
<p align="center">
<a href="https://pypi.org/project/froxy/">
<img alt="PyPI - Status" src="https://img.shields.io/pypi/status/froxy?style=for-the-badge&color=black" />
</a>
<a href="https://pypi.org/project/froxy/">
<img alt="PyPI" src="https://img.shields.io/pypi/v/froxy?style=for-the-badge&color=black" />
</a>
<a href="https://github.com/matheusfelipeog/froxy/releases">
<img alt="GitHub release (latest by date)" src="https://img.shields.io/github/v/release/matheusfelipeog/froxy?style=for-the-badge&color=black" />
</a>
<a href="https://github.com/matheusfelipeog/froxy/blob/master/LICENSE">
<img src="https://img.shields.io/github/license/matheusfelipeog/froxy?color=black&style=for-the-badge" alt="License MIT" />
</a>
</p>
<p align="center">
<img src="https://raw.githubusercontent.com/matheusfelipeog/froxy/master/assets/froxy.png" alt="Froxy logo" width="500px" /><br />
Hide your IP with free proxies
</p>
## Index
- [The goal](#the-goal)
- [How it works?](#how-it-works)
- [Why are you using this API?](#why-are-you-using-this-api)
- [Install](#install)
- [Demo](#demo)
- [Warning](#-warning-)
- [Documentation](#doc)
- [Contributions](#contributions)
- [License](#license)
## The goal
This project aims to provide an interface for filter and using free proxies in your web scraping and web crawler projects with Python and [requests module](https://github.com/psf/requests).
## How it works?
Froxy uses the API available at [Proxy List](https://github.com/clarketm/proxy-list) and runs a filter to obtain only proxies and their information. Then it provides an interface to filter and use the filtered proxies.
### Why are you using this API?
- It free.
- No query limit.
- It has a variety of types of proxies.
- It has an interesting amount of proxies.
- It is updated daily.
Thank you for maintaining and making this API available [@clarketm](https://github.com/clarketm) ❤
## Install
install using pip:
```bash
$ pip install froxy
```
then, see the [demo](#demo) or [documentation](#doc) for more information.
## Demo
This is a demo use to get proxies with a filter:
```python
from froxy import Froxy
froxy = Froxy()
for proxy in froxy.https(): # Get proxies with protocol https
print(proxy)
# Output
['125.17.80.226', '8080', ['IN', 'H', 'S', '+']]
['31.204.180.44', '53281', ['RU', 'H', 'S', '-']]
['213.108.173.247', '8080', ['RU', 'N', 'S', '-']]
['109.169.151.131', '8080', ['RU', 'N', 'S', '+']]
['149.129.240.8', '8080', ['SG', 'N', 'S', '-']],
[...]
```
This a demo use with requests module:
```python
import requests
from froxy import Froxy
froxy = Froxy()
ip, port = froxy.http()[0][:2] # Get first proxy (IP and PORT)
proxies = {
"http": f'{ip}:{port}',
"https": f'{ip}:{port}'
}
r = requests.get('https://httpbin.org/ip', proxies=proxies)
print(f'Response: {r.json()}')
# Output
Response: {'origin': '103.250.69.233'}
```
### ⚠ Warning ⚠
**Not all proxies work, so try to use only those that work use `try...except` as a "filter"**
Basic example:
```python
import requests
from froxy import Froxy
froxy = Froxy()
for proxy in froxy.http():
ip, port = proxy[:2]
proxies = {
"http": f'{ip}:{port}',
"https": f'{ip}:{port}'
}
try:
r = requests.get('https://httpbin.org/ip', proxies=proxies)
print(f'Response: {r.json()}')
except Exception:
print('Fail, next...')
continue
# output
Response: {'origin': '103.250.69.233'}
Fail, next...
Fail, next...
Fail, next...
Fail, next...
Response: {'origin': '212.32.213.170'}
...
```
## Doc
Use `help` function for more information:
```python
>>> from froxy import Froxy
>>> help(Froxy)
```
### `froxy.Froxy`
A class for manipulating and filtering proxies.
All public method returns are made up of a list of lists in the following structure:
```python
# Structure
[
[ip_adress, port, [country_code, anonymity, http_or_https, google_passed]],
...
]
# Example:
[
['189.6.191.184', '8080', ['BR', 'N', 'S', '+']],
...
]
```
### `Froxy.country(...)`
Filter proxies for country.
See all codes at: [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)
Usage:
```python
>>> from froxy import Froxy
>>> froxy = Froxy()
>>> froxy.country('RS', 'US')
# Example output
[
['255.255.255.255', '3000', ['RS', 'N', 'S!', '-'],
['254.254.254.254', '8058', ['US', 'N', 'S!', '+'],
...
]
```
### `Froxy.anonymity(...)`
Filter proxies by anonymity level.
Usage:
```python
>>> from froxy import Froxy
>>> froxy = Froxy()
>>> froxy.anonymity('A', 'H')
# Example output
[
['255.255.255.255', '3000', ['RS', 'H', 'S!', '-'],
['254.254.254.254', '8058', ['US', 'A', 'S!', '+'],
...
]
```
### `Froxy.http(...)`
Filter proxies by http protocol.
Usage:
```python
>>> from froxy import Froxy
>>> froxy = Froxy()
>>> froxy.http()
# Example output
[
['255.255.255.255', '3000', ['AA', 'H', '!', '-'],
['254.254.254.254', '8058', ['ZZ', 'A', '', '+'],
...
]
```
### `Froxy.https(...)`
Filter proxies by https protocol.
Usage:
```python
>>> from froxy import Froxy
>>> froxy = Froxy()
>>> froxy.https()
# Example output
[
['255.255.255.255', '3000', ['AA', 'H', 'S!', '-'],
['254.254.254.254', '8058', ['ZZ', 'A', 'S', '+'],
...
]
```
### `Froxy.google(...)`
Filter proxies by google passed.
Usage:
```python
>>> from froxy import Froxy
>>> froxy = Froxy()
>>> froxy.google('+')
# Example output
[
['255.255.255.255', '3000', ['AA', 'H', 'S!', '+'],
['254.254.254.254', '8058', ['YY', 'N', '', '+'],
...
]
```
### `Froxy.get(...)`
Use multiple proxy filters or get all proxies if the filter arguments are empty.
Usage:
```python
>>> from froxy import Froxy
>>> froxy = Froxy()
>>> froxy.get(
country=[1, 'US', 'BR'],
anonymity=[2, 'H'],
protocol=[2, 'https'],
google_passed=[1, '+']
)
# Example output
[
['255.255.255.255', '3000', ['US', 'H', 'S!', '+'],
['254.254.254.254', '8058', ['BR', 'A', 'S', '+'],
['254.254.254.253', '6000', ['TT', 'H', '', '-'],
['254.254.254.252', '4058', ['BR', 'H', '!', '-'],
['255.255.255.251', '3000', ['RS', 'H', 'S', '-'],
['254.254.254.250', '7058', ['ZZ', 'H', 'S!', '-'],
['254.254.254.250', '7058', ['YY', 'N', '', '+']
]
```
Use `help` function for more information or visit repository of [API](https://github.com/clarketm/proxy-list) for more details.
## Contributions
All contributions are welcome!
Found a problem, want to give a tip? open an [issue](https://github.com/matheusfelipeog/froxy/issues).
Do you have a solution to the problem? Send me a PR.
Did you like this project? Click on the little star 😄
## License
This project is using the MIT license, see in [MIT LICENSE](./LICENSE).
For more information on the API used, visit [clarketm/proxy-list](https://github.com/clarketm/proxy-list).
نیازمندی
| مقدار | نام |
|---|---|
| - | requests |
زبان مورد نیاز
| مقدار | نام |
|---|---|
| >=3.6 | Python |
نحوه نصب
نصب پکیج whl froxy-1.0.5:
pip install froxy-1.0.5.whl
نصب پکیج tar.gz froxy-1.0.5:
pip install froxy-1.0.5.tar.gz