✨ Features #

🚀 Quick Start #

Installation #

dependencies:
  byte_converter: ^2.5.0

Basic Usage #

import 'package:byte_converter/byte_converter.dart';

void main() {
  // 📦 Create from any unit
  final size = ByteConverter.fromGigaBytes(1.5);
  
  // 🎨 Display formats
  print(size.display.auto());    // "1.5 GB"
  print(size.display.fuzzy());   // "about 1.5 GB"
  print(size.display.gnu());     // "1.5G"
  
  // 🔍 Parse strings (even expressions!)
  final parsed = ByteConverter.parse('2 GiB + 512 MiB');
  print(parsed.gigaBytes);       // 2.68...
  
  // 🚀 Data rates & transfer estimation
  final rate = DataRate.parse('100 Mbps');
  final plan = size.estimateTransfer(rate);
  print(plan.etaString());       // "~2 minutes"
}

📦 Import Options #

// 🎯 Core (most use cases)
import 'package:byte_converter/byte_converter.dart';

// 🔥 Full (statistics, streaming, interop)
import 'package:byte_converter/byte_converter_full.dart';

// 🌍 Localization (with intl package)
import 'package:byte_converter/byte_converter_intl.dart';

// 🪶 Lightweight (no intl dependency)
import 'package:byte_converter/byte_converter_lite.dart';

🎯 Namespace API #

final size = ByteConverter.fromMegaBytes(1536);

// 🎨 Display - formatting options
size.display.auto()        // "1.5 GB"
size.display.fuzzy()       // "about 1.5 GB"
size.display.scientific()  // "1.5 × 10⁹ B"

// 💾 Storage - disk alignment
size.storage.sectors       // 3000000 (512B sectors)
size.storage.blocks        // 375000 (4KB blocks)

// 📡 Rate - network calculations
size.rate.bitsPerSecond    // 12884901888.0
size.rate.transferTime(rate) // Duration

// 📊 Compare - size comparisons
size.compare.percentOf(total)     // 15.0
size.compare.percentageBar(total) // "███░░░░░░░"

// ♿ Accessibility
size.accessibility.screenReader() // "one point five gigabytes"

📚 Documentation #