stet-pdf-reader 0.7.0

PDF parser and renderer
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

// stet-pdf-reader
// Copyright (c) 2026 Scott Bowman
// SPDX-License-Identifier: Apache-2.0 OR MIT

//! PDF parsing error types.

use thiserror::Error;

/// Errors that can occur during PDF parsing and object resolution.
///
/// Marked `#[non_exhaustive]` so new error variants can land additively;
/// downstream consumers must include a wildcard arm in `match` sites.
#[derive(Debug, Error)]
#[non_exhaustive]
pub enum PdfError {
    #[error("not a PDF file (missing %PDF header)")]
    NotAPdf,

    #[error("unsupported PDF version: {0}")]
    UnsupportedVersion(String),

    #[error("startxref not found")]
    NoStartXref,

    #[error("malformed xref table at offset {0}")]
    MalformedXref(usize),

    #[error("malformed trailer dictionary")]
    MalformedTrailer,

    #[error("object {obj_num} {gen_num} not found")]
    ObjectNotFound { obj_num: u32, gen_num: u16 },

    #[error("unexpected token: expected {expected}, got {got}")]
    UnexpectedToken { expected: String, got: String },

    #[error("unterminated {0}")]
    Unterminated(&'static str),

    #[error("invalid object at offset {0}")]
    InvalidObject(usize),

    #[error("stream missing /Length")]
    StreamMissingLength,

    #[error("unsupported filter: {0}")]
    UnsupportedFilter(String),

    #[error("decompression error: {0}")]
    DecompressionError(String),

    #[error("missing required key /{0} in dictionary")]
    MissingKey(&'static str),

    #[error("type mismatch: expected {expected} for /{key}")]
    TypeMismatch { key: String, expected: &'static str },

    #[error("page index {0} out of range (document has {1} pages)")]
    PageOutOfRange(usize, usize),

    #[error("circular reference detected for object {0} {1}")]
    CircularReference(u32, u16),

    /// A recursive-descent parse hit its nesting cap.
    ///
    /// Raised instead of letting a crafted file exhaust the native stack,
    /// which aborts the process rather than unwinding.
    #[error("{context} nesting exceeded the limit of {limit}")]
    NestingTooDeep {
        /// What was being parsed, e.g. `"array/dictionary"`.
        context: &'static str,
        /// The cap that was reached.
        limit: u32,
    },

    #[error("PDF requires a password")]
    PasswordRequired,

    #[error("{0}")]
    Other(String),
}