Metadata-Version: 2.1
Name: python-whois
Version: 0.8.0
Summary: Whois querying and parsing of domain registration information.
Home-page: https://github.com/richardpenman/whois
Author: Richard Penman
Author-email: richard.penman@gmail.com
License: MIT
Description: Goal
        ====
        
        -  Create a simple importable Python module which will produce parsed
           WHOIS data for a given domain.
        -  Able to extract data for all the popular TLDs (com, org, net, ...)
        -  Query a WHOIS server directly instead of going through an
           intermediate web service like many others do.
        -  Works with Python 2 & 3
        
        
        
        Example
        =======
        
        .. sourcecode:: bash
        
            >>> import whois
            >>> w = whois.whois('example.com')
            >>> w.expiration_date  # dates converted to datetime object
            datetime.datetime(2022, 8, 13, 4, 0)
            >>> w.text  # the content downloaded from whois server
            u'\nDomain Name: EXAMPLE.COM
            Registry Domain ID: 2336799_DOMAIN_COM-VRSN
            ...'
        
            >>> print w  # print values of all found attributes    
            {
                "creation_date": "1995-08-14 04:00:00",
                "expiration_date": "2022-08-13 04:00:00",
                "updated_date": "2021-08-14 07:01:44",
                "domain_name": "EXAMPLE.COM",
                "name_servers": [
                    "A.IANA-SERVERS.NET",
                    "B.IANA-SERVERS.NET"
                ],
            ...
        
        
        Install
        =======
        
        Install from pypi:
        
        .. sourcecode:: bash
        
            $ pip install python-whois
        
        Or checkout latest version from repository:
        
        .. sourcecode:: bash
        
            $ git clone git@github.com:richardpenman/whois.git
        
        Note that then you will need to manually install the futures module, which allows supporting both Python 2 & 3:
        
        
        .. sourcecode:: bash
        
            $ pip install futures
        
        Run test cases for python 2 & 3:
        
        .. sourcecode:: bash
        
            $ python -m unittest discover test
            .............
            ----------------------------------------------------------------------
            Ran 13 tests in 0.812s
            
            OK
            
            $ python3 -m unittest discover test
            .............
            ----------------------------------------------------------------------
            Ran 13 tests in 1.431s
            
            OK
        
        SOCKS Proxy support requirements:
        
        .. sourcecode:: bash
        
            $ pip install PySocks
            ............
            ---------------------------------------------------------------------
            $ export SOCKS=socksproxy.someplace.com:8080
        
        
        Problems?
        =========
        
        Pull requests are welcome! 
        
        Thanks to the many who have sent patches for additional TLDs. If you want to add or fix a TLD it's quite straightforward. 
        See example domains in `whois/parser.py <https://github.com/richardpenman/whois/blob/master/whois/parser.py>`_
        
        Basically each TLD has a similar format to the following:
        
        .. sourcecode:: python
        
            class WhoisOrg(WhoisEntry):
            """Whois parser for .org domains
            """
            regex = {
                'domain_name':      'Domain Name: *(.+)',
                'registrar':        'Registrar: *(.+)',
                'whois_server':     'Whois Server: *(.+)',
                ...
            }
        
            def __init__(self, domain, text):
                if text.strip() == 'NOT FOUND':
                    raise PywhoisError(text)
                else:
                    WhoisEntry.__init__(self, domain, text)
        
Keywords: whois,python
Platform: UNKNOWN
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 3
Provides-Extra: better date conversion
