Crate promptml 

promptml

Type-safe LLM prompt templates for Rust, with compile-time variable checking.

Why

Prompt templates in most LLM libraries are plain strings. Forget a variable and you get a broken prompt at runtime — or worse, silently wrong output. promptml catches missing variables at compile time using a proc macro, and at runtime with clear, descriptive error messages.

Install

[dependencies]
promptml = "0.1"

Usage

Compile-time safety with prompt!

use promptml::prompt;

let t = prompt!("Translate {text} to {language}.");

// Compiles and runs fine
let out = t.render()
    .set("text", "Hello")
    .set("language", "Spanish")
    .build()?;

// Fails at compile time — missing variable caught before you ship
let bad = t.render()
    .set("text", "Hello")
    .build();

Runtime templates

use promptml::PromptTemplate;

let t = PromptTemplate::new("Summarise {topic} in {n_words} words.")?;
let out = t.render()
    .set("topic", "Rust lifetimes")
    .set("n_words", "50")
    .build()?;

Optional blocks

let t = promptml::prompt!(
    "Answer: {question}{{#if context}}\nContext: {context}{{/if}}"
);

Few-shot examples

use promptml::{prompt, Example};
use std::collections::HashMap;

let t = prompt!("{{#examples}}{input} → {label}\n{{/examples}}\nClassify: {input}");
let mut e1 = HashMap::new();
e1.insert("input".to_string(), "Great!".to_string());
e1.insert("label".to_string(), "positive".to_string());
let out = t.render()
    .set("input", "I love this!")
    .examples(vec![Example { vars: e1 }])
    .build()?;

Chat message format

use promptml::chat_prompt;

let messages = chat_prompt! {
    system: "You are a {persona}.",
    user: "{question}",
}
.render()
.set("persona", "Rust expert")
.set("question", "What is a lifetime?")
.to_messages()?;

Load templates from a TOML file

use promptml::PromptTemplate;

let t = PromptTemplate::from_file("prompts/summarise.toml")?;

# prompts/summarise.toml
[template]
name = "summarise"

[messages]
system = "You are a concise technical writer."
user   = "Summarise the following {doc_type} in {max_bullets} bullet points.\n\n{content}"

License

MIT — see LICENSE-MIT

Macros

chat_prompt

Validate a two-part (system + user) chat template at compile time.

prompt

Validate a prompt template at compile time and produce a [PromptTemplate].

Structs

Example

A set of key-value variables for one row of a few-shot examples block.

Message

A single chat message with a role and text content.

PromptTemplate

A parsed prompt template that can be rendered with variable substitution.

RenderBuilder

A builder that accumulates variable bindings before rendering a PromptTemplate.

Enums

PromptError

Errors that can occur when working with prompt templates.

Role

The role of a participant in a chat conversation.