poet 0.7.0

Static site generator with optional MCP server and LLM SEO optimizations
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
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121

pub mod argument;
pub mod argument_with_input;

use std::collections::HashMap;

use anyhow::Result;
use anyhow::anyhow;
use rhai::CustomType;
use rhai::TypeBuilder;
use serde::Deserialize;
use serde::Serialize;

use self::argument::Argument;
use crate::prompt_document_front_matter::argument_with_input::ArgumentWithInput;

#[derive(Clone, Deserialize, Serialize)]
#[serde(deny_unknown_fields)]
pub struct PromptDocumentFrontMatter {
    pub arguments: HashMap<String, Argument>,
    pub description: String,
    pub title: String,
}

impl PromptDocumentFrontMatter {
    pub fn map_arguments(
        &self,
        inputs: HashMap<String, String>,
    ) -> Result<HashMap<String, ArgumentWithInput>> {
        self.arguments
            .clone()
            .into_iter()
            .map(
                |(
                    name,
                    Argument {
                        description,
                        required,
                        title,
                    },
                )| {
                    Ok((
                        name.clone(),
                        ArgumentWithInput {
                            description,
                            input: inputs
                                .get(&name)
                                .ok_or_else(|| anyhow!("No argument provided for '{name}'"))?
                                .to_string(),
                            required,
                            title,
                        },
                    ))
                },
            )
            .collect()
    }

    fn rhai_description(&mut self) -> String {
        self.description.clone()
    }

    fn rhai_title(&mut self) -> String {
        self.title.clone()
    }
}

impl CustomType for PromptDocumentFrontMatter {
    fn build(mut builder: TypeBuilder<Self>) {
        builder
            .with_name("PromptDocumentFrontMatter")
            .with_get("description", Self::rhai_description)
            .with_get("title", Self::rhai_title);
    }
}

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

    fn front_matter_with_argument() -> PromptDocumentFrontMatter {
        let mut arguments = HashMap::new();

        arguments.insert(
            "topic".to_string(),
            Argument {
                description: "The topic".to_string(),
                required: true,
                title: "Topic".to_string(),
            },
        );

        PromptDocumentFrontMatter {
            arguments,
            description: "description".to_string(),
            title: "title".to_string(),
        }
    }

    #[test]
    fn maps_provided_input_onto_argument() -> Result<()> {
        let mut inputs = HashMap::new();

        inputs.insert("topic".to_string(), "rust".to_string());

        let mapped = front_matter_with_argument().map_arguments(inputs)?;

        assert_eq!(mapped["topic"].input, "rust");
        assert_eq!(mapped["topic"].title, "Topic");

        Ok(())
    }

    #[test]
    fn fails_when_required_argument_input_is_missing() {
        assert!(
            front_matter_with_argument()
                .map_arguments(HashMap::new())
                .is_err()
        );
    }
}