test(cli): add normalize format coverage and documentation

Author: WendellXY

CHANGELOG.md

@@ -10,10 +10,12 @@ The format is based on Keep a Changelog and this project follows Semantic Versio
 - Global `--strict` mode in CLI workflows and strict-read controls in library input options.
 - CLI `diff` command with human-readable and JSON report output.
 - Plural validation enhancements and richer stats reporting.
+- CLI `normalize` command support across Apple `.strings`, `.xcstrings`, Android `strings.xml`, CSV, and TSV formats, including drift detection with `--check`.
 
 ### Changed
 - Ongoing improvements to conversion coverage across Apple, Android, CSV, and TSV formats.
 - Documentation and contributor guidance updates.
+- Normalize workflow documentation, including `--dry-run`, `--no-placeholders`, `--key-style`, multi-input `--output` constraints, and `--continue-on-error` behavior.
 
 ### Fixed
 - Multiple parser/writer correctness and conversion edge-case fixes covered by expanded tests.

README.md

@@ -3,7 +3,7 @@
 Universal localization toolkit: library + CLI for Apple/Android/CSV/TSV.
 
 - Library crate (`langcodec`): parse, write, convert, merge with a unified model
-- CLI crate (`langcodec-cli`): convert, diff, merge, sync, view, stats, debug, edit
+- CLI crate (`langcodec-cli`): convert, diff, merge, sync, view, stats, debug, edit, normalize
 
 ---
 
@@ -59,6 +59,7 @@ This is a `0.7.0` release available on [crates.io](https://crates.io/crates/lang
 - Convert: `langcodec convert -i input.strings -o strings.xml`
 - Diff: `langcodec diff --source A.xcstrings --target B.xcstrings --json`
 - Edit (add/update/remove): `langcodec edit set -i 'locales/**/*.strings' -k welcome -v "Hello"` (use `--dry-run` to preview)
+- Normalize and detect drift: `langcodec normalize -i 'locales/**/*.{strings,xml,csv,tsv,xcstrings}' --check`
 - Sync existing keys only: `langcodec sync --source A.xcstrings --target B.xcstrings --match-lang en`
 - View: `langcodec view -i strings.xml --full`
 - Stats (JSON): `langcodec stats -i Localizable.xcstrings --json`
@@ -92,6 +93,10 @@ This is a `0.7.0` release available on [crates.io](https://crates.io/crates/lang
 - The convert command also supports custom JSON/YAML input formats.
 - The CLI will error if you try to merge files of different formats.
 - Edit supports multiple inputs and glob patterns. When multiple inputs are provided, edits are applied in-place and `--output` is not allowed.
+- Normalize supports `.strings`, Android `strings.xml`, `.csv`, `.tsv`, and `.xcstrings`.
+- Normalize options: `--check` (fail on drift), `--dry-run` (preview only), `--no-placeholders` (skip placeholder canonicalization), `--key-style` (`none|snake|kebab|camel`).
+- Normalize multi-input constraint: `--output` is single-input only; pair multi-input workflows with in-place writes.
+- Normalize `--continue-on-error` processes all inputs and returns non-zero if any file fails.
 - Android path inference: `values/strings.xml` (no qualifier) defaults to English (`en`).
 - When converting to `.xcstrings`, if `source_language` or `version` metadata is missing, the CLI defaults them to `en` and `1.0` respectively (overridable via flags).
 

langcodec-cli/README.md

@@ -3,7 +3,7 @@
 Universal CLI for converting, inspecting, merging, and editing localization files.
 
 - Formats: Apple `.strings`, `.xcstrings`, Android `strings.xml`, CSV, TSV
-- Commands: convert, diff, merge, sync, view, stats, debug, edit
+- Commands: convert, diff, merge, sync, view, stats, debug, edit, normalize
 
 ## Install
 
@@ -121,6 +121,39 @@ Options:
 
 Supported formats: .strings, .xml (Android), .xcstrings, .csv, .tsv. Custom JSON/YAML/.langcodec edit is currently not enabled.
 
+### normalize
+
+Normalize localization files in-place (or to `--output` in single-input mode).
+
+```sh
+# Normalize in-place
+langcodec normalize -i en.lproj/Localizable.strings
+
+# CI drift check (non-zero if any file would change)
+langcodec normalize -i 'locales/**/*.{strings,xml,csv,tsv,xcstrings}' --check
+
+# Preview without writing
+langcodec normalize -i values/strings.xml --dry-run
+
+# Disable placeholder normalization and rename keys to snake_case
+langcodec normalize -i Localizable.xcstrings --no-placeholders --key-style snake
+
+# Keep processing remaining files and summarize failures at the end
+langcodec normalize -i a.strings -i b.csv -i c.tsv --continue-on-error
+```
+
+Options and behavior:
+
+- --check: Detects normalization drift and exits non-zero when a file would change.
+- --dry-run: Prints what would change and exits without writing files.
+- --no-placeholders: Skips placeholder canonicalization (for example `%@` → `%s`).
+- --key-style: Renames keys during normalization. Values: `none` (default), `snake`, `kebab`, `camel`.
+- --output/-o: Single-input mode only. If multiple inputs are provided, `--output` is rejected.
+- --continue-on-error: Continues processing all matched inputs, prints a summary, and exits non-zero if any file failed.
+- --inputs/-i: One or more files, including quoted glob patterns.
+
+Supported normalize formats: `.strings`, Android `strings.xml`, `.csv`, `.tsv`, `.xcstrings`.
+
 ## Notes
 
 - Android plurals `<plurals>` are supported.

langcodec-cli/tests/normalize_cli_tests.rs

@@ -88,6 +88,85 @@ fn test_normalize_dry_run_does_not_write() {
     assert_eq!(after, before);
 }
 
+#[test]
+fn test_normalize_check_detects_drift_across_standard_formats() {
+    let temp_dir = TempDir::new().unwrap();
+    let cases = [
+        (
+            "apple_strings",
+            "en.strings",
+            "\"z\" = \"%@\";\n\"a\" = \"A\";\n",
+        ),
+        (
+            "android_xml",
+            "strings.xml",
+            r#"<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <string name="z">Hello %@</string>
+    <string name="a">A</string>
+</resources>
+"#,
+        ),
+        ("csv", "translations.csv", "z,%@\na,A\n"),
+        ("tsv", "translations.tsv", "z\t%@\na\tA\n"),
+        (
+            "xcstrings",
+            "Localizable.xcstrings",
+            r#"{
+  "sourceLanguage": "en",
+  "version": "1.0",
+  "strings": {
+    "z": {
+      "localizations": {
+        "en": {
+          "stringUnit": {
+            "state": "translated",
+            "value": "Hello %@"
+          }
+        }
+      }
+    },
+    "a": {
+      "localizations": {
+        "en": {
+          "stringUnit": {
+            "state": "translated",
+            "value": "A"
+          }
+        }
+      }
+    }
+  }
+}
+"#,
+        ),
+    ];
+
+    for (label, filename, contents) in cases {
+        let input = temp_dir.path().join(filename);
+        fs::write(&input, contents).unwrap();
+
+        let output = langcodec_cmd()
+            .args(["normalize", "-i", input.to_str().unwrap(), "--check"])
+            .output()
+            .unwrap();
+
+        assert!(
+            !output.status.success(),
+            "{label} should report drift in --check mode"
+        );
+        let combined = format!(
+            "{}{}",
+            String::from_utf8_lossy(&output.stdout),
+            String::from_utf8_lossy(&output.stderr)
+        );
+        assert!(
+            combined.contains("would change"),
+            "{label} expected drift message, got: {combined}"
+        );
+    }
+}
+
 #[test]
 fn test_normalize_output_written_even_when_unchanged() {
     let temp_dir = TempDir::new().unwrap();