microcad-lang-markdown 0.5.0

µcad language markdown support
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

// Copyright © 2026 The µcad authors <info@ucad.xyz>
// SPDX-License-Identifier: AGPL-3.0-or-later

//! Markdown section

use crate::Paragraph;

/// A markdown section with heading and paragraphs.
#[derive(Debug, Clone, Default)]
pub struct Section {
    /// A heading, displayed with a `#` prefix in markdown.
    pub heading: String,
    /// Section level.
    pub level: i64,
    /// The section content, consisting of paragraphs.
    pub content: Vec<Paragraph>,
}

impl Section {
    /// A section with `n` levels deeper.
    pub fn nested(&self, n: i64) -> Section {
        Section {
            heading: self.heading.clone(),
            level: self.level + n,
            content: self.content.clone(),
        }
    }

    /// Returns `false` if this section has a heading and a content.
    pub fn is_empty(&self) -> bool {
        self.heading.is_empty() && self.content.is_empty()
    }
}

impl std::fmt::Display for Section {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        writeln!(f, "{} {}", "#".repeat(self.level as usize), self.heading)?;
        if self.content.is_empty() {
            Ok(())
        } else {
            writeln!(f)?;
            self.content
                .iter()
                .enumerate()
                .try_for_each(|(i, paragraph)| {
                    if i > 0 {
                        writeln!(f)?;
                    }
                    write!(f, "{paragraph}")
                })
        }
    }
}