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.191

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.191
File Size Uploaded Provenance Actions
iptocc-3.3.191.tar.gz 449.6 kB With provenance Details for iptocc-3.3.191.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for iptocc 3.3.191
File Actions
iptocc-3.3.191-cp310-abi3-win_amd64.whl CPython 3.10 abi3 Windows x86-64 Details for iptocc-3.3.191-cp310-abi3-win_amd64.whl
iptocc-3.3.191-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.191-cp310-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
iptocc-3.3.191-cp310-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl CPython 3.10 abi3 Linux glibc 2.17+ ARM64 Details for iptocc-3.3.191-cp310-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
iptocc-3.3.191-cp310-abi3-macosx_11_0_arm64.whl CPython 3.10 abi3 macOS 11.0+ ARM64 Details for iptocc-3.3.191-cp310-abi3-macosx_11_0_arm64.whl
iptocc-3.3.191-cp310-abi3-macosx_10_12_x86_64.whl CPython 3.10 abi3 macOS 10.12+ x86-64 Details for iptocc-3.3.191-cp310-abi3-macosx_10_12_x86_64.whl

Total release size: 3.5 MB

Release files / iptocc-3.3.191.tar.gz

Download URL iptocc-3.3.191.tar.gz
Size 449.6 kB
Tags Source
SHA-256 checksum
How to use checksums
d46011db11644d2526416b7c3f31e680dec443032164736e0b1a58526e027ea8
BLAKE2b-256 checksum
How to use checksums
d91cde8f987a5390d4db6e36d88435b886fe702b127a23a93422464ee870dad1
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 19, 2026.

Transparency log

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

Download URL iptocc-3.3.191-cp310-abi3-win_amd64.whl
Size 524.2 kB
Tags CPython 3.10 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
469951fac84da07d1bca82fc89e7fb04d22180a25e5076ba1226f8e624187d04
BLAKE2b-256 checksum
How to use checksums
0cf44104c86117d65b6873f11e407632c75ab6c14064d8dd7b5eca164572486c
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 19, 2026.

Transparency log

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

Download URL iptocc-3.3.191-cp310-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
Size 630.3 kB
Tags CPython 3.10 Linux glibc 2.17+ x86-64 abi3
SHA-256 checksum
How to use checksums
d9b6b005a025c8b7a09a8d7744c30ca1e4d5c9a503961264173c09207ac02349
BLAKE2b-256 checksum
How to use checksums
e8617e29d7c5f90dad51392e309bf7404ddb081c5a5b5a4028d7d547b5a6ab4e
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 19, 2026.

Transparency log

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

Download URL iptocc-3.3.191-cp310-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
Size 630.9 kB
Tags CPython 3.10 Linux glibc 2.17+ ARM64 abi3
SHA-256 checksum
How to use checksums
bd9d9ed8066208fde49ad6f1bdf3bf20f45fdd15edbf91690a5fdefb6c9dd2de
BLAKE2b-256 checksum
How to use checksums
2e8979e1694b221796c84d286c34e16b1acfea91def9d84aa9d6173347c21502
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 19, 2026.

Transparency log

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

Download URL iptocc-3.3.191-cp310-abi3-macosx_11_0_arm64.whl
Size 623.2 kB
Tags CPython 3.10 abi3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
987bfa7a0534bfe780679e5d83b8da9703e2a86ad6d4b6c8d2ce3c9dc2e7a863
BLAKE2b-256 checksum
How to use checksums
24770476ace599337914bfba52bcc742a05eeae9c9d7bc5b94981dd95418f037
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 19, 2026.

Transparency log

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

Download URL iptocc-3.3.191-cp310-abi3-macosx_10_12_x86_64.whl
Size 623.1 kB
Tags CPython 3.10 abi3 macOS 10.12+ x86-64
SHA-256 checksum
How to use checksums
d5fdebb686dbd0e7f79d953a0d708c3968a2d85cfd1d01d073df99fd9ed63f04
BLAKE2b-256 checksum
How to use checksums
189c68e64253e4df5ff6f5ea8f56061a9d89311f0e7a804408a30787cdb20c5c
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 19, 2026.

Transparency log

Security for iptocc 3.3.191

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.191.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 19, 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.191 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