Struct FilterResultSet 

pub struct FilterResultSet { /* private fields */ }

Result feedback from a single filter execution.

Filters populate this to communicate outcomes (e.g. cache hit/miss, auth success/failure) without knowing about branching.

use praxis_filter::FilterResultSet;

let mut results = FilterResultSet::new();
results.set("status", "hit").unwrap();
assert_eq!(results.get("status"), Some("hit"));
assert!(results.matches("status", "hit"));
assert!(!results.matches("status", "miss"));

Implementations

impl FilterResultSet

pub fn new() -> Self

Create an empty result set.

use praxis_filter::FilterResultSet;

let rs = FilterResultSet::new();
assert!(rs.is_empty());

pub fn get(&self, key: &str) -> Option<&str>

Get a result value by key.

use praxis_filter::FilterResultSet;

let mut rs = FilterResultSet::new();
rs.set("action", "allow").unwrap();
assert_eq!(rs.get("action"), Some("allow"));
assert_eq!(rs.get("missing"), None);

pub fn is_empty(&self) -> bool

Whether the result set has no entries.

pub fn matches(&self, key: &str, value: &str) -> bool

Whether a key-value pair matches.

use praxis_filter::FilterResultSet;

let mut rs = FilterResultSet::new();
rs.set("tier", "premium").unwrap();
assert!(rs.matches("tier", "premium"));
assert!(!rs.matches("tier", "free"));
assert!(!rs.matches("missing", "x"));

pub fn set( &mut self, key: impl Into<Cow<'static, str>>, value: impl Into<Cow<'static, str>>, ) -> Result<(), FilterError>

Set a result key-value pair.

Errors

Returns FilterError if:

• key is empty, exceeds 64 bytes, or contains non-ASCII-alphanumeric characters (besides _ and -)
• value exceeds 256 bytes or contains control characters (0x00-0x1F except 0x09/tab)

use praxis_filter::FilterResultSet;

let mut rs = FilterResultSet::new();
assert!(rs.set("valid-key_1", "value").is_ok());
assert!(rs.set("", "value").is_err());

Trait Implementations

impl Clone for FilterResultSet

fn clone(&self) -> FilterResultSet

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FilterResultSet

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

Formats the value using the given formatter.

impl Default for FilterResultSet

fn default() -> FilterResultSet

Returns the “default value” for a type.