office2pdf 0.5.0

Convert DOCX, XLSX, and PPTX files to PDF using pure Rust
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

//! PDF validation tests using qpdf.
//!
//! These tests convert real fixture files to PDF and validate the output
//! using `qpdf --check`. Validation only runs when:
//! - `OFFICE2PDF_VALIDATE_PDF=1` environment variable is set
//! - `qpdf` is installed on the system
//!
//! In CI, both conditions are met. Locally, tests pass without qpdf
//! (validation is simply skipped).

mod common;

use std::path::PathBuf;

fn fixture_path(format: &str, name: &str) -> PathBuf {
    PathBuf::from(env!("CARGO_MANIFEST_DIR"))
        .join("../../tests/fixtures")
        .join(format)
        .join(name)
}

// ---------------------------------------------------------------------------
// Env-var gating
// ---------------------------------------------------------------------------

#[test]
fn validation_skipped_without_env_var() {
    // This test verifies the gating logic: when the env var is not set,
    // validation should be skipped (return false). We can only test this
    // path when the env var is actually unset.
    if std::env::var("OFFICE2PDF_VALIDATE_PDF").unwrap_or_default() == "1" {
        // In CI the env var is set — skip this test since we cannot safely
        // unset it in a parallel test environment.
        return;
    }

    let dummy_pdf = b"%PDF-1.4 dummy content";
    let result = common::validate_pdf_with_qpdf(dummy_pdf);
    assert!(
        !result,
        "validation should be skipped when env var is not set"
    );
}

// ---------------------------------------------------------------------------
// DOCX PDF validation
// ---------------------------------------------------------------------------

#[test]
fn validate_docx_table_pdf() {
    let path = fixture_path("docx", "table.docx");
    let result = office2pdf::convert(&path).expect("DOCX conversion should succeed");
    assert!(
        result.pdf.starts_with(b"%PDF"),
        "output should be a valid PDF"
    );
    common::validate_pdf_with_qpdf(&result.pdf);
}

#[test]
fn validate_docx_styles_pdf() {
    let path = fixture_path("docx", "styles_en.docx");
    let result = office2pdf::convert(&path).expect("DOCX conversion should succeed");
    assert!(
        result.pdf.starts_with(b"%PDF"),
        "output should be a valid PDF"
    );
    common::validate_pdf_with_qpdf(&result.pdf);
}

// ---------------------------------------------------------------------------
// PPTX PDF validation
// ---------------------------------------------------------------------------

#[test]
fn validate_pptx_sample_pdf() {
    let path = fixture_path("pptx", "powerpoint_sample.pptx");
    let result = office2pdf::convert(&path).expect("PPTX conversion should succeed");
    assert!(
        result.pdf.starts_with(b"%PDF"),
        "output should be a valid PDF"
    );
    common::validate_pdf_with_qpdf(&result.pdf);
}

#[test]
fn validate_pptx_test_slides_pdf() {
    let path = fixture_path("pptx", "test_slides.pptx");
    let result = office2pdf::convert(&path).expect("PPTX conversion should succeed");
    assert!(
        result.pdf.starts_with(b"%PDF"),
        "output should be a valid PDF"
    );
    common::validate_pdf_with_qpdf(&result.pdf);
}

// ---------------------------------------------------------------------------
// XLSX PDF validation
// ---------------------------------------------------------------------------

#[test]
fn validate_xlsx_temperature_pdf() {
    let path = fixture_path("xlsx", "temperature.xlsx");
    let result = office2pdf::convert(&path).expect("XLSX conversion should succeed");
    assert!(
        result.pdf.starts_with(b"%PDF"),
        "output should be a valid PDF"
    );
    common::validate_pdf_with_qpdf(&result.pdf);
}

#[test]
fn validate_xlsx_formatted_pdf() {
    let path = fixture_path("xlsx", "SH106-Formatted.xlsx");
    let result = office2pdf::convert(&path).expect("XLSX conversion should succeed");
    assert!(
        result.pdf.starts_with(b"%PDF"),
        "output should be a valid PDF"
    );
    common::validate_pdf_with_qpdf(&result.pdf);
}