Skip to main content

PropPredicate

Struct PropPredicate 

Source
pub struct PropPredicate {
    pub field: String,
    pub eq: Option<Value>,
    pub in_: Option<Vec<Value>>,
}
Expand description

One property test a role’s visibility may carry, beside labels.

Equality and membership only: no ranges, no negation, no nesting. A mask that can express arbitrary predicates is a query language with a security boundary attached — every operator added is another shape the resolver has to be right about, on the deny side, forever. Two operators are enough for the case that motivates them (status in ["published"]) and small enough to be obviously correct.

Exactly one of eq and in is set; validate enforces it.

§Value shapes accepted on the way in

A predicate is usually hand-written, so both spellings of a value parse: the plain JSON scalar ("published", 3, true) and the tagged form the graph’s own Value serializes as ({"Str": "published"}, {"Int": 3}). They mean the same thing. Serialization always writes the tagged form, so a sidecar this binary rewrote is unambiguous no matter which one was typed.

Fields§

§field: String

The property to test. Never empty.

§eq: Option<Value>

Single-value form: the property must equal this value.

§in_: Option<Vec<Value>>

Membership form: the property must equal one of these values. An empty list matches nothing — it is a valid, fully-closed predicate.

Implementations§

Source§

impl PropPredicate

Source

pub fn holds(&self, value: Option<&Value>) -> bool

Test one node’s property value against the predicate.

visible = keys ∪ { n : label(n) ∈ labels ∧ holds(n) }.

A missing property does not hold: absent is not a match. A node that never carried the field is outside a narrowed role, which is the deny-side answer — a role narrowed to status in ["published"] must not see a document that has no status at all.

Source

pub fn validate_named(&self, what: &str) -> Result<(), String>

Reject a predicate that does not name exactly one test of one field.

what is the argument name in the error ("visible_where" for roles, "where" for query filters).

Source

pub fn validate(&self) -> Result<(), String>

Reject a predicate that does not name exactly one test of one field.

Trait Implementations§

Source§

impl Clone for PropPredicate

Source§

fn clone(&self) -> PropPredicate

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for PropPredicate

Source§

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

Formats the value using the given formatter. Read more
Source§

impl<'de> Deserialize<'de> for PropPredicate

Source§

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>
where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer. Read more
Source§

impl PartialEq for PropPredicate

Source§

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

Equality operator ==. Read more
1.0.0 (const: unstable) · Source§

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

Inequality operator !=. Read more
Source§

impl Serialize for PropPredicate

Source§

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

Serialize this value into the given Serde serializer. Read more
Source§

impl StructuralPartialEq for PropPredicate

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> ArchivePointee for T

Source§

type ArchivedMetadata = ()

The archived version of the pointer metadata for this type.
Source§

fn pointer_metadata( _: &<T as ArchivePointee>::ArchivedMetadata, ) -> <T as Pointee>::Metadata

Converts some archived metadata to the pointer metadata for itself.
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> DeserializeOwned for T
where T: for<'de> Deserialize<'de>,

Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> LayoutRaw for T

Source§

fn layout_raw(_: <T as Pointee>::Metadata) -> Result<Layout, LayoutError>

Returns the layout of the type.
Source§

impl<T, N1, N2> Niching<NichedOption<T, N1>> for N2
where T: SharedNiching<N1, N2>, N1: Niching<T>, N2: Niching<T>,

Source§

unsafe fn is_niched(niched: *const NichedOption<T, N1>) -> bool

Returns whether the given value has been niched. Read more
Source§

fn resolve_niched(out: Place<NichedOption<T, N1>>)

Writes data to out indicating that a T is niched.
Source§

impl<T> Pointee for T

Source§

type Metadata = ()

The metadata type for pointers and references to this type.
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.