Enum ContextDirection 

pub enum ContextDirection {
    ActingIn,
    Subtree,
    Any,
}

Which way a context filter reads along the context hierarchy.

A context id names a subtree, so “entries relevant to context X” is two questions, not one, and an answer is only meaningful paired with the direction being asked:

direction	question	predicate
ActingIn	who may act in X?	scope is X or an ancestor of it
Subtree	who holds a grant beneath X?	scope is X or a descendant of it
Any	whose authority touches X’s subtree?	either of the above

Only ActingIn existed until now, and a caller sweeping a subtree to revoke it got back exactly the entries it was not revoking (the ancestors keeping their authority) while every leaf-scoped grant it existed to cut was silently absent — an incomplete answer that looks like a complete one (#822).

ActingIn is the default, so an omitted parameter is today’s behaviour exactly. An unparseable value is refused rather than defaulted: guessing which question an operator meant is how the silent-wrong-answer failure returns.

Variants

ActingIn

Entries that may act in the context: scoped to it or to an ancestor of it. The historical (and default) behaviour of ?context=.

Subtree

Entries holding a grant at or beneath the context. The revocation- sweep and delegation-audit direction.

Any

The union — every entry whose act authority touches the context’s subtree in either direction. The auditor’s question.

Implementations

impl ContextDirection

pub const ALL: [ContextDirection; 3]

Every direction, in the order the operator-facing help lists them.

pub fn as_str(&self) -> &'static str

The wire spelling — identical to the serde representation, so the CLI, the query string, and the Trust Task payload cannot drift apart.

Trait Implementations

impl Clone for ContextDirection

fn clone(&self) -> ContextDirection

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ContextDirection

impl Debug for ContextDirection

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

Formats the value using the given formatter.

impl Default for ContextDirection

fn default() -> ContextDirection

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ContextDirection

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for ContextDirection

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

Formats the value using the given formatter.

impl Eq for ContextDirection

impl FromStr for ContextDirection

type Err = String

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl PartialEq for ContextDirection

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for ContextDirection

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ContextDirection