Redus #

Developer utilities for Dart - Fine-grained reactivity, dependency injection, and more.

Modules #

Installation #

dependencies:
  redus: ^0.4.0

Dependency Injection #

Simple service locator with type-based and key-based lookup.

import 'package:redus/di.dart';

// Register by type
register<ApiService>(ApiService());
final api = get<ApiService>();

// Register multiple instances with keys
register<Logger>(ConsoleLogger(), key: #console);
register<Logger>(FileLogger(), key: #file);
final log = get<Logger>(key: #console);

// Factory registration
registerFactory<DatabaseConnection>(() => DatabaseConnection());

DI API #

Reactivity #

Vue-like fine-grained reactivity with automatic dependency tracking.

import 'package:redus/reactivity.dart';

final count = ref(0);
final doubled = computed(() => count.value * 2);

watchEffect((_) {
  print('Count: ${count.value}, Doubled: ${doubled.value}');
});

count.value = 5;  // Prints: "Count: 5, Doubled: 10"

Core API #

Utilities #

Advanced #

Examples #

Debounced Ref #

Ref<T> useDebouncedRef<T>(T value, {Duration delay = const Duration(milliseconds: 200)}) {
  Timer? timeout;
  return customRef((track, trigger) => (
    get: () { track(); return value; },
    set: (newValue) {
      timeout?.cancel();
      timeout = Timer(delay, () { value = newValue; trigger(); });
    },
  ));
}

Effect Scoping #

final scope = effectScope();

scope.run(() {
  final doubled = computed(() => count.value * 2);
  watchEffect((_) => print('Doubled: ${doubled.value}'));
});

scope.stop();  // Dispose all effects

License #

MIT License