cargo-stern4rust 0.7.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

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

use crate::reporting::offence::Offence;

// What makes two offences the same offence across two runs.
//
// The line number is deliberately **not** part of it. An offence that moves
// because somebody added an import above it is the same offence, and a baseline
// keyed on the line would go stale on the first unrelated edit -- which would
// make it useless exactly when it is most needed, on a codebase under active
// change.
//
// The file, the rule and the description are what is left. The description
// carries the subject (`\u{60}ColumnWidths\u{60} is a second type...`), so two different
// offences of one rule in one file stay distinct, while the same offence at a
// new line stays the same.
//
// Duplicates are counted rather than deduplicated. Two identical
// `syn::parse_file` calls in one file share a fingerprint, so the baseline
// records how many there were: fixing one and adding another must not pass.
pub struct OffenceFingerprint;

impl OffenceFingerprint {
    pub const SEPARATOR: &'static str = "\u{1f}";

    pub fn of(offence: &Offence) -> String {
        format!(
            "{}{}{}{}{}",
            offence.file,
            Self::SEPARATOR,
            offence.rule,
            Self::SEPARATOR,
            offence.description
        )
    }
}