1
Fork 0
mirror of https://github.com/RGBCube/uutils-coreutils synced 2025-07-28 11:37:44 +00:00

cksum: --tag & --untagged - the order of usage matters. manage it

This commit is contained in:
Sylvestre Ledru 2024-04-15 17:52:06 +02:00 committed by Ben Wiederhake
parent 9e080a3684
commit ee2772925a
2 changed files with 304 additions and 29 deletions

View file

@ -144,10 +144,10 @@ struct Options {
algo_name: &'static str, algo_name: &'static str,
digest: Box<dyn Digest + 'static>, digest: Box<dyn Digest + 'static>,
output_bits: usize, output_bits: usize,
untagged: bool, tag: bool, // will cover the --untagged option
length: Option<usize>, length: Option<usize>,
output_format: OutputFormat, output_format: OutputFormat,
binary: bool, asterisk: bool, // if we display an asterisk or not (--binary/--text)
} }
/// Calculate checksum /// Calculate checksum
@ -244,7 +244,7 @@ where
), ),
(ALGORITHM_OPTIONS_CRC, true) => println!("{sum} {sz}"), (ALGORITHM_OPTIONS_CRC, true) => println!("{sum} {sz}"),
(ALGORITHM_OPTIONS_CRC, false) => println!("{sum} {sz} {}", filename.display()), (ALGORITHM_OPTIONS_CRC, false) => println!("{sum} {sz} {}", filename.display()),
(ALGORITHM_OPTIONS_BLAKE2B, _) if !options.untagged => { (ALGORITHM_OPTIONS_BLAKE2B, _) if options.tag => {
if let Some(length) = options.length { if let Some(length) = options.length {
// Multiply by 8 here, as we want to print the length in bits. // Multiply by 8 here, as we want to print the length in bits.
println!("BLAKE2b-{} ({}) = {sum}", length * 8, filename.display()); println!("BLAKE2b-{} ({}) = {sum}", length * 8, filename.display());
@ -253,15 +253,15 @@ where
} }
} }
_ => { _ => {
if options.untagged { if options.tag {
let prefix = if options.binary { "*" } else { " " };
println!("{sum} {prefix}{}", filename.display());
} else {
println!( println!(
"{} ({}) = {sum}", "{} ({}) = {sum}",
options.algo_name.to_ascii_uppercase(), options.algo_name.to_ascii_uppercase(),
filename.display() filename.display()
); );
} else {
let prefix = if options.asterisk { "*" } else { " " };
println!("{sum} {prefix}{}", filename.display());
} }
} }
} }
@ -312,11 +312,75 @@ mod options {
pub const RAW: &str = "raw"; pub const RAW: &str = "raw";
pub const BASE64: &str = "base64"; pub const BASE64: &str = "base64";
pub const CHECK: &str = "check"; pub const CHECK: &str = "check";
// for legacy compat reasons
pub const TEXT: &str = "text"; pub const TEXT: &str = "text";
pub const BINARY: &str = "binary"; pub const BINARY: &str = "binary";
} }
/// Determines whether to prompt an asterisk (*) in the output.
///
/// This function checks the `tag`, `binary`, and `had_reset` flags and returns a boolean
/// indicating whether to prompt an asterisk (*) in the output.
/// It relies on the overrides provided by clap (i.e., `--binary` overrides `--text` and vice versa).
/// Same for `--tag` and `--untagged`.
fn prompt_asterisk(tag: bool, binary: bool, had_reset: bool) -> bool {
if tag {
return false;
}
if had_reset {
return false;
}
binary
}
/**
* Determine if we had a reset.
* This is basically a hack to support the behavior of cksum
* when we have the following arguments:
* --binary --tag --untagged
* Don't do it with clap because if it struggling with the --overrides_with
* marking the value as set even if not present
*/
fn had_reset(args: &[String]) -> bool {
// Indices where "--binary" or "-b", "--tag", and "--untagged" are found
let binary_index = args.iter().position(|x| x == "--binary" || x == "-b");
let tag_index = args.iter().position(|x| x == "--tag");
let untagged_index = args.iter().position(|x| x == "--untagged");
// Check if all arguments are present and in the correct order
match (binary_index, tag_index, untagged_index) {
(Some(b), Some(t), Some(u)) => b < t && t < u,
_ => false,
}
}
/***
* cksum has a bunch of legacy behavior.
* We handle this in this function to make sure they are self contained
* and "easier" to understand
*/
fn handle_tag_text_binary_flags(matches: &clap::ArgMatches, check: bool) -> UResult<(bool, bool)> {
let untagged: bool = matches.get_flag(options::UNTAGGED);
let tag: bool = matches.get_flag(options::TAG);
let tag: bool = tag || !untagged;
let text_flag: bool = matches.get_flag(options::TEXT);
let binary_flag: bool = matches.get_flag(options::BINARY);
let args: Vec<String> = std::env::args().collect();
let had_reset = had_reset(&args);
let asterisk: bool = prompt_asterisk(tag, binary_flag, had_reset);
if (binary_flag || text_flag) && check {
return Err(io::Error::new(
io::ErrorKind::InvalidInput,
"the --binary and --text options are meaningless when verifying checksums",
)
.into());
}
Ok((tag, asterisk))
}
#[uucore::main] #[uucore::main]
pub fn uumain(args: impl uucore::Args) -> UResult<()> { pub fn uumain(args: impl uucore::Args) -> UResult<()> {
let matches = uu_app().try_get_matches_from(args)?; let matches = uu_app().try_get_matches_from(args)?;
@ -369,7 +433,9 @@ pub fn uumain(args: impl uucore::Args) -> UResult<()> {
None None
}; };
if algo_name == "bsd" && check { let (tag, asterisk) = handle_tag_text_binary_flags(&matches, check)?;
if ["bsd", "crc", "sysv"].contains(&algo_name) && check {
return Err(io::Error::new( return Err(io::Error::new(
io::ErrorKind::InvalidInput, io::ErrorKind::InvalidInput,
"--check is not supported with --algorithm={bsd,sysv,crc}", "--check is not supported with --algorithm={bsd,sysv,crc}",
@ -377,15 +443,6 @@ pub fn uumain(args: impl uucore::Args) -> UResult<()> {
.into()); .into());
} }
let untagged: bool = matches.get_flag(options::UNTAGGED);
let tag: bool = matches.get_flag(options::TAG);
let binary = if untagged && tag {
false
} else {
matches.get_flag(options::BINARY)
};
let (name, algo, bits) = detect_algo(algo_name, length); let (name, algo, bits) = detect_algo(algo_name, length);
let output_format = if matches.get_flag(options::RAW) { let output_format = if matches.get_flag(options::RAW) {
@ -401,9 +458,9 @@ pub fn uumain(args: impl uucore::Args) -> UResult<()> {
digest: algo, digest: algo,
output_bits: bits, output_bits: bits,
length, length,
untagged, tag,
output_format, output_format,
binary, asterisk,
}; };
match matches.get_many::<String>(options::FILE) { match matches.get_many::<String>(options::FILE) {
@ -451,13 +508,15 @@ pub fn uu_app() -> Command {
Arg::new(options::UNTAGGED) Arg::new(options::UNTAGGED)
.long(options::UNTAGGED) .long(options::UNTAGGED)
.help("create a reversed style checksum, without digest type") .help("create a reversed style checksum, without digest type")
.action(ArgAction::SetTrue), .action(ArgAction::SetTrue)
.overrides_with(options::TAG),
) )
.arg( .arg(
Arg::new(options::TAG) Arg::new(options::TAG)
.long(options::TAG) .long(options::TAG)
.help("create a BSD style checksum, undo --untagged (default)") .help("create a BSD style checksum, undo --untagged (default)")
.action(ArgAction::SetTrue), .action(ArgAction::SetTrue)
.overrides_with(options::UNTAGGED),
) )
.arg( .arg(
Arg::new(options::LENGTH) Arg::new(options::LENGTH)
@ -503,15 +562,88 @@ pub fn uu_app() -> Command {
Arg::new(options::TEXT) Arg::new(options::TEXT)
.long(options::TEXT) .long(options::TEXT)
.short('t') .short('t')
.hide(true) // for legacy compatibility, no action .hide(true)
.overrides_with(options::BINARY)
.action(ArgAction::SetTrue), .action(ArgAction::SetTrue),
) )
.arg( .arg(
Arg::new(options::BINARY) Arg::new(options::BINARY)
.long(options::BINARY) .long(options::BINARY)
.short('b') .short('b')
.hide(true) // for legacy compatibility, no action .hide(true)
.overrides_with(options::TEXT)
.action(ArgAction::SetTrue), .action(ArgAction::SetTrue),
) )
.after_help(AFTER_HELP) .after_help(AFTER_HELP)
} }
#[cfg(test)]
mod tests {
use super::had_reset;
use crate::prompt_asterisk;
#[test]
fn test_had_reset() {
let args = ["--binary", "--tag", "--untagged"]
.iter()
.map(|&s| s.to_string())
.collect::<Vec<String>>();
assert!(had_reset(&args));
let args = ["-b", "--tag", "--untagged"]
.iter()
.map(|&s| s.to_string())
.collect::<Vec<String>>();
assert!(had_reset(&args));
let args = ["-b", "--binary", "--tag", "--untagged"]
.iter()
.map(|&s| s.to_string())
.collect::<Vec<String>>();
assert!(had_reset(&args));
let args = ["--untagged", "--tag", "--binary"]
.iter()
.map(|&s| s.to_string())
.collect::<Vec<String>>();
assert!(!had_reset(&args));
let args = ["--untagged", "--tag", "-b"]
.iter()
.map(|&s| s.to_string())
.collect::<Vec<String>>();
assert!(!had_reset(&args));
let args = ["--binary", "--tag"]
.iter()
.map(|&s| s.to_string())
.collect::<Vec<String>>();
assert!(!had_reset(&args));
let args = ["--tag", "--untagged"]
.iter()
.map(|&s| s.to_string())
.collect::<Vec<String>>();
assert!(!had_reset(&args));
let args = ["--text", "--untagged"]
.iter()
.map(|&s| s.to_string())
.collect::<Vec<String>>();
assert!(!had_reset(&args));
let args = ["--binary", "--untagged"]
.iter()
.map(|&s| s.to_string())
.collect::<Vec<String>>();
assert!(!had_reset(&args));
}
#[test]
fn test_prompt_asterisk() {
assert!(!prompt_asterisk(true, false, false));
assert!(!prompt_asterisk(false, false, true));
assert!(prompt_asterisk(false, true, false));
assert!(!prompt_asterisk(false, false, false));
}
}

View file

@ -148,7 +148,7 @@ fn test_tag_after_untagged() {
.arg("-a=md5") .arg("-a=md5")
.arg("lorem_ipsum.txt") .arg("lorem_ipsum.txt")
.succeeds() .succeeds()
.stdout_is("cd724690f7dc61775dfac400a71f2caa lorem_ipsum.txt\n"); .stdout_is_fixture("md5_single_file.expected");
} }
#[test] #[test]
@ -235,10 +235,11 @@ fn test_untagged_algorithm_single_file() {
fn test_tag_short() { fn test_tag_short() {
new_ucmd!() new_ucmd!()
.arg("-t") .arg("-t")
.arg("--untagged")
.arg("--algorithm=md5") .arg("--algorithm=md5")
.arg("lorem_ipsum.txt") .arg("lorem_ipsum.txt")
.succeeds() .succeeds()
.stdout_is("MD5 (lorem_ipsum.txt) = cd724690f7dc61775dfac400a71f2caa\n"); .stdout_is("cd724690f7dc61775dfac400a71f2caa lorem_ipsum.txt\n");
} }
#[test] #[test]
@ -287,6 +288,22 @@ fn test_check_algo() {
.no_stdout() .no_stdout()
.stderr_contains("cksum: --check is not supported with --algorithm={bsd,sysv,crc}") .stderr_contains("cksum: --check is not supported with --algorithm={bsd,sysv,crc}")
.code_is(1); .code_is(1);
new_ucmd!()
.arg("-a=sysv")
.arg("--check")
.arg("lorem_ipsum.txt")
.fails()
.no_stdout()
.stderr_contains("cksum: --check is not supported with --algorithm={bsd,sysv,crc}")
.code_is(1);
new_ucmd!()
.arg("-a=crc")
.arg("--check")
.arg("lorem_ipsum.txt")
.fails()
.no_stdout()
.stderr_contains("cksum: --check is not supported with --algorithm={bsd,sysv,crc}")
.code_is(1);
} }
#[test] #[test]
@ -455,6 +472,58 @@ fn test_all_algorithms_fail_on_folder() {
} }
} }
#[cfg(unix)]
#[test]
fn test_dev_null() {
let scene = TestScenario::new(util_name!());
let at = &scene.fixtures;
at.touch("f");
scene
.ucmd()
.arg("--tag")
.arg("--untagged")
.arg("--algorithm=md5")
.arg("/dev/null")
.succeeds()
.stdout_contains("d41d8cd98f00b204e9800998ecf8427e ");
}
#[test]
fn test_reset_binary() {
let scene = TestScenario::new(util_name!());
let at = &scene.fixtures;
at.touch("f");
scene
.ucmd()
.arg("--binary") // should disappear because of the following option
.arg("--tag")
.arg("--untagged")
.arg("--algorithm=md5")
.arg(at.subdir.join("f"))
.succeeds()
.stdout_contains("d41d8cd98f00b204e9800998ecf8427e ");
}
#[test]
fn test_text_tag() {
let scene = TestScenario::new(util_name!());
let at = &scene.fixtures;
at.touch("f");
scene
.ucmd()
.arg("--text") // should disappear because of the following option
.arg("--tag")
.arg(at.subdir.join("f"))
.succeeds()
.stdout_contains("4294967295 0 ");
}
#[test] #[test]
fn test_binary_file() { fn test_binary_file() {
let scene = TestScenario::new(util_name!()); let scene = TestScenario::new(util_name!());
@ -471,16 +540,69 @@ fn test_binary_file() {
.succeeds() .succeeds()
.stdout_contains("d41d8cd98f00b204e9800998ecf8427e *"); .stdout_contains("d41d8cd98f00b204e9800998ecf8427e *");
// no "*" in this case
scene scene
.ucmd() .ucmd()
.arg("--untagged")
.arg("--tag") .arg("--tag")
.arg("--untagged")
.arg("--binary") .arg("--binary")
.arg("--algorithm=md5") .arg("--algorithm=md5")
.arg(at.subdir.join("f")) .arg(at.subdir.join("f"))
.succeeds() .succeeds()
.stdout_contains("d41d8cd98f00b204e9800998ecf8427e "); .stdout_contains("d41d8cd98f00b204e9800998ecf8427e *");
scene
.ucmd()
.arg("--tag")
.arg("--untagged")
.arg("--binary")
.arg("--algorithm=md5")
.arg("raw/blake2b_single_file.expected")
.succeeds()
.stdout_contains("7e297c07ed8e053600092f91bdd1dad7 *");
new_ucmd!()
.arg("--tag")
.arg("--untagged")
.arg("--binary")
.arg("--algorithm=md5")
.arg("lorem_ipsum.txt")
.succeeds()
.stdout_is("cd724690f7dc61775dfac400a71f2caa *lorem_ipsum.txt\n");
new_ucmd!()
.arg("--untagged")
.arg("--binary")
.arg("--algorithm=md5")
.arg("lorem_ipsum.txt")
.succeeds()
.stdout_is("cd724690f7dc61775dfac400a71f2caa *lorem_ipsum.txt\n");
new_ucmd!()
.arg("--binary")
.arg("--untagged")
.arg("--algorithm=md5")
.arg("lorem_ipsum.txt")
.succeeds()
.stdout_is("cd724690f7dc61775dfac400a71f2caa *lorem_ipsum.txt\n");
new_ucmd!()
.arg("-a")
.arg("md5")
.arg("--binary")
.arg("--untagged")
.arg("lorem_ipsum.txt")
.succeeds()
.stdout_is("cd724690f7dc61775dfac400a71f2caa *lorem_ipsum.txt\n");
new_ucmd!()
.arg("-a")
.arg("md5")
.arg("--binary")
.arg("--tag")
.arg("--untagged")
.arg("lorem_ipsum.txt")
.succeeds()
.stdout_is("cd724690f7dc61775dfac400a71f2caa lorem_ipsum.txt\n");
} }
#[test] #[test]
@ -500,3 +622,24 @@ fn test_folder_and_file() {
.stderr_contains(format!("cksum: {folder_name}: Is a directory")) .stderr_contains(format!("cksum: {folder_name}: Is a directory"))
.stdout_is_fixture("crc_single_file.expected"); .stdout_is_fixture("crc_single_file.expected");
} }
#[test]
fn test_conflicting_options() {
let scene = TestScenario::new(util_name!());
let at = &scene.fixtures;
at.touch("f");
scene
.ucmd()
.arg("--binary")
.arg("--check")
.arg("f")
.fails()
.no_stdout()
.stderr_contains(
"cksum: the --binary and --text options are meaningless when verifying checksums",
)
.code_is(1);
}