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
Description: # 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
        
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
