flowscope-export 0.7.0

Database export for FlowScope analysis results
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
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106

use chrono::{DateTime, Utc};

use crate::ExportFormat;

#[derive(Debug, Clone)]
pub struct ExportNaming {
    project_name: String,
    exported_at: DateTime<Utc>,
}

impl ExportNaming {
    pub fn new(project_name: impl Into<String>) -> Self {
        Self::with_exported_at(project_name, Utc::now())
    }

    pub fn with_exported_at(project_name: impl Into<String>, exported_at: DateTime<Utc>) -> Self {
        let mut name = project_name.into();
        if name.trim().is_empty() {
            name = "lineage".to_string();
        }
        Self {
            project_name: sanitize_project_name(&name),
            exported_at,
        }
    }

    pub fn exported_at(&self) -> DateTime<Utc> {
        self.exported_at
    }

    pub fn project_name(&self) -> &str {
        &self.project_name
    }

    pub fn filename(&self, format: ExportFormat) -> String {
        let timestamp = self.exported_at.format("%Y%m%d-%H%M%S");
        let (suffix, extension) = format_filename_parts(format);
        format!(
            "{}-{}-{}.{}",
            self.project_name, timestamp, suffix, extension
        )
    }
}

fn format_filename_parts(format: ExportFormat) -> (&'static str, &'static str) {
    match format {
        ExportFormat::Json { .. } => ("json", "json"),
        ExportFormat::Mermaid { view } => match view {
            crate::MermaidView::All => ("mermaid", "md"),
            crate::MermaidView::Script => ("mermaid-script", "md"),
            crate::MermaidView::Table => ("mermaid-table", "md"),
            crate::MermaidView::Column => ("mermaid-column", "md"),
            crate::MermaidView::Hybrid => ("mermaid-hybrid", "md"),
        },
        ExportFormat::Html => ("report", "html"),
        ExportFormat::Sql { .. } => ("duckdb", "sql"),
        ExportFormat::CsvBundle => ("csv", "zip"),
        ExportFormat::Xlsx => ("xlsx", "xlsx"),
        ExportFormat::DuckDb => ("duckdb", "duckdb"),
        ExportFormat::Png => ("png", "png"),
    }
}

fn sanitize_project_name(name: &str) -> String {
    let mut cleaned = String::new();
    let mut last_dash = false;

    for ch in name.trim().chars() {
        let normalized = ch.to_ascii_lowercase();
        if normalized.is_ascii_alphanumeric() {
            cleaned.push(normalized);
            last_dash = false;
        } else if matches!(normalized, '-' | '_' | ' ') && !last_dash {
            cleaned.push('-');
            last_dash = true;
        }
    }

    let cleaned = cleaned.trim_matches('-').to_string();
    if cleaned.is_empty() {
        "lineage".to_string()
    } else {
        cleaned
    }
}

#[cfg(test)]
mod tests {
    use chrono::{TimeZone, Utc};

    use super::*;

    #[test]
    fn test_filename_generation() {
        let timestamp = Utc.with_ymd_and_hms(2026, 1, 18, 12, 30, 5).unwrap();
        let naming = ExportNaming::with_exported_at("FlowScope Demo", timestamp);
        let name = naming.filename(ExportFormat::Json { compact: false });
        assert_eq!(name, "flowscope-demo-20260118-123005-json.json");
    }

    #[test]
    fn test_project_name_sanitization() {
        let naming = ExportNaming::with_exported_at("  !!! ", Utc::now());
        assert_eq!(naming.project_name(), "lineage");
    }
}