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
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
// Copyright 2025 Umberto Gotti <umberto.gotti@umbertogotti.dev>
// Licensed under the MIT License
// SPDX-License-Identifier: MIT
use std::path::PathBuf;
use clap::Parser;
use crate::offence_threshold::OffenceThreshold;
use crate::output_format::OutputFormat;
#[derive(Debug, Parser)]
#[command(name = "cargo-stern4rust")]
#[command(bin_name = "cargo stern4rust")]
#[command(version)]
#[command(about = "Check Rust packages and fail the build when the rule is broken")]
pub struct Args {
#[arg(long)]
pub manifest_path: Option<PathBuf>,
#[arg(long = "package")]
pub packages: Vec<String>,
/// File holding the header every .rs file must open with. It is data rather
/// than a built-in constant because it is never the same twice: MIT here,
/// Apache 2.0 in a sibling repository, and a different year again next year.
#[arg(long)]
pub header_file: Option<PathBuf>,
/// How to report. The table is for a person; `json` is the same run as a
/// document, for a gate script or an agent that would otherwise have to
/// guess where one column of the table ends and the next begins.
#[arg(long, value_enum, default_value_t = OutputFormat::Text)]
pub format: OutputFormat,
/// How many offences the report prints. A first run against a large
/// codebase can find a thousand, and a thousand rows is a wall rather than
/// a report. The cap is on what is shown and never on what is counted:
/// the summary, the omitted count and the exit code all see every offence.
/// Use 0 for no limit.
#[arg(long, default_value_t = OffenceThreshold::DEFAULT)]
pub offence_threshold: usize,
/// Apply only these rules; repeatable. Omit to apply every rule. Naming one
/// makes the selection a whitelist, which is what lets a codebase facing
/// hundreds of offences gate on one rule today and the rest as it goes.
#[arg(long = "rule")]
pub rules: Vec<String>,
/// Do not apply these rules; repeatable. Subtracted from whatever --rule
/// selected, so skipping wins over selecting.
#[arg(long = "skip")]
pub skipped_rules: Vec<String>,
}
impl Args {
pub fn parse_args() -> Self {
Self::parse_from(Self::without_cargo_subcommand(std::env::args()))
}
/// Cargo invokes `cargo stern4rust` as `cargo-stern4rust stern4rust ...`, so
/// the subcommand name arrives as an extra leading argument that clap would
/// otherwise reject. Running the binary directly does not repeat it, which
/// is why the strip is conditional rather than unconditional.
pub fn without_cargo_subcommand<I>(args: I) -> Vec<String>
where
I: IntoIterator<Item = String>,
{
let args: Vec<String> = args.into_iter().collect();
if args.get(1).map(String::as_str) != Some("stern4rust") {
return args;
}
let mut forwarded = Vec::with_capacity(args.len() - 1);
forwarded.extend(args.iter().take(1).cloned());
forwarded.extend(args.into_iter().skip(2));
forwarded
}
}