A high-performance Rust library for validating, normalizing, parsing, and formatting phone numbers according to the E.164 international standard.

• ⚡ Constant-time validation: Validate E.164 numbers with zero allocations
• 🗺️ Country-aware normalization: Convert various phone formats to E.164
• 🧩 Structured parsing: Extract country codes and national numbers
• 🖨️ Local formatting: Format numbers according to local conventions
• 🛡️ No-std compatible: Use in embedded systems and WebAssembly
• 🧰 CLI tool: Batch processing and interactive usage
• 🌐 FFI-ready: Bindings for Go, Python, and C
• 📊 Benchmarked: Extensively tested for performance

Add to your Cargo.toml:

[dependencies]
fast_e164 = "0.1.0"

Example usage:

use fast_e164::{is_valid_e164, normalize_to_e164, parse_e164, format_local};

// Validate an E.164 number
assert!(is_valid_e164("+14155552671"));

// Normalize a phone number to E.164
let e164 = normalize_to_e164("(415) 555-2671", "US").unwrap();
assert_eq!(e164, "+14155552671");

// Parse a phone number into its components
let phone = parse_e164("+14155552671").unwrap();
assert_eq!(phone.country_code, 1);
assert_eq!(phone.national_number, "4155552671");
assert_eq!(phone.iso_country, Some("US".to_string()));

// Format a phone number in local style
let local = format_local(&phone);
assert_eq!(local, "(415) 555-2671");

The fast-e164 CLI tool can be installed with:

cargo install fast_e164 --features cli

# Validate a phone number
fast-e164 validate "+14155552671"

# Normalize a phone number to E.164
fast-e164 normalize "(415) 555-2671" --country US

# Parse a phone number and display info
fast-e164 parse "+14155552671"

# Show detailed metadata
fast-e164 info "+14155552671"

# Process batch CSV file
fast-e164 batch --input phones.csv --output normalized.csv --column phone_number --country US

# Generate test data
fast-e164 testgen --countries US,GB,DE --count 1000 --output test_vectors.csv

Benchmarked on an Intel i7-10700K @ 3.8GHz:

fast_e164 focuses on being lightweight and high-performance, especially suitable for validation and normalization tasks. Unlike more comprehensive libraries like phonenumber or Google's libphonenumber, it prioritizes speed and low memory usage over complete feature parity.

Contributions are welcome! Check out the DESIGN.md file for architectural details and project structure.

MIT License - See LICENSE for details.