fastmcp-rust 0.7.0

Asupersync-based MCP framework for Rust
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

//! Test harness infrastructure for FastMCP.
//!
//! This module provides utilities for writing comprehensive tests without mocks:
//!
//! - [`TestServer`]: Builder for creating test servers with real handlers
//! - Assertion helpers for validating JSON-RPC and MCP compliance
//! - Timing utilities for performance measurements
//! - [`fixtures`]: Test data generators for tools, resources, prompts, and messages
//!
//! With the `testing-lab` feature, [`lab`] also exposes deterministic-runtime
//! helpers such as `TestContext`, `TestClient`, and `LabRuntime`.
//!
//! # Example
//!
//! ```ignore
//! use fastmcp_rust::testing::prelude::*;
//!
//! #[test]
//! fn test_tool_call() {
//!     // Create a test server with real handlers
//!     let (router, client_transport, server_transport) = TestServer::builder()
//!         .build();
//!
//!     // Create a test client
//! }
//! ```
//!
//! # Design Philosophy
//!
//! - **No mocks**: All tests use real implementations via MemoryTransport
//! - **Production-faithful by default**: ordinary helpers require only public
//!   production APIs
//! - **Lab isolation**: deterministic runtime helpers require `testing-lab`
//! - **Comprehensive logging**: Built-in trace support for debugging
//! - **Resource cleanup**: Automatic cleanup of spawned tasks

mod assertions;
#[cfg(feature = "testing-lab")]
mod client;
#[cfg(feature = "testing-lab")]
mod context;
pub mod fixtures;
mod server;
mod timing;
mod trace;

pub use assertions::*;
pub use server::*;
pub use timing::*;
pub use trace::*;

/// Deterministic test helpers, available only with `testing-lab`.
///
/// This is the sole facade path that exposes lab runtime configuration and
/// helpers that obtain a runtime-installed context on the caller's behalf.
#[cfg(feature = "testing-lab")]
pub mod lab {
    pub use super::client::*;
    pub use super::context::*;
    pub use crate::{LabConfig, LabRuntime};
}

/// Prelude for convenient imports in tests.
///
/// ```ignore
/// use fastmcp_rust::testing::prelude::*;
/// ```
pub mod prelude {
    pub use super::{
        // Timing
        Stopwatch,
        // Server
        TestServer,
        TestServerBuilder,
        // Trace
        TestTrace,
        TestTraceBuilder,
        TestTraceOutput,
        Timer,
        TimingStats,
        TraceEntry,
        TraceLevel,
        TraceSummary,
        // Assertions
        assert_content_valid,
        assert_is_notification,
        assert_is_request,
        assert_json_rpc_error,
        assert_json_rpc_success,
        assert_json_rpc_valid,
        assert_mcp_compliant,
        assert_prompt_valid,
        assert_resource_valid,
        assert_tool_valid,
        is_trace_enabled,
        measure_duration,
    };

    #[cfg(feature = "testing-lab")]
    pub use super::lab::{LabConfig, LabRuntime, TestClient, TestContext};

    // Re-export commonly used types
    pub use crate::{
        Content, Cx, JsonRpcMessage, JsonRpcRequest, JsonRpcResponse, McpContext, McpError,
        McpErrorCode, McpResult, Prompt, Resource, Tool,
    };

    pub use serde_json::json;
}