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

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.187
File Size Uploaded Provenance Actions
iptocc-3.3.187.tar.gz 449.3 kB With provenance Details for iptocc-3.3.187.tar.gz

Built distributions (wheels)

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

Total release size: 3.5 MB

Release files / iptocc-3.3.187.tar.gz

Download URL iptocc-3.3.187.tar.gz
Size 449.3 kB
Tags Source
SHA-256 checksum
How to use checksums
6c324d686ab856e58f7cb070f4b140aff5dd59bd5f387df1fc39b6a4a4d3a46e
BLAKE2b-256 checksum
How to use checksums
9431337f91e5be92cee5da428daf8a8711c5c1b0f07e4071d17bf5a0b6ae5325
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 15, 2026.

Transparency log

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

Download URL iptocc-3.3.187-cp310-abi3-win_amd64.whl
Size 523.7 kB
Tags CPython 3.10 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
887e30ba7ff82f5e4e8eeef19ed6bd264052a1e3e692a39bafb5fbcb62df88db
BLAKE2b-256 checksum
How to use checksums
13852899835f0ff45ca06ea02351934e0e68cc3aaa439ddd204e947b34976017
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 15, 2026.

Transparency log

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

Download URL iptocc-3.3.187-cp310-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
Size 630.0 kB
Tags CPython 3.10 Linux glibc 2.17+ x86-64 abi3
SHA-256 checksum
How to use checksums
296c3abb4d40e0393b25a5b04a303152ab6928bb9b5157a5715d711c5035b2dd
BLAKE2b-256 checksum
How to use checksums
d8c4aa5c5198c37790b061245f12de2395628ff907eefc3d44df9f1886e28440
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 15, 2026.

Transparency log

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

Download URL iptocc-3.3.187-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
cb64c88346258769e0047279c86a8afde249909373a62e55f79206db854ccc47
BLAKE2b-256 checksum
How to use checksums
ae455edaeca43829ede292317b3906d6012a4d38500431c3e212ea3a84493e5c
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 15, 2026.

Transparency log

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

Download URL iptocc-3.3.187-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
de4d343e8ee8949fcbb2e9a408b5f6f5e769be2db04b7a3e5b9ffda74e36afcd
BLAKE2b-256 checksum
How to use checksums
a85b3c6135dac90e5ece8755e26ea01790906cfa6f3ab4df0f6e2b21fc17ad8d
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 15, 2026.

Transparency log

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

Download URL iptocc-3.3.187-cp310-abi3-macosx_10_12_x86_64.whl
Size 622.7 kB
Tags CPython 3.10 abi3 macOS 10.12+ x86-64
SHA-256 checksum
How to use checksums
9233784a154001c8bb689d3ce57cd5aeee96765cad8db536cf895000090918c2
BLAKE2b-256 checksum
How to use checksums
9595d089744e38ec59e7c46731cfc18fe6411d8ed6644d847026d5d46a0b7559
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 15, 2026.

Transparency log

Security for iptocc 3.3.187

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.187.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 15, 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.187 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