namba 0.1.0

A fast, lightweight library for parsing, validating, and formatting phone numbers
Documentation
//! Append-only and editable phone number input.

use namba::{AsYouType, FormattedEdit, Region};

#[test]
fn append_only_input_never_loses_digits() {
    let mut formatter = AsYouType::new(Region::new("US").unwrap());
    for character in "6502530000".chars() {
        formatter.push(character);
    }
    assert_eq!(formatter.raw_input(), "6502530000");
    assert_eq!(formatter.push('x'), "(650) 253-0000");
}

#[test]
fn editable_format_maps_the_cursor_by_digit_position() {
    let formatted = FormattedEdit::new(Region::new("US").unwrap(), "6502530000", 3);
    assert_eq!(formatted.text(), "(650) 253-0000");
    assert_eq!(&formatted.text()[..formatted.cursor()], "(650");
}

#[test]
fn cursor_offsets_inside_multibyte_text_do_not_panic() {
    let formatted = FormattedEdit::new(Region::new("IN").unwrap(), "९८७६५४३२१०", 1);
    assert!(formatted.cursor() <= formatted.text().len());
    assert_eq!(formatted.text(), "098765 43210");
}

#[test]
fn append_only_input_normalizes_unicode_digits() {
    let mut formatter = AsYouType::new(Region::new("IN").unwrap());
    for character in "९८७६५४३२१०".chars() {
        formatter.push(character);
    }
    assert_eq!(formatter.raw_input(), "9876543210");
    assert_eq!(formatter.push('x'), "098765 43210");
}

#[test]
fn international_input_keeps_international_presentation() {
    let mut formatter = AsYouType::new(Region::new("US").unwrap());
    for character in "+442079460018".chars() {
        formatter.push(character);
    }
    assert_eq!(formatter.push('x'), "+44 20 7946 0018");
}

#[test]
fn interactive_input_keeps_at_most_fifteen_digits() {
    let us = Region::new("US").unwrap();
    let mut formatter = AsYouType::new(us);
    for character in "12345678901234567890".chars() {
        formatter.push(character);
    }
    assert_eq!(formatter.raw_input(), "123456789012345");

    let formatted = FormattedEdit::new(us, "12345678901234567890", 20);
    assert_eq!(
        formatted
            .text()
            .chars()
            .filter(char::is_ascii_digit)
            .count(),
        15
    );
    assert_eq!(formatted.cursor(), formatted.text().len());
}

#[test]
fn interactive_debug_output_redacts_input() {
    let us = Region::new("US").unwrap();
    let mut formatter = AsYouType::new(us);
    for character in "6502530000".chars() {
        formatter.push(character);
    }
    let editable = FormattedEdit::new(us, "6502530000", 10);

    assert!(!format!("{formatter:?}").contains("650253"));
    assert!(!format!("{editable:?}").contains("650253"));
}

#[test]
fn editable_input_stops_at_a_utf8_boundary() {
    let text = format!("{}é", "a".repeat(255));
    let formatted = FormattedEdit::new(Region::new("US").unwrap(), &text, text.len());
    assert!(formatted.text().is_empty());
    assert_eq!(formatted.cursor(), 0);
}