Merge pull request #6 from WendellXY/feature/edit-command

feat(cli): add edit command for in-place localization file modifications

Author: WendellXY

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, merge, view, stats, debug
+- CLI crate (`langcodec-cli`): convert, merge, view, stats, debug, edit
 
 ---
 
@@ -57,6 +57,7 @@ This is a `0.4.0` release available on [crates.io](https://crates.io/crates/lang
 ### CLI Highlights
 
 - Convert: `langcodec convert -i input.strings -o strings.xml`
+- Edit (add/update/remove): `langcodec edit set -i 'locales/**/*.strings' -k welcome -v "Hello"` (use `--dry-run` to preview)
 - View: `langcodec view -i strings.xml --full`
 - Stats (JSON): `langcodec stats -i Localizable.xcstrings --json`
   - See full options: langcodec-cli/README.md#stats
@@ -88,6 +89,7 @@ This is a `0.4.0` release available on [crates.io](https://crates.io/crates/lang
 - All commands support Apple `.strings`, `.xcstrings`, Android `strings.xml`, and CSV.
 - The convert command also supports JSON files with key-value pairs.
 - 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.
 - 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

@@ -1,9 +1,9 @@
 # langcodec-cli (Command Line)
 
-Universal CLI for converting, inspecting, and merging localization files.
+Universal CLI for converting, inspecting, merging, and editing localization files.
 
 - Formats: Apple `.strings`, `.xcstrings`, Android `strings.xml`, CSV, TSV
-- Commands: convert, merge, view, stats, debug
+- Commands: convert, merge, view, stats, debug, edit
 
 ## Install
 
@@ -51,11 +51,50 @@ Shows per-language totals, counts by status, and completion percent (excludes Do
 langcodec debug -i input.strings --lang en -o output.json
 ```
 
+### edit
+
+Unified in-place editing (add/update/remove) across one or many files.
+
+Basics:
+
+```sh
+# Add or update a key
+langcodec edit set -i en.strings -k welcome -v "Hello" --status translated --comment "Shown on home"
+
+# Remove a key (omit or empty value)
+langcodec edit set -i en.strings -k welcome
+langcodec edit set -i en.strings -k welcome -v ""
+
+# Multiple files or globs (quote patterns)
+langcodec edit set -i 'locales/**/*.strings' -k app_name -v "My App"
+langcodec edit set -i a.strings -i b.strings -k welcome -v "Hello"
+
+# Preview only
+langcodec edit set -i en.strings -k welcome -v "Hello" --dry-run
+
+# Write to a different file (single input only)
+langcodec edit set -i en.strings -k welcome -v "Hello" -o out.strings
+```
+
+Options:
+
+- --inputs/-i: One or more input files. Supports glob patterns when quoted.
+- --lang/-l: Language code (required when an input contains multiple languages).
+- --key/-k: Entry key to modify.
+- --value/-v: New value. If omitted or empty, the entry is removed.
+- --comment: Optional translator note.
+- --status: translated|needs_review|new|do_not_translate|stale.
+- --output/-o: Optional output path. Not allowed with multiple inputs.
+- --dry-run: Print what would change and exit without writing.
+- --continue-on-error: Process all inputs; report failures at the end (non-zero exit if any fail).
+
+Supported formats: .strings, .xml (Android), .xcstrings, .csv, .tsv. Custom JSON/YAML/.langcodec edit is currently not enabled.
+
 ## Notes
 
 - Android plurals `<plurals>` are supported.
 - Language inference: `en.lproj/Localizable.strings`, `values-es/strings.xml`, base `values/` → `en` by default.
-- Globbing: use quotes for patterns in merge (e.g., `'**/*.xml'`).
+- Globbing: use quotes for patterns in merge and edit (e.g., `'**/*.xml'`).
 
 ## License