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

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.189
File Size Uploaded Provenance Actions
iptocc-3.3.189.tar.gz 449.4 kB With provenance Details for iptocc-3.3.189.tar.gz

Built distributions (wheels)

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

Total release size: 3.5 MB

Release files / iptocc-3.3.189.tar.gz

Download URL iptocc-3.3.189.tar.gz
Size 449.4 kB
Tags Source
SHA-256 checksum
How to use checksums
9a0b90239a128ab4e6e4b656173bdd3b31d476bf5aec612d11a58e18f6ef7177
BLAKE2b-256 checksum
How to use checksums
4eef9bf8d073d6ca01fc6c49d6abb097cc2624328e8d3be04ed68faaf7c2e714
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 17, 2026.

Transparency log

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

Download URL iptocc-3.3.189-cp310-abi3-win_amd64.whl
Size 524.0 kB
Tags CPython 3.10 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
cc3478b880a4fed1a7229f37d3ae93558e2581a286c3074c6e386432b65f367e
BLAKE2b-256 checksum
How to use checksums
f075e021b8100b1998b44639bbca16192103deec5baa9c959367628de9eea7fd
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 17, 2026.

Transparency log

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

Download URL iptocc-3.3.189-cp310-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
Size 630.2 kB
Tags CPython 3.10 Linux glibc 2.17+ x86-64 abi3
SHA-256 checksum
How to use checksums
1bbe0c7bdb37ae610bdbbe5e421d9568d1343bc813e52e1664a736c18a47aaa2
BLAKE2b-256 checksum
How to use checksums
ce65725792beb90859f1b79f7c3a814d819f8e9286f7d0f2b1a2ab32ed9830bb
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 17, 2026.

Transparency log

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

Download URL iptocc-3.3.189-cp310-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
Size 630.7 kB
Tags CPython 3.10 Linux glibc 2.17+ ARM64 abi3
SHA-256 checksum
How to use checksums
196dc3cf8c99cf5e92b3f003782fe7baf8799f24b1041f07423bd8a9c0588ca2
BLAKE2b-256 checksum
How to use checksums
29025147eab84dff48202051d2eab2c9c90badc6b6b03fe5fb449b79584b2d3f
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 17, 2026.

Transparency log

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

Download URL iptocc-3.3.189-cp310-abi3-macosx_11_0_arm64.whl
Size 622.7 kB
Tags CPython 3.10 abi3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
3081ed43b69c16946cd9c1b62c89945413664598ecc37ed8afde796607a5a40e
BLAKE2b-256 checksum
How to use checksums
8c461e08781ee308276235c09edde57ee4c51766cbb97d78db89347a7d6595a5
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 17, 2026.

Transparency log

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

Download URL iptocc-3.3.189-cp310-abi3-macosx_10_12_x86_64.whl
Size 622.9 kB
Tags CPython 3.10 abi3 macOS 10.12+ x86-64
SHA-256 checksum
How to use checksums
1211c336aee2c70980a8442dc5704c02a9d4bf3e57882157f41329948b6e8db6
BLAKE2b-256 checksum
How to use checksums
0cf28dad36dfaded7366829ddd2649ec47135fc93eafdcaeac8e425885ec5a30
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 17, 2026.

Transparency log

Security for iptocc 3.3.189

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.189.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 17, 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.189 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