feat: Add --file-list <PATH> to choose files to check

crates/typos-cli/src/bin/typos-cli/args.rs

@@ -39,9 +39,13 @@ impl Format {
 #[command(group = clap::ArgGroup::new("mode").multiple(false))]
 pub(crate) struct Args {
     /// Paths to check with `-` for stdin
-    #[arg(default_value = ".")]
+    #[arg(default_value = ".", group = "source")]
     pub(crate) path: Vec<std::path::PathBuf>,
 
+    /// Read the list of newline separated paths from file or stdin (if `-`)
+    #[arg(long, group = "source")]
+    pub(crate) file_list: Option<std::path::PathBuf>,
+
     /// The approximate number of threads to use.
     #[arg(short = 'j', long = "threads", default_value = "0")]
     pub(crate) threads: usize,

crates/typos-cli/src/bin/typos-cli/main.rs

@@ -1,4 +1,5 @@
-use std::io::Write;
+use std::io::{BufRead as _, BufReader, Write as _};
+use std::path::PathBuf;
 
 use clap::Parser;
 
@@ -167,8 +168,34 @@ fn run_checks(args: &args::Args) -> proc_exit::ExitResult {
 
     let mut typos_found = false;
     let mut errors_found = false;
-    for path in args.path.iter() {
+
+    let file_list = match args.file_list.as_deref() {
+        Some(dash) if dash == PathBuf::from("-") => Some(
+            std::io::stdin()
+                .lines()
+                .map(|res| res.map(PathBuf::from))
+                .collect::<Result<_, _>>()
+                .with_code(proc_exit::sysexits::IO_ERR)?,
+        ),
+        Some(path) => Some(
+            BufReader::new(std::fs::File::open(path).with_code(proc_exit::sysexits::IO_ERR)?)
+                .lines()
+                .map(|res| res.map(PathBuf::from))
+                .collect::<Result<_, _>>()
+                .with_code(proc_exit::sysexits::IO_ERR)?,
+        ),
+        None => None,
+    };
+
+    // Note: file_list and args.path are mutually exclusive, enforced by clap
+    for path in file_list.as_ref().unwrap_or(&args.path) {
+        // Note paths are passed through stdin, `-` is treated like a normal path
         let cwd = if path == std::path::Path::new("-") {
+            if args.file_list.is_some() {
+                return Err(proc_exit::sysexits::USAGE_ERR.with_message(
+                    "Can't use `-` (stdin) while using `--file_list` provided paths",
+                ));
+            };
             global_cwd.clone()
         } else if path.is_file() {
             let mut cwd = path

crates/typos-cli/tests/cmd/file-list-stdin.in/_typos.toml

@@ -0,0 +1,8 @@
+[files]
+extend-exclude = ["_typos.toml"]
+
+[default.extend-identifiers]
+hello = "goodbye"
+
+[type.fail]
+extend-glob = ["*.fail"]

crates/typos-cli/tests/cmd/file-list-stdin.in/a.fail

@@ -0,0 +1 @@
+hello

crates/typos-cli/tests/cmd/file-list-stdin.in/b.fail

@@ -0,0 +1 @@
+hello

crates/typos-cli/tests/cmd/file-list-stdin.in/c.fail

@@ -0,0 +1 @@
+hello

crates/typos-cli/tests/cmd/file-list-stdin.in/d.fail

@@ -0,0 +1 @@
+hello

crates/typos-cli/tests/cmd/file-list-stdin.toml

@@ -0,0 +1,22 @@
+bin.name = "typos"
+args = "--file-list -"
+stdin = """
+b.fail
+d.fail
+"""
+stdout = """
+error: `hello` should be `goodbye`
+  --> b.fail:1:1
+  |
+1 | hello
+  | ^^^^^
+  |
+error: `hello` should be `goodbye`
+  --> d.fail:1:1
+  |
+1 | hello
+  | ^^^^^
+  |
+"""
+stderr = ""
+status.code = 2

crates/typos-cli/tests/cmd/help.toml

@@ -9,10 +9,11 @@ Arguments:
   [PATH]...  Paths to check with `-` for stdin [default: .]
 
 Options:
-  -j, --threads <THREADS>  The approximate number of threads to use [default: 0]
-      --force-exclude      Respect excluded files even for paths passed explicitly
-  -h, --help               Print help
-  -V, --version            Print version
+      --file-list <FILE_LIST>  Read the list of newline separated paths from file or stdin (if `-`)
+  -j, --threads <THREADS>      The approximate number of threads to use [default: 0]
+      --force-exclude          Respect excluded files even for paths passed explicitly
+  -h, --help                   Print help
+  -V, --version                Print version
 
 Config:
   -c, --config <CUSTOM_CONFIG>  Custom config file