feat(frequency): add freq alias (#904)

Signed-off-by: Nico Wagner <[email protected]>

crates/pica-cli/src/commands/frequency.rs

@@ -25,6 +25,7 @@ use crate::prelude::*;
 /// requires the {}-notation and is expected at the first position (e.g.
 /// "044H/*{b == 'GND' && 9?, 9}").
 #[derive(Parser, Debug)]
+#[clap(visible_alias = "freq")]
 pub(crate) struct Frequency {
     /// Skip invalid records that can't be decoded as normalized PICA+.
     #[arg(long, short)]

crates/pica-cli/tests/frequency/mod.rs

@@ -26,6 +26,26 @@ fn frequency_stdout() -> TestResult {
     Ok(())
 }
 
+#[test]
+fn frequency_alias() -> TestResult {
+    let mut cmd = Command::cargo_bin("pica")?;
+    let assert = cmd
+        .args(["freq", "-s", "[email protected]"])
+        .arg(data_dir().join("algebra.dat"))
+        .arg(data_dir().join("invalid.dat"))
+        .arg(data_dir().join("ada.dat"))
+        .arg(data_dir().join("ada.dat"))
+        .assert();
+
+    assert
+        .success()
+        .code(0)
+        .stdout(predicates::ord::eq("Tp1,2\nTs1,1\n"))
+        .stderr(predicates::str::is_empty());
+
+    Ok(())
+}
+
 #[test]
 fn frequency_output() -> TestResult {
     let mut cmd = Command::cargo_bin("pica")?;

docs/book/commands/frequency.qmd

@@ -1,11 +1,11 @@
 # frequency {.unnumbered}
 
-Das Kommando `frequency` wird dazu genutzt, um die Häufigkeiten der Werte ein
-oder mehrerer Unterfelder zu bestimmen. Ist das zu untersuchende Feld bzw.
-Unterfeld wiederholbar, gehen alle Wertausprägungen eines Datensatzes in die
-Häufigkeitsverteilung ein. Die Ausgabe erfolgt standardmäßig im CSV-Format. Im
-folgenden Beispiel wird die Häufigkeitsverteilung des Unterfelds `[email protected]`
-(Satzart) ermittelt:
+Das Kommando `frequency` (Alias `freq`) wird dazu genutzt, um die Häufigkeiten
+der Werte ein oder mehrerer Unterfelder zu bestimmen. Ist das zu untersuchende
+Feld bzw. Unterfeld wiederholbar, gehen alle Wertausprägungen eines Datensatzes
+in die Häufigkeitsverteilung ein. Die Ausgabe erfolgt standardmäßig im
+CSV-Format. Im folgenden Beispiel wird die Häufigkeitsverteilung des Unterfelds
+`[email protected]` (Satzart) ermittelt:
 
 ```{.bash}
 $ pica frequency -s "[email protected]" DUMP.dat.gz