claude-api-test 0.5.3

Test utilities for claude-api: cassette-based replay of recorded HTTP exchanges
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
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148

//! End-to-end: load a cassette, mount it, drive a real `claude_api::Client`
//! through it.

use claude_api::Client;
use claude_api::messages::{ContentBlock, CreateMessageRequest, KnownBlock};
use claude_api::types::ModelId;
use claude_api_test::{Cassette, RecordedExchange, mount_cassette};
use pretty_assertions::assert_eq;
use serde_json::json;
use wiremock::MockServer;

fn client_for(server: &MockServer) -> Client {
    Client::builder()
        .api_key("sk-ant-test")
        .base_url(server.uri())
        .build()
        .unwrap()
}

#[tokio::test]
async fn replays_messages_create_from_jsonl_file() {
    let cassette = Cassette::from_path("tests/cassettes/messages_create.jsonl")
        .await
        .expect("cassette loads");
    assert_eq!(cassette.len(), 1);

    let server = MockServer::start().await;
    mount_cassette(&server, &cassette).await;

    let client = client_for(&server);
    let req = CreateMessageRequest::builder()
        .model(ModelId::SONNET_4_6)
        .max_tokens(64)
        .user("hi")
        .build()
        .unwrap();
    let resp = client.messages().create(req).await.unwrap();
    assert_eq!(resp.id, "msg_replay");
    match &resp.content[0] {
        ContentBlock::Known(KnownBlock::Text { text, .. }) => {
            assert_eq!(text, "Hello from cassette");
        }
        other => panic!("expected text block, got {other:?}"),
    }
}

#[tokio::test]
async fn replays_in_memory_cassette_with_request_body_match() {
    // Two exchanges with the same (method, path) but different request
    // bodies; matching disambiguates by body.
    let cassette = Cassette::from_exchanges(vec![
        RecordedExchange::new(
            "POST",
            "/v1/messages",
            200,
            json!({
                "id": "msg_alpha",
                "type": "message",
                "role": "assistant",
                "content": [{"type": "text", "text": "alpha-resp"}],
                "model": "claude-sonnet-4-6",
                "stop_reason": "end_turn",
                "usage": {"input_tokens": 5, "output_tokens": 1}
            }),
        )
        .with_request(json!({
            "model": "claude-sonnet-4-6",
            "max_tokens": 8,
            "messages": [{"role": "user", "content": "alpha"}]
        })),
        RecordedExchange::new(
            "POST",
            "/v1/messages",
            200,
            json!({
                "id": "msg_beta",
                "type": "message",
                "role": "assistant",
                "content": [{"type": "text", "text": "beta-resp"}],
                "model": "claude-sonnet-4-6",
                "stop_reason": "end_turn",
                "usage": {"input_tokens": 5, "output_tokens": 1}
            }),
        )
        .with_request(json!({
            "model": "claude-sonnet-4-6",
            "max_tokens": 8,
            "messages": [{"role": "user", "content": "beta"}]
        })),
    ]);

    let server = MockServer::start().await;
    mount_cassette(&server, &cassette).await;
    let client = client_for(&server);

    let make_req = |text: &str| {
        CreateMessageRequest::builder()
            .model(ModelId::SONNET_4_6)
            .max_tokens(8)
            .user(text)
            .build()
            .unwrap()
    };

    let r_alpha = client.messages().create(make_req("alpha")).await.unwrap();
    assert_eq!(r_alpha.id, "msg_alpha");

    let r_beta = client.messages().create(make_req("beta")).await.unwrap();
    assert_eq!(r_beta.id, "msg_beta");
}

#[tokio::test]
async fn replays_error_response_with_request_id_header() {
    let cassette = Cassette::from_exchanges(vec![
        RecordedExchange::new(
            "POST",
            "/v1/messages",
            429,
            json!({
                "type": "error",
                "error": {"type": "rate_limit_error", "message": "slow down"}
            }),
        )
        .with_header("request-id", "req_429_x")
        .with_header("retry-after", "30"),
    ])
    .skip_request_match();

    let server = MockServer::start().await;
    mount_cassette(&server, &cassette).await;
    let client = Client::builder()
        .api_key("sk-ant-test")
        .base_url(server.uri())
        // Disable retries so the 429 surfaces immediately.
        .retry(claude_api::retry::RetryPolicy::none())
        .build()
        .unwrap();

    let req = CreateMessageRequest::builder()
        .model(ModelId::SONNET_4_6)
        .max_tokens(8)
        .user("x")
        .build()
        .unwrap();
    let err = client.messages().create(req).await.unwrap_err();
    assert_eq!(err.request_id(), Some("req_429_x"));
    assert_eq!(err.status(), Some(http::StatusCode::TOO_MANY_REQUESTS));
}