Metadata-Version: 1.1
Name: ipwhois
Version: 0.1.3
Summary: IP Whois Resolution and Parsing
Home-page: https://github.com/secynic/ipwhois
Author: Philip Hane
Author-email: secynic AT gmail DOT com
License: Copyright (c) 2013, Philip Hane
All rights reserved.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met: 

1. Redistributions of source code must retain the above copyright notice, this
   list of conditions and the following disclaimer. 
2. Redistributions in binary form must reproduce the above copyright notice,
   this list of conditions and the following disclaimer in the documentation
   and/or other materials provided with the distribution. 

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
Download-URL: https://github.com/secynic/ipwhois/tarball/master
Description: =======
        ipwhois
        =======
        
        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::
        
            >>>> import ipwhois
            >>>> from pprint import pprint
            
            >>>> obj = ipwhois.IPWhois("74.125.225.229")
            >>>> results = obj.lookup(False)
            >>>> pprint(results)
            
            {
            'asn': '15169',
        	'asn_cidr': '74.125.225.0/24',
        	'asn_country_code': 'US',
        	'asn_date': '2007-03-13',
        	'asn_registry': 'arin',
        	'nets': [{'cidr': '74.125.0.0/16',
        	          'city': 'Mountain View',
        	          'country': 'US',
        	          'description': 'Google Inc.',
        	          'name': 'GOOGLE',
        	          'state': 'CA'}],
        	'query': '74.125.225.229',
        	'raw': None
        	}
        	
        Countries::
        
        	>>>> import ipwhois
        	
        	>>>> countries = ipwhois.get_countries()
        	>>>> obj = ipwhois.IPWhois("74.125.225.229")
        	>>>> results = obj.lookup(False)
        	>>>> print(countries[results['nets'][0]['country']])
        
        	United States
        	
        Parsing
        =======
        
        Parsing is currently limited to CIDR, country, description, name, and state 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'.
        
        Future Plans
        ============
        
        IPWhois.httplookup() - Allow parsing of Whois data via RWS feeds from the various NICs. This feature is useful when outbound port 43 is not available. Only ARIN and RIPE have Whois-RWS services at the time of this writing. Although RIPE does have a feature that integrates the other NICs, they are limited on the types of information that is allowed to be displayed. Additionally, as part of this feature, proxy support will also be added.
        
        Changelog
        =========
        
        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.
Keywords: Python,WHOIS,ASN,IP Address,IP,IPv4,IPv6,IETF
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.3
Classifier: Topic :: Internet
Classifier: Topic :: Software Development
