serial_task_executor

Description:

serial task executor

SerialTaskExecutor
A Dart package providing a simple and efficient way to execute tasks serially, ensuring that each task is completed before the next one begins. `SerialTaskExecutor` is useful for scenarios where tasks need to be executed in order without overlapping, such as sync operations sequence, networking or file operations.






Features #

Ensures serial execution of asynchronous tasks.
Maintains task order, executing tasks in the sequence they were added.
Tasks exceptions don't blocking the entire execution queue.
Supports returning results from tasks.

Getting Started #
To use SerialTaskExecutor in your Dart project, add it as a dependency in your pubspec.yaml file:
dependencies:
serial_task_executor: ^0.0.1
copied to clipboard
Then import the package in your Dart code:
import 'package:serial_task_executor/serial_task_executor.dart';

copied to clipboard
Usage #
Create an instance of SerialTaskExecutor:
final executor = SerialTaskExecutor();

Future<SomeOperationResult> runSyncOperationSequence() {
return executor.executeTask(_runSyncOperationSequence);
}

Future<SomeOperationResult> _runSyncOperationSequence() async {
await _upSyncOperation();
await _downSyncOperation();
return _getSyncResult();
}
copied to clipboard
Each task will be executed in the order they were added, and the next task will not start until the current one is completed.
Handling Errors #
Errors in tasks can be handled using standard try-catch blocks or Future error handling mechanisms:
executor.executeTask(() async {
try {
// Task code that might throw
} catch (e) {
// Error handling
}
});
copied to clipboard
Notably, an unhandled error will not affect the sequential execution of other tasks in the queue. All tasks in the queue will be executed in the order they were added, even if one or more tasks throw an unhandled exception.