cargo-stern4rust 0.10.0

Cargo subcommand that fails the build when a Rust workspace breaks a house coding rule, such as AAA test structure or one struct per file
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

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

use anyhow::Result;
use std::path::Path;
use std::path::PathBuf;

use crate::adoption::exclusion::Exclusion;
use crate::adoption::exclusion_outcome::ExclusionOutcome;

// Every `--exclude` pattern this run was given, applied to the walked paths.
//
// Exclusion happens after the walk rather than by pruning it. Pruning would be
// faster on a large vendored tree and would cost the one thing that makes an
// exclusion acceptable at all: knowing how many files each pattern removed. A
// tree that is never entered cannot be counted, and an exclusion nobody can
// count is the silent skip this tool removed from the walker in 0.4.0.
//
// A path is attributed to the **first** pattern that covers it, so two
// overlapping patterns do not both claim the same file and inflate the total.
pub struct ExclusionSet {
    exclusions: Vec<Exclusion>,
}

impl ExclusionSet {
    pub fn new(patterns: &[String]) -> Result<Self> {
        let exclusions = patterns
            .iter()
            .map(|pattern| Exclusion::new(pattern))
            .collect::<Result<Vec<_>>>()?;
        Ok(Self { exclusions })
    }

    pub fn is_empty(&self) -> bool {
        self.exclusions.is_empty()
    }

    pub fn apply(&self, paths: Vec<PathBuf>, root: &Path) -> ExclusionOutcome {
        let mut counts = vec![0usize; self.exclusions.len()];
        let mut kept = Vec::new();
        for path in paths {
            match self.covering(&path, root) {
                Some(index) => counts[index] += 1,
                None => kept.push(path),
            }
        }
        let excluded = self
            .exclusions
            .iter()
            .zip(counts)
            .map(|(exclusion, count)| (exclusion.pattern().to_string(), count))
            .collect();
        ExclusionOutcome::new(kept, excluded)
    }

    fn covering(&self, path: &Path, root: &Path) -> Option<usize> {
        let relative = path.strip_prefix(root).unwrap_or(path);
        self.exclusions
            .iter()
            .position(|exclusion| exclusion.matches(relative))
    }
}