pdf_oxide 0.3.38

The fastest Rust PDF library with text extraction: 0.8ms mean, 100% pass rate on 3,830 PDFs. 5× faster than pdf_extract, 17× faster than oxidize_pdf. Extract, create, and edit PDFs.
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

//! Logging utilities for the text extraction pipeline.
//!
//! These macros forward to the `log` crate so the configured log level
//! (via `log::set_max_level`, `env_logger`, `pyo3_log`, etc.) is honored.
//! When the `logging` feature is disabled, all logging is compiled out.
//!
//! Each macro accepts two forms for backward compatibility:
//! 1. A single expression: `extract_log_info!(my_string_var)` — logged as `{}`.
//! 2. A format string with optional args: `extract_log_info!("page {}", n)`.

/// Log an INFO level message. Forwards to `log::info!`.
#[macro_export]
macro_rules! extract_log_info {
    ($fmt:literal $(, $($arg:tt)*)?) => {
        #[cfg(feature = "logging")]
        ::log::info!($fmt $(, $($arg)*)?);
    };
    ($msg:expr) => {
        #[cfg(feature = "logging")]
        ::log::info!("{}", $msg);
    };
}

/// Log a WARN level message. Forwards to `log::warn!`.
#[macro_export]
macro_rules! extract_log_warn {
    ($fmt:literal $(, $($arg:tt)*)?) => {
        #[cfg(feature = "logging")]
        ::log::warn!($fmt $(, $($arg)*)?);
    };
    ($msg:expr) => {
        #[cfg(feature = "logging")]
        ::log::warn!("{}", $msg);
    };
}

/// Log a DEBUG level message. Forwards to `log::debug!`.
#[macro_export]
macro_rules! extract_log_debug {
    ($fmt:literal $(, $($arg:tt)*)?) => {
        #[cfg(feature = "logging")]
        ::log::debug!($fmt $(, $($arg)*)?);
    };
    ($msg:expr) => {
        #[cfg(feature = "logging")]
        ::log::debug!("{}", $msg);
    };
}

/// Log a TRACE level message. Forwards to `log::trace!`.
#[macro_export]
macro_rules! extract_log_trace {
    ($fmt:literal $(, $($arg:tt)*)?) => {
        #[cfg(feature = "logging")]
        ::log::trace!($fmt $(, $($arg)*)?);
    };
    ($msg:expr) => {
        #[cfg(feature = "logging")]
        ::log::trace!("{}", $msg);
    };
}

/// Log an ERROR level message. Forwards to `log::error!`.
#[macro_export]
macro_rules! extract_log_error {
    ($fmt:literal $(, $($arg:tt)*)?) => {
        #[cfg(feature = "logging")]
        ::log::error!($fmt $(, $($arg)*)?);
    };
    ($msg:expr) => {
        #[cfg(feature = "logging")]
        ::log::error!("{}", $msg);
    };
}

// Re-export the macros for convenience
pub use extract_log_debug;
pub use extract_log_error;
pub use extract_log_info;
pub use extract_log_trace;
pub use extract_log_warn;