Skip to main content

A Python module and CLI tool that returns IP address ownership and location information based on MaxMind’s GeoLite2 databases

usage: geoip          [-h] [-d DATABASE_DIRECTORY] [-v]
                      ip_address [ip_address ...]

positional arguments:
  ip_address            One or more IP addresses to look up

optional arguments:
  -h, --help            show this help message and exit
  -d DATABASE_DIRECTORY, --database-directory DATABASE_DIRECTORY
                        Overrides the path to the directory containing MaxMind
                        databases
  -v, --version         show program's version number and exit

Prerequisites

In order to use simplegeoip2, you must have the MaxMind GeoLite2 databases on your system. This simplest way to do this is to use the geoipupdate tool from MaxMind.

https://github.com/maxmind/geoipupdate

Installation

While this script should work under Python 2 and 3, using Python 3 for your OS is strongly recommended.

On Debian or Ubuntu systems, run:

$ sudo apt-get install python3-pip

Python 3 installers for Windows and macOS can be found at https://www.python.org/downloads/

To install or upgrade to the latest stable release of checkdmarc on macOS or Linux, run

$ sudo pip3 -U install simplegeoip2

Or, install the latest development release directly from GitHub:

$ sudo pip3 -U install git+https://github.com/domainaware/simplegeoip2.git

Note to Windows users

On Windows, pip3 is pip, regardless if you installed Python 2 or 3. So on Windows, simply substitute pip as an administrator in place of sudo pip3, in the above commands.

Bug reports

Please report bugs on the GitHub issue tracker

https://github.com/domainaware/simplegeoip/issues

Metadata

Release files for simplegeoip2 1.0.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for simplegeoip2 1.0.2
File Interpreter ABI Platform Actions
simplegeoip2-1.0.2-py2.py3-none-any.whl Python 3, Python 2 none any Details for simplegeoip2-1.0.2-py2.py3-none-any.whl

Release files / simplegeoip2-1.0.2-py2.py3-none-any.whl

Download URL simplegeoip2-1.0.2-py2.py3-none-any.whl
Size 5.7 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
a7b3c2b480ed323b5b3cfd2d47469dc4058d23b5a88a2b94c103df87e9e2368a
BLAKE2b-256 checksum
How to use checksums
1c6c1e0d644a0735e54a32583aa1f3fb4f2e11d4c5fe2b6f8874af22c1142c9b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Security for simplegeoip2 1.0.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.0.2 This release

1 release file No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page