zshrs 0.13.36

The first JIT-compiled Unix shell — bytecode VM, Cranelift JIT, worker pool, AOP intercept, Rkyv caching
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
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77

//! Port of `_expand_word` from `Completion/Base/Widget/_expand_word`.
//!
//! Full upstream body (13 lines verbatim):
//! ```text
//! sh: 1  #compdef -K _expand_word complete-word \C-xe _list_expansions list-choices \C-xd
//! sh: 2
//! sh: 3  # Simple completion front-end implementing expansion.
//! sh: 4
//! sh: 5  local curcontext="$curcontext"
//! sh: 6
//! sh: 7  if [[ -z "$curcontext" ]]; then
//! sh: 8    curcontext="expand-word:::"
//! sh: 9  else
//! sh:10    curcontext="expand-word:${curcontext#*:}"
//! sh:11  fi
//! sh:12
//! sh:13  _main_complete _expand
//! ```

use crate::compsys::ported::shared::dispatch_action_command;
use crate::ported::params::{getsparam, setsparam};

/// `_expand_word` — front-end widget: set context to `expand-word`
/// and dispatch `_main_complete _expand`.
pub fn _expand_word() -> i32 {
    let _fn_scope = crate::compsys::ported::shared::FnScope::enter("_expand_word");
    // sh:5 snapshot for shell-local restore
    let saved = getsparam("curcontext").unwrap_or_default();

    // sh:7-11
    let new_ctx = if saved.is_empty() {
        "expand-word:::".to_string()
    } else {
        let tail = saved.splitn(2, ':').nth(1).unwrap_or("");
        format!("expand-word:{}", tail)
    };
    let _ = setsparam("curcontext", &new_ctx);

    // sh:13
    // sh:13 is a COMMAND WORD, so `dispatch_action_command`
    // (shared.rs:1407) resolves it exactly as `execcmd` does:
    // shfunc/port/plugin (c:Src/exec.c:3105-3109), then builtin, then
    // `$PATH`, then c:903's `command not found` with c:908's 127. The
    // `.unwrap_or(1)` this replaces had NO not-found arm, so a name
    // that resolved nowhere returned in silence.
    let r = dispatch_action_command("_main_complete", &["_expand".to_string()], 13);

    // Restore shell-local scoping
    let _ = setsparam("curcontext", &saved);
    r
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    /// With no executor wired the command word this path ends in resolves
    /// to no shell function, no builtin and nothing on `$PATH` — the
    /// `Src/exec.c:903` case — so it reports `command not found` and the
    /// status is c:908's 127. It used to return a silent 1.
    fn unresolvable_command_word_reports_not_found() {
        let _g = crate::test_util::global_state_lock();
        assert_eq!(_expand_word(), 127);
    }

    #[test]
    fn restores_curcontext_after_call() {
        let _g = crate::test_util::global_state_lock();
        let _ = setsparam("curcontext", "original:ctx:foo:bar");
        let _ = _expand_word();
        assert_eq!(
            getsparam("curcontext").as_deref(),
            Some("original:ctx:foo:bar")
        );
    }
}