types-maxminddb

What it is and what it does

types-maxminddb is a PEP 561 type stub package that provides type information for the maxminddb library. It allows static type checkers like mypy, PyCharm, and pytype to understand and validate the types of maxminddb's API, catching type errors at development time rather than runtime.

The package is maintained as part of typeshed. The description notes that maxminddb has shipped its own type annotations since version 2.0.2, so installing this stub package may be unnecessary if you are already using that version or later of maxminddb itself.

Use it for:

• Enable type checkers to validate code that calls maxminddb functions for IP geolocation queries.
• Provide IDE autocomplete and type hints when working with maxminddb APIs.
• Catch type mismatches in geolocation lookup code before runtime in CI/CD pipelines.
• Support maxminddb versions that lack built-in type annotations.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides type stubs for the maxminddb package, enabling static type checkers like mypy and PyCharm to validate code using maxminddb.

Yes, if you are using maxminddb versions before 2.0.2 and rely on static type checking. No, if you are already on maxminddb 2.0.2 or later, since maxminddb itself now includes type annotations. Check your maxminddb version first to avoid redundant installation.

Install

types-maxminddb on PyPI

pip install types-maxminddb

uv add types-maxminddb

poetry add types-maxminddb

Installing types-maxminddb

Before you install

Low install friction with a single lightweight runtime dependency (types-ipaddress). The package is actively maintained via typeshed, though the latest release is from 2021-09-20.

License in practice

Licensed under Apache-2.0 (permissive), allowing use in most commercial and open-source projects without significant restriction.

Quickstart

pip install types-maxminddb

import maxminddb
# Type checker now understands maxminddb API types

Verify before relying

• Whether maxminddb version 2.0.2 or later is already installed (stub package may be unnecessary in that case)
• Current maintenance status relative to typeshed's active development cycle

Package facts

Evidence: types_maxminddb-1.5.0-py3-none-any.whl

Tags

More Software Development packages