Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ricerati/proxy-checker-python
Proxy checker in Python
https://github.com/ricerati/proxy-checker-python
proxy-checker pycurl python
Last synced: about 2 months ago
JSON representation
Proxy checker in Python
- Host: GitHub
- URL: https://github.com/ricerati/proxy-checker-python
- Owner: ricerati
- License: mit
- Created: 2019-12-28T20:02:45.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2022-06-30T23:18:33.000Z (over 2 years ago)
- Last Synced: 2024-10-28T22:57:07.834Z (2 months ago)
- Topics: proxy-checker, pycurl, python
- Language: Python
- Homepage: https://pypi.org/project/proxy-checker/
- Size: 20.5 KB
- Stars: 53
- Watchers: 4
- Forks: 23
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
- awesome - ricerati/proxy-checker-python - Proxy checker in Python (Python)
README
# Proxy Checker (Python)
[](https://pepy.tech/project/proxy-checker)
A proxy checker in Python using PycURL, a Python interface to libcurl.
## Description
The proxy checker takes a proxy as input and uses it to send a request to a proxy judge (a website that outputs the information that was sent to it). If the request succeeds, the proxy checker will use the information it receives from the proxy judge to determine the proxy's:
- Country
- Protocol
- Anonymity
- Speed
## Installation
```console
pip install proxy-checker
```
## Usage
```python3
from proxy_checker import ProxyChecker
checker = ProxyChecker()
checker.check_proxy(':')
```
```json
{
"country": "United States",
"country_code": "US",
"protocols": ["socks4", "socks5"],
"anonymity": "Elite",
"timeout": 1649
}
```
## Parameters
| Name | Type | Default | Description |
| ------------- | ---- | ------- | ---------------------------------------------------- |
| proxy | str | | The proxy to test |
| check_country | bool | True | If `true`, the proxy's country will be looked up |
| check_address | bool | False | If `true`, the proxy's remote address will looked up |
| user | str | None | The proxy's username |
| password | str | None | The proxy's password |
## Requirements
- Python 3.\*
- [PycURL](http://pycurl.io/) - A Python interface to libcurl \*
###### \* If you have trouble installing PycURL on Windows, try to use Christoph Gohlke's collection of [Python Extension Package for Windows](https://www.lfd.uci.edu/~gohlke/pythonlibs/#pycurl).
## Contributing
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
Please make sure to update tests as appropriate.
## License
[MIT](LICENSE.md)