switchyard-translation 0.2.0

Pure Rust request, response, and stream translation for Switchyard
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

// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
// SPDX-License-Identifier: Apache-2.0

//! Diagnostics emitted when translation preserves, drops, or degrades data.

use serde::{Deserialize, Serialize};

use crate::format::FormatId;

/// Severity level for translation diagnostics.
#[derive(Clone, Debug, Eq, PartialEq, Serialize, Deserialize)]
pub enum DiagnosticSeverity {
    Info,
    Warning,
    Error,
}

/// Structured diagnostic attached to translation output.
#[derive(Clone, Debug, Eq, PartialEq, Serialize, Deserialize)]
pub struct TranslationDiagnostic {
    pub severity: DiagnosticSeverity,
    pub code: String,
    pub message: String,
    pub source: Option<FormatId>,
    pub target: Option<FormatId>,
    pub path: Option<String>,
}

impl TranslationDiagnostic {
    /// Creates a warning diagnostic.
    pub fn warning(code: impl Into<String>, message: impl Into<String>) -> Self {
        Self {
            severity: DiagnosticSeverity::Warning,
            code: code.into(),
            message: message.into(),
            source: None,
            target: None,
            path: None,
        }
    }

    /// Adds a JSON-path-like location to a diagnostic.
    pub fn at_path(mut self, path: impl Into<String>) -> Self {
        self.path = Some(path.into());
        self
    }

    /// Adds source and target format metadata to a diagnostic.
    pub fn with_formats(
        mut self,
        source: impl Into<FormatId>,
        target: impl Into<FormatId>,
    ) -> Self {
        self.source = Some(source.into());
        self.target = Some(target.into());
        self
    }
}