Struct FilterChain 

pub struct FilterChain { /* private fields */ }

Filter chain with correct include/exclude semantics.

Evaluation order:

1. Exclude filters (AND): Any match → reject. Adapter must pass ALL excludes.
2. Include filters (OR): Any match → accept. Adapter needs to pass ANY include. Empty includes = match all (passthrough).

Examples

use ddns_a::network::filter::{FilterChain, KindFilter, AdapterFilter};
use ddns_a::network::{AdapterSnapshot, AdapterKind};

let chain = FilterChain::new()
    .exclude(KindFilter::new([AdapterKind::Loopback]))
    .include(KindFilter::new([AdapterKind::Wireless, AdapterKind::Ethernet]));

let eth = AdapterSnapshot::new("eth0", AdapterKind::Ethernet, vec![], vec![]);
let virtual_adapter = AdapterSnapshot::new("vm0", AdapterKind::Virtual, vec![], vec![]);
let loopback = AdapterSnapshot::new("lo", AdapterKind::Loopback, vec![], vec![]);

assert!(chain.matches(&eth));       // Included by kind
assert!(!chain.matches(&virtual_adapter)); // Not in include kinds
assert!(!chain.matches(&loopback)); // Excluded

Implementations

impl FilterChain

pub fn new() -> Self

Creates an empty filter chain (matches all adapters).

pub fn include<F: AdapterFilter + 'static>(self, filter: F) -> Self

Adds an include filter (OR semantics).

Adapters matching ANY include filter will be accepted (after passing all exclude filters).

pub fn exclude<F: AdapterFilter + 'static>(self, filter: F) -> Self

Adds an exclude filter (AND semantics - must not match ANY).

Adapters matching ANY exclude filter will be rejected, regardless of include filters.

pub fn include_count(&self) -> usize

Returns the number of include filters.

pub fn exclude_count(&self) -> usize

Returns the number of exclude filters.

pub fn is_empty(&self) -> bool

Returns true if no filters are configured.

Trait Implementations

impl AdapterFilter for FilterChain

fn matches(&self, adapter: &AdapterSnapshot) -> bool

Returns true if the adapter should be included, false to filter it out.

impl Debug for FilterChain

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

Formats the value using the given formatter.

impl Default for FilterChain

fn default() -> FilterChain

Returns the “default value” for a type.