Whois querying and parsing of domain registration information.
Project 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.
Example
>>> 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:
$ pip install python-whois
Or checkout latest version from repository:
$ git clone git@github.com:richardpenman/whois.git
$ pip install -r requirements.txt
Run test cases:
$ python -m unittest discover test
.............
----------------------------------------------------------------------
Ran 13 tests in 1.431s
OK
SOCKS Proxy support requirements:
$ 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
Basically each TLD has a similar format to the following:
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)
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for python_whois-0.9.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | ff8a0a8f3d8630868c8d0f6561977a3614a70f95907ae151de63bfac1f82c313 |
|
MD5 | f81277c4501a9065f6e9dcf0d31d7fc5 |
|
BLAKE2b-256 | e4ffb89c831f6a5f829dc71ab7fa01be7150ce9c0d00c4855d2fcfb701a02c96 |