From ad3899d0a82937688d646fb693e8df65b20ed478 Mon Sep 17 00:00:00 2001 From: Joel Natividad <1980690+jqnatividad@users.noreply.github.com> Date: Wed, 31 Jan 2024 08:04:05 -0500 Subject: [PATCH] `documentation`: refine Extended Input Support section - expand stdin support explanation - mention auto snappy decompression - also, when logging extended input processing, expand log message to indicate it could be several files [skip ci] --- README.md | 6 ++++-- src/util.rs | 2 +- 2 files changed, 5 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 2b59beea9..901e4c37b 100644 --- a/README.md +++ b/README.md @@ -255,9 +255,11 @@ Click [here](https://docs.rs/file-format/latest/file_format/#reader-features) fo ### Extended Input Support -The `cat`, `headers`, `sqlp` & `to` commands have extended input support (🗄️). If the input is empty, the command will try to copy stdin. If it's not empty, it will check if its a directory, and if so, add all the files in the directory as input files. +The `cat`, `headers`, `sqlp` & `to` commands have extended input support (🗄️). If the input is `-` or empty, the command will try to use stdin as input. If it's not, it will check if its a directory, and if so, add all the files in the directory as input files. -If its a file, it will first check if it has an `.infile-list` extension. If it does, it will load the text file and parse each line as an input file path. This is a much faster and convenient way to process a large number of input files, without having to pass them all as separate command-line arguments. Further, the file paths can be anywhere in the file system, even on separate volumes. If the path is not fully qualified, it will be treated as relative to the current working directory. +If its a file, it will first check if it has an `.infile-list` extension. If it does, it will load the text file and parse each line as an input file path. This is a much faster and convenient way to process a large number of input files, without having to pass them all as separate command-line arguments. Further, the file paths can be anywhere in the file system, even on separate volumes. If an input file path is not fully qualified, it will be treated as relative to the current working directory. + +For both directory and `.infile-list` input, snappy compressed files with a `.sz` extension will be automatically decompressed. Finally, if its just a regular file, it will be treated as a regular input file. diff --git a/src/util.rs b/src/util.rs index 00d4d6ede..0e48b2298 100644 --- a/src/util.rs +++ b/src/util.rs @@ -1553,7 +1553,7 @@ pub fn process_input( } return fail_clierror!("{custom_empty_stdin_errmsg}"); } - log::debug!("processed input: {:?}", processed_input); + log::debug!("processed input file/s: {:?}", processed_input); Ok(processed_input) }