dictzip_reader 0.1.2

A Dart package to read and decompress dictzip (.dict.dz) files with random access support.

example/example.dart

import 'dart:io';
import 'dart:typed_data';
import 'package:dictzip_reader/dictzip_reader.dart';

void main() async {
  // Replace with a path to a real .dict.dz file for manual testing
  final path = 'test_assets/test.dict.dz';
  
  if (!File(path).existsSync()) {
    print('Please provide a valid .dict.dz file at $path');
    exit(1);
  }

  final reader = DictzipReader(path);
  try {
    await reader.open();
    print('Header parsed successfully.');
    
    // ── Single Read ──────────────────────────────────────────────────────────
    print('\nReading first 50 bytes (single):');
    final text = await reader.read(0, 50);
    print('Result: $text');
    
    // ── Bulk Read ────────────────────────────────────────────────────────────
    print('\nReading multiple ranges in bulk:');
    final queries = [
      (0, 14),   // "Hello Dictzip!"
      (100, 14), // next occurrence
      (200, 14), // next occurrence
    ];
    
    final results = await reader.readBulk(queries);
    for (int i = 0; i < results.length; i++) {
      print('Query $i (offset ${queries[i].$1}): ${results[i]}');
    }

    // ── Custom Source (Memory) ────────────────────────────────────────────────
    print('\nUsing custom MemoryRandomAccessSource:');
    final fileBytes = await File(path).readAsBytes();
    final memorySource = MemoryRandomAccessSource(fileBytes);
    final memoryReader = DictzipReader(null);
    
    await memoryReader.openSource(memorySource);
    final memoryText = await memoryReader.read(0, 14);
    print('Result from memory: $memoryText');
    await memoryReader.close();

  } catch (e) {
    print('Error: $e');
  } finally {
    await reader.close();
  }
}

/// Simple in-memory source for demonstration.
class MemoryRandomAccessSource implements RandomAccessSource {
  final Uint8List data;
  MemoryRandomAccessSource(this.data);

  @override
  Future<int> get length async => data.length;

  @override
  Future<Uint8List> read(int offset, int length) async {
    final end = offset + length > data.length ? data.length : offset + length;
    return data.sublist(offset, end);
  }

  @override
  Future<void> close() async {}
}