From e7b8ce751f8e6b6626291d177892a58559faf656 Mon Sep 17 00:00:00 2001
From: Ada Alakbarova <ada.alakbarova@proton.me>
Date: Wed, 24 Dec 2025 16:26:53 +0100
Subject: [PATCH 1/2] parse_value: add docs, fix string interpolation

---
 src/config/args.rs | 18 +++++++++++++++---
 1 file changed, 15 insertions(+), 3 deletions(-)

diff --git a/src/config/args.rs b/src/config/args.rs
index 07b9729a..5da3cc56 100644
--- a/src/config/args.rs
+++ b/src/config/args.rs
@@ -102,6 +102,18 @@ impl Args {
     }
 }
 
+/// Attempts to parse either:
+/// - `arg` as `<name>=<value>`
+/// - `arg` and the following argument as `<name>` and `<value>`, respectively
+///
+/// and returns `value` on success.
+///
+/// Returns:
+/// - `Ok(Some(value))` if `arg` looks as described above
+/// - `Ok(None)` if `arg` doesn't start with `<name>`
+/// - `Err` if:
+///   - there is additional text between `<name>` and `=`
+///   - `arg` is `<name>`, but there is no second argument
 fn parse_value<'a>(
     name: &str,
     arg: &'a str,
@@ -111,15 +123,15 @@ fn parse_value<'a>(
         Some(s) => s,
         None => return Ok(None),
     };
-    if let Some(n) = with_eq.strip_prefix('=') {
-        Ok(Some(n.into()))
+    if let Some(value) = with_eq.strip_prefix('=') {
+        Ok(Some(value.into()))
     } else {
         ensure!(with_eq.is_empty(), "`{name}` can only be followed by `=`");
 
         if let Some(next) = iter.next() {
             Ok(Some(next.into()))
         } else {
-            bail!("`name` must be followed by a value")
+            bail!("`{name}` must be followed by a value")
         }
     }
 }

From dcf78af44019050b28108f83ad95b9d1d4dcd79d Mon Sep 17 00:00:00 2001
From: Ada Alakbarova <ada.alakbarova@proton.me>
Date: Wed, 24 Dec 2025 16:35:51 +0100
Subject: [PATCH 2/2] doc(cli): update the list of available flags

---
 CHANGELOG.md       |  2 ++
 src/config/args.rs | 15 ++++++++++++++-
 2 files changed, 16 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 248ca4b8..c383ed33 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -11,6 +11,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Fixed
 
+- Update the help string in CLI to include new flags
+
 ### Changed
 
 - when a test file has no error patterns, there's now a suggestion to add `//@check-pass`
diff --git a/src/config/args.rs b/src/config/args.rs
index 5da3cc56..54978f79 100644
--- a/src/config/args.rs
+++ b/src/config/args.rs
@@ -86,7 +86,20 @@ impl Args {
             } else if let Some(skip) = parse_value("--skip", &arg, &mut iter)? {
                 self.skip.push(skip.into_owned());
             } else if arg == "--help" {
-                bail!("available flags: --quiet, --check, --bless, --test-threads=n, --skip")
+                bail!(
+                    "\
+available flags:
+--quiet
+--check
+--bless
+--list
+--exact
+--ignored
+--help
+--skip=<TEST_NAME>
+--format=[json,pretty,terse]
+--test-threads=<NUM_THREADS>"
+                )
             } else if let Some(n) = parse_value("--test-threads", &arg, &mut iter)? {
                 self.threads = Some(n.parse()?);
             } else if arg.starts_with("--") {