🔧 Reorganize command index and localize help headings (v0.4.6) #17

Merged

umpire274 merged 2 commits from v0.4.6 into main

2025-11-11 14:39:00 +01:00

umpire274 commented

2025-11-11 14:37:19 +01:00

(Migrated from github.com)

✨ Summary

This PR refines the overall CLI help experience by reorganizing the command index and adding full localization support for help section titles (help_heading).
The goal is to make the help output more structured, readable, and consistent across all commands and languages.

🔧 Changed

Reorganized command index in the main CLI help to follow a more intuitive structure:
- 📚 Book commands: list, search, add, edit, del
- ⚙️ App commands: config, backup, export, import
- ❓ Other: help
Localized all help headings (help_heading) for a fully translated CLI help:
- “Global options”
- “List-specific options”
- “Import-specific options”
- “Export-specific options”
- and other command-related sections
Improved consistency and readability of the help output across English and Italian.

🧩 Internal

Updated display_order values in cli.rs to align with the new logical command hierarchy.
Simplified cli.rs structure for easier future maintenance of localized headings.
Verified full compatibility with Clap’s help_template customization and i18n integration.

✅ Testing

Verified localized help output with cargo run -- --help for both English and Italian.
Confirmed proper command order and translated headings in the rendered help.
Ensured no regression in subcommand-specific help (librius list --help, librius import --help).

📦 Version

Release: v0.4.6
Date: 2025-11-12

## ✨ Summary This PR refines the overall CLI help experience by reorganizing the **command index** and adding full **localization support for help section titles** (`help_heading`). The goal is to make the help output more structured, readable, and consistent across all commands and languages. --- ## 🔧 Changed - **Reorganized command index** in the main CLI help to follow a more intuitive structure: - 📚 *Book commands*: list, search, add, edit, del - ⚙️ *App commands*: config, backup, export, import - ❓ *Other*: help - **Localized all help headings** (`help_heading`) for a fully translated CLI help: - “Global options” - “List-specific options” - “Import-specific options” - “Export-specific options” - and other command-related sections - Improved **consistency and readability** of the help output across English and Italian. --- ## 🧩 Internal - Updated `display_order` values in `cli.rs` to align with the new logical command hierarchy. - Simplified `cli.rs` structure for easier future maintenance of localized headings. - Verified full compatibility with Clap’s `help_template` customization and i18n integration. --- ## ✅ Testing - Verified localized help output with `cargo run -- --help` for both English and Italian. - Confirmed proper command order and translated headings in the rendered help. - Ensured no regression in subcommand-specific help (`librius list --help`, `librius import --help`). --- ## 📦 Version Release: **v0.4.6** Date: **2025-11-12**