proto_core 0.55.5

Core proto APIs.
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
122
123

use crate::id::*;
use serde::{Deserialize, Serialize};
use std::cmp::Ordering;
use std::fmt;
use std::str::FromStr;

#[derive(Clone, Debug, Default, Deserialize, Eq, Hash, PartialEq, Serialize)]
#[serde(into = "String", try_from = "String")]
pub struct ToolContext {
    /// ID of the backend that tool is sourced from.
    pub backend: Option<Id>,

    /// ID of the tool itself.
    pub id: Id,

    /// The original string. Primarily exists for traits!
    original: String,
}

impl ToolContext {
    pub fn new(id: Id) -> Self {
        Self {
            original: id.to_string(),
            id,
            ..Default::default()
        }
    }

    pub fn with_backend(id: Id, backend: Id) -> Self {
        Self {
            original: format!("{backend}:{id}"),
            backend: Some(backend),
            id,
        }
    }

    pub fn as_str(&self) -> &str {
        &self.original
    }

    pub fn parse<T: AsRef<str>>(value: T) -> Result<Self, IdError> {
        Self::from_str(value.as_ref())
    }
}

impl FromStr for ToolContext {
    type Err = IdError;

    fn from_str(value: &str) -> Result<Self, Self::Err> {
        let value = value.trim_matches(':');

        let (backend, id) = if let Some((prefix, suffix)) = value.split_once(':') {
            (Some(Id::new(prefix)?), Id::new(suffix)?)
        } else {
            (None, Id::new(value)?)
        };

        Ok(Self {
            backend,
            id,
            original: value.into(),
        })
    }
}

impl TryFrom<String> for ToolContext {
    type Error = IdError;

    fn try_from(value: String) -> Result<Self, Self::Error> {
        Self::from_str(&value)
    }
}

#[allow(clippy::from_over_into)]
impl Into<String> for ToolContext {
    fn into(self) -> String {
        self.to_string()
    }
}

impl AsRef<ToolContext> for ToolContext {
    fn as_ref(&self) -> &ToolContext {
        self
    }
}

impl AsRef<str> for ToolContext {
    fn as_ref(&self) -> &str {
        self.as_str()
    }
}

impl PartialOrd for ToolContext {
    fn partial_cmp(&self, other: &Self) -> Option<Ordering> {
        Some(self.cmp(other))
    }
}

impl Ord for ToolContext {
    fn cmp(&self, other: &Self) -> Ordering {
        self.original.cmp(&other.original)
    }
}

impl fmt::Display for ToolContext {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        if let Some(backend) = &self.backend {
            write!(f, "{backend}:")?;
        }

        write!(f, "{}", self.id)
    }
}

impl schematic::Schematic for ToolContext {
    fn schema_name() -> Option<String> {
        Some("ToolContext".into())
    }

    fn build_schema(mut schema: schematic::SchemaBuilder) -> schematic::Schema {
        schema.string_default()
    }
}