Struct ExplainArgs 

pub struct ExplainArgs { /* private fields */ }

Arguments for the unified policy explain verb (basil-1zx.3).

One command, two sources of truth for the same subject/op/key → allow/deny question:

• Default (offline dry-run, basil-4vf): loads ONLY the catalog + policy JSON (no sealed bundle, no backend, no socket), builds the real Pdp, and evaluates the proposed tuple through the SAME matcher enforcement uses. It NEVER performs the op, reads a secret, or talks to a backend: safe to run anywhere, before rollout. --effective previews every grant for the subject.
• --live: queries the RUNNING broker’s serving generation over the global --socket (needs the explain admin permission). The offline config-override paths are irrelevant here, and --effective is offline-only.

What the PDP matches on: authorization binds to a registered subject. The offline tool evaluates that subject name directly; Unix uid/gid resolution is covered by the loader and runtime actor-resolution tests.

Implementations

impl ExplainArgs

pub const fn is_live(&self) -> bool

True when --live was given: query the running broker rather than files.

pub fn subject(&self) -> &str

The registered subject to evaluate.

pub fn op_token(&self) -> Option<&'static str>

The stable op token to evaluate, when --op was given. Always present on the live path, where --effective (the only thing that makes --op optional) is rejected by clap.

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

The catalog key/target to evaluate, when --key was given.

pub const fn json(&self) -> bool

Whether --json machine-readable output was requested.

Trait Implementations

impl Args for ExplainArgs

fn group_id() -> Option<Id>

Report the ArgGroup::id for this set of arguments

fn augment_args<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate Self via FromArgMatches::from_arg_matches_mut

fn augment_args_for_update<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate self via FromArgMatches::update_from_arg_matches_mut

impl Debug for ExplainArgs

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

Formats the value using the given formatter.

impl FromArgMatches for ExplainArgs

fn from_arg_matches(__clap_arg_matches: &ArgMatches) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn from_arg_matches_mut( __clap_arg_matches: &mut ArgMatches, ) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn update_from_arg_matches( &mut self, __clap_arg_matches: &ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

fn update_from_arg_matches_mut( &mut self, __clap_arg_matches: &mut ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.