clippy_dev/src/main.rs

   1 #![cfg_attr(feature = "deny-warnings", deny(warnings))]
   2
   3 use clap::{App, Arg, ArgMatches, SubCommand};
   4 use clippy_dev::{bless, fmt, new_lint, ra_setup, serve, stderr_length_check, update_lints};
   5
   6 #[cfg(feature = "lintcheck")]
   7 use clippy_dev::lintcheck;
   8
   9 fn main() {
  10     let matches = get_clap_config();
  11
  12     match matches.subcommand() {
  13         ("bless", Some(matches)) => {
  14             bless::bless(matches.is_present("ignore-timestamp"));
  15         },
  16         #[cfg(feature = "lintcheck")]
  17         ("lintcheck", Some(matches)) => {
  18             lintcheck::run(&matches);
  19         },
  20         ("fmt", Some(matches)) => {
  21             fmt::run(matches.is_present("check"), matches.is_present("verbose"));
  22         },
  23         ("update_lints", Some(matches)) => {
  24             if matches.is_present("print-only") {
  25                 update_lints::print_lints();
  26             } else if matches.is_present("check") {
  27                 update_lints::run(update_lints::UpdateMode::Check);
  28             } else {
  29                 update_lints::run(update_lints::UpdateMode::Change);
  30             }
  31         },
  32         ("new_lint", Some(matches)) => {
  33             match new_lint::create(
  34                 matches.value_of("pass"),
  35                 matches.value_of("name"),
  36                 matches.value_of("category"),
  37             ) {
  38                 Ok(_) => update_lints::run(update_lints::UpdateMode::Change),
  39                 Err(e) => eprintln!("Unable to create lint: {}", e),
  40             }
  41         },
  42         ("limit_stderr_length", _) => {
  43             stderr_length_check::check();
  44         },
  45         ("ra_setup", Some(matches)) => ra_setup::run(matches.value_of("rustc-repo-path")),
  46         ("serve", Some(matches)) => {
  47             let port = matches.value_of("port").unwrap().parse().unwrap();
  48             let lint = matches.value_of("lint");
  49             serve::run(port, lint);
  50         },
  51         _ => {},
  52     }
  53 }
  54
  55 fn get_clap_config<'a>() -> ArgMatches<'a> {
  56     #[cfg(feature = "lintcheck")]
  57     let lintcheck_sbcmd = SubCommand::with_name("lintcheck")
  58         .about("run clippy on a set of crates and check output")
  59         .arg(
  60             Arg::with_name("only")
  61                 .takes_value(true)
  62                 .value_name("CRATE")
  63                 .long("only")
  64                 .help("only process a single crate of the list"),
  65         )
  66         .arg(
  67             Arg::with_name("crates-toml")
  68                 .takes_value(true)
  69                 .value_name("CRATES-SOURCES-TOML-PATH")
  70                 .long("crates-toml")
  71                 .help("set the path for a crates.toml where lintcheck should read the sources from"),
  72         )
  73         .arg(
  74             Arg::with_name("threads")
  75                 .takes_value(true)
  76                 .value_name("N")
  77                 .short("j")
  78                 .long("jobs")
  79                 .help("number of threads to use, 0 automatic choice"),
  80         )
  81         .arg(Arg::with_name("fix").help("runs cargo clippy --fix and checks if all suggestions apply"));
  82
  83     let app = App::new("Clippy developer tooling")
  84         .subcommand(
  85             SubCommand::with_name("bless")
  86                 .about("bless the test output changes")
  87                 .arg(
  88                     Arg::with_name("ignore-timestamp")
  89                         .long("ignore-timestamp")
  90                         .help("Include files updated before clippy was built"),
  91                 ),
  92         )
  93         .subcommand(
  94             SubCommand::with_name("fmt")
  95                 .about("Run rustfmt on all projects and tests")
  96                 .arg(
  97                     Arg::with_name("check")
  98                         .long("check")
  99                         .help("Use the rustfmt --check option"),
 100                 )
 101                 .arg(
 102                     Arg::with_name("verbose")
 103                         .short("v")
 104                         .long("verbose")
 105                         .help("Echo commands run"),
 106                 ),
 107         )
 108         .subcommand(
 109             SubCommand::with_name("update_lints")
 110                 .about("Updates lint registration and information from the source code")
 111                 .long_about(
 112                     "Makes sure that:\n \
 113                  * the lint count in README.md is correct\n \
 114                  * the changelog contains markdown link references at the bottom\n \
 115                  * all lint groups include the correct lints\n \
 116                  * lint modules in `clippy_lints/*` are visible in `src/lifb.rs` via `pub mod`\n \
 117                  * all lints are registered in the lint store",
 118                 )
 119                 .arg(Arg::with_name("print-only").long("print-only").help(
 120                     "Print a table of lints to STDOUT. \
 121                  This does not include deprecated and internal lints. \
 122                  (Does not modify any files)",
 123                 ))
 124                 .arg(
 125                     Arg::with_name("check")
 126                         .long("check")
 127                         .help("Checks that `cargo dev update_lints` has been run. Used on CI."),
 128                 ),
 129         )
 130         .subcommand(
 131             SubCommand::with_name("new_lint")
 132                 .about("Create new lint and run `cargo dev update_lints`")
 133                 .arg(
 134                     Arg::with_name("pass")
 135                         .short("p")
 136                         .long("pass")
 137                         .help("Specify whether the lint runs during the early or late pass")
 138                         .takes_value(true)
 139                         .possible_values(&["early", "late"])
 140                         .required(true),
 141                 )
 142                 .arg(
 143                     Arg::with_name("name")
 144                         .short("n")
 145                         .long("name")
 146                         .help("Name of the new lint in snake case, ex: fn_too_long")
 147                         .takes_value(true)
 148                         .required(true),
 149                 )
 150                 .arg(
 151                     Arg::with_name("category")
 152                         .short("c")
 153                         .long("category")
 154                         .help("What category the lint belongs to")
 155                         .default_value("nursery")
 156                         .possible_values(&[
 157                             "style",
 158                             "correctness",
 159                             "complexity",
 160                             "perf",
 161                             "pedantic",
 162                             "restriction",
 163                             "cargo",
 164                             "nursery",
 165                             "internal",
 166                             "internal_warn",
 167                         ])
 168                         .takes_value(true),
 169                 ),
 170         )
 171         .subcommand(
 172             SubCommand::with_name("limit_stderr_length")
 173                 .about("Ensures that stderr files do not grow longer than a certain amount of lines."),
 174         )
 175         .subcommand(
 176             SubCommand::with_name("ra_setup")
 177                 .about("Alter dependencies so rust-analyzer can find rustc internals")
 178                 .arg(
 179                     Arg::with_name("rustc-repo-path")
 180                         .long("repo-path")
 181                         .short("r")
 182                         .help("The path to a rustc repo that will be used for setting the dependencies")
 183                         .takes_value(true)
 184                         .value_name("path")
 185                         .required(true),
 186                 ),
 187         )
 188         .subcommand(
 189             SubCommand::with_name("serve")
 190                 .about("Launch a local 'ALL the Clippy Lints' website in a browser")
 191                 .arg(
 192                     Arg::with_name("port")
 193                         .long("port")
 194                         .short("p")
 195                         .help("Local port for the http server")
 196                         .default_value("8000")
 197                         .validator_os(serve::validate_port),
 198                 )
 199                 .arg(Arg::with_name("lint").help("Which lint's page to load initially (optional)")),
 200         );
 201
 202     #[cfg(feature = "lintcheck")]
 203     let app = app.subcommand(lintcheck_sbcmd);
 204
 205     app.get_matches()
 206 }