pumb to 0.0.2

Author: maxzod

CHANGELOG.md

@@ -1,3 +1,10 @@
+## 0.0.2
+
+- support 404 `LNotFoundException`
+- support 500 `LServerException`
+- support 422 `LValidationException`
+- unit tests
+
 ## 0.0.1-beta
 
 - Initial version.

README.md

@@ -2,35 +2,35 @@
 
 # **`Part of Queen Packages 👑`**
 
-[![style: lint](https://img.shields.io/badge/style-lint-4BC0F5.svg)](https://pub.dev/packages/lint)
-
 # Motivation
 
 - since we work with APIs built with `Laravel` almost daily
-- i have built this package to easily wrap the validation exception which laravel might throw
-- you can easily know which fields got rejected or have failed and there messages
+- i have built this package to easily wrap the validation , NotFound , Internal Server Error exceptions which laravel might throw
+- you can easily know which fields got rejected or have failed and there messages in case of validation
+- in laravel debug mode extract the message easily with the stack trace
+- also you can build your custom exception if needed
 
 # Content
 
-- `LaravelException` Exception class which will parse the laravel response
+- `LaravelException` abstract class which will parse the laravel response
+- `LValidationException` Exception for `422` status code use the constructor to create objects
+- `LServerException` Exception for `500` status code use the `parse(Map)` factory to create objects
+- `LNotFoundException` Exception for `404` status code use the `parse(Map)` factory to create objects
 
 # example
 
 ```dart
- // 422
-if(res.statusCode == HttpStatus.unprocessableEntity){
-      throw LaravelException.parse(res.data);
+
+if(res.statusCode == 422){
+      throw  LValidationException(res.data);
+}else if(res.statusCode == 500){
+      throw  LServerException.parse(res.data);
+}else if(res.statusCode == 404){
+      throw  LNotFoundException.parse(res.data);
 }
 
 ```
 
-# Exception props 🧬
-
-- `keys` contains the failed input keys in the exception object
-- `errorMessages` contains the failed input keys in the exception object
-- `firstErrorMessage` return the first failure message
-- `toString()` convert the object to one big error message
-
 # What is next ?
 
 - [ ] dio interceptor

lib/laravel_exception.dart

@@ -1,8 +1,7 @@
 /// Support for doing something royal.
 library laravel_exception;
 
+export 'src/exceptions/imp.dart';
 export 'src/exceptions/internal_server_error.dart';
-export 'src/extractors.dart';
 export 'src/exceptions/not_found.dart';
 export 'src/exceptions/validation_err.dart';
-export 'src/exceptions/imp.dart';

lib/src/dio_interceptor.dart

@@ -8,6 +8,7 @@
 //   @override
 //   void onResponse(Response response, ResponseInterceptorHandler handler) {
 //     //TODO:: check if the backend is laravel
+//     //TODO:: interceptors wont catch the thrown the exception instead will skip it 
 //     log(response.statusCode.toString());
 //     switch (response.statusCode) {
 //       case 500:

lib/src/exceptions/imp.dart

@@ -2,15 +2,13 @@ import 'package:equatable/equatable.dart';
 
 /// * " Long Live The Queen "
 
-abstract class LaravelException<T> with EquatableMixin implements Exception {
+abstract class LaravelException with EquatableMixin implements Exception {
   /// contains the `response` data
-  final T response;
+  final Map<String, dynamic> response;
 
   String get message;
 
-  LaravelException({
-    required this.response,
-  });
+  LaravelException({required this.response});
 
   @override
   String toString() => message;

lib/src/exceptions/internal_server_error.dart

@@ -2,7 +2,7 @@ import 'package:laravel_exception/src/exceptions/imp.dart';
 import 'package:laravel_exception/src/models/file_stack_trace.dart';
 
 /// * `status code of => 500
-class LServerException extends LaravelException<Map<String, dynamic>> {
+class LServerException extends LaravelException {
   /// * Exception
   final String? exception;
 
@@ -30,16 +30,15 @@ class LServerException extends LaravelException<Map<String, dynamic>> {
           response: response,
         );
 
-  factory LServerException.fromMap(Map<String, dynamic> map) {
+  factory LServerException.parse(Map<String, dynamic> map) {
     return LServerException(
       response: map,
       message: map['message'],
       exception: map['exception'],
       file: map['file'],
       line: map['line'],
-      trace: (map['trace'] as List?)
-          ?.map((x) => FileStackTrace.fromMap(x))
-          .toList(),
+      trace:
+          (map['trace'] as List?)?.map((x) => FileStackTrace.parse(x)).toList(),
     );
   }
 

lib/src/exceptions/not_found.dart

@@ -1,6 +1,6 @@
 import 'package:laravel_exception/src/exceptions/imp.dart';
 
-class LNotFoundException extends LaravelException<Map<String, dynamic>> {
+class LNotFoundException extends LaravelException {
   /// * Exception
   final String? exception;
 
@@ -23,7 +23,7 @@ class LNotFoundException extends LaravelException<Map<String, dynamic>> {
           response: response,
         );
 
-  factory LNotFoundException.fromMap(Map<String, dynamic> map) {
+  factory LNotFoundException.parse(Map<String, dynamic> map) {
     return LNotFoundException(
       response: map,
       message: map['message'],

lib/src/exceptions/validation_err.dart

@@ -1,9 +1,6 @@
-import 'package:equatable/equatable.dart';
-
 import 'package:laravel_exception/src/exceptions/imp.dart';
 
-class LValidationException extends LaravelException<Map<String, dynamic>>
-    with EquatableMixin {
+class LValidationException extends LaravelException {
   final Map<String, List<String>> _errors;
 
   LValidationException(

lib/src/extractors.dart

@@ -14,7 +14,7 @@ class FileStackTrace extends Equatable {
     required this.type,
   });
 
-  factory FileStackTrace.fromMap(Map<String, dynamic> map) {
+  factory FileStackTrace.parse(Map<String, dynamic> map) {
     return FileStackTrace(
       file: map['file'],
       line: map['line'],

lib/src/models/file_stack_trace.dart

@@ -1,19 +1,13 @@
 name: laravel_exception
-description: parse laravel exception message to dart class with geters to make it simpler
-version: 0.0.1-beta
-publish_to: "none"
-homepage: https://github.com/maxzod/
+description: parse laravel exceptions to dart classes for easier and better handling support 422 - validation ,500 server errors , 404 not found exceptions
+version: 0.0.2
+homepage: https://github.com/maxzod/laravel_exception
 environment:
   sdk: ">=2.12.0 <3.0.0"
 
 dependencies:
-  # dio: ^4.0.0
   equatable: ^2.0.3
-  # json_blueprint:
-  #   git:
-  #     url: git@github.com:maxzod/json_blueprint.git
 
 dev_dependencies:
   lints: ^1.0.1
-  meta: ^1.3.0
   test: ^1.16.0

pubspec.yaml

@@ -6,7 +6,7 @@ void main() {
   test(
     'laravel 500 response aka InternalServerError',
     () {
-      final exception = LServerException.fromMap(response);
+      final exception = LServerException.parse(response);
       expect(exception.message, equals('Undefined variable: name'));
       expect(exception.exception, equals('ErrorException'));
       expect(