iivanoo / python-whois Goto Github PK

whois
=====
A Python package for retrieving WHOIS information of domains.

Features
=============
 * Python wrapper for Linux "whois" command
 * simple interface to access parsed WHOIS data for a given domain
 * able to extract data for all the popular TLDs (com, org, net, biz, info, pl, jp, uk, nz,  ...)
 * query a WHOIS server directly instead of going through an intermediate web service like many others do
 * works with Python 2.4+ and Python 3.x
 * all dates as datetime objects
 * possibility to cache results

Help Wanted
===========
You contributions are welcome , look for the Help wanted tag https://github.com/DannyCork/python-whois/labels/help%20wanted

Usage example
=============

Install `whois` package from your distribution (e.g apt install whois)

$pip install whois

>>> import whois
>>> domain = whois.query('google.com')

>>> print(domain.__dict__)
{
	'expiration_date': datetime.datetime(2020, 9, 14, 0, 0),
	'last_updated': datetime.datetime(2011, 7, 20, 0, 0),
	'registrar': 'MARKMONITOR INC.',
	'name': 'google.com',
	'creation_date': datetime.datetime(1997, 9, 15, 0, 0)
}

>>> print(domain.name)
google.com

>>> print(domain.expiration_date)
2020-09-14 00:00:00


ccTLD & TLD support
===================
ccTLD
- uz
- ac.uk
- ar
- at
- be
- br
- ca
- co
- co.jp
- cl
- cn
- cz
- de
- eu
- fr
- it
- ir
- jp
- kr
- lv
- lt
- mx
- nz
- pl
- ru
- uk
- us
- mx
- br
- sh
- id
- tv
- cc
- nyc
- pw
- рф (xn--p1ai)
- in

TLD
- download
- biz
- edu
- education
- com
- download
- info
- me
- mobi
- name
- net
- ninja
- nyc
- online
- org
- io
- xyz
- tel
- online
- wiki
- press
- pharmacy
- rest
- security
- site
- space
- store
- tech
- tel
- theatre
- tickets
- video
- website
- club

Issues
=============
Raise an issue https://github.com/DannyCork/python-whois/issues/new


Support
=======
Python 3.x supported. Should work on Python 2.x but not supported.