Struct AppBuilder 

pub struct AppBuilder { /* private fields */ }

Builder for configuring an App before construction.

This is the canonical public composition surface for host-level setup.

Examples

Minimal embedder main.rs:

use osp_cli::App;

fn main() {
    std::process::exit(
        App::builder().build().run_process(std::env::args_os()),
    );
}

Implementations

impl AppBuilder

pub fn with_native_commands( self, native_commands: NativeCommandRegistry, ) -> Self

Replaces the native command registry used by the built application.

This is the builder-friendly way to extend the host with extra native commands before calling AppBuilder::build. When omitted, the built app uses the crate’s default native-command registry.

This is the builder-side equivalent of App::with_native_commands. Prefer it when a wrapper crate wants to finish command registration before deciding whether to build an owned App or a sink-bound AppRunner.

pub fn with_product_defaults(self, product_defaults: ConfigLayer) -> Self

Replaces the product-owned defaults layered into runtime bootstrap.

Wrapper crates should put site-owned keys under extensions.<site>.* and inject that layer here so native commands, config get, config explain, help rendering, and REPL rebuilds all see the same resolved config.

If omitted, the built app uses only the crate’s built-in runtime defaults.

pub fn build(self) -> App

Builds an App from the current builder state.

Choose this when you want an owned application value that can be reused across many calls. Use AppBuilder::build_with_sink when binding the output sink is part of the setup.

Examples

use osp_cli::App;

let app = App::builder().build();
let exit = app.run_process(["osp", "--help"]);

assert_eq!(exit, 0);

pub fn build_with_sink<'a>(self, sink: &'a mut dyn UiSink) -> AppRunner<'a>

Builds an AppRunner bound to the provided UI sink.

This is the shortest path for tests and embedders that want one sink binding plus the full host behavior.

Examples

use osp_cli::App;
use osp_cli::app::BufferedUiSink;

let mut sink = BufferedUiSink::default();
let exit = App::builder()
    .build_with_sink(&mut sink)
    .run_process(["osp", "--help"]);

assert_eq!(exit, 0);
assert!(!sink.stdout.is_empty());
assert!(sink.stderr.is_empty());

Trait Implementations

impl Clone for AppBuilder

fn clone(&self) -> AppBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for AppBuilder

fn default() -> AppBuilder

Returns the “default value” for a type.