Changed #

• BREAKING: Renamed package from sized_file to file_sized
  • Update your imports from package:sized_file/sized_file.dart to package:file_sized/file_sized.dart
  • All functionality remains the same, only the package name has changed
• BREAKING: Renamed class from SizedFile to FileSize
• BREAKING: Renamed main library file from sized_file.dart to file_sized.dart
• Updated repository URL to reflect new package name
• Updated all documentation and examples with new package and class names

Migration Guide #

To migrate from sized_file to file_sized:

1. Update your pubspec.yaml:

   dependencies:
     file_sized: ^2.0.0  # was: sized_file: ^1.3.4
   

2. Update your imports:

   import 'package:file_sized/file_sized.dart';  // was: package:sized_file/sized_file.dart
   

3. Update class references:

   final size = FileSize.mb(5);  // was: SizedFile.mb(5)
   

Changed #

• edit package description (Max Length:180 characters)

Changed #

• add topics for pub.flutter-io.cn
• edit package description

Added #

• New extensionMethodsExample() function in example/main.dart demonstrating:
  • Basic extension usage for creating FileSize instances
  • Using extensions in arithmetic expressions
  • Comparing extension syntax vs constructor syntax
  • Complex calculations with multiple extensions

Changed #

• Fix Static Analyizer by Pub server

Added #

• Extension methods on num for convenient FileSize creation
  • .b extension: Creates FileSize from bytes (converts to integer)
  • .kb extension: Creates FileSize from kilobytes
  • .mb extension: Creates FileSize from megabytes
  • .gb extension: Creates FileSize from gigabytes
  • .tb extension: Creates FileSize from terabytes
  • Example: 5.mb is equivalent to FileSize.mb(5)
• Comprehensive test coverage for all extension methods (10 new tests, 126 total)
• Extension methods documentation in README with usage examples and comparison table

Changed #

• Enhanced documentation across all source files:
  • ByteConverter: Added comprehensive class and method documentation
  • UnitConverter (formerly ConverterStrategy): Enhanced documentation with detailed explanations
  • numericExtensions: Added detailed documentation for each extension method
  • FileSize: Improved documentation for _strategy, _postfixesGenerator, format(), and setPostfixesGenerator()
• Improved format() method documentation with clearer unit selection criteria including TB range
• Updated README Features section to highlight extension methods

Improved #

• Better code readability with expressive extension syntax
• More intuitive API for creating file size instances
• Clearer documentation throughout the codebase

Added #

• inTB property for accessing file size in terabytes
• Documentation examples for inTB property in code, README, and example files
• Comprehensive unit tests for inTB property conversions

Changed #

• BREAKING: FileSize.min() now accepts Iterable<FileSize> instead of two parameters
  • Returns the smallest size from a collection
  • Returns zero if the collection is empty
  • Example: FileSize.min([size1, size2, size3])
• BREAKING: FileSize.max() now accepts Iterable<FileSize> instead of two parameters
  • Returns the largest size from a collection
  • Returns zero if the collection is empty
  • Example: FileSize.max([size1, size2, size3])
• BREAKING renaming FileSize.values() to FileSize.units() factory constructor for creating instances from multiple units
  • Accepts optional named parameters: b, kb, mb, gb, tb
  • Example: FileSize.units(gb: 2, mb: 500, kb: 256) creates a file size of 2 GB + 500 MB + 256 KB
  • Efficiently ignores zero values
  • All parameters default to 0
• Updated all examples and documentation to reflect new min() and max() signatures
• Improved _ByteConverter class with better encapsulation (renamed to private)

Added #

• FileSize.units() factory constructor for creating instances from multiple units
• Accepts optional named parameters: b, kb, mb, gb, tb
• Example: FileSize.units(gb: 2, mb: 500, kb: 256) creates a file size of 2 GB + 500 MB + 256 KB
• Efficiently ignores zero values
• All parameters default to 0
• Complete documentation for FileSize.units with usage examples in README
• 8 new unit tests for FileSize.units factory constructor (112 total tests)
• Practical examples in example/main.dart demonstrating mixed units use cases

Added #

• Equality and comparison operators (==, <, <=, >, >=)
• Hash code support for use in Set and Map collections
• Arithmetic operators for addition (+) and subtraction (-)
• Multiplication operator (*) for scaling by numeric factors
• Division operator (/) for dividing by numeric values (returns FileSize)
• Comparable<FileSize> interface implementation with compareTo() method
• Static helper methods: min(), max(), sum(), average()
• New ratioTo() method for calculating ratios between two FileSize instances
  • Returns double representing the ratio
  • Example: used.ratioTo(total) returns 0.244 for 250 MB / 1 GB
• FileSize.zero static constant for zero-byte instances
• Comprehensive test suite expanded to 104 tests
• Advanced features examples demonstrating all new capabilities
• Equality and comparison focused example file

Changed #

• Updated all documentation to reflect the new API
• Updated README.md with arithmetic operations, static helpers, and comparison features
• Updated all example files to use ratioTo() for ratio calculations
• Simplified test expectations by removing unnecessary equals() matchers

Fixed #

• Removed ambiguous division operator behavior
• Improved code clarity with dedicated methods for different operations

Changed #

• Enhanced documentation

Changed #

• Removed unnecessary_library_name rule from analysis_options.yaml

Added #

• Initial release of the file_sized package
• FileSize class for handling file size conversions and formatting
• Support for multiple size units: bytes (B), kilobytes (KB), megabytes (MB), gigabytes (GB), and terabytes (TB)
• Constructors for creating instances from any unit: FileSize.b(), FileSize.kb(), FileSize.mb(), FileSize.gb(), FileSize.tb()
• Properties to access size in different units: inBytes, inKB, inMB, inGB
• Smart format() method that automatically selects the most appropriate unit for display
• Customizable fraction digits in formatting (default: 2 decimal places)
• Support for custom postfixes (unit labels) per format call
• Global postfix generator for internationalization support via setPostfixesGenerator()
• Binary divider (1024) for accurate storage size calculations
• Comprehensive unit tests with 32 test cases covering all features
• Complete API documentation with examples
• Example code demonstrating real-world use cases
• README with detailed usage instructions and practical examples

Features #

• Zero dependencies - pure Dart implementation
• Lightweight and performant
• Type-safe API with proper error handling
• Fully documented code with dartdoc comments
• Tested and verified with 100% test coverage