ph4-python-whois

Whois querying and parsing of domain registration information.


Keywords
whois, python
License
MIT
Install
pip install ph4-python-whois==0.6.8

Documentation

Whois Python lib

This project has been forked from the https://bitbucket.org/richardpenman/pywhois

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

>>> import ph4whois
>>> w = ph4whois.whois('webscraping.com')
>>> w.expiration_date  # dates converted to datetime object
datetime.datetime(2013, 6, 26, 0, 0)
>>> w.text  # the content downloaded from whois server
u'\nWhois Server Version 2.0\n\nDomain names in the .com and .net
...'

>>> print w  # print values of all found attributes
creation_date: 2004-06-26 00:00:00
domain_name: [u'WEBSCRAPING.COM', u'WEBSCRAPING.COM']
emails: [u'WEBSCRAPING.COM@domainsbyproxy.com', u'WEBSCRAPING.COM@domainsbyproxy.com']
expiration_date: 2013-06-26 00:00:00
...

Install

Install from pypi:

pip install ph4-python-whois

Or checkout latest version from repository:

git clone https://github.com/ph4r05/python-whois.git

Original repo of the fork

Note that then you will need to manually install the futures module, which allows supporting both Python 2 & 3:

pip install futures

Changelog

0.6 - 2016-03-02:

  • support added for python 3
  • updated TLD list

0.5 - 2015-09-05:

  • added native client, which now handles whois requests by default
  • added pretty formatting to string representation
  • return None instead of raising KeyError when an attribute does not exist
  • new TLD's: .mobi, .io, .kg, .su, .biz

0.4 - 2015-08-13:

  • new TLD's: .de, .nl, .ca, .be
  • migrated to bitbucket
  • added socket timeout

0.3 - 2015-03-31:

  • improved datetime parsing with python-dateutil when available
  • base WhoisEntry class inherits from dict
  • fixed TLD's: .org, .info

Contact

You can post ideas or patches here: https://bitbucket.org/richardpenman/pywhois/issues

Thanks to the many who have sent patches for additional domains!