llmposter 0.5.0

Drop-in mock server for OpenAI, Anthropic & Gemini APIs — library or standalone CLI. SSE streaming, tool calling, OAuth2, failure injection, streaming chaos, stateful scenarios, request capture, hot-reload, response templating, record/replay (VCR). Test LLM apps without burning tokens.
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

//! VCR record/replay: proxy unmatched requests to a real provider API and
//! save the response as a replayable fixture in a cassette file (a YAML
//! fixture file the recorder appends to). Enabled by the `record` feature.

mod cassette;
mod extract;
mod reassemble;
mod recorder;
mod redact;
mod respond;

pub(crate) use cassette::*;
pub(crate) use extract::*;
pub(crate) use reassemble::*;
pub(crate) use recorder::*;
pub(crate) use redact::*;
pub(crate) use respond::*;

/// How the server treats incoming requests relative to the cassette.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Default, clap::ValueEnum)]
pub enum VcrMode {
    /// Serve fixtures only; never contacts an upstream. This is the default.
    #[default]
    Replay,
    /// Forward every request upstream and record 2xx responses.
    /// Existing fixtures are ignored.
    ///
    /// Recording is append-idempotent: prompts already in the cassette
    /// are NOT re-recorded on later runs (the dedupe set is seeded from
    /// the cassette at build time). Delete the cassette entry — or the
    /// whole file — to re-record a prompt.
    Record,
    /// Serve matching fixtures locally; forward and record only misses.
    RecordOnMiss,
}

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

    #[test]
    fn should_default_to_replay() {
        assert_eq!(VcrMode::default(), VcrMode::Replay);
    }
}