excel_translator 1.0.2
excel_translator: ^1.0.2 copied to clipboard
Generate type-safe Flutter localizations from Excel files with multi-sheet support, automatic language validation, and context-free access patterns.
Changelog #
1.0.2 - 2025-09-04 #
Added #
- Multi-Format File Support: Added CSV (.csv) and ODS (.ods) format support
- ODS Format Support: Full OpenDocument Spreadsheet (.ods) support using spreadsheet_decoder
- Added
spreadsheet_decoder
package dependency for ODS parsing - Added
csv
package dependency for CSV parsing - ODS files now support multiple sheets (same as Excel)
- Enhanced
FileFormat
enum with modern Dart enhanced enum features - Comprehensive multi-format support: Excel (.xlsx), CSV (.csv), and ODS (.ods)
Enhanced #
- CLI Help: Updated help text to reflect full multi-format support
- Documentation: Added CSV and ODS examples and usage instructions
- File Parser: Modernized enum implementation using Dart 2.17+ enhanced enum features
- Example Files: Added CSV and ODS example files in
example/assets/
- Format Detection: Improved file format detection with better error messages
- Unified API: Refactored to use
generateFromFile
with backward compatibility
Technical #
- Created FileParserFactory for handling different file formats
- Implemented CsvFileParser with proper line ending handling
- Implemented OdsFileParser with comprehensive error handling
- Refactored
FileFormat
enum to use enhanced enum with extension values - Simplified format detection logic by eliminating manual switch statements
- Added comprehensive format comparison documentation
- All three formats now have feature parity where applicable
- Maintained legacy
generateFromExcel
method for backward compatibility
Style #
- Code Formatting: Applied
dart format
to all source files - Fixed formatting issues reported by pub.flutter-io.cn static analysis
- Ensures compliance with official Dart style guidelines
1.0.1 - 2025-09-04 #
Fixed #
- WASM Compatibility: Removed
dart:io
dependency from generated code - Generated localizations now work in WASM environments
- System language detection uses only
PlatformDispatcher
(WASM compatible) - Separated runtime exports from build-time dependencies
- Static Analysis: Fixed CLI import issues for pub.flutter-io.cn scoring
- Resolved relative import warnings in
bin/excel_translator.dart
- Created dedicated CLI export file (
lib/cli.dart
) for build-time dependencies
Changed #
- Improved language detection fallback mechanism
- Better error handling for environments without platform access
1.0.0 - 2024-12-19 #
Added #
- Initial release of Excel Translator
- Multi-sheet Excel file support
- Type-safe localization generation
- BuildContext extension for easy access
- String interpolation with dynamic parameters
- Command-line generation tool
- Comprehensive example application
- Support for multiple languages per sheet
- Automatic fallback handling
- Clean, modular code generation
Features #
- Generate localizations from Excel files with multiple sheets
- Access translations via
context.loc.sheetName.key
- String interpolation support with
{variable}
syntax - Type-safe parameter handling
- Automatic code generation with proper imports
- Support for unlimited languages and sheets