syster-base 0.4.0-alpha

Core library for SysML v2 and KerML parsing, AST, and semantic analysis
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

use crate::base::constants::SUPPORTED_EXTENSIONS;
use crate::parser::ParseError;
use std::fs;
use std::path::{Path, PathBuf};

/// Loads a file and returns its content as a string.
///
/// # Errors
///
/// Returns an error if the file cannot be read.
pub fn load_file(path: &PathBuf) -> Result<String, String> {
    fs::read_to_string(path).map_err(|e| format!("Failed to read {}: {}", path.display(), e))
}

/// Validates that a file has a supported extension (.sysml or .kerml).
///
/// # Errors
///
/// Returns an error if the extension is not supported.
pub fn validate_extension(path: &Path) -> Result<&str, String> {
    let ext = path
        .extension()
        .and_then(|e| e.to_str())
        .ok_or_else(|| format!("Invalid file extension for {}", path.display()))?;

    if SUPPORTED_EXTENSIONS.contains(&ext) {
        Ok(ext)
    } else {
        Err(format!("Unsupported file extension: {ext}"))
    }
}

/// Returns the file extension if valid, for use in ParseResult contexts.
///
/// # Errors
///
/// Returns ParseError if extension is missing or unsupported.
pub fn get_extension(path: &Path) -> Result<&str, ParseError> {
    let ext = path.extension().and_then(|e| e.to_str());

    match ext {
        Some(e) if SUPPORTED_EXTENSIONS.contains(&e) => Ok(e),
        _ => Err(ParseError::syntax_error("Unsupported file extension", 0, 0)),
    }
}