easyship 0.1.5 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 26a4f14b66c264e247eba786be5a7e7c69e364b15bd82fb3a0b972d3738a2291
-  data.tar.gz: a602f6940102161c1b6e2e9e8a9714f7cd2e2576f5d4d5e04621d8119d7dbc06
+  metadata.gz: 7c050cd7909443866f9f0365555f577024aa49ce0065be2a961018385409972d
+  data.tar.gz: a827b2cdaa8207b8723f5a7c2b65efba7c6b7f9e10cf16b46ea36f34aebae763
 SHA512:
-  metadata.gz: 2548182a0a00f80abe3096a247f1a85b0878f8ed737f370813e169de5a0db67fc982080fc7650eae22a931f844adfc465566e27cfb331d381744ca53e038693d
-  data.tar.gz: c5be671de26cefaa90af42d8b5f22ddb32af00e84dcc4ad57db9a8fd193b05902a6b60fdc093968e7781ac523ca066cd322c9a478ea637cf8ca775f79fce329e
+  metadata.gz: 959f2149e8e0d3f33ce0592de28df9718a0fb1c24cdb78909acffbdcecbeab71449b29a1000c03589d24616603214f0f9aa0dc05bad67e96ee413b2acad2a25c
+  data.tar.gz: 0ba62b8bf714db84417d4c2abb13e66738b0510dd0f57997c9403cdbfb81e2fa78029fb9b058d07a5ed943bb5eb8a9054be8929f6a7975b816fc59dda360b781

data/.rubocop.yml

@@ -1,4 +1,5 @@
-require:
+plugins:
+  - rubocop-rake
   - rubocop-rspec
   - rubocop-performance
 
@@ -8,3 +9,6 @@ AllCops:
 
 Style/Copyright:
   Enabled: false
+
+RSpec/ExampleLength:
+  Max: 10

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 ## [Unreleased]
 
+## [v.0.2.0](https://github.com/mmarusyk/easyship/tree/v0.2.0) - 2025-05-04
+
+### Added
+- Add response_body and response_header to Easyship::Error
+- Deprecate body_error by @mmarusyk in https://github.com/mmarusyk/easyship/pull/9
+- Add badges by @mmarusyk in https://github.com/mmarusyk/easyship/pull/10
+
+
 ## [v0.1.5](https://github.com/mmarusyk/easyship/tree/v0.1.5) - 2025-05-03
 
 ### Fixed

data/README.md

@@ -1,5 +1,9 @@
 # Easyship
 
+[![Gem Version](https://badge.fury.io/rb/easyship.svg)](https://badge.fury.io/rb/easyship)
+[![Build Status](https://github.com/mmarusyk/easyship/workflows/Ruby/badge.svg)](https://github.com/mmarusyk/easyship/actions?query=workflow%3ARuby)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
 This gem provides a simple client for Easyship, offering accessing to Easyship's
     shipping, tracking, and logistics services directly from Ruby applications.
 
@@ -103,6 +107,15 @@ rescue Easyship::Errors::RateLimitError => e
 end
 ```
 
+Each error instance provides these methods:
+
+- `message`: Returns the error message text.
+- `body_error`: Returns an error details **(Deprecated)**.
+- `error`: Returns a hash containing original detailed error object from Easyship.
+- `response_body`: Returns the full response body from the API.
+- `response_headers`: Returns the HTTP headers from the API response.
+
+
 ### Pagination
 The `get` method in the `Easyship::Client` class is designed to support pagination seamlessly when interacting with the Easyship API by passing block of code. This method abstracts the complexity of managing pagination logic, allowing you to retrieve all items across multiple pages with a single method call.
 

data/lib/easyship/errors/easyship_error.rb

@@ -4,12 +4,20 @@ module Easyship
   module Errors
     # Represents an error that is raised when an error occurs in the Easyship API.
     class EasyshipError < StandardError
-      attr_reader :message, :body_error
+      attr_reader :message, :error, :response_body, :response_headers
 
-      def initialize(message: '', body_error: {})
+      def initialize(message: '', body_error: {}, error: {}, response_body: nil, response_headers: {})
         super(message)
+        @error = error
         @message = message
         @body_error = body_error
+        @response_body = response_body
+        @response_headers = response_headers
+      end
+
+      def body_error
+        warn '[DEPRECATION] `body_error` is deprecated. Please use `error` instead.'
+        @body_error
       end
     end
   end

data/lib/easyship/middleware/error_handler_middleware.rb

@@ -9,20 +9,33 @@ module Easyship
       def on_complete(env)
         status_code = env[:status].to_i
         body = response_body(env[:body])
+        headers = env[:response_headers]
 
-        handle_status_code(status_code, body)
+        handle_status_code(status_code, headers, body)
       end
 
       private
 
-      def handle_status_code(status_code, body)
+      def handle_status_code(status_code, headers, body)
         error_class = Easyship::Error.for_status(status_code)
 
-        raise_error(error_class, body) if error_class
+        raise_error(error_class, headers, body) if error_class
       end
 
-      def raise_error(class_error, body)
-        raise class_error.new(message: message(body), body_error: body_error(body))
+      def raise_error(class_error, headers, body)
+        raise class_error.new(
+          message: message(body),
+          body_error: body_error(body),
+          error: build_error(body),
+          response_body: body,
+          response_headers: headers
+        )
+      end
+
+      def build_error(body)
+        return default_error unless body.is_a?(Hash)
+
+        body[:error]
       end
 
       def body_error(body)
@@ -55,6 +68,10 @@ module Easyship
         { details: body, message: 'Something went wrong.' }
       end
 
+      def default_error
+        { details: [], message: 'Something went wrong.' }
+      end
+
       def response_body(body)
         JSON.parse(body, symbolize_names: true)
       rescue JSON::ParserError

data/lib/easyship/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Easyship
-  VERSION = '0.1.5'
+  VERSION = '0.2.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: easyship
 version: !ruby/object:Gem::Version
-  version: 0.1.5
+  version: 0.2.0
 platform: ruby
 authors:
 - Michael Marusyk