docx-rust 0.1.11

A Rust library for parsing and generating docx files.
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

use hard_xml::{XmlRead, XmlWrite};
use std::borrow::Cow;

use crate::{__setter, __xml_test_suites, document::Run};

/// A bidirectional embedding, which can nest to more bidirectional embeddings
#[derive(Debug, Default, XmlRead, XmlWrite, Clone)]
#[cfg_attr(test, derive(PartialEq))]
#[xml(tag = "w:dir")]
pub struct BidirectionalEmbedding<'a> {
    // A BidirectionalEmbedding can have a number of rich text runs
    #[xml(child = "w:r")]
    pub runs: Vec<Run<'a>>,
    // A BidirectionalEmbedding can include nested embedding layers
    #[xml(child = "w:dir")]
    pub nested_levels: Vec<BidirectionalEmbedding<'a>>,
}

impl<'a> BidirectionalEmbedding<'a> {
    __setter!(runs: Vec<Run<'a>>);
    __setter!(nested_levels: Vec<BidirectionalEmbedding<'a>>);

    pub fn iter_text(&self) -> Box<dyn Iterator<Item = &Cow<'a, str>> + '_> {
        Box::new(
            self.runs.iter().flat_map(|run| run.iter_text()).chain(
                self.nested_levels
                    .iter()
                    .flat_map(|nested| nested.iter_text()),
            ),
        )
    }

    pub fn iter_text_mut(&mut self) -> Box<dyn Iterator<Item = &mut Cow<'a, str>> + '_> {
        Box::new(
            self.runs
                .iter_mut()
                .flat_map(|run| run.iter_text_mut())
                .chain(
                    self.nested_levels
                        .iter_mut()
                        .flat_map(|nested| nested.iter_text_mut()),
                ),
        )
    }
}

__xml_test_suites!(
    BidirectionalEmbedding,
    BidirectionalEmbedding::default(),
    r#"<w:dir/>"#,
    BidirectionalEmbedding::default().runs(vec![Run::default(), Run::default().push_text("text")]),
    r#"<w:dir><w:r/><w:r><w:t>text</w:t></w:r></w:dir>"#,
    BidirectionalEmbedding::default().nested_levels(vec![
        BidirectionalEmbedding::default().runs(vec![Run::default()])
    ]),
    r#"<w:dir><w:dir><w:r/></w:dir></w:dir>"#,
);