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

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

// One publicly reachable function, identified by name and arity.
//
// Arity rather than the parameter types, and that limit is the rule's whole
// honesty: at a call site `check(3, &paths)` gives two arguments and nothing
// more. Whether `3` is a `usize` and `&paths` a `&[&str]` is type inference,
// which is rustc's work and not something a syntax tree can answer. Arity is
// available, costs nothing, and separates `new()` from `new(a, b)` -- which is
// most of what a name alone confuses.
//
// The receiver does not count. `printer.with_fixed(12)` passes one argument and
// `pub fn with_fixed(self, fixed: usize)` declares one parameter besides self,
// so the two match.
#[derive(Debug, Clone, PartialEq, Eq, PartialOrd, Ord)]
pub struct PublicEntryPoint {
    pub name: String,
    pub arity: usize,
}

impl PublicEntryPoint {
    pub fn new(name: &str, arity: usize) -> Self {
        Self {
            name: name.to_string(),
            arity,
        }
    }

    // How the offence names it, so two entry points sharing a name are still
    // told apart on the page.
    pub fn signature(&self) -> String {
        format!("{}/{}", self.name, self.arity)
    }
}