llm-output-parser 0.2.0

Production-grade parser for extracting structured data from LLM responses. Handles think blocks, markdown fences, malformed JSON, and real-world model output without an additional LLM call.
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

#![deny(missing_docs)]
#![deny(clippy::all)]
//! # LLM Output Parser
//!
//! Production-grade parser for extracting structured data from LLM responses.
//! Handles think blocks, markdown fences, malformed JSON, and other real-world
//! model output patterns without requiring an additional LLM call.
//!
//! ## Parsers Available
//!
//! | Parser | Use Case |
//! |--------|----------|
//! | [`parse_json`] | Extract typed JSON structs |
//! | [`parse_json_value`] | Extract untyped JSON |
//! | [`parse_string_list`] | Extract cleaned string lists (tags, items) |
//! | [`parse_string_list_raw`] | Extract string lists without cleaning |
//! | [`parse_xml_tag`] | Extract content from an XML tag |
//! | [`parse_xml_tags`] | Extract content from multiple XML tags |
//! | [`parse_choice`] | Extract a choice from valid options |
//! | [`parse_number`] | Extract a numeric value |
//! | [`parse_number_in_range`] | Extract a bounded numeric value |
//! | [`parse_text`] | Clean text extraction |
//! | `parse_yaml` | Extract typed YAML (feature: `yaml`) |
//!
//! ## Traced Variants
//!
//! | Parser | Use Case |
//! |--------|----------|
//! | [`parse_json_with_trace`] | JSON extraction with diagnostic trace |
//! | [`parse_json_value_with_trace`] | Untyped JSON with diagnostic trace |
//! | [`parse_string_list_with_trace`] | List extraction with diagnostic trace |
//! | [`parse_xml_tag_with_trace`] | Single XML tag extraction with trace |
//! | [`parse_xml_tags_with_trace`] | Multi-tag XML extraction with trace |
//! | [`parse_choice_with_trace`] | Choice extraction with trace |
//! | [`parse_number_with_trace`] | Numeric extraction with trace |
//! | [`parse_number_in_range_with_trace`] | Bounded numeric extraction with trace |
//! | [`parse_text_with_trace`] | Text cleanup with trace |
//!
//! ## Configuration
//!
//! | Type | Purpose |
//! |------|---------|
//! | [`ParseOptions`] | Safety limits and behavior toggles |
//! | [`ParseTrace`] | Diagnostic output from traced parse calls |
//!
//! ## Shared Utilities
//!
//! | Function | Purpose |
//! |----------|---------|
//! | [`strip_think_tags`] | Remove `<think>` blocks from text |
//! | [`try_repair_json`] | Fix common LLM JSON errors |

pub mod choice;
pub mod error;
pub mod extract;
pub mod json;
pub mod list;
pub mod number;
pub mod repair;
pub mod text;
pub mod xml;

#[cfg(feature = "yaml")]
pub mod yaml;

// Re-export all public functions at module level
pub use choice::{parse_choice, parse_choice_with_trace};
pub use error::{ParseError, ParseOptions, ParseTrace};
pub use extract::{preprocess, strip_think_tags};
pub use json::{parse_json, parse_json_value, parse_json_value_with_trace, parse_json_with_trace};
pub use list::{parse_string_list, parse_string_list_raw, parse_string_list_with_trace};
pub use number::{
    parse_number, parse_number_in_range, parse_number_in_range_with_trace, parse_number_with_trace,
};
pub use repair::try_repair_json;
pub use text::{parse_text, parse_text_with_trace};
pub use xml::{parse_xml_tag, parse_xml_tag_with_trace, parse_xml_tags, parse_xml_tags_with_trace};

#[cfg(feature = "yaml")]
pub use yaml::parse_yaml;