Skip to main content

Shell script and module for easy geoip lookups.

Project description

[![Build Status](https://travis-ci.org/Tethik/simplegeoip.svg?branch=master)](https://travis-ci.org/Tethik/simplegeoip) [![codecov](https://codecov.io/gh/Tethik/simplegeoip/branch/master/graph/badge.svg)](https://codecov.io/gh/Tethik/simplegeoip) [![PyPI version](https://badge.fury.io/py/simplegeoip.svg)](https://badge.fury.io/py/simplegeoip)

# simple-geoip
Dead simple geoip package. Pretty much just a wrapper around [maxminddb](https://github.com/maxmind/MaxMind-DB-Reader-python/)
that automatically downloads the geolite database for you. You can either do this manually using the 'download_latest_database' function
or let the script do it automatically when it detects no database is installed.

Can be used as a package or standalone script.

# Install
```bash
pip install simplegeoip
```

# Usage
As a python package.
```python
import simplegeoip

# Gets a dict with country/city information
simplegeoip.lookup('127.0.0.1')
# Downloads an updated database into simplegeoip's package directory
simplegeoip.download_latest_database()
# Tells you when the database was last updated by maxmind
simplegeoip.last_updated()
# Returns a maxminddb reader object with the database automatically downloaded.
simplegeoip.reader()
```

The same as above but as a standalone script
```bash
simplegeoip 8.8.8.8
simplegeoip update
simplegeoip info
```

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for simplegeoip, version 0.1.4
Filename, size File type Python version Upload date Hashes
Filename, size simplegeoip-0.1.4-py2.py3-none-any.whl (29.8 kB) File type Wheel Python version 3.5 Upload date Hashes View
Filename, size simplegeoip-0.1.4.tar.gz (28.3 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page