anyllm 0.1.0

Low-level, generic LLM provider abstraction for Rust
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

use std::sync::Arc;

/// Shared provider identity surface for chat and embedding providers.
///
/// Returns the provider identity string used for logs, tracing, fixtures, and
/// diagnostics (for example `"anthropic"` or `"openai"`).
///
/// This is an open string surface rather than a closed enum so wrappers and
/// custom providers can preserve their existing naming. Callers should not
/// treat it as a stable capability-dispatch mechanism.
pub trait ProviderIdentity: Send + Sync {
    /// Returns the provider identity name.
    fn provider_name(&self) -> &'static str {
        "unknown"
    }
}

impl<T> ProviderIdentity for &T
where
    T: ProviderIdentity + ?Sized,
{
    fn provider_name(&self) -> &'static str {
        T::provider_name(*self)
    }
}

impl<T> ProviderIdentity for Box<T>
where
    T: ProviderIdentity + ?Sized,
{
    fn provider_name(&self) -> &'static str {
        T::provider_name(self.as_ref())
    }
}

impl<T> ProviderIdentity for Arc<T>
where
    T: ProviderIdentity + ?Sized,
{
    fn provider_name(&self) -> &'static str {
        T::provider_name(self.as_ref())
    }
}

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

    struct Named;

    impl ProviderIdentity for Named {
        fn provider_name(&self) -> &'static str {
            "named"
        }
    }

    struct Default;

    impl ProviderIdentity for Default {}

    #[test]
    fn default_method_returns_unknown() {
        assert_eq!(Default.provider_name(), "unknown");
    }

    #[test]
    fn concrete_impl_returns_configured_name() {
        assert_eq!(Named.provider_name(), "named");
    }

    #[test]
    fn ref_forwarding_delegates() {
        let named = Named;
        let borrowed: &Named = &named;
        assert_eq!(borrowed.provider_name(), "named");
    }

    #[test]
    fn box_forwarding_delegates() {
        let boxed: Box<dyn ProviderIdentity> = Box::new(Named);
        assert_eq!(boxed.provider_name(), "named");
    }

    #[test]
    fn arc_forwarding_delegates() {
        let arced: Arc<dyn ProviderIdentity> = Arc::new(Named);
        assert_eq!(arced.provider_name(), "named");
    }
}