harn-vm 0.10.68

Async bytecode virtual machine for the Harn programming language
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

//! Leading-call-head extraction — the field pair that keeps the Harn walk off
//! the regex path.

use super::super::syntax::ident_length;
use super::unit::CallHead;

/// The leading call head of `text`: an identifier immediately followed, modulo
/// inline whitespace, by `(` or `{`.
///
/// `None` when `text` does not open that way — including when it opens with an
/// identifier that no separator follows, because a bare word is narration, not
/// a call head. Whether `name` is a registered tool is deliberately not
/// answered here; that is policy, and policy lives in Harn.
#[expect(
    clippy::string_slice,
    reason = "name_len is an ASCII ident length, a char boundary"
)]
pub(crate) fn call_head(text: &str) -> Option<CallHead> {
    let trimmed = text.trim_start();
    let bytes = trimmed.as_bytes();
    let name_len = ident_length(bytes)?;
    let mut idx = name_len;
    while matches!(bytes.get(idx), Some(b' ') | Some(b'\t')) {
        idx += 1;
    }
    let sep = match bytes.get(idx) {
        Some(b'(') => '(',
        Some(b'{') => '{',
        _ => return None,
    };
    Some(CallHead {
        name: trimmed[..name_len].to_string(),
        sep,
    })
}