4 releases

0.1.3 Jul 18, 2022
0.1.2 Jul 18, 2022
0.1.1 Jul 18, 2022
0.1.0 Jul 18, 2022

#1796 in Database interfaces

ISC license

11KB
155 lines

MaxMindDB-UF

User-friendly library to interact with MaxMind City database

This is simple wrapper around maxminddb crate.

Example:

let reader = maxminddb::Reader::open_readfile("./GeoLite2-City.mmdb").uwnrap();
let normalized_db = NormalizedDatabase::from(reader);
let addr = IpAddr::from_str("1.1.1.1").unwrap();

let record = normalized_db.lookup(addr); // Returns Result<NormalizedRecord, MaxMindDBError>
let record = record.unwrap();
record.postal_code(); // Option<&str>
record.city_name(language? (Option<&str>); // Option<String>
record.continent_name(language? (Option<&str>); // Option<String>

and more functions.

Why this wrapper is created?

Just let me show you sample of code that you may use with this crate.

let country = record
                .country_name(None)
                .or(record.registered_country_name(None))
                .or(record.represented_country_name(None));

or

let localized_name = record
                    .country_name(Some("de"))
                    .or(record.country_name(None));

I have thoughts that looks better than.

let record = maxminddb.lookup(ip);
let c = record.country
        .and_then(|c| c.names)
        .and_then(|n| n.get("de"));
if let None = c {
    let c = record.registered_country
            .and_then(|c| c.names)
            .and_then(|n| n.get("en"));
}

Example with falling back through represented country and registered country would be bigger instead of few lines with this wrapper.

Dependencies

~0.7–1.4MB
~31K SLoC