ipwhois 0.1.8

IP Whois Resolution and Parsing

ipwhois is a simple package for retrieving and parsing whois data for IPv4 and IPv6 addresses. This code was quickly thrown together to demonstrate functionality, and is by no means optimized or fully featured.

This version requires Python 3.3+ (for the ipaddress library) and dnspython3. Other Python version support is planned.

Usage Examples

Typical usage:

>>>> from ipwhois import IPWhois
>>>> from pprint import pprint

>>>> obj = IPWhois('74.125.225.229')
>>>> results = obj.lookup()
>>>> pprint(results)

{
'asn': '15169',
'asn_cidr': '74.125.225.0/24',
'asn_country_code': 'US',
'asn_date': '2007-03-13',
'asn_registry': 'arin',
'nets': [{'address': '1600 Amphitheatre Parkway',
          'cidr': '74.125.0.0/16',
          'city': 'Mountain View',
          'country': 'US',
          'description': 'Google Inc.',
          'name': 'GOOGLE',
          'postal_code': '94043',
          'state': 'CA'}],
'query': '74.125.225.229',
'raw': None
}

REST (HTTP):

>>>> from ipwhois import IPWhois
>>>> from pprint import pprint

>>>> obj = IPWhois('74.125.225.229')
>>>> results = obj.lookup_rws()
>>>> pprint(results)

{
'asn': '15169',
'asn_cidr': '74.125.225.0/24',
'asn_country_code': 'US',
'asn_date': '2007-03-13',
'asn_registry': 'arin',
'nets': [{'address': '1600 Amphitheatre Parkway',
          'cidr': '74.125.0.0/16',
          'city': 'Mountain View',
          'country': 'US',
          'description': 'Google Inc.',
          'name': 'GOOGLE',
          'postal_code': '94043',
          'state': 'CA'}],
'query': '74.125.225.229',
'raw': None
}

Proxy:

>>>> from urllib import request
>>>> from ipwhois import IPWhois
>>>> handler = request.ProxyHandler({'http': 'http://192.168.0.1:80/'})
>>>> opener = request.build_opener(handler)
>>>> obj = IPWhois('74.125.225.229', proxy_opener = opener)

Hostname:

>>>> from ipwhois import IPWhois
>>>> from pprint import pprint

>>>> obj = IPWhois('74.125.225.229')
>>>> results = obj.get_host()
>>>> pprint(results)

('dfw06s26-in-f5.1e100.net', [], ['74.125.225.229'])

Countries:

>>>> from ipwhois import IPWhois
>>>> from ipwhois.utils import get_countries

>>>> countries = get_countries()
>>>> obj = IPWhois('74.125.225.229')
>>>> results = obj.lookup(False)
>>>> print(countries[results['nets'][0]['country']])

United States

Installing

Latest version from PyPi:

pip install ipwhois

Latest version from GitHub:

pip install -e git+https://github.com/secynic/ipwhois@master#egg=ipwhois

Parsing

Parsing is currently limited to CIDR, country, name, description, state, city, address, and postal_code fields. This is assuming that those fields are present.

Some IPs have parent networks listed. The parser attempts to recognize this, and break the networks into individual dictionaries. If a single network has multiple CIDRs, they will be separated by ‘, ‘.

Sometimes, you will see whois information with multiple consecutive same name fields, e.g., Description: some text\nDescription: more text. The parser will recognize this and the returned result will have these separated by ‘\n’.

REST (HTTP)

IPWhois.lookup_rws() should be faster than IPWhois.lookup(), but may not be as reliable. APNIC, LACNIC, and AFRINIC do not have a Whois-RWS service yet. We have to rely on the Ripe RWS service, which does not contain all of the data we need.

Changelog

0.1.8 (2013-09-17)

• Removed set_proxy() in favor of having the user provide their own urllib.request.OpenerDirector instance as a parameter to IPWhois().

• Restructured package in favor of modularity. get_countries() is now located in ipwhois.utils.

• Added exception WhoisLookupError for IPWhois.lookup() and IPWhois.lookup_rws().

0.1.7 (2013-09-16)

• Fixed bug in set_proxy().

• Removed ARIN top level network entries from return dictionary of IPWhois.lookup_rws().

• Fixed bug in ARIN RWS parsing when only one network.

0.1.6 (2013-09-16)

• Added IPWhois.get_host() to resolve hostname information.

• Added address and postal_code fields to parsed results.

• Normalized single/double quote use.

0.1.5 (2013-09-13)

• Added set_proxy() function for proxy support in Whois-RWS queries.

• Added IPWhois.lookup_rws() function for Whois-RWS queries.

0.1.4 (2013-09-12)

• Added validity checks for the asn_registry value due to a bug in the Team Cymru ASN lookup over night.

• Added timeout argument to IPWhois(). This is the default timeout in seconds for socket connections.

• Fixed decoding issue in IPWhois.get_whois().

0.1.3 (2013-09-11)

• Added exception handling with query retry support for socket errors, timeouts, connection resets.

• Moved ASN queries to their own functions (IPWhois.get_asn_dns() and IPWhois.get_asn_whois())

• Moved whois query to its own function (IPWhois.get_whois())

• Country codes are now forced as upper case in the return dictionary.

0.1.2 (2013-09-10)

• Fixed file path for get_countries().

• Fixed variable names that conflicted with builtins.

• Added content to README.

• Moved CHANGES.txt to CHANGES.rst and added to setup.py.

• Download URL now points to GitHub master tarball.

0.1.1 (2013-09-09)

• Fixed README issue.

0.1.0 (2013-09-06)

• Initial release.