Metadata-Version: 2.1
Name: py-proxy
Version: 0.2.6
Summary: A proxy library for python 3
Home-page: https://github.com/HOWZ1T/py_proxy
Author: HOWZ1T
Author-email: dylan.d.randall@gmail.com
License: MIT License
Project-URL: Bug Reports, https://github.com/HOWZ1T/py_proxy/issues
Project-URL: Source, https://github.com/HOWZ1T/py_proxy
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Internet :: Proxy Servers
Description-Content-Type: text/markdown
Requires-Dist: requests
Requires-Dist: beautifulsoup4

# py_proxy
Python proxy manager. <br>
Please use diligently and respectfully. <br>
Always respect a website's ROBOTS.txt <br>

## compatibility
This library is compatible with python 3

## dependencies
This library is dependant on:
- requests
- beautifulsoup4

## install
```bash
pip install py_proxy
```

## Features
- Automatically fetches up to 80 proxies
- Cycle between proxies easily
- Test a proxy and get details about the proxy
- Validate all fetched proxies concurrently
- Format proxies for use with requests library

## Examples
```python
from proxy import Proxy

proxy = Proxy()

# getting the current proxy
cur_proxy = proxy.proxy

# testing the current proxy
res = proxy.test_proxy(cur_proxy)

if res == 1:
	print("success!")
else:
	print("failure!")

# cycling the proxy to a new proxy from the pool
proxy.cycle()

# filtering proxies by a country code
proxy = Proxy("US") #gets US only proxies from the pool

# automatically validating proxies after fetching them
proxy = Proxy(validate_proxies=True)

# format a proxy for use with requests library
ip = "100.100.100.100" #example ip, not real
port = "1989" #example port, not real
addr = [ip, port]
proxies = proxy.format_proxy(addr) #returns the requests proxies dictionary

# validating all proxies concurrently
proxy.validate_proxies()

# cycling through valid only proxies
proxy.cycle(valid_only=True)
```

## License
You're free to use this package which is licensed under the [MIT-LICENSE](LICENSE)

## Contributing
Contribution is always appreciated. <br>
If you are contributing please remember to update the README. <br>
If your contribution is accepted you will be credited for it.

## Original Author
[Dylan Randall aka HOWZ1T](https://github.com/howz1t)

## Contributors
[Berkkarahan](https://github.com/berkkarahan) - added multi-thread proxy validation


