glyphweaveforge 0.1.6

Convert Markdown into PDF through an explicit Rust pipeline with minimal and Typst backends.
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

use std::path::PathBuf;

use thiserror::Error;

/// Crate-wide result type.
pub type Result<T> = std::result::Result<T, ForgeError>;

/// Errors produced by the conversion pipeline.
#[derive(Debug, Error)]
pub enum ForgeError {
    /// No markdown source was configured before conversion.
    #[error("a markdown source must be provided before conversion")]
    MissingSource,
    /// No output target was configured before conversion.
    #[error("an output target must be provided before conversion")]
    MissingOutput,
    /// Reading a path-based markdown source failed.
    #[error("failed to read markdown input from {path}: {source}")]
    InputRead {
        path: PathBuf,
        #[source]
        source: std::io::Error,
    },
    /// Byte input was not valid UTF-8.
    #[error("input bytes are not valid UTF-8")]
    InvalidUtf8(#[from] std::str::Utf8Error),
    /// Markdown parsing failed.
    #[error("failed to parse markdown: {message}")]
    Parse { message: String },
    /// A resource resolver returned a hard failure.
    #[error("resource resolution failed for {target}: {message}")]
    Resource { target: String, message: String },
    /// A supplied runtime configuration value was invalid.
    #[error("invalid configuration for {field}: {message}")]
    InvalidConfiguration {
        field: &'static str,
        message: String,
    },
    /// The selected renderer failed.
    #[error("renderer failed: {message}")]
    Render { message: String },
    /// Typst compilation failed.
    #[error("typst compilation failed: {message}")]
    TypstCompile { message: String },
    /// Typst PDF export failed.
    #[error("typst PDF export failed: {message}")]
    TypstExport { message: String },
    /// Typst-specific asset preparation failed.
    #[error("typst asset {target} is unavailable: {message}")]
    TypstAsset { target: String, message: String },
    /// Writing the final PDF to a file failed.
    #[error("failed to write PDF to {path}: {source}")]
    OutputWrite {
        path: PathBuf,
        #[source]
        source: std::io::Error,
    },
    /// Creating the output directory failed.
    #[error("failed to create output directory {path}: {source}")]
    OutputDirectory {
        path: PathBuf,
        #[source]
        source: std::io::Error,
    },
    /// A caller-supplied directory output file name was empty after trimming.
    #[error("the output file name cannot be empty")]
    InvalidOutputFileName,
}