sheet_mapper 1.0.0
sheet_mapper: ^1.0.0 copied to clipboard
A Flutter package for mapping Excel/CSV/TSV/PSV files to Dart objects using annotations, with a beautiful drag-and-drop UI widget.
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.
1.0.0 - 2024-01-10 #
Added #
- Initial release of sheet_mapper
- Support for Excel files (.xlsx, .xls, .xlsm) using the
excelpackage - Support for CSV, TSV, and PSV text-based formats
- Type-safe code generation using annotations (@SheetTable, @SheetColumn)
- Beautiful customizable drag-and-drop UI widget (SheetMapperWidget)
- Programmatic API for non-UI usage (SheetMapper.fromFile, fromBytes, fromString)
- Type conversions for String, int, double, bool, DateTime
- Support for nullable types
- Default value handling with customizable defaults
- Required field validation
- Multi-sheet Excel support
- Comprehensive error handling with user-friendly messages
- Full platform support (iOS, Android, Web, Desktop)
Features #
- @SheetTable annotation: Mark classes for sheet mapping with options for sheet name, index, header row, and start row
- @SheetColumn annotation: Map fields to columns with custom names, default values, date formats, and validation
- SheetMapperWidget: Drag-and-drop file upload with customizable appearance and animations
- SheetMapper API: Parse files, bytes, or string content into typed objects
- SheetParser: Unified parsing for all supported file types
- ExcelParser: Specialized Excel file parsing
- CsvParser: Text-based file parsing with proper quote handling