harn-vm 0.10.91

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
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56

//! Typed boundary helpers for Harn agent-host primitive arguments.

use std::sync::Arc;

use crate::value::{DictMap, VmError, VmValue};

pub(super) fn tools(
    args: &[VmValue],
    index: usize,
    label: &str,
) -> Result<Option<VmValue>, VmError> {
    match args.get(index) {
        Some(VmValue::Nil) | None => Ok(crate::stdlib::tools::current_tool_registry()),
        Some(VmValue::Dict(_)) => Ok(args.get(index).cloned()),
        Some(other) => Err(invalid_tools(label, other)),
    }
}

pub(super) fn tools_value(value: Option<VmValue>, label: &str) -> Result<Option<VmValue>, VmError> {
    match value {
        Some(VmValue::Nil) | None => Ok(crate::stdlib::tools::current_tool_registry()),
        Some(value @ VmValue::Dict(_)) => Ok(Some(value)),
        Some(other) => Err(invalid_tools(label, &other)),
    }
}

pub(super) fn options_value(value: Option<VmValue>, label: &str) -> Result<DictMap, VmError> {
    match value {
        Some(VmValue::Dict(options)) => {
            Ok(Arc::try_unwrap(options).unwrap_or_else(|options| options.as_ref().clone()))
        }
        Some(VmValue::Nil) | None => Ok(DictMap::new()),
        Some(other) => Err(VmError::Runtime(format!(
            "{label}: options must be a dict or nil; got {}",
            other.type_name()
        ))),
    }
}

pub(super) fn option_str(options: &DictMap, key: &str) -> Option<String> {
    match options.get(key)? {
        VmValue::Nil => None,
        value => Some(value.display()),
    }
}

pub(super) fn option_int(options: &DictMap, key: &str) -> Option<i64> {
    options.get(key)?.as_int()
}

fn invalid_tools(label: &str, value: &VmValue) -> VmError {
    VmError::Runtime(format!(
        "{label}: tools must be a tool registry dict or nil; got {}",
        value.type_name()
    ))
}