pmat 3.11.0

PMAT - Zero-config AI context generation and code quality toolkit (CLI, MCP, HTTP)
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
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153

#![cfg_attr(coverage_nightly, coverage(off))]
use super::{ModuleError, PmatModule};
use async_trait::async_trait;
use serde::{Deserialize, Serialize};
use std::sync::Arc;

// Public interface - the ONLY way other modules interact
#[async_trait]
pub trait AnalyzerModule: Send + Sync {
    async fn analyze(&self, input: &str) -> Result<Metrics, ModuleError>;
    async fn analyze_file(&self, path: &std::path::Path) -> Result<Metrics, ModuleError>;
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Metrics {
    pub complexity: u32,
    pub lines_of_code: usize,
    pub functions: usize,
    pub classes: usize,
    pub imports: usize,
}

// Private implementation details
mod internal {
    use super::*;
    use syn;

    pub(super) struct AnalyzerCore {
        _cache: lru::LruCache<String, Arc<Metrics>>,
    }

    impl AnalyzerCore {
        pub(super) fn new() -> Self {
            Self {
                _cache: lru::LruCache::new(
                    std::num::NonZeroUsize::new(100).expect("internal error"),
                ),
            }
        }

        pub(super) fn analyze_ast(&mut self, ast: &syn::File) -> Metrics {
            let mut metrics = Metrics {
                complexity: 1,
                lines_of_code: 0,
                functions: 0,
                classes: 0,
                imports: 0,
            };

            for item in &ast.items {
                match item {
                    syn::Item::Fn(_) => metrics.functions += 1,
                    syn::Item::Struct(_) => metrics.classes += 1,
                    syn::Item::Use(_) => metrics.imports += 1,
                    _ => {}
                }
            }

            metrics
        }
    }
}

// Concrete implementation hidden from other modules
#[derive(Clone)]
pub struct AnalyzerImpl {
    core: Arc<parking_lot::Mutex<internal::AnalyzerCore>>,
}

impl Default for AnalyzerImpl {
    fn default() -> Self {
        Self::new()
    }
}

impl AnalyzerImpl {
    pub fn new() -> Self {
        Self {
            core: Arc::new(parking_lot::Mutex::new(internal::AnalyzerCore::new())),
        }
    }
}

#[async_trait]
impl AnalyzerModule for AnalyzerImpl {
    async fn analyze(&self, input: &str) -> Result<Metrics, ModuleError> {
        let ast =
            syn::parse_file(input).map_err(|e| ModuleError::ExecutionFailed(e.to_string()))?;

        let metrics = self.core.lock().analyze_ast(&ast);
        Ok(metrics)
    }

    async fn analyze_file(&self, path: &std::path::Path) -> Result<Metrics, ModuleError> {
        let content = tokio::fs::read_to_string(path)
            .await
            .map_err(|e| ModuleError::ExecutionFailed(e.to_string()))?;

        self.analyze(&content).await
    }
}

#[async_trait]
impl PmatModule for AnalyzerImpl {
    type Input = String;
    type Output = Metrics;

    fn name(&self) -> &'static str {
        "AnalyzerModule"
    }

    async fn initialize(&mut self) -> Result<(), ModuleError> {
        // Any initialization logic
        Ok(())
    }

    async fn process(&self, input: Self::Input) -> Result<Self::Output, ModuleError> {
        self.analyze(&input).await
    }

    async fn shutdown(&mut self) -> Result<(), ModuleError> {
        // Cleanup if needed
        Ok(())
    }
}

#[cfg_attr(coverage_nightly, coverage(off))]
#[cfg(test)]
mod tests {
    use super::*;

    #[tokio::test]
    async fn test_analyzer_module() {
        let analyzer = AnalyzerImpl::new();

        let code = r#"
            fn main() {
                println!("Hello, world!");
            }

            struct Foo {
                bar: i32,
            }

            use std::collections::HashMap;
        "#;

        let metrics = analyzer.analyze(code).await.expect("internal error");
        assert_eq!(metrics.functions, 1);
        assert_eq!(metrics.classes, 1);
        assert_eq!(metrics.imports, 1);
    }
}