clean_dev_dirs/
output.rs

1//! Structured JSON output for scripting and piping.
2//!
3//! This module provides serializable data structures that represent the
4//! complete output of a scan or cleanup operation. When the `--json` flag
5//! is passed, these structures are serialized to stdout as a single JSON
6//! object, replacing all human-readable output.
7
8use std::collections::BTreeMap;
9
10use humansize::{DECIMAL, format_size};
11use serde::Serialize;
12
13use crate::project::{Project, ProjectType};
14
15/// Top-level JSON output emitted when `--json` is active.
16#[derive(Serialize)]
17pub struct JsonOutput {
18    /// The execution mode: `"dry_run"` or `"cleanup"`.
19    pub mode: String,
20
21    /// List of projects that were found (and matched filters).
22    pub projects: Vec<JsonProjectEntry>,
23
24    /// Aggregated summary statistics.
25    pub summary: JsonSummary,
26
27    /// Cleanup results. Present only when an actual cleanup was performed
28    /// (i.e. not in dry-run mode).
29    #[serde(skip_serializing_if = "Option::is_none")]
30    pub cleanup: Option<JsonCleanupResult>,
31}
32
33/// A single project entry in the JSON output.
34#[derive(Serialize)]
35pub struct JsonProjectEntry {
36    /// Project name extracted from config files, or `null`.
37    pub name: Option<String>,
38
39    /// Project type (`"rust"`, `"node"`, `"python"`, `"go"`, `"java"`, `"cpp"`, `"swift"`, `"dot_net"`).
40    #[serde(rename = "type")]
41    pub project_type: ProjectType,
42
43    /// Absolute path to the project root directory.
44    pub root_path: String,
45
46    /// Absolute path to the build artifacts directory.
47    pub build_artifacts_path: String,
48
49    /// Size of the build artifacts in bytes.
50    pub build_artifacts_size: u64,
51
52    /// Human-readable formatted size (e.g. `"1.23 GB"`).
53    pub build_artifacts_size_formatted: String,
54}
55
56/// Aggregated summary across all matched projects.
57#[derive(Serialize)]
58pub struct JsonSummary {
59    /// Total number of projects found.
60    pub total_projects: usize,
61
62    /// Total reclaimable size in bytes.
63    pub total_size: u64,
64
65    /// Human-readable formatted total size.
66    pub total_size_formatted: String,
67
68    /// Per-type breakdown (key is the project type name).
69    pub by_type: BTreeMap<String, JsonTypeSummary>,
70}
71
72/// Per-project-type count and size.
73#[derive(Serialize)]
74pub struct JsonTypeSummary {
75    /// Number of projects of this type.
76    pub count: usize,
77
78    /// Total size in bytes for this type.
79    pub size: u64,
80
81    /// Human-readable formatted size.
82    pub size_formatted: String,
83}
84
85/// Results of a cleanup operation.
86#[derive(Serialize)]
87pub struct JsonCleanupResult {
88    /// Number of projects successfully cleaned.
89    pub success_count: usize,
90
91    /// Number of projects that failed to clean.
92    pub failure_count: usize,
93
94    /// Total bytes actually freed.
95    pub total_freed: u64,
96
97    /// Human-readable formatted freed size.
98    pub total_freed_formatted: String,
99
100    /// Error messages for projects that failed.
101    pub errors: Vec<String>,
102}
103
104impl JsonOutput {
105    /// Build a `JsonOutput` from a slice of projects in dry-run mode.
106    #[must_use]
107    pub fn from_projects_dry_run(projects: &[Project]) -> Self {
108        Self {
109            mode: "dry_run".to_string(),
110            projects: projects
111                .iter()
112                .map(JsonProjectEntry::from_project)
113                .collect(),
114            summary: JsonSummary::from_projects(projects),
115            cleanup: None,
116        }
117    }
118
119    /// Build a `JsonOutput` from a slice of projects after a cleanup operation.
120    #[must_use]
121    pub fn from_projects_cleanup(
122        projects: &[Project],
123        clean_result: &crate::cleaner::CleanResult,
124    ) -> Self {
125        Self {
126            mode: "cleanup".to_string(),
127            projects: projects
128                .iter()
129                .map(JsonProjectEntry::from_project)
130                .collect(),
131            summary: JsonSummary::from_projects(projects),
132            cleanup: Some(JsonCleanupResult::from_clean_result(clean_result)),
133        }
134    }
135}
136
137impl JsonProjectEntry {
138    /// Convert a `Project` into a `JsonProjectEntry`.
139    #[must_use]
140    pub fn from_project(project: &Project) -> Self {
141        Self {
142            name: project.name.clone(),
143            project_type: project.kind.clone(),
144            root_path: project.root_path.display().to_string(),
145            build_artifacts_path: project.build_arts.path.display().to_string(),
146            build_artifacts_size: project.build_arts.size,
147            build_artifacts_size_formatted: format_size(project.build_arts.size, DECIMAL),
148        }
149    }
150}
151
152impl JsonSummary {
153    /// Compute summary statistics from a slice of projects.
154    #[must_use]
155    pub fn from_projects(projects: &[Project]) -> Self {
156        let mut by_type: BTreeMap<String, (usize, u64)> = BTreeMap::new();
157
158        for project in projects {
159            let key = match project.kind {
160                ProjectType::Rust => "rust",
161                ProjectType::Node => "node",
162                ProjectType::Python => "python",
163                ProjectType::Go => "go",
164                ProjectType::Java => "java",
165                ProjectType::Cpp => "cpp",
166                ProjectType::Swift => "swift",
167                ProjectType::DotNet => "dotnet",
168            };
169
170            let entry = by_type.entry(key.to_string()).or_insert((0, 0));
171            entry.0 += 1;
172            entry.1 += project.build_arts.size;
173        }
174
175        let total_size: u64 = projects.iter().map(|p| p.build_arts.size).sum();
176
177        Self {
178            total_projects: projects.len(),
179            total_size,
180            total_size_formatted: format_size(total_size, DECIMAL),
181            by_type: by_type
182                .into_iter()
183                .map(|(k, (count, size))| {
184                    (
185                        k,
186                        JsonTypeSummary {
187                            count,
188                            size,
189                            size_formatted: format_size(size, DECIMAL),
190                        },
191                    )
192                })
193                .collect(),
194        }
195    }
196}
197
198impl JsonCleanupResult {
199    /// Convert a `CleanResult` into a `JsonCleanupResult`.
200    #[must_use]
201    pub fn from_clean_result(result: &crate::cleaner::CleanResult) -> Self {
202        Self {
203            success_count: result.success_count,
204            failure_count: result.errors.len(),
205            total_freed: result.total_freed,
206            total_freed_formatted: format_size(result.total_freed, DECIMAL),
207            errors: result.errors.clone(),
208        }
209    }
210}
clean_dev_dirs/output.rs

clean_dev_dirs/
output.rs
