Struct CompletionTreeBuilder 

pub struct CompletionTreeBuilder;

Builds immutable completion trees from command and config metadata.

This is the canonical builder surface for completion-tree construction.

Implementations

impl CompletionTreeBuilder

pub fn build_from_specs( &self, specs: &[CommandSpec], pipe_verbs: impl IntoIterator<Item = (String, String)>, ) -> Result<CompletionTree, CompletionTreeBuildError>

Builds an immutable completion tree from declarative command specs.

The resulting structure is intentionally plain data so callers can cache it, augment it with plugin/provider hints, and pass it into the engine without keeping builder state alive.

Errors

Returns CompletionTreeBuildError::DuplicateRootCommand when specs contains duplicate root command names, or CompletionTreeBuildError::DuplicateSubcommand when any nested subcommand list reuses a name under the same parent path.

Examples

use osp_cli::completion::{CommandSpec, CompletionTreeBuilder};

let tree = CompletionTreeBuilder.build_from_specs(
    &[CommandSpec::new("config")
        .tooltip("Runtime configuration")
        .subcommand(CommandSpec::new("set"))],
    [("P".to_string(), "Project fields".to_string())],
)
.expect("tree should build");

assert!(tree.root.children.contains_key("config"));
assert!(tree.root.children["config"].children.contains_key("set"));
assert_eq!(tree.pipe_verbs.get("P").map(String::as_str), Some("Project fields"));

pub fn apply_config_set_keys( &self, tree: &mut CompletionTree, keys: impl IntoIterator<Item = ConfigKeySpec>, ) -> Result<(), CompletionTreeBuildError>

Injects config set key completions into an existing tree.

This is a no-op when the tree does not contain a config set path.

Errors

Returns CompletionTreeBuildError::DuplicateConfigSetKey when keys contains duplicate config-set key names.

Examples

use osp_cli::completion::{CommandSpec, CompletionTreeBuilder, ConfigKeySpec};

let mut tree = CompletionTreeBuilder.build_from_specs(
    &[CommandSpec::new("config").subcommand(CommandSpec::new("set"))],
    [],
)
.expect("tree should build");
CompletionTreeBuilder.apply_config_set_keys(
    &mut tree,
    [
        ConfigKeySpec::new("ui.format"),
        ConfigKeySpec::new("log.level"),
    ],
)
.expect("config keys should inject");

let set_node = &tree.root.children["config"].children["set"];
assert!(set_node.children.contains_key("ui.format"));
assert!(set_node.children.contains_key("log.level"));
assert!(set_node.children["ui.format"].value_key);

Trait Implementations

impl Clone for CompletionTreeBuilder

fn clone(&self) -> CompletionTreeBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CompletionTreeBuilder

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

Formats the value using the given formatter.

impl Default for CompletionTreeBuilder

fn default() -> CompletionTreeBuilder

Returns the “default value” for a type.