iptocc

Fast, offline IPv4/IPv6 to ISO 3166-1 alpha-2 country code lookup.

Python and WASM bindings built on this crate live in the same repository.

[!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).

Features

• Offline lookup, no API keys, no network calls
• IPv4 and IPv6 in one call
• Generic country_code<T: IpAddress>(input) accepts &str, String, Ipv4Addr, Ipv6Addr, or IpAddr
• Batch country_codes takes any iterable of the above
• Lookup data embedded via include_bytes!; no runtime file I/O
• Nanosecond-scale lookups: ~1.3 ns typed, ~6 ns string. See BENCHMARK.md.
• iptocc CLI installed with cargo install iptocc
• Data refreshed nightly from the five Regional Internet Registries (RIRs)

Install

cargo add iptocc

Usage

use iptocc::{country_code, country_codes};

assert_eq!(country_code("8.8.8.8"), Some("US"));
assert_eq!(country_code("2001:4860:4860::8888"), Some("US"));
assert_eq!(country_code("10.0.0.0"), None);

let codes = country_codes(["8.8.8.8", "1.0.16.1"]);
assert_eq!(codes, vec![Some("US"), Some("JP")]);

Typed inputs are also accepted and skip the string parsing step:

use std::net::Ipv4Addr;
use iptocc::country_code;

assert_eq!(country_code(Ipv4Addr::new(8, 8, 8, 8)), Some("US"));

A CLI is installed by cargo install iptocc:

$ iptocc 8.8.8.8 1.0.16.1
8.8.8.8 US
1.0.16.1 JP