mirror of
https://github.com/storytold/craft-libs.git
synced 2026-11-17 05:14:24 +00:00
Add craft-doc-binary: WordCraft's .doc reader on craft-wordmodel and craft-cfb * craft-doc-binary: WordCraft's crates/docbin as it is at wordcraft 07f97737 The source, unchanged, so the next commit shows only what the move changes. It has no manifest yet, so it is not built. * craft-doc-binary: on craft-wordmodel, craft-cfb and craft-codepage - The compound file is read with craft-cfb (bounded directory, streams refused above 1 GiB before anything is allocated), in place of the cfb crate and WordCraft's cfb_guard precheck; an oversized stream is DocbinError::Limit. - 8-bit text uses craft-codepage in place of wordcraft_doc::encoding. - wordcraft-doc is craft-wordmodel; wordcraft-geom's helpers are its geom. The tests keep building their files with the cfb crate (a dev-dependency), so craft-cfb's reader is checked against another implementation's writer. The repeating-DIFAT regression is craft-cfb's own; the guard asserts in the valid-files test go with the guard.
165 lines
7.3 KiB
Rust
165 lines
7.3 KiB
Rust
//! OLE property sets constructed from MS-OLEPS, exercised through the public DOC reader.
|
|
use super::{Piece, body_texts, text_doc};
|
|
use std::io::{Cursor, Seek, SeekFrom, Write};
|
|
|
|
fn summary(cp: u16, values: &[(u32, u32, Vec<u8>)]) -> Vec<u8> {
|
|
let mut props = vec![(1, [2u32.to_le_bytes().as_slice(), &cp.to_le_bytes(), &[0, 0]].concat())];
|
|
for (id, kind, bytes) in values {
|
|
let size = if *kind == 31 { bytes.len() / 2 } else { bytes.len() } as u32;
|
|
let mut value = [kind.to_le_bytes().as_slice(), &size.to_le_bytes(), bytes].concat();
|
|
while !value.len().is_multiple_of(4) {
|
|
value.push(0);
|
|
}
|
|
props.push((*id, value));
|
|
}
|
|
let mut section = vec![0; 8 + 8 * props.len()];
|
|
section[4..8].copy_from_slice(&(props.len() as u32).to_le_bytes());
|
|
for (i, (id, value)) in props.iter().enumerate() {
|
|
section[8 + i * 8..12 + i * 8].copy_from_slice(&id.to_le_bytes());
|
|
let offset = section.len() as u32;
|
|
section[12 + i * 8..16 + i * 8].copy_from_slice(&offset.to_le_bytes());
|
|
section.extend_from_slice(value);
|
|
}
|
|
let size = section.len() as u32;
|
|
section[..4].copy_from_slice(&size.to_le_bytes());
|
|
let mut header = vec![0; 48];
|
|
header[..2].copy_from_slice(&[0xfe, 0xff]);
|
|
header[24..28].copy_from_slice(&1u32.to_le_bytes());
|
|
header[28..44].copy_from_slice(&[0xe0, 0x85, 0x9f, 0xf2, 0xf9, 0x4f, 0x68, 0x10, 0xab, 0x91, 0x08, 0, 0x2b, 0x27, 0xb3, 0xd9]);
|
|
header[44..48].copy_from_slice(&48u32.to_le_bytes());
|
|
header.extend(section);
|
|
header
|
|
}
|
|
|
|
fn open_with_metadata(bytes: &[u8], template: bool) -> craft_wordmodel::Document {
|
|
let file = text_doc(&[Piece { compressed: false, text: "Body stays readable\r".into() }], &[], 0);
|
|
let mut cfb = cfb::CompoundFile::open(Cursor::new(file)).unwrap();
|
|
cfb.create_stream("/\u{5}SummaryInformation").unwrap().write_all(bytes).unwrap();
|
|
if template {
|
|
let mut stream = cfb.open_stream("/WordDocument").unwrap();
|
|
stream.seek(SeekFrom::Start(0x0a)).unwrap();
|
|
stream.write_all(&0x1001u16.to_le_bytes()).unwrap();
|
|
}
|
|
let doc = crate::read(&cfb.into_inner().into_inner()).unwrap();
|
|
assert_eq!(body_texts(&doc), ["Body stays readable"]);
|
|
doc
|
|
}
|
|
|
|
#[test]
|
|
fn doc_and_dot_import_summary_text_properties() {
|
|
let data = summary(
|
|
1252,
|
|
&[
|
|
(2, 30, b"R\xe9sum\xe9\0".to_vec()),
|
|
(3, 30, b"Subject\0".to_vec()),
|
|
(4, 30, b"Writer\0".to_vec()),
|
|
(5, 30, b"one;two\0".to_vec()),
|
|
(6, 30, b"Description\0".to_vec()),
|
|
(8, 30, b"Editor\0".to_vec()),
|
|
(9, 30, b"12\0".to_vec()),
|
|
],
|
|
);
|
|
for template in [false, true] {
|
|
let c = open_with_metadata(&data, template).core;
|
|
assert_eq!(c.title, "Résumé");
|
|
assert_eq!(c.subject, "Subject");
|
|
assert_eq!(c.creator, "Writer");
|
|
assert_eq!(c.keywords, "one;two");
|
|
assert_eq!(c.description, "Description");
|
|
assert_eq!(c.last_modified_by, "Editor");
|
|
assert_eq!(c.revision, 12);
|
|
}
|
|
}
|
|
|
|
#[test]
|
|
fn summary_handles_codepages_and_utf16_length_units() {
|
|
let wide: Vec<u8> = "Unicode ä 文 😀\0".encode_utf16().flat_map(u16::to_le_bytes).collect();
|
|
for kind in [30, 31] {
|
|
assert_eq!(open_with_metadata(&summary(1200, &[(2, kind, wide.clone())]), false).core.title, "Unicode ä 文 😀");
|
|
}
|
|
assert_eq!(open_with_metadata(&summary(65001, &[(2, 30, "UTF-8 ä\0".as_bytes().to_vec())]), false).core.title, "UTF-8 ä");
|
|
assert_eq!(open_with_metadata(&summary(1251, &[(2, 30, vec![0xcf, 0xf0, 0xe8, 0xe2, 0xe5, 0xf2, 0])]), false).core.title, "Привет");
|
|
}
|
|
|
|
#[test]
|
|
fn malformed_or_oversized_summary_does_not_break_doc_open() {
|
|
let valid = summary(1252, &[(2, 30, b"Title\0".to_vec())]);
|
|
for n in [0, 2, 24, 44, 47, 55, valid.len() - 5] {
|
|
assert!(open_with_metadata(&valid[..n], false).core.title.is_empty());
|
|
}
|
|
for (at, value) in [(44, u32::MAX), (48, u32::MAX), (52, u32::MAX), (68, 4), (84, u32::MAX)] {
|
|
let mut bad = valid.clone();
|
|
bad[at..at + 4].copy_from_slice(&value.to_le_bytes());
|
|
assert!(open_with_metadata(&bad, false).core.title.is_empty(), "offset {at}");
|
|
}
|
|
let huge = summary(1252, &[(2, 30, vec![b'x'; (64 << 10) + 1])]);
|
|
assert!(open_with_metadata(&huge, false).core.title.is_empty());
|
|
assert!(open_with_metadata(&vec![0; (2 << 20) + 1], false).core.title.is_empty());
|
|
}
|
|
|
|
fn custom_summary(props: &[(u32, Vec<u8>)], num_property_sets: u32) -> Vec<u8> {
|
|
let mut section = vec![0; 8 + 8 * props.len()];
|
|
section[4..8].copy_from_slice(&(props.len() as u32).to_le_bytes());
|
|
for (i, (id, value)) in props.iter().enumerate() {
|
|
section[8 + i * 8..12 + i * 8].copy_from_slice(&id.to_le_bytes());
|
|
let offset = section.len() as u32;
|
|
section[12 + i * 8..16 + i * 8].copy_from_slice(&offset.to_le_bytes());
|
|
section.extend_from_slice(value);
|
|
}
|
|
let size = section.len() as u32;
|
|
section[..4].copy_from_slice(&size.to_le_bytes());
|
|
let mut header = vec![0; 28 + 20 * num_property_sets as usize];
|
|
header[..2].copy_from_slice(&[0xfe, 0xff]);
|
|
header[24..28].copy_from_slice(&num_property_sets.to_le_bytes());
|
|
// First property set FMTID and offset
|
|
header[28..44].copy_from_slice(&[0xe0, 0x85, 0x9f, 0xf2, 0xf9, 0x4f, 0x68, 0x10, 0xab, 0x91, 0x08, 0, 0x2b, 0x27, 0xb3, 0xd9]);
|
|
let first_offset = header.len() as u32;
|
|
header[44..48].copy_from_slice(&first_offset.to_le_bytes());
|
|
if num_property_sets > 1 {
|
|
// Dummy second property set header
|
|
header[48..64].copy_from_slice(&[1; 16]);
|
|
let second_offset = (first_offset + size) as u32;
|
|
header[64..68].copy_from_slice(&second_offset.to_le_bytes());
|
|
}
|
|
header.extend(section);
|
|
header
|
|
}
|
|
|
|
#[test]
|
|
fn summary_defaults_codepage_and_accepts_vti4_and_num_property_sets() {
|
|
let title_prop = [30u32.to_le_bytes().as_slice(), &7u32.to_le_bytes(), b"Default\0"].concat();
|
|
// 1. Missing PID_CODEPAGE (property 1) should default to 1252 per MS-OLEPS.
|
|
let no_cp = custom_summary(&[(2, title_prop.clone())], 1);
|
|
assert_eq!(open_with_metadata(&no_cp, false).core.title, "Default");
|
|
|
|
// 2. PID_CODEPAGE as VT_I4 (type 3).
|
|
let cp_vti4 = [3u32.to_le_bytes().as_slice(), &1252u32.to_le_bytes()].concat();
|
|
let with_vti4 = custom_summary(&[(1, cp_vti4), (2, title_prop.clone())], 1);
|
|
assert_eq!(open_with_metadata(&with_vti4, false).core.title, "Default");
|
|
|
|
// 3. Stream with NumPropertySets = 2.
|
|
let multi_sets = custom_summary(&[(2, title_prop)], 2);
|
|
assert_eq!(open_with_metadata(&multi_sets, false).core.title, "Default");
|
|
}
|
|
|
|
#[test]
|
|
fn summary_parses_filetime_created_and_modified_dates() {
|
|
// 2024-03-15T12:30:45Z = 133549794450000000 in 100ns since 1601-01-01
|
|
let ft_val: u64 = 133_549_794_450_000_000;
|
|
let ft_low = (ft_val & 0xFFFFFFFF) as u32;
|
|
let ft_high = (ft_val >> 32) as u32;
|
|
let filetime_bytes = [64u32.to_le_bytes().as_slice(), &ft_low.to_le_bytes(), &ft_high.to_le_bytes()].concat();
|
|
|
|
let stream = custom_summary(
|
|
&[
|
|
(12, filetime_bytes.clone()), // PIDSI_CREATE_DTM
|
|
(13, filetime_bytes), // PIDSI_LASTSAVE_DTM
|
|
],
|
|
1,
|
|
);
|
|
|
|
let core = open_with_metadata(&stream, false).core;
|
|
assert_eq!(core.created, "2024-03-15T12:30:45Z");
|
|
assert_eq!(core.modified, "2024-03-15T12:30:45Z");
|
|
}
|