Struct RpslEvaluator

pub struct RpslEvaluator { /* private fields */ }

An implementation of rpsl::expr::eval::Evaluator that resolves RPSL names using the IRRd query protocol.

Examples

use bgpfu::RpslEvaluator;
use ip::traits::PrefixSet;
use rpsl::expr::MpFilterExpr;

let filter: MpFilterExpr = "AS-FOO AND { 0.0.0.0/0^8-24, ::/0^16-48 }".parse()?;
RpslEvaluator::new("whois.radb.net", 43)?
    .evaluate(filter)?
    .ranges()
    .for_each(|range| println!("{range}"));

Implementations

impl RpslEvaluator

pub fn new(host: &str, port: u16) -> Result<Self, Error>

Construct a new Evaluator.

Errors

An Error::Irr is returned if the connection to the IRRd server cannot be established.

pub fn evaluate<'a, T>( &mut self, expr: T, ) -> Result<<Self as Evaluator<'a>>::Output<T>, <Self as Evaluator<'a>>::Error>

where T: Evaluate<'a, Self> + Display,

Evaluate an RPSL expression.

This method wraps Evaluator::evaluate, and is provided as a convenience so that the underlying trait does not have to be brought into scope explicitly.

Errors

See Evaluator for error handling details.

Trait Implementations

impl Debug for RpslEvaluator

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

Formats the value using the given formatter.

impl<'a> Evaluator<'a> for RpslEvaluator

type Output<T> = <T as Evaluate<'a, RpslEvaluator>>::Output where T: Evaluate<'a, Self>

The type returned by evaluate() for expression type T.

type Error = Error

The error type produced by failed evaluations.

fn finalise<T>( &mut self, output: T::Output, ) -> Result<Self::Output<T>, Self::Error>

where T: Evaluate<'a, Self>,

Perform the final conversion from the type returned by Evaluate::<Self>::evaluate (i.e. T::Output) into Self::Output<T>.

fn sink_error(&mut self, err: &(dyn Error + Send + Sync + 'static)) -> bool

Handle an error condition or abort evaluation.

fn evaluate<T>(&mut self, expr: T) -> Result<Self::Output<T>, Self::Error>

where T: Evaluate<'a, Self>,

Evaluate an RPSL expression.

fn collect_result<T, E1, E2>( &mut self, result: Result<T, E1>, ) -> Result<Option<T>, E2>

where E1: Into<E2> + Error + Send + Sync + 'static, E2: Error + Send + Sync + 'static,

Handle the Result returned by a fallible operation using the error handling provided by sink_error().

fn collect_results<I, T, E1, E2, O>(&mut self, iter: I) -> Result<O, E2>

where I: IntoIterator<Item = Result<T, E1>>, E1: Into<E2> + Error + Send + Sync + 'static, E2: Error + Send + Sync + 'static, O: FromIterator<T>,

Collect an Iterator of Results into a collection, handling and filtering out non-fatal errors in the process.

impl Resolver<'_, AsSet, <Any as AfiClass>::PrefixSet> for RpslEvaluator

type IError = Error

The error type produced by failed resolution attempts.

fn resolve(&mut self, as_set: &AsSet) -> Result<PrefixSet<Any>, Self::IError>

Attempt to resolve an RPSL name or primitive.

impl Resolver<'_, AutNum, <Any as AfiClass>::PrefixSet> for RpslEvaluator

type IError = Error

The error type produced by failed resolution attempts.

fn resolve(&mut self, autnum: &AutNum) -> Result<PrefixSet<Any>, Self::IError>

Attempt to resolve an RPSL name or primitive.

impl Resolver<'_, FilterSet, Expr<Any>> for RpslEvaluator

type IError = Error

The error type produced by failed resolution attempts.

fn resolve( &mut self, filter_set: &FilterSet, ) -> Result<MpFilterExpr, Self::IError>

Attempt to resolve an RPSL name or primitive.

impl Resolver<'_, PeerAs, <Any as AfiClass>::PrefixSet> for RpslEvaluator

type IError = Error

The error type produced by failed resolution attempts.

fn resolve(&mut self, _: &PeerAs) -> Result<PrefixSet<Any>, Self::IError>

Attempt to resolve an RPSL name or primitive.

impl Resolver<'_, RouteSet, <Any as AfiClass>::PrefixSet> for RpslEvaluator

type IError = Error

The error type produced by failed resolution attempts.

fn resolve( &mut self, route_set: &RouteSet, ) -> Result<PrefixSet<Any>, Self::IError>

Attempt to resolve an RPSL name or primitive.