iptocc 3.2.2__tar.gz → 3.3.0__tar.gz

{iptocc-3.2.2 → iptocc-3.3.0}/Cargo.lock

@@ -350,7 +350,7 @@ dependencies = [
 
 [[package]]
 name = "iptocc"
-version = "1.3.2"
+version = "1.4.0"
 dependencies = [
  "clap",
  "criterion",
@@ -359,7 +359,7 @@ dependencies = [
 
 [[package]]
 name = "iptocc-py"
-version = "3.2.2"
+version = "3.3.0"
 dependencies = [
  "iptocc",
  "pyo3",
@@ -367,7 +367,7 @@ dependencies = [
 
 [[package]]
 name = "iptocc-wasm"
-version = "1.2.2"
+version = "1.3.0"
 dependencies = [
  "iptocc",
  "js-sys",
@@ -407,9 +407,9 @@ dependencies = [
 
 [[package]]
 name = "libc"
-version = "0.2.185"
+version = "0.2.186"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "52ff2c0fe9bc6cb6b14a0592c2ff4fa9ceb83eea9db979b0487cd054946a2b8f"
+checksum = "68ab91017fe16c622486840e4c83c9a37afeff978bd239b5293d61ece587de66"
 
 [[package]]
 name = "memchr"
@@ -936,9 +936,9 @@ dependencies = [
 
 [[package]]
 name = "winnow"
-version = "1.0.1"
+version = "1.0.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "09dac053f1cd375980747450bfc7250c264eaae0583872e845c0c7cd578872b5"
+checksum = "2ee1708bef14716a11bae175f579062d4554d95be2c6829f518df847b7b3fdd0"
 dependencies = [
  "memchr",
 ]

{iptocc-3.2.2 → iptocc-3.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: iptocc
-Version: 3.2.2
+Version: 3.3.0
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
@@ -23,10 +23,15 @@ Project-URL: Repository, https://github.com/roniemartinez/IPToCC
 
 # iptocc
 
-Fast, offline IPv4/IPv6 to ISO 3166-1 alpha-2 country code lookup for Python.
+[![PyPI](https://img.shields.io/pypi/v/iptocc.svg?logo=pypi&logoColor=white&label=PyPI&style=for-the-badge)](https://pypi.org/project/iptocc/)
+[![Python](https://img.shields.io/pypi/pyversions/iptocc.svg?logo=python&logoColor=white&label=Python&style=for-the-badge)](https://pypi.org/project/iptocc/)
+![License](https://img.shields.io/badge/license-MIT%20OR%20Apache--2.0-blue.svg?style=for-the-badge)
 
-> [!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 ~100 ns, and a batch API was added. IPv6 is still supported.
+Python bindings for the [`iptocc`](https://crates.io/crates/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](https://figshare.swinburne.edu.au/articles/report/On_the_accuracy_of_IP_geolocation_based_on_IP_allocation_data/26254751)).
+
+> **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
 
@@ -34,8 +39,8 @@ Fast, offline IPv4/IPv6 to ISO 3166-1 alpha-2 country code lookup for Python.
 - 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 alongside the library
-- Database refreshed nightly from the five Regional Internet Registries
+- `iptocc` CLI installed with `pip install iptocc`
+- Data refreshed nightly from the five Regional Internet Registries
 
 ## Install
 
@@ -77,3 +82,9 @@ from iptocc import country_code
 cc = country_code("8.8.8.8")  # returns None on miss
 ```
 
+## See also
+
+- [iptocc](https://crates.io/crates/iptocc) — the Rust crate this binding is built on
+- [@roniemartinez/iptocc](https://www.npmjs.com/package/@roniemartinez/iptocc) — WASM/JavaScript bindings
+- [GitHub repo](https://github.com/roniemartinez/IPToCC)
+

iptocc-3.3.0/README.md

@@ -0,0 +1,66 @@
+# iptocc
+
+[![PyPI](https://img.shields.io/pypi/v/iptocc.svg?logo=pypi&logoColor=white&label=PyPI&style=for-the-badge)](https://pypi.org/project/iptocc/)
+[![Python](https://img.shields.io/pypi/pyversions/iptocc.svg?logo=python&logoColor=white&label=Python&style=for-the-badge)](https://pypi.org/project/iptocc/)
+![License](https://img.shields.io/badge/license-MIT%20OR%20Apache--2.0-blue.svg?style=for-the-badge)
+
+Python bindings for the [`iptocc`](https://crates.io/crates/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](https://figshare.swinburne.edu.au/articles/report/On_the_accuracy_of_IP_geolocation_based_on_IP_allocation_data/26254751)).
+
+> **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.
+
+```bash
+pip install iptocc
+```
+
+## Usage
+
+```python
+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:
+
+```bash
+$ iptocc 8.8.8.8 1.0.16.1
+8.8.8.8 US
+1.0.16.1 JP
+```
+
+## Migrating from 2.x
+
+```python
+# 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
+
+- [iptocc](https://crates.io/crates/iptocc) — the Rust crate this binding is built on
+- [@roniemartinez/iptocc](https://www.npmjs.com/package/@roniemartinez/iptocc) — WASM/JavaScript bindings
+- [GitHub repo](https://github.com/roniemartinez/IPToCC)

{iptocc-3.2.2 → iptocc-3.3.0}/bindings/python/Cargo.toml

@@ -1,7 +1,7 @@
 [package]
 name = "iptocc-py"
 description = "Python bindings for iptocc, a fast IP-to-country lookup library written in Rust"
-version = "3.2.2"
+version = "3.3.0"
 edition.workspace = true
 license.workspace = true
 repository.workspace = true

iptocc-3.3.0/bindings/python/README.md

@@ -0,0 +1,66 @@
+# iptocc
+
+[![PyPI](https://img.shields.io/pypi/v/iptocc.svg?logo=pypi&logoColor=white&label=PyPI&style=for-the-badge)](https://pypi.org/project/iptocc/)
+[![Python](https://img.shields.io/pypi/pyversions/iptocc.svg?logo=python&logoColor=white&label=Python&style=for-the-badge)](https://pypi.org/project/iptocc/)
+![License](https://img.shields.io/badge/license-MIT%20OR%20Apache--2.0-blue.svg?style=for-the-badge)
+
+Python bindings for the [`iptocc`](https://crates.io/crates/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](https://figshare.swinburne.edu.au/articles/report/On_the_accuracy_of_IP_geolocation_based_on_IP_allocation_data/26254751)).
+
+> **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.
+
+```bash
+pip install iptocc
+```
+
+## Usage
+
+```python
+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:
+
+```bash
+$ iptocc 8.8.8.8 1.0.16.1
+8.8.8.8 US
+1.0.16.1 JP
+```
+
+## Migrating from 2.x
+
+```python
+# 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
+
+- [iptocc](https://crates.io/crates/iptocc) — the Rust crate this binding is built on
+- [@roniemartinez/iptocc](https://www.npmjs.com/package/@roniemartinez/iptocc) — WASM/JavaScript bindings
+- [GitHub repo](https://github.com/roniemartinez/IPToCC)

{iptocc-3.2.2 → iptocc-3.3.0}/crate/Cargo.toml

@@ -1,7 +1,7 @@
 [package]
 name = "iptocc"
 description = "Fast, offline IPv4/IPv6 address to ISO-3166 country code lookup using RIR delegated statistics"
-version = "1.3.2"
+version = "1.4.0"
 default-run = "iptocc"
 edition.workspace = true
 license.workspace = true

iptocc-3.3.0/crate/README.md

@@ -0,0 +1,60 @@
+# iptocc
+
+[![crates.io](https://img.shields.io/crates/v/iptocc.svg?logo=rust&label=crates.io&style=for-the-badge)](https://crates.io/crates/iptocc)
+[![CI](https://img.shields.io/github/actions/workflow/status/roniemartinez/IPToCC/ci.yml?branch=master&label=CI&logo=github%20actions&style=for-the-badge)](https://github.com/roniemartinez/IPToCC/actions/workflows/ci.yml)
+[![Rust](https://img.shields.io/badge/rust-1.85%2B-orange.svg?logo=rust&style=for-the-badge)](https://www.rust-lang.org/)
+![License](https://img.shields.io/badge/license-MIT%20OR%20Apache--2.0-blue.svg?style=for-the-badge)
+
+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](https://github.com/roniemartinez/IPToCC).
+
+> [!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](https://figshare.swinburne.edu.au/articles/report/On_the_accuracy_of_IP_geolocation_based_on_IP_allocation_data/26254751)).
+
+## 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](../BENCHMARK.md).
+- `iptocc` CLI installed with `cargo install iptocc`
+- Data refreshed nightly from the five Regional Internet Registries (RIRs)
+
+## Install
+
+```bash
+cargo add iptocc
+```
+
+## Usage
+
+```rust
+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:
+
+```rust
+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`:
+
+```bash
+$ iptocc 8.8.8.8 1.0.16.1
+8.8.8.8 US
+1.0.16.1 JP
+```

iptocc-3.3.0/crate/benches/lookup.rs

@@ -0,0 +1,127 @@
+use core::net::{Ipv4Addr, Ipv6Addr};
+
+use criterion::{Criterion, Throughput, criterion_group, criterion_main};
+use std::hint::black_box;
+
+const V4_CASES: &[(&str, &str)] = &[
+    ("afrinic", "41.0.0.1"),
+    ("apnic", "1.0.16.1"),
+    ("arin", "8.8.8.8"),
+    ("lacnic", "200.160.0.1"),
+    ("ripencc", "193.0.6.139"),
+    ("miss_private", "10.0.0.0"),
+];
+
+const V6_CASES: &[(&str, &str)] = &[
+    ("afrinic", "2001:4200::1"),
+    ("apnic", "2001:200::1"),
+    ("arin", "2001:4860:4860::8888"),
+    ("lacnic", "2001:1280::1"),
+    ("ripencc", "2001:67c:18::1"),
+    ("miss_loopback", "::1"),
+];
+
+fn bench_v4(c: &mut Criterion) {
+    let mut group = c.benchmark_group("v4");
+    for (name, ip) in V4_CASES {
+        group.bench_with_input(*name, ip, |b, &ip| b.iter(|| iptocc::country_code(black_box(ip))));
+    }
+    group.finish();
+}
+
+fn bench_v6(c: &mut Criterion) {
+    let mut group = c.benchmark_group("v6");
+    for (name, ip) in V6_CASES {
+        group.bench_with_input(*name, ip, |b, &ip| b.iter(|| iptocc::country_code(black_box(ip))));
+    }
+    group.finish();
+}
+
+fn bench_v4_typed(c: &mut Criterion) {
+    let mut group = c.benchmark_group("v4_typed");
+    for (name, ip) in V4_CASES {
+        let parsed: Ipv4Addr = ip.parse().unwrap();
+        group.bench_with_input(*name, &parsed, |b, &ip| b.iter(|| iptocc::country_code(black_box(ip))));
+    }
+    group.finish();
+}
+
+fn bench_v6_typed(c: &mut Criterion) {
+    let mut group = c.benchmark_group("v6_typed");
+    for (name, ip) in V6_CASES {
+        let parsed: Ipv6Addr = ip.parse().unwrap();
+        group.bench_with_input(*name, &parsed, |b, &ip| b.iter(|| iptocc::country_code(black_box(ip))));
+    }
+    group.finish();
+}
+
+fn bench_batch_v4(c: &mut Criterion) {
+    let mut group = c.benchmark_group("batch_v4");
+    for &n in &[10usize, 100, 1000, 10000] {
+        let addrs: Vec<&str> = V4_CASES.iter().map(|(_, ip)| *ip).cycle().take(n).collect();
+        group.throughput(Throughput::Elements(n as u64));
+        group.bench_with_input(format!("n={n}"), &addrs, |b, addrs| {
+            b.iter(|| iptocc::country_codes(black_box(addrs.iter().copied())))
+        });
+    }
+    group.finish();
+}
+
+fn bench_batch_v4_typed(c: &mut Criterion) {
+    let mut group = c.benchmark_group("batch_v4_typed");
+    for &n in &[10usize, 100, 1000, 10000] {
+        let addrs: Vec<Ipv4Addr> = V4_CASES
+            .iter()
+            .map(|(_, ip)| ip.parse().unwrap())
+            .cycle()
+            .take(n)
+            .collect();
+        group.throughput(Throughput::Elements(n as u64));
+        group.bench_with_input(format!("n={n}"), &addrs, |b, addrs| {
+            b.iter(|| iptocc::country_codes(black_box(addrs.iter().copied())))
+        });
+    }
+    group.finish();
+}
+
+fn bench_batch_v6(c: &mut Criterion) {
+    let mut group = c.benchmark_group("batch_v6");
+    for &n in &[10usize, 100, 1000, 10000] {
+        let addrs: Vec<&str> = V6_CASES.iter().map(|(_, ip)| *ip).cycle().take(n).collect();
+        group.throughput(Throughput::Elements(n as u64));
+        group.bench_with_input(format!("n={n}"), &addrs, |b, addrs| {
+            b.iter(|| iptocc::country_codes(black_box(addrs.iter().copied())))
+        });
+    }
+    group.finish();
+}
+
+fn bench_batch_v6_typed(c: &mut Criterion) {
+    let mut group = c.benchmark_group("batch_v6_typed");
+    for &n in &[10usize, 100, 1000, 10000] {
+        let addrs: Vec<Ipv6Addr> = V6_CASES
+            .iter()
+            .map(|(_, ip)| ip.parse().unwrap())
+            .cycle()
+            .take(n)
+            .collect();
+        group.throughput(Throughput::Elements(n as u64));
+        group.bench_with_input(format!("n={n}"), &addrs, |b, addrs| {
+            b.iter(|| iptocc::country_codes(black_box(addrs.iter().copied())))
+        });
+    }
+    group.finish();
+}
+
+criterion_group!(
+    benches,
+    bench_v4,
+    bench_v6,
+    bench_v4_typed,
+    bench_v6_typed,
+    bench_batch_v4,
+    bench_batch_v4_typed,
+    bench_batch_v6,
+    bench_batch_v6_typed
+);
+criterion_main!(benches);