ppt-rs 0.2.25

Create, read, and update PowerPoint 2007+ (.pptx) files with rich formatting, bullet styles, themes, and templates.
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

//! Structural compatibility checks aligned with PowerPoint package expectations.
//!
//! This module is a thin wrapper around [`crate::core::package_validation`] for
//! backward compatibility. Prefer [`validate_package_bytes`] for new code.

use std::io::{Read, Seek};

use zip::ZipArchive;

pub use crate::core::package_validation::{validate_package, PackageValidationReport};

/// Result of a PowerPoint structural compatibility scan (legacy).
#[derive(Debug, Default)]
pub struct CompatReport {
    pub issues: Vec<String>,
}

impl CompatReport {
    pub fn is_ok(&self) -> bool {
        self.issues.is_empty()
    }

    pub fn push(&mut self, issue: impl Into<String>) {
        self.issues.push(issue.into());
    }
}

impl From<PackageValidationReport> for CompatReport {
    fn from(report: PackageValidationReport) -> Self {
        Self {
            issues: report.error_messages(),
        }
    }
}

/// Validate structural compatibility of a PPTX ZIP archive.
pub fn validate_powerpoint_structure<R: Read + Seek>(
    archive: &mut ZipArchive<R>,
) -> CompatReport {
    validate_package(archive).into()
}

#[cfg(test)]
mod tests {
    use super::*;
    use crate::generator::create_pptx;

    #[test]
    fn minimal_deck_passes_compat_gate() {
        let bytes = create_pptx("Compat", 1).unwrap();
        let cursor = std::io::Cursor::new(bytes);
        let mut archive = ZipArchive::new(cursor).unwrap();
        let report = validate_powerpoint_structure(&mut archive);
        assert!(report.is_ok(), "issues: {:?}", report.issues);
    }

    #[test]
    fn compat_report_matches_package_validation() {
        use crate::validate_package_bytes;
        let bytes = create_pptx("Compat", 3).unwrap();
        let package_report = validate_package_bytes(&bytes);
        let compat: CompatReport = package_report.clone().into();
        assert_eq!(compat.issues, package_report.error_messages());
    }
}