aam-rs 2.6.0

A Rust implementation of the Abstract Alias Mapping (AAM) framework for aliasing and maping aam 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
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81

use crate::builder::AAMBuilder;
use std::collections::HashMap;

/// Parses a multi-section AAML text and returns a `HashMap` mapping each file name
/// (extracted from `# filename.aam` headers) to an [`AAMBuilder`] containing the
/// section's content.
///
/// Each non-empty line inside a section is expected to be an assignment `key = value`
/// and is added via [`AAMBuilder::add_line`]. Lines that do not follow this format,
/// including comments and blank lines, are silently ignored.
///
/// # Example
/// ```
/// # use std::collections::HashMap;
/// # use aam_rs::builder::AAMBuilder;
/// # use aam_rs::splitter::split_aam;
/// let input = "# kvantum.aam\na = b\nx = d\n# another.aam\nc = d\ng = f\n";
/// let map = split_aam(input);
/// assert_eq!(map.len(), 2);
/// assert_eq!(map["kvantum.aam"].as_string(), "a = b\nx = d");
/// assert_eq!(map["another.aam"].as_string(), "c = d\ng = f");
/// ```
#[must_use]
pub fn split_aam(input: &str) -> HashMap<String, AAMBuilder> {
    let mut result = HashMap::new();
    let mut current_name: Option<String> = None;
    let mut current_builder = AAMBuilder::new();

    for line in input.lines() {
        let trimmed = line.trim();
        if trimmed.is_empty() {
            continue;
        }

        if let Some(filename) = parse_section_header(trimmed) {
            if let Some(prev_name) = current_name.take() {
                let old_builder = std::mem::take(&mut current_builder);
                result.insert(prev_name, old_builder);
            }
            current_name = Some(filename.to_owned());
            continue;
        }

        if current_name.is_some()
            && let Some((key, value)) = parse_assignment(trimmed)
        {
            current_builder.add_line(key, value);
        }
    }

    if let Some(prev_name) = current_name {
        result.insert(prev_name, current_builder);
    }

    result
}

/// Checks if a line is a section header (`# filename.aam`) and returns the file name.
fn parse_section_header(s: &str) -> Option<&str> {
    if let Some(without_hash) = s.strip_prefix('#') {
        let rest = without_hash.trim();
        if std::path::Path::new(rest)
            .extension()
            .is_some_and(|ext| ext.eq_ignore_ascii_case("aam"))
        {
            return Some(rest);
        }
    }
    None
}

/// Splits a string `key = value` into a key-value pair, trimming whitespace.
fn parse_assignment(s: &str) -> Option<(&str, &str)> {
    let mut parts = s.splitn(2, '=');
    let key = parts.next()?.trim();
    let value = parts.next().map(str::trim)?;
    if key.is_empty() {
        return None;
    }
    Some((key, value))
}