prompty 2.0.0-beta.1

Prompty is an asset class and format for LLM prompts
Documentation
// Code generated by Prompty emitter; DO NOT EDIT.

#![allow(
    unused_imports,
    dead_code,
    non_camel_case_types,
    unused_variables,
    clippy::all
)]

use super::super::context::{LoadContext, SaveContext};

use super::trace_span::TraceSpan;

/// The top-level .tracy file structure written by the file backend (ยง3.6.1).
#[derive(Debug, Clone, Default)]
pub struct TraceFile {
    /// Language/runtime name (e.g., 'python', 'csharp', 'javascript')
    pub runtime: String,
    /// Prompty library version
    pub version: String,
    /// The root trace span
    pub trace: TraceSpan,
}

impl TraceFile {
    /// Create a new TraceFile with default values.
    pub fn new() -> Self {
        Self::default()
    }

    /// Load TraceFile from a JSON string.
    pub fn from_json(json: &str, ctx: &LoadContext) -> Result<Self, serde_json::Error> {
        let value: serde_json::Value = serde_json::from_str(json)?;
        Ok(Self::load_from_value(&value, ctx))
    }

    /// Load TraceFile from a YAML string.
    pub fn from_yaml(yaml: &str, ctx: &LoadContext) -> Result<Self, serde_yaml::Error> {
        let value: serde_json::Value = serde_yaml::from_str(yaml)?;
        Ok(Self::load_from_value(&value, ctx))
    }

    /// Load TraceFile from a `serde_json::Value`.
    ///
    /// Calls `ctx.process_input` before field extraction.
    pub fn load_from_value(value: &serde_json::Value, ctx: &LoadContext) -> Self {
        let value = ctx.process_input(value.clone());
        Self {
            runtime: value
                .get("runtime")
                .and_then(|v| v.as_str())
                .unwrap_or_default()
                .to_string(),
            version: value
                .get("version")
                .and_then(|v| v.as_str())
                .unwrap_or_default()
                .to_string(),
            trace: value
                .get("trace")
                .filter(|v| v.is_object() || v.is_array() || v.is_string())
                .map(|v| TraceSpan::load_from_value(v, ctx))
                .unwrap_or_default(),
        }
    }

    /// Serialize TraceFile to a `serde_json::Value`.
    ///
    /// Calls `ctx.process_dict` after serialization.
    pub fn to_value(&self, ctx: &SaveContext) -> serde_json::Value {
        let mut result = serde_json::Map::new();
        // Write base fields
        if !self.runtime.is_empty() {
            result.insert(
                "runtime".to_string(),
                serde_json::Value::String(self.runtime.clone()),
            );
        }
        if !self.version.is_empty() {
            result.insert(
                "version".to_string(),
                serde_json::Value::String(self.version.clone()),
            );
        }
        {
            let nested = self.trace.to_value(ctx);
            if !nested.is_null() {
                result.insert("trace".to_string(), nested);
            }
        }
        ctx.process_dict(serde_json::Value::Object(result))
    }

    /// Serialize TraceFile to a JSON string.
    pub fn to_json(&self, ctx: &SaveContext) -> Result<String, serde_json::Error> {
        serde_json::to_string_pretty(&self.to_value(ctx))
    }

    /// Serialize TraceFile to a YAML string.
    pub fn to_yaml(&self, ctx: &SaveContext) -> Result<String, serde_yaml::Error> {
        serde_yaml::to_string(&self.to_value(ctx))
    }
}