factbook 0.1.0

A high-speed, self-maintaining fact enricher for data at scale. Point it at reference data and it fetches, verifies, indexes and serves it, keeping itself current. IP geolocation is the batteries-included case.
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
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83

// Project:   factbook
// File:      src/geoip/download/verify/fixtures.rs
// Purpose:   Minimal MaxMind DB files the content checks are exercised against
// Language:  Rust
//
// License:   Apache-2.0
// Copyright: (c) 2026 HYPERI PTY LIMITED

//! The databases the content checks are asked about.
//!
//! A real provider database is far too large to commit and the ones MaxMind
//! publishes for testing hold none of the probe addresses, so a file built here
//! is the only way to assert that the probe accepts a populated database as well
//! as refusing an empty one -- a probe that only ever refuses would silently
//! stop every deployment updating.
//!
//! The encoding is [`mmdb_wire`](crate::geoip::mmdb_wire); this is the records
//! put through it.

use crate::geoip::mmdb_wire::{IPV4, database, map, string, uint32};

/// The other family, for a source published over IPv6 space.
#[cfg(feature = "geoip-lookup")]
const IPV6: u16 = 6;

/// The record an ASN database answers with.
fn asn_record(number: u32, organisation: &str) -> Vec<u8> {
    map(&[
        ("autonomous_system_number", uint32(number)),
        ("autonomous_system_organization", string(organisation)),
    ])
}

/// The record a city database answers with, MaxMind's nested shape.
#[cfg(feature = "geoip-lookup")]
fn city_record(iso_code: &str) -> Vec<u8> {
    map(&[("country", map(&[("iso_code", string(iso_code))]))])
}

/// An ASN database answering every address with one number and one name.
///
/// An empty `organisation` is the `dbip-asn` defect: a valid record carrying a
/// number and a blank name.
pub(crate) fn asn_mmdb(number: u32, organisation: &str) -> Vec<u8> {
    database(&asn_record(number, organisation), 0, "GeoLite2-ASN", IPV4)
}

/// The same database, declared for IPv6 the way a source covering that space
/// publishes it.
#[cfg(feature = "geoip-lookup")]
pub(crate) fn asn_mmdb_v6(number: u32, organisation: &str) -> Vec<u8> {
    database(&asn_record(number, organisation), 0, "GeoLite2-ASN", IPV6)
}

/// A city database answering every address with one country, MaxMind's shape.
///
/// Only the probe reads it, and the probe needs a reader compiled in.
#[cfg(feature = "geoip-lookup")]
pub(crate) fn city_mmdb(iso_code: &str) -> Vec<u8> {
    database(&city_record(iso_code), 0, "GeoLite2-City", IPV4)
}

/// The same database, declared for IPv6.
#[cfg(feature = "geoip-lookup")]
pub(crate) fn city_mmdb_v6(iso_code: &str) -> Vec<u8> {
    database(&city_record(iso_code), 0, "GeoLite2-City", IPV6)
}

/// A city database naming the country at the top level, IPinfo Lite's shape.
///
/// Only the probe reads it, and the probe needs a reader compiled in.
#[cfg(feature = "geoip-lookup")]
pub(crate) fn flat_city_mmdb(country_code: &str) -> Vec<u8> {
    database(
        &map(&[
            ("country_code", string(country_code)),
            ("continent_code", string("OC")),
        ]),
        0,
        "ipinfo lite",
        IPV4,
    )
}