Skip to content

Latest commit

 

History

History
70 lines (51 loc) · 1.95 KB

README.md

File metadata and controls

70 lines (51 loc) · 1.95 KB


random_proxies

Python package to generate a random proxy on the fly!

Features

  • Supports HTTP, HTTPS or SOCKS proxy.

Currently support SOCKS over HTTP only with version 4.

  • Fetch specific country proxy by using country name or country code.
  • Fetch elite / transparent / anonymous proxies respectively.
  • Fetch directly from free-proxy-list.
  • For better response time, fetch from an elasticsearch cache_server.
  • cache_server is updated via routines described here

Example usage

  pip install random-proxies

or

  $ git clone https://github.com/2knal/random_proxies.git`
  $ cd random_proxies/ 
  $ pip install -r requirements.txt 

Open python interpreter. (Supports version 3.7+)

>>> from random_proxies import random_proxy
>>> random_proxy()
'23.101.2.247:81'

Refer more examples here

TODO

  • Port to MongoDB
  • Publish package version 0.0.2
  • Return meta data, response structure found here
  • Scrape proxies from other sources
  • Add support for SOCKS version 5
  • Implement REST API to allow other languages to interface with it
  • Setup documentation page
  • Add unit tests

Contributing

  • We are open to enhancements & bug-fixes 😊. Take a look here to get started
  • Feel free to add issues and submit patches

Author

Kunal Sonawane - 2knal


License

This project is licensed under the MIT - see the LICENSE file for details.