Add output encoding options and bump version to 0.5.0 (#23)

## Summary
- add a global `--output-encoding` option with `utf8-no-bom`,
`utf8-bom`, and `utf8` values
- plumb output encoding through CLI query execution into file writes
while keeping the default behavior as UTF-8 without BOM
- bump cirup and packaging metadata to 0.5.0 and document the new option

## Details
- add `CliOutputEncoding` parsing and tests in `cirup_cli`
- add `OutputEncoding` support and BOM-aware byte generation in
`cirup_core::file`
- expose the core output encoding type and route interactive writes
through the new encoding-aware save path
- sync 0.5.0 across the Rust crates, NuGet packaging projects, sample
project, and e2e script

## Validation
- `cargo fmt --all --check`
- `cargo clippy --workspace --all-targets`
- `cargo test --workspace`
- manual smoke test of `file-convert` output bytes for RESX, JSON, and
RESTEXT with `utf8-no-bom` vs `utf8-bom`

## Notes
- `cargo clippy` completed successfully but emitted an environment-level
warning while finalizing an incremental compilation directory under
`target`

Author: mamoreau-devolutions

.gitignore

@@ -4,3 +4,4 @@ bin/
 .vscode/
 .idea/
 target/
+cirup.sln

Cargo.lock

@@ -1,10 +1,16 @@
-# cirup-rs
+# cirup
 
 `cirup` is a command-line tool for working with localization resource files.
 It supports `.json`, `.resx`, and `.restext` files.
 
 ## Quick start
 
+Install `cirup` globally as a .NET tool:
+
+```bash
+dotnet tool install -g Devolutions.Cirup.Tool
+```
+
 Build the workspace:
 
 ```bash
@@ -28,6 +34,7 @@ cirup --help
 - `-v`, `-vv`, ...: increase log verbosity.
 - `-C`, `--show-changes`: for `file-diff`, include keys that exist in both files but have different values.
 - `--touch`: force writing output files even when generated bytes are identical.
+- `--output-encoding <utf8-no-bom|utf8-bom|utf8>`: control output file encoding. `utf8` behaves like `utf8-no-bom`.
 
 By default, cirup avoids rewriting output files when content has not changed.
 

README.md

@@ -1,6 +1,6 @@
 [package]
 name = "cirup_cli"
-version = "0.4.0"
+version = "0.5.0"
 authors = ["Marc-André Moreau <marcandre.moreau@gmail.com>"]
 edition = "2024"