catching_josh #

Author: Joseph88 Email: [email protected] (Feedback welcome) Version: 1.2.4 License: MIT Git: https://github.com/joseph-seph88/catching_josh

Simple error handling with automatic logging. Focus on business logic, not error handling.

Why catching_josh? #

Before:

Future<String> fetchData() async {
  try {
    final response = await http.get(Uri.parse(url));
    if (response.statusCode >= 200 && response.statusCode < 300) {
      debugPrint('HTTP ${response.statusCode} Success: ${response.body}');
      return response.body.toString();
    } else {
      debugPrint('HTTP Error: ${response.statusCode} - ${response.reasonPhrase}');
      return 'Error: ${response.reasonPhrase}';
    }
  } catch (e) {
    debugPrint('Exception: $e');
    return 'Exception: $e';
  }
}

After:

Future<String> fetchData() async {
  final response = await joshReq(() => http.get(Uri.parse(url)));
  return response.data?.toString() ?? 'No data';
}

Usage #

Basic Examples #

// Sync operation
final result = joshSync(() => parseJson(jsonString));

// Async operation
final user = await joshAsync(() async => api.getUser(id));

// HTTP request
final response = await joshReq(() => http.get(url));

With Logging & Mock Data #

final result = await joshAsync(
  () async => api.getUser(id),
  logTitle: 'Get-User',
  showErrorLog: true,
  mockResultOnCatch: {'id': 1, 'name': 'Mock User'},
);

Batch Logging #

JoshLogBuffer.beginScope();
// ... multiple operations that generate logs
JoshLogBuffer.flushAll();  // Print all logs at once
JoshLogBuffer.endScope();

Core Functions #

Return Types #

class StandardResult {
  final Object? data;
  final String? dataType;
  final String? errorMessage;
  final bool? isSuccess;
}

class StandardResponse {
  final int? statusCode;
  final String? statusMessage;
  final dynamic data;
  final String? dataType;
  final bool? isSuccess;
}

Parameters #

License #

MIT License - see LICENSE file for details.