eggsearch 0.3.2

Lightweight MCP metasearch server for AI agents
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

//! Error types for eggsearch-core.

use thiserror::Error;

/// Errors produced by eggsearch-core operations.
#[derive(Debug, Error)]
pub enum CoreError {
    /// A URL failed to parse or failed URL-based validation.
    #[error("invalid URL: {0}")]
    InvalidUrl(String),

    /// A query failed validation (empty, oversized, or invalid `max_results`).
    #[error("invalid query: {0}")]
    InvalidQuery(String),

    /// The configuration file or values are invalid.
    #[error("config error: {0}")]
    Config(String),

    /// A specific provider failed during a search.
    #[error("provider '{provider}' failed: {message}")]
    Provider {
        /// Stable provider id (e.g. `"duckduckgo"`).
        provider: String,
        /// Human-readable detail.
        message: String,
    },

    /// An I/O error.
    #[error("io error: {0}")]
    Io(#[from] std::io::Error),

    /// A JSON serialization error.
    #[error("serialization error: {0}")]
    Serde(#[from] serde_json::Error),

    /// A TOML deserialization error.
    #[error("toml parse error: {0}")]
    TomlDe(#[from] toml::de::Error),

    /// A TOML serialization error.
    #[error("toml serialization error: {0}")]
    TomlSer(String),

    /// A catch-all error for anything not covered above.
    #[error("{0}")]
    Other(String),
}

/// Convenience alias for `Result<T, CoreError>`.
pub type CoreResult<T> = Result<T, CoreError>;

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

    #[test]
    fn invalid_url_message() {
        let err = CoreError::InvalidUrl("not a url".to_string());
        assert!(err.to_string().contains("invalid URL"));
        assert!(err.to_string().contains("not a url"));
    }

    #[test]
    fn invalid_query_message() {
        let err = CoreError::InvalidQuery("query too long".to_string());
        assert!(err.to_string().contains("invalid query"));
        assert!(err.to_string().contains("query too long"));
    }

    #[test]
    fn config_error_message() {
        let err = CoreError::Config("missing field".to_string());
        assert!(err.to_string().contains("config error"));
        assert!(err.to_string().contains("missing field"));
    }

    #[test]
    fn provider_error_message() {
        let err = CoreError::Provider {
            provider: "duckduckgo".to_string(),
            message: "timeout".to_string(),
        };
        let s = err.to_string();
        assert!(s.contains("provider 'duckduckgo'"));
        assert!(s.contains("timeout"));
    }

    #[test]
    fn io_error_from_std() {
        use std::io;
        let err = CoreError::Io(io::Error::new(io::ErrorKind::NotFound, "file not found"));
        assert!(err.to_string().contains("io error"));
    }

    #[test]
    fn serde_error_from_json() {
        let json_err = serde_json::from_str::<()>("invalid json").unwrap_err();
        let err = CoreError::Serde(json_err);
        assert!(err.to_string().contains("serialization error"));
    }

    #[test]
    fn toml_de_error_from_invalid_toml() {
        let toml_err = toml::from_str::<()>("invalid = toml").unwrap_err();
        let err = CoreError::TomlDe(toml_err);
        assert!(err.to_string().contains("toml parse error"));
    }

    #[test]
    fn toml_ser_error_message() {
        let err = CoreError::TomlSer("serialization failed".to_string());
        assert!(err.to_string().contains("toml serialization error"));
    }

    #[test]
    fn other_error_message() {
        let err = CoreError::Other("something went wrong".to_string());
        assert!(err.to_string().contains("something went wrong"));
    }
}