mdx-gen 0.0.4

A robust Rust library for processing Markdown and converting it to HTML with support for custom blocks, enhanced table formatting, and flexible configuration options.
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

// SPDX-License-Identifier: MIT OR Apache-2.0
// Copyright (c) 2026 MDX Gen. All rights reserved.

//! MarkdownError catalogue — live + constructed variants.
//!
//! Run: `cargo run --example errors`

#![allow(clippy::unwrap_used, clippy::expect_used)]

#[path = "support.rs"]
mod support;

use mdx_gen::{
    process_markdown, process_markdown_to_writer, MarkdownError,
    MarkdownOptions, Options,
};

fn main() {
    support::header("mdx-gen -- errors");

    support::task_with_output("InputTooLarge (live)", || {
        let options = MarkdownOptions::new()
            .with_custom_blocks(false)
            .with_enhanced_tables(false)
            .with_max_input_size(16);
        match process_markdown(&"a".repeat(64), &options) {
            Err(MarkdownError::InputTooLarge { size, limit }) => {
                vec![format!(
                    "{size} bytes rejected against {limit}-byte cap"
                )]
            }
            other => vec![format!("BUG unexpected: {other:?}")],
        }
    });

    support::task_with_output("InvalidOptionsError (live)", || {
        let mut comrak_options = Options::default();
        comrak_options.extension.table = false;
        let options = MarkdownOptions::new()
            .with_enhanced_tables(true)
            .with_comrak_options(comrak_options);
        match process_markdown("# hi", &options) {
            Err(MarkdownError::InvalidOptionsError(msg)) => {
                vec![format!("validation tripped: {msg}")]
            }
            other => vec![format!("BUG unexpected: {other:?}")],
        }
    });

    support::task_with_output(
        "IoError via always-failing writer",
        || {
            struct AlwaysFails;
            impl std::io::Write for AlwaysFails {
                fn write(
                    &mut self,
                    _: &[u8],
                ) -> std::io::Result<usize> {
                    Err(std::io::Error::new(
                        std::io::ErrorKind::BrokenPipe,
                        "simulated pipe",
                    ))
                }
                fn flush(&mut self) -> std::io::Result<()> {
                    Ok(())
                }
            }

            let options = MarkdownOptions::new()
                .with_custom_blocks(false)
                .with_enhanced_tables(false);
            match process_markdown_to_writer(
                "# hi",
                &mut AlwaysFails,
                &options,
            ) {
                Err(MarkdownError::IoError(e)) => {
                    vec![format!("writer failure surfaced: {e}")]
                }
                other => vec![format!("BUG unexpected: {other:?}")],
            }
        },
    );

    support::task_with_output(
        "Constructed variants (Display form)",
        || {
            let variants = [
                MarkdownError::ParseError(
                    "unterminated code fence".into(),
                ),
                MarkdownError::ConversionError(
                    "comrak write failed".into(),
                ),
                MarkdownError::CustomBlockError(
                    "unknown block: frobnicate".into(),
                ),
                MarkdownError::SyntaxHighlightError(
                    "no syntax for <klingon>".into(),
                ),
                MarkdownError::SyntaxSetError(
                    "failed to load defaults".into(),
                ),
                MarkdownError::RenderError("non-UTF-8 output".into()),
            ];
            variants.iter().map(|e| format!("{e}")).collect()
        },
    );

    support::summary(4);
}