Struct FilterExpr 

pub struct FilterExpr { /* private fields */ }

One parsed --filter predicate.

Implementations

impl FilterExpr

pub fn parse(raw: &str) -> Result<Self, String>

Parses one --filter expression.

Errors

Returns a localized message when no operator is present or when the key side is empty.

pub fn key(&self) -> String

The dotted path this predicate addresses, as the caller wrote it.

The gate needs the key to resolve it against the envelope vocabulary and to name it in a refusal; rebuilding the string from Self::path at every call site would duplicate the join.

pub fn path(&self) -> &[String]

The parsed path segments, for callers that resolve rather than compare.

pub fn matches(&self, element: &Value, command: Option<&str>) -> bool

Evaluates the predicate against one element.

A missing or non-scalar path never satisfies FilterOp::Equals or FilterOp::Contains; it does satisfy FilterOp::NotEquals, which reads as “this element does not carry that value”.

GAP-SG-274: command is the surface’s subcommand slug, and it scopes the synonym table exactly as it scopes the gate. Passing None here would not merely narrow the lookup — it would let the gate ACCEPT a key the walk then fails to find, which is the accepted-and-ignored shape the surface exists to remove.

Trait Implementations

impl Clone for FilterExpr

fn clone(&self) -> FilterExpr

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FilterExpr

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

Formats the value using the given formatter.

impl Eq for FilterExpr

impl PartialEq for FilterExpr

fn eq(&self, other: &FilterExpr) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for FilterExpr