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

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.188
File Size Uploaded Provenance Actions
iptocc-3.3.188.tar.gz 449.2 kB With provenance Details for iptocc-3.3.188.tar.gz

Built distributions (wheels)

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

Total release size: 3.5 MB

Release files / iptocc-3.3.188.tar.gz

Download URL iptocc-3.3.188.tar.gz
Size 449.2 kB
Tags Source
SHA-256 checksum
How to use checksums
f2013687bba9274e2966f73da7824a973713f2f0a1ac337610b0cd55376dadcd
BLAKE2b-256 checksum
How to use checksums
3f7eed1bdbc17a85b41123378eb46bfbb156c4af4de6dab6021f5ae83ff55779
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 16, 2026.

Transparency log

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

Download URL iptocc-3.3.188-cp310-abi3-win_amd64.whl
Size 523.7 kB
Tags CPython 3.10 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
031cfcf746b6fcc0f6cd47efd4b35e09fcce4513f36e827d2f12039151dc7e85
BLAKE2b-256 checksum
How to use checksums
729a3e7cb1949ef83126c438151f3c72153d9cc87d333a442a8e77d108825229
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 16, 2026.

Transparency log

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

Download URL iptocc-3.3.188-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
1cc77b25aae87a7f8663ef3e1264de6acf4d706244aaf9a49f958ca8b98d2bfd
BLAKE2b-256 checksum
How to use checksums
081d22735698523fe0891c3018275f1e6f7932b4abf985368e327d857ddf320c
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 16, 2026.

Transparency log

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

Download URL iptocc-3.3.188-cp310-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
Size 630.4 kB
Tags CPython 3.10 Linux glibc 2.17+ ARM64 abi3
SHA-256 checksum
How to use checksums
69e55caa98a2c4d24c1d10e332d1406f0ce0a87c10f4c9be0b2b997a3ddb5352
BLAKE2b-256 checksum
How to use checksums
0d9e56e3e6581fc5d4db271611aae859ef9dfc8dee03ed81e7f70cea0f5d3640
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 16, 2026.

Transparency log

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

Download URL iptocc-3.3.188-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
f9faf28f02d0265de10f7f3867239962626d7729812e30f8675f5f05ab9a8616
BLAKE2b-256 checksum
How to use checksums
90b943037542c267096cff2922b43b92cf78d1dbc22ba5bc155fb44aff1c03cd
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 16, 2026.

Transparency log

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

Download URL iptocc-3.3.188-cp310-abi3-macosx_10_12_x86_64.whl
Size 622.6 kB
Tags CPython 3.10 abi3 macOS 10.12+ x86-64
SHA-256 checksum
How to use checksums
dddd2c5ff75884f9e0b0a67151ac52396a0f46c7555938b3c8b48651fba77dfd
BLAKE2b-256 checksum
How to use checksums
0fd1987967bafbf002238626812eee22c5ed16ff6ad0dfc4db02f0a222e1d9e6
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 16, 2026.

Transparency log

Security for iptocc 3.3.188

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.188.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 16, 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.188 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