Metadata-Version: 2.1
Name: geoip2nation
Version: 0.2.7
Summary: Convert ip addresses to a country using ip2nation db in memory.
Home-page: http://pypi.python.org/pypi/geoip2nation/
Author: Avi Asher
Author-email: aviasher@outlook.com
License: MIT
Description: ===========
        Geo IP
        ===========
        
        Provides a fast, seamless in memory ip to country functionality based on the ip2nation db.
        - No dependencies
        - Completely free
        - Country resolution only
        - Queries / sec > 13.5k per core
        - Data file can be refreshed without a restart
        - Memory footprint < 40 MB
        - Command line
        - Stream / pipe ips and get comma delimited [ip,2 letter country code] e.g. 12.12.12.12,US
        
        
        Change log:
        - If you upgrade please note that there is a BREAKING CHANGE geoip module was renamed to xgeoip
        - Supports Python 2.7 / 3.x
        - ip2nation file updated to May 2020 version
        
        ```python
        #Python 2.7 / Python 3.x
        from geoip import xgeoip
        r = xgeoip.GeoIp()
        r.load_memory()
        r.resolve("12.12.12.12").country_code
        #This prints : 'US'
        
        print (r.resolve("123.44.57.4"))
        #This prints : {'country': 'Korea (South)', 'host_name': '', 'country_code': 'KR'}
        
        r.resolve2("133.12.12.12")
        #This prints : 'JP'
        ```
        
        Command line
        =========
        package usage: python geoip/xgeoip.py resolve 1.1.1.1
        {'country_code': 'AU', 'country': 'Australia', 'host_name': ''}
        
        source usage: python xgeoip.py [-h] [-v] {download,resolve} ...
        
        positional arguments:
          {download,resolve}
        
        optional arguments:
          -h, --help          show this help message and exit
          -v, --verbose       increase output verbosity
        
        
        usage: geoip.py resolve [-h] [-ho] [-s] [--stream] ip
        
        positional arguments:
          ip           The ip address to get the country for
        
        optional arguments:
          -h, --help   show this help message and exit
          -ho, --host  When set to true the code will try to get the host name
          -s, --short  When set to true the code will return a 2 letter country code
                       only
          --stream     When set to true the code expect a stream of ips
        
        usage: geoip.py download [-h]
        
        optional arguments:
          -h, --help  show this help message and exit
        
        
        Installation
        =========
        
        pip install geoip2nation
        
        PyPI: https://pypi.python.org/pypi/geoip2nation/
        
        Github: https://github.com/avindak/python-geo-ip
        
        ip2nation
        =========
        
        * Data can be downloaded using the download method
        
        * The load_memory method loads the ip2nation sql data file from disk into an in memory sqlite3 db
        
        license
        ========
        MIT
        
        Links
        ========
        
        * ip2nation home: http://ip2nation.com/
        * ip2nation data file: http://www.ip2nation.com/ip2nation.zip
        
Platform: UNKNOWN
Description-Content-Type: text/markdown
