crates-docs 0.9.0

High-performance Rust crate documentation query MCP server, supports Stdio/HTTP/SSE transport and OAuth authentication
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

//! Error module unit tests

use crates_docs::error::Error;
use std::io;

// ============================================================================
// Error conversion tests
// ============================================================================

#[test]
fn test_error_from_io_error() {
    let io_err = io::Error::new(io::ErrorKind::NotFound, "file not found");
    let err: Error = io_err.into();
    assert!(matches!(err, Error::Io(_)));
}

#[test]
fn test_error_from_json_error() {
    let json_err = serde_json::from_str::<serde_json::Value>("invalid json").unwrap_err();
    let err: Error = json_err.into();
    assert!(matches!(err, Error::Json(_)));
}

#[test]
fn test_error_from_url_error() {
    let url_err = url::ParseError::EmptyHost;
    let err: Error = url_err.into();
    assert!(matches!(err, Error::Url(_)));
}

#[test]
fn test_error_from_boxed_error() {
    let boxed: Box<dyn std::error::Error + Send + Sync> = Box::new(io::Error::other("test error"));
    let err: Error = boxed.into();
    assert!(err.to_string().contains("test error"));
}

#[test]
fn test_error_from_anyhow_error() {
    let anyhow_err = anyhow::anyhow!("anyhow error");
    let err: Error = anyhow_err.into();
    assert!(err.to_string().contains("anyhow error"));
}

// ============================================================================
// Error Display tests
// ============================================================================

#[test]
fn test_error_display() {
    let err = Error::config("field", "test config error");
    assert!(err.to_string().contains("test config error"));

    let err = Error::cache("get", Some("key".to_string()), "test cache error");
    assert!(err.to_string().contains("test cache error"));

    let err = Error::mcp("context", "test mcp error");
    assert!(err.to_string().contains("test mcp error"));
}

#[test]
fn test_error_variants_display() {
    // Test various error type displays
    let err = Error::config("field", "config error");
    assert!(!err.to_string().is_empty());

    let err = Error::cache("get", None, "cache error");
    assert!(!err.to_string().is_empty());

    let err = Error::http_request("GET", "https://example.com", 500, "http error");
    assert!(!err.to_string().is_empty());

    let err = Error::Json(serde_json::from_str::<serde_json::Value>("bad").unwrap_err());
    assert!(!err.to_string().is_empty());

    let err = Error::Io(io::Error::other("io error"));
    assert!(!err.to_string().is_empty());

    let err = Error::Url(url::ParseError::EmptyHost);
    assert!(!err.to_string().is_empty());

    let err = Error::mcp("context", "mcp error");
    assert!(!err.to_string().is_empty());

    let err = Error::initialization("component", "init error");
    assert!(!err.to_string().is_empty());

    let err = Error::auth("provider", "auth error");
    assert!(!err.to_string().is_empty());

    let err = Error::parse("input", None, "parse error");
    assert!(!err.to_string().is_empty());

    let err = Error::Other("other error".to_string());
    assert!(!err.to_string().is_empty());
}

// ============================================================================
// Result type tests
// ============================================================================

#[test]
fn test_result_type() {
    fn returns_result() -> crates_docs::Result<()> {
        Ok(())
    }

    let result = returns_result();
    assert!(result.is_ok());
}