micropdf 0.17.0

A pure Rust PDF library - A pure Rust PDF library with fz_/pdf_ API compatibility
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
112
113
114
115
116
117

# Test Fixtures

PDF test documents for MicroPDF integration testing.

## Files

### `minimal.pdf`
A minimal valid PDF document with:
- Single page
- Basic text content ("Hello, World!")
- Helvetica font (Type1)
- Standard US Letter size (612x792 points)

### `multipage.pdf`
A multi-page PDF for testing page handling:
- 5 pages
- Simple text content on each page
- Single font
- Standard page size

### `comprehensive_test.pdf`
A comprehensive PDF containing all major PDF features for testing:

#### Structure
- 3 pages
- PDF version 1.7
- Document catalog with all optional entries

#### Fonts
- Helvetica (Type1)
- Times-Roman (Type1)

#### Annotations
- Link annotation (external URL)
- Text annotation (sticky note)
- Highlight annotation
- Widget annotations (form fields)

#### Form Fields (AcroForm)
- Text field (`name_field`)
- Checkbox (`checkbox_field`)
- Dropdown/Choice field (`dropdown_field`)

#### Metadata
- XMP metadata stream
- Document info dictionary (Title, Author, Subject, Keywords, Creator, Producer, dates)

#### Outlines/Bookmarks
- Two chapters with destinations

#### Named Destinations
- Named destinations for each page

#### Graphics Features
- Inline image (8x8 RGB checkerboard)
- Pattern (tiling pattern)
- Extended Graphics State (transparency)
- ICC-based colorspace reference
- Compressed content stream (FlateDecode on page 2)

#### Page Features
- MediaBox and CropBox
- Resource dictionaries with Font, XObject, Pattern, ExtGState, ColorSpace

### `encrypted_empty_password.pdf`
A PDF encrypted with the Standard security handler:
- Standard encryption (V1, R2)
- Empty password
- For testing encryption detection

## Usage in Tests

```rust
use std::path::PathBuf;

fn fixture_path(name: &str) -> PathBuf {
    let mut path = PathBuf::from(env!("CARGO_MANIFEST_DIR"));
    path.push("tests");
    path.push("fixtures");
    path.push(name);
    path
}

fn read_fixture(name: &str) -> Vec<u8> {
    std::fs::read(fixture_path(name))
        .expect(&format!("Failed to read fixture: {}", name))
}
```

## Adding New Fixtures

When adding new test PDFs:

1. Place them in this directory
2. Document the features they test above
3. Git LFS will automatically handle them (see `.gitattributes`)
4. Add corresponding tests in `../integration_tests.rs`

## PDF Specification Reference

These fixtures are designed to test conformance with:
- PDF 1.4 through 1.7 specification
- ISO 32000-1:2008

Key PDF Reference Manual sections covered:
- §7.3 - Objects (null, bool, int, real, string, name, array, dict, stream)
- §7.5 - File Structure (header, body, xref, trailer)
- §7.6 - Encryption
- §7.7 - Document Structure (catalog, pages tree)
- §8 - Graphics
- §9 - Text
- §10 - Rendering
- §12.3 - Document-level Navigation (outlines, named destinations)
- §12.4 - Page-level Navigation (links, annotations)
- §12.5 - Annotations
- §12.7 - Interactive Forms (AcroForm)