shell/lib.rs
1#![warn(missing_docs)]
2
3//! The Shell layer of the Virtual Computing Engine (VCE).
4//!
5//! This crate implements the **Shell** layer of the architecture: four
6//! concrete shells over two shared cores. Bash and Zsh share the execution
7//! core ([`core::ShellCore`]); PowerShell and cmd share the Windows
8//! machinery ([`windows_core`]). Each shell owns its own grammar, builtin
9//! table, and dialect. Applications drive shells through the
10//! [`shell::Shell`] trait, so a VM can boot into whichever shell its OS
11//! declares.
12
13/// The common [`Shell`] trait implemented by every shell.
14pub mod shell;
15
16/// The shared shell execution core.
17pub mod core;
18
19/// Word expansion in the session.
20pub mod expansion;
21
22/// The Bash shell implementation.
23pub mod bash;
24
25/// The Zsh shell implementation.
26pub mod zsh;
27
28/// The PowerShell shell implementation (Windows).
29pub mod powershell;
30
31/// The cmd shell implementation (Windows Command Prompt).
32pub mod cmd;
33
34/// The machinery Windows shells share (path handling, external execution,
35/// redirect I/O).
36pub mod windows_core;
37
38/// The maximum number of history entries any shell retains.
39///
40/// One limit for every shell: Bash and Zsh share the execution core's
41/// list, while PowerShell and cmd each keep their own. The cap is a single
42/// fact.
43pub const HISTORY_LIMIT: usize = 1000;
44
45pub use crate::shell::Shell;