Metadata-Version: 2.1
Name: proxy-manager-g4
Version: 1.0.7
Summary: Proxy Manager
Home-page: https://github.com/Genzo4/proxy_manager
Author: Genzo
Author-email: genzo@bk.ru
License: MIT
Project-URL: Bug Tracker, https://github.com/Genzo4/proxy_manager/issues
Keywords: proxy,proxy_manager,manager,proxy-manager,proxymanager,g4
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Internet :: Proxy Servers
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE

# Proxy Manager

Proxy manager to download a list of proxy servers from the Internet with the required parameters 
(protocol and degree of anonymity) and work with loading servers (for example, getting a random
proxy servers from this list).

***

## Installation

### Package Installation from PyPi

```bash
$ pip3 install proxy-manager-g4
```

### Package Installation from Source Code

The source code is available on [GitHub](https://github.com/Genzo4/proxy_manager).  
Download and install the package.

```bash
$ git clone https://github.com/Genzo4/proxy_manager
$ cd proxy_manager
$ pip3 install .
```

***

## Basic usage

Import:
```python
from proxy_manager_g4 import ProxyManager
from proxy_manager_g4.consts import PROTOCOL_HTTPS
```

We create an instance of the proxy manager. At the same time, loading a list of proxy servers from the Internet 
with the required parameters (protocol and degree of anonymity).
```python
proxy_manager = ProxyManager(protocol=PROTOCOL_HTTPS, anonymity=True)
```

Get random proxy:
```python
proxy = proxy_manager.get_random()
```

When getting a random proxy server multiple times, proxy manager will track the number of uses of each
proxy for uniform delivery.  

Using the received proxy server:
```python
proxy.ip                # "1.2.3.4"
proxy.port              # 8080
proxy.get_ip_port()     # "1.2.3.4:8080"
print(proxy)            # "1.2.3.4:8080"
```

Usage example in file minitest.py

[Changelog](https://github.com/Genzo4/proxy_manager/blob/main/CHANGELOG.md)

***

P.S. The list of proxy servers is loaded from 
[https://github.com/fate0/proxylist/](https://github.com/fate0/proxylist/)  

***

# Proxy Manager

Прокси менеджер для загрузки из интернета списка прокси серверов с требуемыми параметрами 
(протокол и степень анонимности) и работы с загруженными серверами (например, получение случайного 
прокси-сервера из данного списка).

***

## Установка

### Установка пакета с PyPi

```bash
$ pip3 install proxy-manager-g4
```

### Установка пакета из исходного кода

Исходный код размещается на [GitHub](https://github.com/Genzo4/proxy_manager).  
Скачайте его и установите пакет:

```bash
$ git clone https://github.com/Genzo4/proxy_manager
$ cd proxy_manager
$ pip3 install .
```

***

## Использование

Подключаем:
```python
from proxy_manager_g4 import ProxyManager
from proxy_manager_g4.consts import PROTOCOL_HTTPS
```

Создаём экземпляр прокси менеджера. При этом происходит загрузка списка прокси-серверов из интернета 
с требуемыми параметрами: протокол и степень анонимности.
```python
proxy_manager = ProxyManager(protocol=PROTOCOL_HTTPS, anonymity=True)
```

Получение случайного прокси-сервера из списка:
```python
proxy = proxy_manager.get_random()
```
При многократном получении случайного прокси-сервера, прокси менеджер будет отслеживать количество использований 
каждого прокси для равномерной выдачи.  

Использование полученного прокси-сервера:
```python
proxy.ip                # "1.2.3.4"
proxy.port              # 8080
proxy.get_ip_port()     # "1.2.3.4:8080"
print(proxy)            # "1.2.3.4:8080"
```

Пример использования см. в файле minitest.py

[Changelog](https://github.com/Genzo4/proxy_manager/blob/main/CHANGELOG.md)

***

P.S. Пока загрузка списка прокси-серверов осуществляется с 
[https://github.com/fate0/proxylist/](https://github.com/fate0/proxylist/)  

