Struct CliApp 

pub struct CliApp { /* private fields */ }

Builder entry point for the Kanban CLI.

A third-party backend crate constructs a CliApp, registers its own StoreFactory, and calls CliApp::run from its own main — owning the binary while reusing every CLI command here.

Implementations

impl CliApp

pub fn with_defaults() -> Self

Returns a CliApp pre-configured with all backends compiled in. SQLite is registered first so content-sniffing prefers it; JSON is registered as the catch-all fallback. When no backend features are active the registry is empty (same as Default).

pub fn register_backend(self, factory: Box<dyn StoreFactory>) -> Self

Registers an additional backend factory. Order matters for content sniffing — factories registered earlier win when multiple match.

Example — third-party binary with a custom backend

A crate that owns its own main can reuse every CLI command while injecting a proprietary storage backend:

use kanban_cli::CliApp;
use kanban_persistence::{PersistenceError, PersistenceStore, StoreFactory};
use std::sync::Arc;

// A backend factory provided by a third-party crate.
struct MyBackendFactory;
impl StoreFactory for MyBackendFactory {
    fn name(&self) -> &str { "my-backend" }
    fn create(
        &self,
        locator: &str,
    ) -> Result<Arc<dyn PersistenceStore + Send + Sync>, PersistenceError> {
        unimplemented!()
    }
}

#[tokio::main]
async fn main() -> anyhow::Result<()> {
    CliApp::with_defaults()
        .register_backend(Box::new(MyBackendFactory))
        .run()
        .await
}

pub fn with_config(self, config: AppConfig) -> Self

Overrides the AppConfig that run would otherwise load from disk.

pub fn registry(&self) -> &StoreRegistry

Exposes the underlying registry for inspection and tests.

pub async fn run(self) -> Result<()>

Executes the CLI: parses args, loads config, and dispatches to the requested command (or launches the TUI if no subcommand was given).

pub async fn run_with_args<I, T>(self, args: I) -> Result<()>

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Like [run], but accepts an explicit argument list instead of reading from std::env::args_os(). Useful for testing without spawning a subprocess.

Trait Implementations

impl Default for CliApp

fn default() -> Self

Returns an empty CliApp with no registered backends. Callers must register at least one via CliApp::register_backend before run can produce a store.