pdf_oxide 0.3.23

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
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100

//! Regression tests for GitHub issue #307.
//!
//! Text rendered as garbled symbols when system fonts are missing.
//! The font parsing failure was silent, and the fallback font list
//! lacked common Linux alternatives.

use pdf_oxide::document::PdfDocument;
use pdf_oxide::editor::{DocumentEditor, EditableDocument, SaveOptions};
use tempfile::tempdir;

/// Create a minimal PDF with a Type1 font and text content.
fn create_text_pdf() -> Vec<u8> {
    let content: &[u8] = b"BT /F1 12 Tf 72 720 Td (Sample text for testing) Tj ET";
    let cs_header = format!("<</Length {}>>", content.len());

    let mut pdf = Vec::new();
    pdf.extend_from_slice(b"%PDF-1.4\n%\xe2\xe3\xcf\xd3\n");

    let off1 = pdf.len();
    pdf.extend_from_slice(b"1 0 obj\n<</Type /Catalog /Pages 2 0 R>>\nendobj\n");

    let off2 = pdf.len();
    pdf.extend_from_slice(b"2 0 obj\n<</Type /Pages /Kids [3 0 R] /Count 1>>\nendobj\n");

    let off3 = pdf.len();
    pdf.extend_from_slice(
        b"3 0 obj\n<</Type /Page /Parent 2 0 R /MediaBox [0 0 612 792] /Contents 4 0 R /Resources <</Font <</F1 5 0 R>>>>>>\nendobj\n",
    );

    let off4 = pdf.len();
    pdf.extend_from_slice(format!("4 0 obj\n{}\nstream\n", cs_header).as_bytes());
    pdf.extend_from_slice(content);
    pdf.extend_from_slice(b"\nendstream\nendobj\n");

    let off5 = pdf.len();
    pdf.extend_from_slice(
        b"5 0 obj\n<</Type /Font /Subtype /Type1 /BaseFont /Helvetica /Encoding /WinAnsiEncoding>>\nendobj\n",
    );

    let xref_offset = pdf.len();
    pdf.extend_from_slice(b"xref\n0 6\n");
    pdf.extend_from_slice(b"0000000000 65535 f \n");
    for &off in &[off1, off2, off3, off4, off5] {
        pdf.extend_from_slice(format!("{:010} 00000 n \n", off).as_bytes());
    }

    pdf.extend_from_slice(b"trailer\n<</Size 6 /Root 1 0 R>>\n");
    pdf.extend_from_slice(format!("startxref\n{}\n%%EOF", xref_offset).as_bytes());

    pdf
}

#[test]
fn test_text_extraction_with_standard_font() {
    let pdf_bytes = create_text_pdf();
    let mut doc = PdfDocument::from_bytes(pdf_bytes).unwrap();
    let text = doc.extract_text(0).unwrap_or_default();
    assert!(text.contains("Sample text"), "Should extract readable text, got: '{}'", text);
}

#[test]
fn test_text_preserved_after_save_roundtrip() {
    let dir = tempdir().unwrap();
    let original_path = dir.path().join("text_rt.pdf");
    let saved_path = dir.path().join("text_rt_saved.pdf");

    std::fs::write(&original_path, create_text_pdf()).unwrap();

    let mut editor = DocumentEditor::open(&original_path).unwrap();
    editor
        .save_with_options(&saved_path, SaveOptions::full_rewrite())
        .unwrap();

    let saved_bytes = std::fs::read(&saved_path).unwrap();
    let mut saved_doc = PdfDocument::from_bytes(saved_bytes).unwrap();
    let text = saved_doc.extract_text(0).unwrap_or_default();
    assert!(
        text.contains("Sample text"),
        "Text should be preserved after roundtrip save, got: '{}'",
        text
    );
}

#[test]
fn test_font_resources_preserved_after_save() {
    let dir = tempdir().unwrap();
    let original_path = dir.path().join("font_res.pdf");
    let saved_path = dir.path().join("font_res_saved.pdf");

    std::fs::write(&original_path, create_text_pdf()).unwrap();

    let mut editor = DocumentEditor::open(&original_path).unwrap();
    editor
        .save_with_options(&saved_path, SaveOptions::full_rewrite())
        .unwrap();

    let saved_bytes = std::fs::read(&saved_path).unwrap();
    let saved_content = String::from_utf8_lossy(&saved_bytes);
    assert!(saved_content.contains("Helvetica"), "Saved PDF should preserve font references");
}