excelize-rs 0.1.7

Rust language library for reading and writing Microsoft Excel (XLAM / XLSM / XLSX / XLTM / XLTX) spreadsheets
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

//! Comments part (`xl/commentsN.xml`).
//!
//! Ported from Go `xmlComments.go`.

use serde::{Deserialize, Serialize};

use super::common::{RichTextRun, XlsxPhoneticPr, XlsxPhoneticRun, XlsxR};

/// Directly maps the comments element.
#[derive(Debug, Default, Clone, PartialEq, Serialize, Deserialize)]
#[serde(rename = "comments", rename_all = "PascalCase")]
pub struct XlsxComments {
    #[serde(rename = "authors", default)]
    pub authors: XlsxAuthor,
    #[serde(rename = "commentList", default)]
    pub comment_list: XlsxCommentList,
    #[serde(skip)]
    pub cells: Vec<String>,
}

/// Holds the list of authors.
#[derive(Debug, Default, Clone, PartialEq, Eq, Serialize, Deserialize)]
pub struct XlsxAuthor {
    #[serde(rename = "author", default)]
    pub author: Vec<String>,
}

/// Container for the list of comments.
#[derive(Debug, Default, Clone, PartialEq, Serialize, Deserialize)]
pub struct XlsxCommentList {
    #[serde(rename = "comment", default)]
    pub comment: Vec<XlsxComment>,
}

/// A single comment.
#[derive(Debug, Default, Clone, PartialEq, Serialize, Deserialize)]
pub struct XlsxComment {
    #[serde(rename = "@ref", default)]
    pub r#ref: String,
    #[serde(rename = "@authorId", default)]
    pub author_id: i32,
    #[serde(rename = "text", default)]
    pub text: XlsxText,
}

/// Rich text content of a comment.
#[derive(Debug, Default, Clone, PartialEq, Serialize, Deserialize)]
pub struct XlsxText {
    #[serde(rename = "t", default)]
    pub t: Option<String>,
    #[serde(rename = "r", default)]
    pub r: Vec<XlsxR>,
    #[serde(rename = "rPh", default)]
    pub r_ph: Option<XlsxPhoneticRun>,
    #[serde(rename = "phoneticPr", default)]
    pub phonetic_pr: Option<XlsxPhoneticPr>,
}

/// Comment information used in the public API.
#[derive(Debug, Default, Clone, PartialEq, Serialize, Deserialize)]
pub struct Comment {
    #[serde(default)]
    pub author: String,
    #[serde(rename = "AuthorID", default)]
    pub author_id: i32,
    #[serde(default)]
    pub cell: String,
    #[serde(default)]
    pub text: String,
    #[serde(default)]
    pub width: u32,
    #[serde(default)]
    pub height: u32,
    #[serde(default)]
    pub paragraph: Vec<RichTextRun>,
}