swt 5.0.0-rc.9

🍬 Sweet: A blazing-fast code health and architecture analyzer.
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

//! Report generation and formatting module.
//!
//! This module contains the data structures representing analysis results
//! and the logic for exporting them to various formats (Terminal, JSON).

pub mod json;
pub mod terminal;

use crate::config::Config;
use crate::config::thresholds::Severity;
use serde::{Deserialize, Serialize};
use std::path::{Path, PathBuf};

/// Orchestrate report output to terminal and optional JSON files.
pub fn print_reports(reports: &[FileReport], quiet: bool, json_path: Option<&Path>) {
    if let Some(path) = json_path {
        json::write_json_report(reports, path);
    }

    terminal::print_summary(reports, quiet);
}

/// A single rule violation with its importance level.
#[derive(Debug, Serialize, Deserialize, Clone)]
pub struct Issue {
    /// Description of the problem.
    pub message: String,
    /// Importance level.
    pub severity: Severity,
    /// Line number where the issue occurs (optional).
    pub line: Option<usize>,
}

/// Analysis results for a single source file.
#[derive(Debug, Serialize, Deserialize, Clone)]
pub struct FileReport {
    /// Absolute or relative path to the file.
    pub path: PathBuf,
    /// Measured source lines.
    pub lines: usize,
    /// Measured import count.
    pub imports: usize,
    /// Measured nesting depth.
    pub max_depth: usize,
    /// Measured repetition percentage.
    pub repetition: f64,
    /// True if no Error-level thresholds were exceeded.
    pub is_sweet: bool,
    /// List of descriptive issue messages.
    pub issues: Vec<Issue>,
    /// Effective configuration used for this file.
    #[serde(skip_serializing)]
    pub config: Option<Config>,
    /// Details about duplicated code chunks.
    pub duplicates: Vec<RepetitionDetail>,
    /// Lines where the nesting depth exceeds the threshold.
    pub deep_lines: Vec<(usize, usize)>,
    /// Internal: Pre-computed hashes of lines (without comments) for repetition analysis.
    #[serde(skip)]
    pub hashes: Vec<(usize, u64)>,
}

/// Details about a specific duplicated code chunk.
#[derive(Debug, Serialize, Deserialize, Clone)]
pub struct RepetitionDetail {
    /// The actual code content that is repeated.
    pub content: String,
    /// Starting line number in the file.
    pub line: usize,
    /// Other files where this same chunk appears.
    pub occurrences: Vec<(PathBuf, usize)>,
}