arb_excel_converter_tool 1.1.1
arb_excel_converter_tool: ^1.1.1 copied to clipboard
A complete CLI tool to export Flutter ARB files to Excel for translators and import them back into your project.
Changelog #
All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
🚀 Fixed #
1.1.1 - 2025-12-25 #
- Fixed: subcommand help flag support for
exportandimport. - Improved: Error handling for invalid command-line arguments.
1.1.0 - 2025-12-25 #
🚀 Added #
- Two-Way Sync: Introduced the
importcommand. You can now convert Excel (.xlsx) files back into Flutter.arbfiles, completing the localization workflow. - Smart Defaults: Both commands now look for standard Flutter paths by default (
lib/l10n/app_en.arb), allowing for zero-config usage. - New Primary CLI: Added
arb_toolas the main global command with a revamped help menu and usage examples. - Pretty-Print JSON: Imported ARB files are automatically formatted with a 2-space indent to match Flutter's localization standards.
🛠 Fixed & Improved #
- Enhanced Help Menu: Added a rich in-terminal help experience with emojis, box-drawing characters, and contextual examples for sub-commands.
- Excel 4.x Migration: Rewrote row handling using
TextCellValueto ensure compatibility with the latestexcelpackage standards. - Metadata Persistence: Improved the logic for handling
@descriptiontags during both export and import cycles. - Robust Parsing: Added defensive checks to skip empty rows and handle missing keys gracefully during the import process.
1.0.2 - 2025-12-16 #
- Fix: Resolved "Unsupported operation: Cannot remove from an unmodifiable list" crash during Excel sheet creation.
- Stability: Improved Excel saving logic for better compatibility across different OS environments.
1.0.1 - 2025-12-16 #
- Feature: Added a default input path (
lib/l10n/app_en.arb) for easier use. - Feature: Added a
--help(-h) flag for in-terminal instructions. - Fix: Removed the "mandatory input" requirement that caused crashes.
- Improvement: Added descriptive error messages for missing files.
- Docs: Updated README with usage examples and an arguments table.
1.0.0 - 2025-12-15 #
Added #
- Initial public release of the ARB to Excel Converter Tool.
- Added core functionality to read
.arbfiles and extract keys, values, and descriptions. - Implemented command-line arguments for specifying input (
-i) and output (-o) files. - Created
arb_exportexecutable to simplify running the tool globally.