kaish-kernel 0.16.0

Core kernel for kaish: lexer, parser, interpreter, and runtime
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49

//! Tool system for kaish.
//!
//! Tools are the primary way to perform actions in kaish. Every command
//! is a tool — builtins and user-defined tools all implement
//! the same `Tool` trait.
//!
//! # Architecture
//!
//! ```text
//! ToolRegistry
//! ├── Builtins (echo, ls, cat, ...)
//! └── User Tools (defined via `tool` statements)
//! ```

mod builtin;
mod clap_schema;
mod context;
mod global_flags;
mod registry;
mod traits;

pub use builtin::register_builtins;
#[cfg(feature = "subprocess")]
pub use builtin::{resolve_in_path, virtual_cwd_error};
pub use clap_schema::{params_from_clap, schema_from_clap, schema_tree_from_clap};
pub use context::{
    external_commands_unavailable_error, ExecContext, ExternalCommandsUnavailable,
    GateExpectations, OutputContext, OverwriteExpectation,
};
pub(crate) use context::{cas_overwrite, is_trash_excluded, ExternalCommandOutcome};
pub use global_flags::GlobalFlags;
pub use registry::ToolRegistry;
pub use traits::{ArgBinding, global_flag_value_is_truthy, is_global_output_flag, validate_against_schema, Tool, ToolArgs, ToolCtx, ToolSchema, ParamSchema};

/// Commands that consume bareword `key=value` argv (Arg::WordAssign) as
/// shell-assignment pairs and route them through `tool_args.named`. For every
/// other command, `key=value` lands as a positional `"key=value"` string —
/// matching bash (`cat foo=bar` opens a file named `foo=bar`).
///
/// Add to this list only for builtins that have a documented shell-assignment
/// argv contract (`export FOO=bar`, `alias greet='echo hi'`). Long-flag
/// `--key=value` is a separate AST node (`Arg::Named`) and routes through
/// `tool_args.named` regardless — except past `--`, where both spellings
/// become literal positionals.
pub const WORD_ASSIGN_BUILTINS: &[&str] = &["export", "alias", "unalias"];

pub fn accepts_word_assign(name: &str) -> bool {
    WORD_ASSIGN_BUILTINS.contains(&name)
}