catch_and_flow 1.0.0
catch_and_flow: ^1.0.0 copied to clipboard
A Flutter package for simplified and type-safe error handling in synchronous and asynchronous operations with a functional programming approach.
Changelog #
All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
1.0.0 - 2025-06-21 #
Added #
- First stable release of the catch_and_flow package
- Core
CustomErrorclass withGenericErrorandErrorFromExceptionimplementations Resulttype for functional error handling with success/error pattern- Safety handlers for different operation types:
runSafetyFutureandrunSafetyFutureNullablefor async operationsrunSafetyStreamandrunSafetyStreamNullablefor reactive streamsrunSafetySyncandrunSafetySyncNullablefor synchronous operations
- Extension methods:
Future.when()for callback-based future handling with progress, success, and error callbacksStream.when()for simplified stream subscription with progress, success, and error callbacksResult.when()for functional pattern matching
- Configurable logging system with:
- Multiple log levels (debug, info, warning, error, none)
- Custom logger interface for easy integration with existing logging solutions
- Helper functions for context-aware logging
- Complete API documentation with comprehensive examples
- Optimized error handling with minimal boilerplate code
- Full compatibility with Flutter and Dart projects
- Reliable error transformation and propagation
Changed #
- Improved documentation with detailed usage examples for all components
- Enhanced type safety across all APIs
- Optimized internal error handling mechanisms
Removed #
- Removed experimental features to ensure stability for 1.0.0 release
0.1.0 - 2025-06-20 #
Initial Release #
- Initial beta release of the catch_and_flow package
- Core
CustomErrorclass withGenericErrorandErrorFromExceptionimplementations Resulttype for functional error handling with success/error pattern- Basic safety handlers for different operation types
- Extension methods for Future, Stream and Result types
- Configurable logging system
- Initial API documentation with examples