Enum DecidingRule 

pub enum DecidingRule {
    Folder {
        folder_id: String,
        depth: usize,
    },
    File {
        file_id: String,
    },
}

Which configured rule (if any) decided a Decision.

None — the Option wrapping this, not a variant here — means no rule matched anywhere and the bare default policy decided it instead. Carried into the request log’s decided_by_folder_id/ decided_by_file_id/decided_by_depth context fields so a refusal is exactly as auditable as a success.

An enum rather than one struct with optional fields: a file rule has no depth (it names the target itself, at depth −1) and a folder rule has no file id, so “a file rule at depth 3” is a state that should not be expressible at all.

Variants

Folder

A folder_id rule matched the target’s ancestor chain.

Fields

folder_id: String

The folder id of the rule that decided the verdict.

depth: usize

How many levels above the target this rule’s folder sits (0 = the target itself).

File

A file_id rule named the target itself.

Fields

file_id: String

The file id of the rule that decided the verdict.

Implementations

impl DecidingRule

pub fn id(&self) -> &str

The id this rule keys on — a file id or a folder id.

Deliberately not rendered here: the id is operator-supplied but the strings it sits beside are not, and this module stays free of the CLI layer. Every render site must therefore sanitize before the line reaches a terminal — the three CLI sites (drive edit, upload, create) run the id through sanitize_for_terminal directly; the two engine-layer describe functions (sheets write, sheets create) embed it raw and their CLI callers sanitize the whole rendered line instead.

pub const fn kind_label(&self) -> &'static str

"folder" or "file" — the noun the operator-facing messages use.

pub fn depth_suffix(&self) -> String

" (depth 2)" for a folder rule, "" for a file rule.

Exists so the five describe/print_report sites are one identical line — "refused by rule on {kind} {id}{suffix}" — and cannot drift into disagreeing about how a file rule is worded.

Trait Implementations

impl Clone for DecidingRule

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DecidingRule

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

Formats the value using the given formatter.

impl Eq for DecidingRule

impl PartialEq for DecidingRule

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for DecidingRule

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 DecidingRule