pipa-lang 1.0.0-alpha.1

A tiny template 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
57
58
59
60
61
62
63

// SPDX-FileCopyrightText: Copyright 2026 olav@occy.org
// SPDX-License-Identifier: MPL-2.0

//! Define template functions and built-in values.

use crate::lang::arity::Arity;
use crate::value::Value;
use crate::value::keys::Keys;
use crate::value::map::Map;
use crate::value::operation;
use crate::value::operation::Operation;
use crate::value::span::Span;

/// Define a custom adapter for your environment.
pub trait Adapter: core::fmt::Debug {
    fn template_source(&self) -> Option<&str> {
        None
    }

    fn template_span(&self) -> Option<Span> {
        None
    }

    fn value_get(&self, map: &Map, keys: &Keys) -> Option<Value> {
        operation::get_map_value(map, keys)
    }

    #[doc(hidden)]
    fn record_setter(&self, _: &Value) -> Result<Option<Operation>, String> {
        Ok(None)
    }

    #[doc(hidden)]
    fn record_getter(&self, _: &Value) -> Result<Option<Operation>, String> {
        Ok(None)
    }

    #[doc(hidden)]
    fn record_operation(&self, _: &Operation) -> Result<(), String> {
        Ok(())
    }

    #[doc(hidden)]
    fn erase_operation(&self, _: &Value) -> Result<Vec<Operation>, String> {
        Ok(Vec::default())
    }

    fn func_find(&self, _: &[u8]) -> Option<Arity> {
        None
    }

    fn func_call(&self, _: &[u8], _: Vec<Option<Value>>) -> Result<Option<Value>, String> {
        Ok(None)
    }
}

/// A default noop-y adapter for simple scenarios.
#[derive(Debug, Default)]
pub struct Default {
    _private: (),
}

impl super::Adapter for Default {}