pdf_process 0.2.0

Library for rendering and extracting metadata/text from PDF files using poppler
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
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144

use pdf_process::{
    pdf_info, render_all_pages, render_pages, render_single_page, OutputFormat, Password,
    PdfInfoArgs, PdfRenderError, RenderArgs,
};
use tokio::fs::read;

/// Tests rendering all pages
#[tokio::test]
async fn test_all_pages() {
    let data = read("./tests/samples/test-pdf-2-pages.pdf").await.unwrap();
    let info = pdf_info(&data, &PdfInfoArgs::default()).await.unwrap();
    let args = RenderArgs::default();
    let output = render_all_pages(&data, &info, OutputFormat::Jpeg, &args)
        .await
        .unwrap();

    assert_eq!(output.len(), 2);
}

/// Tests rendering a specific page
#[tokio::test]
async fn test_specific_page() {
    let data = read("./tests/samples/test-pdf-2-pages.pdf").await.unwrap();

    let info = pdf_info(&data, &PdfInfoArgs::default()).await.unwrap();
    let args = RenderArgs::default();

    let _output = render_single_page(&data, &info, OutputFormat::Jpeg, 1, &args)
        .await
        .unwrap();
}

/// Tests rendering a specific set of pages
#[tokio::test]
async fn test_specific_pages() {
    let data = read("./tests/samples/test-pdf-2-pages.pdf").await.unwrap();

    let info = pdf_info(&data, &PdfInfoArgs::default()).await.unwrap();
    let args = RenderArgs::default();

    let output = render_pages(&data, &info, OutputFormat::Jpeg, vec![1, 2], &args)
        .await
        .unwrap();

    assert_eq!(output.len(), 2);
}

/// Tests preventing attempts at rendering a page that goes out
/// of bounds from the acceptable number of pages
#[tokio::test]
async fn test_page_bounds() {
    let data = read("./tests/samples/test-pdf-2-pages.pdf").await.unwrap();

    let info = pdf_info(&data, &PdfInfoArgs::default()).await.unwrap();
    let args = RenderArgs::default();

    let err = render_single_page(&data, &info, OutputFormat::Jpeg, 99, &args)
        .await
        .unwrap_err();
    assert!(matches!(err, PdfRenderError::PageOutOfBounds(99, 2)));

    let err = render_pages(&data, &info, OutputFormat::Jpeg, vec![99], &args)
        .await
        .unwrap_err();

    assert!(matches!(err, PdfRenderError::PageOutOfBounds(99, 2)));
}

/// Tests prevents rendering when the pdf info specifies a password
/// but the render args didn't provide a password
#[tokio::test]
async fn test_encrypted() {
    let data = read("./tests/samples/test-pdf-2-pages-encrypted.pdf")
        .await
        .unwrap();

    let info_args = PdfInfoArgs::default().set_password(Password::user("password"));
    let info = pdf_info(&data, &info_args).await.unwrap();
    let args = RenderArgs::default();

    let err = render_single_page(&data, &info, OutputFormat::Jpeg, 99, &args)
        .await
        .unwrap_err();
    assert!(matches!(err, PdfRenderError::PdfEncrypted));

    let err = render_pages(&data, &info, OutputFormat::Jpeg, vec![99], &args)
        .await
        .unwrap_err();

    assert!(matches!(err, PdfRenderError::PdfEncrypted));
}

/// Tests rendering an encrypted pdf when the password is provided
#[tokio::test]
async fn test_encrypted_with_password() {
    let data = read("./tests/samples/test-pdf-2-pages-encrypted.pdf")
        .await
        .unwrap();

    let info_args = PdfInfoArgs::default().set_password(Password::user("password"));
    let info = pdf_info(&data, &info_args).await.unwrap();
    let args = RenderArgs::default().set_password(Password::user("password"));

    let _output = render_single_page(&data, &info, OutputFormat::Jpeg, 2, &args)
        .await
        .unwrap();

    let output = render_all_pages(&data, &info, OutputFormat::Jpeg, &args)
        .await
        .unwrap();

    assert_eq!(output.len(), 2);

    let output = render_pages(&data, &info, OutputFormat::Jpeg, vec![1, 2], &args)
        .await
        .unwrap();

    assert_eq!(output.len(), 2);
}

/// Tests rendering an encrypted pdf when the password is provided
/// but incorrect
#[tokio::test]
async fn test_encrypted_with_incorrect_password() {
    let data = read("./tests/samples/test-pdf-2-pages-encrypted.pdf")
        .await
        .unwrap();

    let info_args = PdfInfoArgs::default().set_password(Password::user("password"));

    let info = pdf_info(&data, &info_args).await.unwrap();
    let args = RenderArgs::default().set_password(Password::user("incorrect"));

    let err = render_single_page(&data, &info, OutputFormat::Jpeg, 1, &args)
        .await
        .unwrap_err();
    assert!(matches!(err, PdfRenderError::IncorrectPassword));

    let err = render_pages(&data, &info, OutputFormat::Jpeg, vec![1], &args)
        .await
        .unwrap_err();

    assert!(matches!(err, PdfRenderError::IncorrectPassword));
}