originet 1.1.0

Map IP addresses to origin ASNs with CAIDA's RouteViews prefix-to-AS snapshots, fetched on the fly or read from a local file
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

//! Map IP addresses to origin ASNs with CAIDA's RouteViews prefix-to-AS snapshots.
//!
//! The crate is a thin library under the `originet` binary:
//!
//! - [`pfx2as`] parses the `pfx2as` text format CAIDA publishes;
//! - [`table`] holds a longest-prefix-match table for IPv4 and IPv6;
//! - [`caida`] knows the dataset layout on `publicdata.caida.org` and picks a snapshot by date;
//! - [`fetch`] downloads the index and the snapshots into a local cache;
//! - [`cache`] lists what the cache holds and prunes it;
//! - [`load`] fills a table from a local file or from CAIDA and records where it came from;
//! - [`input`] reads and validates the addresses to look up;
//! - [`output`] serializes results as JSON, JSON Lines, CSV, TSV or Parquet.

pub mod cache;
pub mod caida;
pub mod fetch;
pub mod input;
pub mod load;
pub mod output;
pub mod pfx2as;
pub mod table;

/// The crate version, as compiled into the binary.
pub const VERSION: &str = env!("CARGO_PKG_VERSION");

/// The `User-Agent` sent to CAIDA, so the data host can tell who is downloading.
pub const USER_AGENT: &str = concat!(
    "originet/",
    env!("CARGO_PKG_VERSION"),
    " (+https://github.com/estcarisimo/originet)"
);