Struct ApcliGroup 

pub struct ApcliGroup { /* private fields */ }

Visibility configuration for the built-in apcli command group.

Instantiated via ApcliGroup::from_cli_config (Tier 1) or ApcliGroup::from_yaml (Tier 3). The constructor is private to preserve the Tier-1-vs-Tier-3 flag distinction.

Implementations

impl ApcliGroup

pub fn from_cli_config( config: Option<ApcliConfig>, registry_injected: bool, ) -> Self

Tier 1 constructor — config came from a programmatic embedder (i.e. an ApcliConfig value passed to a future embedding API).

A non-auto mode from this tier wins over env var and yaml. Because ApcliConfig is strongly typed, no validation is needed here.

pub fn from_yaml(yaml_value: Option<Value>, registry_injected: bool) -> Self

Tier 3 constructor — config came from apcore.yaml.

Env var (Tier 2) may override the yaml-supplied mode unless disable_env is true. On validation error, prints a message to stderr and calls std::process::exit with EXIT_INVALID_INPUT; the fallible variant ApcliGroup::try_from_yaml is available for tests.

pub fn try_from_yaml( yaml_value: Option<Value>, registry_injected: bool, ) -> Result<Self, ApcliGroupError>

Fallible sibling of ApcliGroup::from_yaml. Used by tests; the production wrapper prints the error and exits.

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

Resolve effective visibility after applying the four-tier precedence.

Returns one of "all" | "none" | "include" | "exclude" — never "auto". Tier order (spec §4.4):

1. from_cli_config with a non-auto mode wins outright.
2. APCORE_CLI_APCLI env var (unless sealed by disable_env).
3. yaml non-auto mode.
4. Auto-detect: registry_injected ? "none" : "all".

pub fn is_subcommand_included(&self, subcommand: &str) -> bool

Return true iff subcommand passes the include/exclude filter.

Callers MUST first check ApcliGroup::resolve_visibility — this method panics if called under modes "all" or "none" (caller bug per spec §4.6).

pub fn is_group_visible(&self) -> bool

True iff the apcli group itself should appear in root --help.

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

Enumerate the effective include list. Empty unless resolved mode is "include".

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

Enumerate the effective exclude list. Empty unless resolved mode is "exclude".

pub fn disable_env(&self) -> bool

True iff Tier 2 env-var lookup is sealed.

Trait Implementations

impl Debug for ApcliGroup

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

Formats the value using the given formatter.