Skip to main content

iptocc

PyPI Python License

Python bindings for the iptocc Rust crate. Offline IPv4 and IPv6 to ISO 3166-1 alpha-2 country code lookup.

Note: Country codes reflect the country assigned by a Regional Internet Registry (RIR) to each IP block, not where the block is being used. RIR data agrees with MaxMind for ~95% of IPv4 addresses and has minimal discrepancies for IPv6 (Zander, 2012).

Important: iptocc 3.0 is a complete Rust rewrite. Versions 2.x and earlier were pure Python on top of pandas. The public API stays mostly compatible (see migration notes below), single-lookup latency dropped from ~78 ms to ~44-141 ns, and a batch API was added.

Features

  • Offline lookup, no API keys, no network calls
  • IPv4 and IPv6 in one call
  • Single string OR batch (any iterable of strings)
  • Lookup data embedded in the wheel; no runtime file I/O
  • iptocc CLI installed with pip install iptocc
  • Data refreshed nightly from the five Regional Internet Registries

Install

Requires Python 3.10 or newer.

pip install iptocc

Usage

from iptocc import country_code

country_code("8.8.8.8")                       # "US"
country_code(["8.8.8.8", "1.0.16.1"])         # ["US", "JP"]

A CLI is installed alongside the library:

$ iptocc 8.8.8.8 1.0.16.1
8.8.8.8 US
1.0.16.1 JP

Migrating from 2.x

# 2.x
from iptocc import get_country_code, CountryCodeNotFound
try:
    cc = get_country_code("8.8.8.8")
except CountryCodeNotFound:
    cc = None

# 3.x
from iptocc import country_code
cc = country_code("8.8.8.8")  # returns None on miss

See also

Metadata

Release files for iptocc 3.3.185

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

Source distribution (sdist)

Source distribution for iptocc 3.3.185
File Size Uploaded Provenance Actions
iptocc-3.3.185.tar.gz 449.3 kB With provenance Details for iptocc-3.3.185.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for iptocc 3.3.185
File Actions
iptocc-3.3.185-cp310-abi3-win_amd64.whl CPython 3.10 abi3 Windows x86-64 Details for iptocc-3.3.185-cp310-abi3-win_amd64.whl
iptocc-3.3.185-cp310-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl CPython 3.10 abi3 Linux glibc 2.17+ x86-64 Details for iptocc-3.3.185-cp310-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
iptocc-3.3.185-cp310-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl CPython 3.10 abi3 Linux glibc 2.17+ ARM64 Details for iptocc-3.3.185-cp310-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
iptocc-3.3.185-cp310-abi3-macosx_11_0_arm64.whl CPython 3.10 abi3 macOS 11.0+ ARM64 Details for iptocc-3.3.185-cp310-abi3-macosx_11_0_arm64.whl
iptocc-3.3.185-cp310-abi3-macosx_10_12_x86_64.whl CPython 3.10 abi3 macOS 10.12+ x86-64 Details for iptocc-3.3.185-cp310-abi3-macosx_10_12_x86_64.whl

Total release size: 3.5 MB

Release files / iptocc-3.3.185.tar.gz

Download URL iptocc-3.3.185.tar.gz
Size 449.3 kB
Tags Source
SHA-256 checksum
How to use checksums
27f87323e7f1277d973aa757902a6841e8fc0b1a5fee56e44202f20ef4eec222
BLAKE2b-256 checksum
How to use checksums
5264c4eee95d70bf6a7230ab084e490b16bac8b5eb01bd4d61131efadf013bd2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 13, 2026.

Transparency log

Release files / iptocc-3.3.185-cp310-abi3-win_amd64.whl

Download URL iptocc-3.3.185-cp310-abi3-win_amd64.whl
Size 523.7 kB
Tags CPython 3.10 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
d6c949cffc8d5c0abdf2d8499686795590fbfc7caf4b2dc0d16757d1d27d0f13
BLAKE2b-256 checksum
How to use checksums
9e2211131b8829868f7aeb0355f2c8ee56c8cdde7318e62f54521f81043ee5d0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 13, 2026.

Transparency log

Release files / iptocc-3.3.185-cp310-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl

Download URL iptocc-3.3.185-cp310-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
Size 629.9 kB
Tags CPython 3.10 Linux glibc 2.17+ x86-64 abi3
SHA-256 checksum
How to use checksums
ea5524778c485b19ca631c0dcc98ec96c139f98cf2ea99af357355ad07152b90
BLAKE2b-256 checksum
How to use checksums
2d3b66fcda38d2f24cbe559e86ef7c90603c34296714b53dfbd13089437996b0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 13, 2026.

Transparency log

Release files / iptocc-3.3.185-cp310-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl

Download URL iptocc-3.3.185-cp310-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
Size 630.2 kB
Tags CPython 3.10 Linux glibc 2.17+ ARM64 abi3
SHA-256 checksum
How to use checksums
6edfccb0929700ec4d308af07e65ec79fe03d8fe3b93fcf10d5f50d980429163
BLAKE2b-256 checksum
How to use checksums
8014d3aa9ed18fb8dc8911c5139ff8f8f3d85f6f7b7b10c37b7f452a894abe10
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 13, 2026.

Transparency log

Release files / iptocc-3.3.185-cp310-abi3-macosx_11_0_arm64.whl

Download URL iptocc-3.3.185-cp310-abi3-macosx_11_0_arm64.whl
Size 622.4 kB
Tags CPython 3.10 abi3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
930fcf3d1550ad2b4cf4f46c9d23809ecf13254e69ae3338fb2c3ef23684c8bb
BLAKE2b-256 checksum
How to use checksums
6e208b8fea4823dfac9ad2271976583a2390260d7ad219d7c85e827c66ad1a38
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 13, 2026.

Transparency log

Release files / iptocc-3.3.185-cp310-abi3-macosx_10_12_x86_64.whl

Download URL iptocc-3.3.185-cp310-abi3-macosx_10_12_x86_64.whl
Size 622.5 kB
Tags CPython 3.10 abi3 macOS 10.12+ x86-64
SHA-256 checksum
How to use checksums
eb18f1b96ab5028d99d5416f8e91707090ce10cb2f3c231692473428ab6f53c3
BLAKE2b-256 checksum
How to use checksums
b6fdba98a19555b22d1071453fceda0680b6bd40ea24e20e9ab13bc2860b03a7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 13, 2026.

Transparency log

Security for iptocc 3.3.185

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.

Full provenance

All 6 files in this release have been uploaded with provenance metadata.

Select from 6 files

Attestation for iptocc-3.3.185.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 13, 2026.

Transparency log

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

3.3.185 This release

6 release files Full 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