resource_reaper 1.0.5

resource_reaper: ^1.0.5 copied to clipboard

A lightweight resource manager for Dart and Flutter applications that handles the lifecycle and disposal of resources. Automatically purges expired items, disposes of old resources when capacity is reached, and helps prevent memory leaks.

Features #

✅ Automatic Disposal: Dispose of items when exceeding a maximum size limit.

⏱️ Time-Based Purging: Automatically purge items after a configurable expiration duration.

🗑️ Manual Control: Clear, purge, or remove items manually when needed.

⚡ Lightweight & Simple: Minimal dependencies, easy to integrate into existing projects.

Usage #

import 'package:resource_reaper/resource_reaper.dart';

class Connection {
  final String id;
  Connection(this.id);
  void close() => print('Connection $id closed.');
}

void main() {
  final reaper = ResourceReaper<Connection>(
    name: 'ConnectionReaper',
    size: 3,
    onDisposeItem: (conn) => conn.close(),
    verbose: true,
  );

  reaper.add(Connection('A'));
  reaper.add(Connection('B'));
  reaper.add(Connection('C'));
  reaper.add(Connection('D')); // Exceeds limit, disposes Connection A

  reaper.dispose(); // Clean up when done
}

For example usage with riverpod, refer to this example.

API Overview #

Important Notes #

• Always call dispose() when the ResourceReaper is no longer needed to prevent memory leaks due to lingering timers.
• For custom classes, ensure == and hashCode are properly overridden for accurate item removal.