rust_xlsxwriter 0.98.2

A Rust library for writing Excel 2007 xlsx files
Documentation
// RichValueStructure - A module for creating the Excel rdrichvaluestructure.xml file.
//
// SPDX-License-Identifier: MIT OR Apache-2.0
//
// Copyright 2022-2026, John McNamara, jmcnamara@cpan.org

use std::io::Cursor;

use crate::xmlwriter::{xml_declaration, xml_empty_tag, xml_end_tag, xml_start_tag};

pub struct RichValueStructure {
    pub(crate) writer: Cursor<Vec<u8>>,
    pub(crate) has_embedded_image_descriptions: bool,
}

impl RichValueStructure {
    // -----------------------------------------------------------------------
    // Crate public methods.
    // -----------------------------------------------------------------------

    // Create a new RichValueStructure struct.
    pub(crate) fn new() -> RichValueStructure {
        let writer = Cursor::new(Vec::with_capacity(2048));

        RichValueStructure {
            writer,
            has_embedded_image_descriptions: false,
        }
    }

    // -----------------------------------------------------------------------
    // XML assembly methods.
    // -----------------------------------------------------------------------

    // Assemble and generate the XML file.
    pub(crate) fn assemble_xml_file(&mut self) {
        xml_declaration(&mut self.writer);

        // Write the <rvStructures> element.
        self.write_rv_structures();

        // Close the final tag.
        xml_end_tag(&mut self.writer, "rvStructures");
    }

    // Write the <rvStructures> element.
    fn write_rv_structures(&mut self) {
        let attributes = [
            (
                "xmlns",
                "http://schemas.microsoft.com/office/spreadsheetml/2017/richdata",
            ),
            ("count", "1"),
        ];

        xml_start_tag(&mut self.writer, "rvStructures", &attributes);

        // Write the <s> element.
        self.write_s();
    }

    // Write the <s> element.
    fn write_s(&mut self) {
        let attributes = [("t", "_localImage")];

        xml_start_tag(&mut self.writer, "s", &attributes);

        // Write the <k> elements.
        self.write_k("_rvRel:LocalImageIdentifier", "i");
        self.write_k("CalcOrigin", "i");

        if self.has_embedded_image_descriptions {
            // Write the <k> element for embedded image descriptions.
            self.write_k("Text", "s");
        }

        xml_end_tag(&mut self.writer, "s");
    }

    // Write the <k> element.
    fn write_k(&mut self, name: &str, name_type: &str) {
        let attributes = [("n", name), ("t", name_type)];

        xml_empty_tag(&mut self.writer, "k", &attributes);
    }
}