Struct Aggregator 

pub struct Aggregator { /* private fields */ }

Collects ranges and produces the minimal covering prefix list.

Exclusions are subtracted address by address: the summary covers exactly the added addresses minus the excluded ones, whatever the order of calls and however the inputs overlap. A prefix that partly overlaps an exclusion is split around it.

use route_summarization::Aggregator;

let mut agg = Aggregator::new();
agg.add_str("192.0.2.0/24", false).unwrap();
agg.exclude_str("192.0.2.0/25", false).unwrap();
agg.exclude_str("192.0.2.255", false).unwrap();
let out: Vec<String> = agg.summarize().iter().map(|p| p.to_string()).collect();
assert_eq!(out, ["192.0.2.128/26", "192.0.2.192/27", "192.0.2.224/28",
                 "192.0.2.240/29", "192.0.2.248/30", "192.0.2.252/31", "192.0.2.254"]);

Implementations

impl Aggregator

pub fn new() -> Self

pub fn add(&mut self, r: Range)

pub fn add_str(&mut self, input: &str, spf: bool) -> Result<(), ParseError>

Parse and add one entry; see parse_entry.

pub fn exclude(&mut self, r: Range)

Remove these addresses from the summary, wherever they appear.

pub fn exclude_str(&mut self, input: &str, spf: bool) -> Result<(), ParseError>

Parse and exclude one entry; see parse_entry.

pub fn is_empty(&self) -> bool

True when nothing has been added (exclusions alone don’t count).

pub fn summarize(&self) -> Vec<Prefix>

Minimal CIDR list: all IPv4 first, then IPv6, each in address order.

Trait Implementations

impl Clone for Aggregator

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Aggregator

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Aggregator

fn default() -> Self

Returns the “default value” for a type.