rlibphonenumber 2.1.0

A high-performance Rust port of Google's libphonenumber for parsing, formatting, and validating international phone numbers.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50

mod mask_tests;
mod matcher_tests;
mod metadata_tests;
mod phonenumberutil_tests;

mod common {
    use std::{env, sync::LazyLock};

    use prost::Message;

    use crate::{
        PhoneMetadataCollection, generated::metadata::TEST_METADATA,
        phonenumber_mask::PhoneMaskUtil, phonenumber_matcher::PhoneNumberMatcherFactory,
        phonenumberutil::phonenumberutil_internal::PhoneNumberUtilInternal,
    };

    pub static ONCE: std::sync::Once = std::sync::Once::new();
    static UTIL: LazyLock<PhoneNumberUtilInternal> =
        LazyLock::new(|| PhoneNumberUtilInternal::new_for_metadata(load_metadata()).unwrap());
    static MATCHER_FACTORY: LazyLock<
        PhoneNumberMatcherFactory<PhoneNumberUtilInternal, &'static PhoneNumberUtilInternal>,
    > = LazyLock::new(|| PhoneNumberMatcherFactory::new_for_util(get_phone_util()));

    pub fn get_phone_mask_util()
    -> PhoneMaskUtil<PhoneNumberUtilInternal, &'static PhoneNumberUtilInternal> {
        PhoneMaskUtil::new_for_util(get_phone_util())
    }

    pub fn get_phone_util() -> &'static PhoneNumberUtilInternal {
        ONCE.call_once(|| {
            if env::var("RUST_LOG").is_ok_and(|var| var.to_lowercase() == "trace") {
                colog::default_builder()
                    .filter_level(log::LevelFilter::Trace)
                    .init()
            }
        });

        &UTIL
    }

    pub fn get_phone_matcher_factory()
    -> &'static PhoneNumberMatcherFactory<PhoneNumberUtilInternal, &'static PhoneNumberUtilInternal>
    {
        &MATCHER_FACTORY
    }

    pub fn load_metadata() -> PhoneMetadataCollection {
        PhoneMetadataCollection::decode(TEST_METADATA).expect("Metadata should be valid")
    }
}