cargo-twin4rust 0.5.0

Cargo subcommand that fails the build when a Rust source file has no mirrored test file beside it
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

// Copyright 2026 Umberto Gotti <umberto.gotti@umbertogotti.dev>
// Licensed under the MIT License
// SPDX-License-Identifier: MIT

use crate::analysis_report::AnalysisReport;
use crate::missing_test_gap::MissingTestGap;

#[derive(Default)]
pub struct ReportPrinter;

impl ReportPrinter {
    pub fn new() -> Self {
        Self
    }

    pub fn print(&self, reports: &[AnalysisReport]) {
        let missing = self.collect_missing(reports);

        println!("twin4rust report");
        println!();

        if missing.is_empty() {
            println!("All mirrored test-gap expectations are satisfied.");
            return;
        }

        println!("Files without a matching mirrored test file:");
        for gap in self.sorted(&missing) {
            println!(
                "- {}: {} -> {}",
                gap.package_name, gap.relative_source_file, gap.expected_test_file
            );
        }

        println!();
        println!(
            "summary: packages_with_gaps={} missing_files={}",
            reports.iter().filter(|report| !report.is_empty()).count(),
            missing.len()
        );
    }

    fn collect_missing<'a>(&self, reports: &'a [AnalysisReport]) -> Vec<&'a MissingTestGap> {
        reports
            .iter()
            .flat_map(|report| report.missing.iter())
            .collect()
    }

    fn sorted<'a>(&self, missing: &[&'a MissingTestGap]) -> Vec<&'a MissingTestGap> {
        let mut sorted = missing.to_vec();
        sorted.sort_by(|left, right| {
            left.package_name
                .cmp(&right.package_name)
                .then_with(|| left.relative_source_file.cmp(&right.relative_source_file))
                .then_with(|| left.expected_test_file.cmp(&right.expected_test_file))
        });
        sorted
    }
}