mrz 0.9.1

Zero-dependency (by default) ICAO 9303 Machine Readable Zone (MRZ) parser, emitter, and check-digit validator for TD1/TD2/TD3 and MRV-A/MRV-B (visa) documents.
Documentation
use mrz::{
    format_mrv_a, format_mrv_b, format_td1, format_td2, format_td3, parse_mrv_a, parse_mrv_b,
    parse_td1, parse_td2, parse_td3, MrvAFields, MrvBFields, MrzError, Td1Fields, Td2Fields,
    Td3Fields,
};

#[test]
fn length_is_counted_in_characters_not_bytes() {
    let zone = format_td3(&Td3Fields::default());
    let (line1, line2) = zone.split_once('\n').expect("two TD3 lines");

    // 44 characters, 45 bytes: the length is right, so the error names the
    // character that is wrong, at its character position.
    let mut right_length = line1.to_string();
    right_length.replace_range(5..6, "É");
    assert_eq!(right_length.chars().count(), 44);
    assert_eq!(right_length.len(), 45);
    assert_eq!(
        parse_td3(&right_length, line2),
        Err(MrzError::BadCharacter {
            character: 'É',
            line: Some(0),
            position: 5,
        })
    );

    // 45 characters, 46 bytes: the length is wrong, and `got` counts characters.
    let too_long = format!("{right_length}<");
    assert_eq!(too_long.len(), 46);
    assert_eq!(
        parse_td3(&too_long, line2),
        Err(MrzError::BadLength {
            expected: 44,
            got: 45
        })
    );
}

#[test]
fn bad_document_code_always_keeps_both_raw_cells() {
    let td3 = format_td3(&Td3Fields::default());
    let td2 = format_td2(&Td2Fields::default());
    let td1 = format_td1(&Td1Fields::default());
    let mrv_a = format_mrv_a(&MrvAFields::default());
    let mrv_b = format_mrv_b(&MrvBFields::default());
    for (zone, parse) in [
        (&td3, parse_td3 as fn(&str, &str) -> Result<_, _>),
        (&td2, parse_td2),
        (&mrv_a, parse_mrv_a),
        (&mrv_b, parse_mrv_b),
    ] {
        let (line1, line2) = zone.split_once('\n').expect("two lines");
        let mut line1 = line1.to_string();
        line1.replace_range(0..1, "Z");
        assert_eq!(
            parse(&line1, line2),
            Err(MrzError::BadDocumentCode("Z<".into()))
        );
    }
    let mut lines = td1.lines();
    let mut line1 = lines.next().expect("TD1 line 1").to_string();
    line1.replace_range(0..1, "Z");
    assert_eq!(
        parse_td1(
            &line1,
            lines.next().expect("TD1 line 2"),
            lines.next().expect("TD1 line 3")
        ),
        Err(MrzError::BadDocumentCode("Z<".into()))
    );
}