Metadata-Version: 2.1
Name: python-whois
Version: 0.9.3
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
Keywords: whois,python
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 :: 3
License-File: LICENSE.txt

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.


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

.. sourcecode:: bash

    $ pip install -r requirements.txt

Run test cases:

.. sourcecode:: bash

    $ python -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)
