ev-recharge-sdk 1.2.0 → 1.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3581a5328737a93ee89d58d621cd5b0cd8ab33f77a8940b52e7a5992e96c17ae
-  data.tar.gz: d6397da21ac9a71c372605d673fcf9f4afddf119405becae51a32228fdf4cb50
+  metadata.gz: 5f958a760fdf4430c7366b744e7c56aace6ed34cf48f6ee7a06d938cf947c7dd
+  data.tar.gz: b8f570f5c8bbe7f0f2dc577867d8f43c59362717015a9ca56f779129efd0254b
 SHA512:
-  metadata.gz: 3b459aa49f87f0aef6aa7d6aad385b8488718c06c3b69f1d6950e4732a71d454d3649fa80f7fd89ebe72ddff63c84adc5b4b410dba9dc4585e6753f662eabe6c
-  data.tar.gz: a484563a4340d88c652cfbaf24ba62ad4c875e501ccabccc7cce407e68574f1d335681bb62397adf75c5a1bda963443fc065e8c810d30218b5ea3a9779a8ed5a
+  metadata.gz: ec2964929d7df347bb30519395f465e3b1336acfb5967b5d57e97f237e7544613ffa579bcdc0204a4c43158049652f533de9b7db62ffbcb1ed39ce5118399835
+  data.tar.gz: 429bffca3aacd25c25ab4a8ed87bc1c6b56007c36e78c25290ce62b01277e021b5200a66b25934e37263944aed23c294a98e6eff8b7859cffa26ea257c05c448

data/LICENSE

@@ -3,7 +3,7 @@ License:
 The MIT License (MIT)
 http://opensource.org/licenses/MIT
 
-Copyright (c) 2014 - 2024 APIMATIC Limited
+Copyright (c) 2014 - 2025 APIMATIC Limited
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -27,17 +27,17 @@ Go to the Shell Developer Portal: [https://developer.shell.com](https://develope
 
 Install the gem from the command line:
 
-```ruby
-gem install ev-recharge-sdk -v 1.2.0
+```bash
+gem install ev-recharge-sdk -v 1.4.0
 ```
 
 Or add the gem to your Gemfile and run `bundle`:
 
 ```ruby
-gem 'ev-recharge-sdk', '1.2.0'
+gem 'ev-recharge-sdk', '1.4.0'
 ```
 
-For additional gem details, see the [RubyGems page for the ev-recharge-sdk gem](https://rubygems.org/gems/ev-recharge-sdk/versions/1.2.0).
+For additional gem details, see the [RubyGems page for the ev-recharge-sdk gem](https://rubygems.org/gems/ev-recharge-sdk/versions/1.4.0).
 
 ## Test the SDK
 
@@ -49,7 +49,7 @@ rake
 
 ## Initialize the API Client
 
-**_Note:_** Documentation for the client can be found [here.](https://www.github.com/sdks-io/ev-recharge-ruby-sdk/tree/1.2.0/doc/client.md)
+**_Note:_** Documentation for the client can be found [here.](https://www.github.com/sdks-io/ev-recharge-ruby-sdk/tree/1.4.0/doc/client.md)
 
 The following parameters are configurable for the API Client:
 
@@ -65,7 +65,7 @@ The following parameters are configurable for the API Client:
 | `retry_statuses` | `Array` | A list of HTTP statuses to retry. <br> **Default: [408, 413, 429, 500, 502, 503, 504, 521, 522, 524]** |
 | `retry_methods` | `Array` | A list of HTTP methods to retry. <br> **Default: %i[get put]** |
 | `http_callback` | `HttpCallBack` | The Http CallBack allows defining callables for pre and post API calls. |
-| `client_credentials_auth_credentials` | [`ClientCredentialsAuthCredentials`](https://www.github.com/sdks-io/ev-recharge-ruby-sdk/tree/1.2.0/doc/$a/https://www.github.com/sdks-io/ev-recharge-ruby-sdk/tree/1.2.0/oauth-2-client-credentials-grant.md) | The credential object for OAuth 2 Client Credentials Grant |
+| `client_credentials_auth_credentials` | [`ClientCredentialsAuthCredentials`](https://www.github.com/sdks-io/ev-recharge-ruby-sdk/tree/1.4.0/doc/auth/oauth-2-client-credentials-grant.md) | The credential object for OAuth 2 Client Credentials Grant |
 
 The API client can be initialized as follows:
 
@@ -87,23 +87,23 @@ The SDK can be configured to use a different environment for making API calls. A
 
 | Name | Description |
 |  --- | --- |
-| production | **Default** Production |
-| environment2 | Test |
+| production | **Default** Production Server |
+| environment2 | Test Server |
 
 ## Authorization
 
 This API uses the following authentication schemes.
 
-* [`BearerAuth (OAuth 2 Client Credentials Grant)`](https://www.github.com/sdks-io/ev-recharge-ruby-sdk/tree/1.2.0/doc/$a/https://www.github.com/sdks-io/ev-recharge-ruby-sdk/tree/1.2.0/oauth-2-client-credentials-grant.md)
+* [`BearerAuth (OAuth 2 Client Credentials Grant)`](https://www.github.com/sdks-io/ev-recharge-ruby-sdk/tree/1.4.0/doc/auth/oauth-2-client-credentials-grant.md)
 
 ## List of APIs
 
-* [Locations](https://www.github.com/sdks-io/ev-recharge-ruby-sdk/tree/1.2.0/doc/controllers/locations.md)
-* [Charging](https://www.github.com/sdks-io/ev-recharge-ruby-sdk/tree/1.2.0/doc/controllers/charging.md)
+* [Locations](https://www.github.com/sdks-io/ev-recharge-ruby-sdk/tree/1.4.0/doc/controllers/locations.md)
+* [Charging](https://www.github.com/sdks-io/ev-recharge-ruby-sdk/tree/1.4.0/doc/controllers/charging.md)
 
 ## Classes Documentation
 
-* [Utility Classes](https://www.github.com/sdks-io/ev-recharge-ruby-sdk/tree/1.2.0/doc/utility-classes.md)
-* [HttpResponse](https://www.github.com/sdks-io/ev-recharge-ruby-sdk/tree/1.2.0/doc/http-response.md)
-* [HttpRequest](https://www.github.com/sdks-io/ev-recharge-ruby-sdk/tree/1.2.0/doc/http-request.md)
+* [Utility Classes](https://www.github.com/sdks-io/ev-recharge-ruby-sdk/tree/1.4.0/doc/utility-classes.md)
+* [HttpResponse](https://www.github.com/sdks-io/ev-recharge-ruby-sdk/tree/1.4.0/doc/http-response.md)
+* [HttpRequest](https://www.github.com/sdks-io/ev-recharge-ruby-sdk/tree/1.4.0/doc/http-request.md)
 

data/lib/shell_ev/configuration.rb

@@ -6,8 +6,8 @@
 module ShellEv
   # An enum for SDK environments.
   class Environment
-    # PRODUCTION: Production
-    # ENVIRONMENT2: Test
+    # PRODUCTION: Production Server
+    # ENVIRONMENT2: Test Server
     ENVIRONMENT = [
       PRODUCTION = 'production'.freeze,
       ENVIRONMENT2 = 'environment2'.freeze
@@ -17,7 +17,8 @@ module ShellEv
   # An enum for API servers.
   class Server
     SERVER = [
-      DEFAULT = 'default'.freeze
+      DEFAULT = 'default'.freeze,
+      ACCESS_TOKEN_SERVER = 'access token server'.freeze
     ].freeze
   end
 
@@ -143,10 +144,12 @@ module ShellEv
     # All the environments the SDK can run in.
     ENVIRONMENTS = {
       Environment::PRODUCTION => {
-        Server::DEFAULT => 'https://api.shell.com'
+        Server::DEFAULT => 'https://api.shell.com/ev/v1',
+        Server::ACCESS_TOKEN_SERVER => 'https://api.shell.com/v2/oauth'
       },
       Environment::ENVIRONMENT2 => {
-        Server::DEFAULT => 'https://api-test.shell.com'
+        Server::DEFAULT => 'https://api-test.shell.com/ev/v1',
+        Server::ACCESS_TOKEN_SERVER => 'https://api.shell.com/v2/oauth'
       }
     }.freeze
 

data/lib/shell_ev/controllers/charging_controller.rb

@@ -15,12 +15,12 @@ module ShellEv
     # 8-4-4-4-12 for a total of 36 characters (32 hexadecimal characters and 4
     # hyphens) <br>
     # @param [ChargesessionStartBody] body Optional parameter: Example:
-    # @return [InlineResponse202] response from the API call
+    # @return [InlineResponse202] response from the API call.
     def start(request_id,
               body: nil)
       new_api_call_builder
         .request(new_request_builder(HttpMethodEnum::POST,
-                                     '/ev/v1/charge-session/start',
+                                     '/charge-session/start',
                                      Server::DEFAULT)
                    .header_param(new_parameter(request_id, key: 'RequestId'))
                    .header_param(new_parameter('application/json', key: 'Content-Type'))
@@ -66,12 +66,12 @@ module ShellEv
     # 8-4-4-4-12 for a total of 36 characters (32 hexadecimal characters and 4
     # hyphens) <br>
     # @param [String] session_id Required parameter: Session Id
-    # @return [InlineResponse2021] response from the API call
+    # @return [InlineResponse2021] response from the API call.
     def stop(request_id,
              session_id)
       new_api_call_builder
         .request(new_request_builder(HttpMethodEnum::POST,
-                                     '/ev/v1/charge-session/stop',
+                                     '/charge-session/stop',
                                      Server::DEFAULT)
                    .header_param(new_parameter(request_id, key: 'RequestId'))
                    .query_param(new_parameter(session_id, key: 'sessionId'))
@@ -114,12 +114,12 @@ module ShellEv
     # 8-4-4-4-12 for a total of 36 characters (32 hexadecimal characters and 4
     # hyphens) <br>
     # @param [String] session_id Required parameter: Session Id
-    # @return [GetChargeSessionRetrieveResponse200Json] response from the API call
+    # @return [GetChargeSessionRetrieveResponse200Json] response from the API call.
     def get_charge_session_retrieve(request_id,
                                     session_id)
       new_api_call_builder
         .request(new_request_builder(HttpMethodEnum::GET,
-                                     '/ev/v1/charge-session/retrieve',
+                                     '/charge-session/retrieve',
                                      Server::DEFAULT)
                    .header_param(new_parameter(request_id, key: 'RequestId'))
                    .query_param(new_parameter(session_id, key: 'sessionId'))
@@ -163,12 +163,12 @@ module ShellEv
     # hyphens) <br>
     # @param [String] ema_id Required parameter: Emobility Account
     # Identifier(Ema-ID)
-    # @return [ActiveResponse200Json] response from the API call
+    # @return [ActiveResponse200Json] response from the API call.
     def active(request_id,
                ema_id)
       new_api_call_builder
         .request(new_request_builder(HttpMethodEnum::GET,
-                                     '/ev/v1/charge-session/active',
+                                     '/charge-session/active',
                                      Server::DEFAULT)
                    .header_param(new_parameter(request_id, key: 'RequestId'))
                    .query_param(new_parameter(ema_id, key: 'emaId'))

data/lib/shell_ev/controllers/locations_controller.rb

@@ -57,7 +57,7 @@ module ShellEv
     # @param [Array[String]] exclude_country Optional parameter: Filter by
     # Locations that are not in one of the given countries (specified using ISO
     # 3166-1 alpha-3 codes)
-    # @return [Response] response from the API call
+    # @return [Response] response from the API call.
     def get_ev_locations(request_id,
                          evse_status: nil,
                          connector_types: nil,
@@ -74,7 +74,7 @@ module ShellEv
                          exclude_country: nil)
       new_api_call_builder
         .request(new_request_builder(HttpMethodEnum::GET,
-                                     '/locations/v1/ev',
+                                     '/locations',
                                      Server::DEFAULT)
                    .header_param(new_parameter(request_id, key: 'RequestId'))
                    .query_param(new_parameter(evse_status, key: 'evseStatus'))
@@ -137,14 +137,14 @@ module ShellEv
     # wish to see locations and tariffs for
     # @param [String] since Optional parameter: to get the locations modified
     # after a date
-    # @return [Response] response from the API call
+    # @return [Response] response from the API call.
     def ev_locations_by_id(request_id,
                            id,
                            provider_id: nil,
                            since: nil)
       new_api_call_builder
         .request(new_request_builder(HttpMethodEnum::GET,
-                                     '/locations/v1/ev/{id}',
+                                     '/locations/{id}',
                                      Server::DEFAULT)
                    .header_param(new_parameter(request_id, key: 'RequestId'))
                    .template_param(new_parameter(id, key: 'id')
@@ -216,14 +216,14 @@ module ShellEv
     # given by the Operator, unique for that Operator
     # @param [String] operator_name Optional parameter: Filter by Locations that
     # have the given operator
-    # @param [NearbyLocationsEvseStatusEnum] evse_status Optional parameter:
+    # @param [GetEVLocationsEvseStatusEnum] evse_status Optional parameter:
     # Filter by Locations that have the given status
     # @param [NearbyLocationsConnectorTypesEnum] connector_types Optional
     # parameter: Filter by Locations that have Connectors with these Connector
     # Types
     # @param [Float] connector_min_power Optional parameter: Filter by Locations
     # that have a Connector with at least this power output (in kW)
-    # @param [NearbyLocationsAuthorizationMethodsEnum] authorization_methods
+    # @param [GetEVLocationsAuthorizationMethodsEnum] authorization_methods
     # Optional parameter: Filter by Locations that support the given
     # Authorization Methods
     # @param [TrueClass | FalseClass] with_operator_name Optional parameter:
@@ -238,7 +238,7 @@ module ShellEv
     # @param [Array[String]] exclude_country Optional parameter: Filter by
     # Locations that are not in one of the given countries (specified using ISO
     # 3166-1 alpha-3 codes)
-    # @return [Response] response from the API call
+    # @return [Response] response from the API call.
     def nearby_locations(request_id,
                          latitude,
                          longitude,
@@ -257,7 +257,7 @@ module ShellEv
                          exclude_country: nil)
       new_api_call_builder
         .request(new_request_builder(HttpMethodEnum::GET,
-                                     '/locations/v1/ev/nearby',
+                                     '/locations/nearby',
                                      Server::DEFAULT)
                    .header_param(new_parameter(request_id, key: 'RequestId'))
                    .query_param(new_parameter(latitude, key: 'latitude'))
@@ -330,14 +330,14 @@ module ShellEv
     # get the Shell Recharge Locations
     # @param [String] zoom Required parameter: Zoom level to show ex: (1: World,
     # 5: Landmass/continent, 10: City, 15: Streets, 20: Buildings)
-    # @param [LocationsMarkersEvseStatusEnum] evse_status Optional parameter:
+    # @param [GetEVLocationsEvseStatusEnum] evse_status Optional parameter:
     # Filter by Locations that have the given status
-    # @param [LocationsMarkersConnectorTypesEnum] connector_types Optional
+    # @param [GetEVLocationsConnectorTypesEnum] connector_types Optional
     # parameter: Filter by Locations that have Connectors with the set of
     # Connector Types
     # @param [Float] connector_min_power Optional parameter: Filter by Locations
     # that have a Connector with at least this power output (in kW)
-    # @param [LocationsMarkersAuthorizationMethodsEnum] authorization_methods
+    # @param [GetEVLocationsAuthorizationMethodsEnum] authorization_methods
     # Optional parameter: Filter by Locations that support the given
     # Authorization Methods
     # @param [TrueClass | FalseClass] with_operator_name Optional parameter:
@@ -362,7 +362,7 @@ module ShellEv
     # @param [Array[String]] exclude_country Optional parameter: Filter by
     # Locations that are not in one of the given countries (specified using ISO
     # 3166-1 alpha-3 codes)
-    # @return [SingleLocationMarkerResponse] response from the API call
+    # @return [SingleLocationMarkerResponse] response from the API call.
     def locations_markers(request_id,
                           west,
                           south,
@@ -383,7 +383,7 @@ module ShellEv
                           exclude_country: nil)
       new_api_call_builder
         .request(new_request_builder(HttpMethodEnum::GET,
-                                     '/locations/v1/ev/markers',
+                                     '/locations/markers',
                                      Server::DEFAULT)
                    .header_param(new_parameter(request_id, key: 'RequestId'))
                    .query_param(new_parameter(west, key: 'west'))

data/lib/shell_ev/controllers/o_auth_authorization_controller.rb

@@ -13,14 +13,14 @@ module ShellEv
     # space-delimited list.
     # @param [Hash] _field_parameters Additional optional form parameters are
     # supported by this endpoint.
-    # @return [OAuthToken] response from the API call
+    # @return [OAuthToken] response from the API call.
     def request_token(authorization,
                       scope: nil,
                       _field_parameters: nil)
       new_api_call_builder
         .request(new_request_builder(HttpMethodEnum::POST,
-                                     '/v1/oauth/token',
-                                     Server::DEFAULT)
+                                     '/token',
+                                     Server::ACCESS_TOKEN_SERVER)
                    .form_param(new_parameter('client_credentials', key: 'grant_type'))
                    .header_param(new_parameter(authorization, key: 'Authorization'))
                    .form_param(new_parameter(scope, key: 'scope'))

data/lib/shell_ev/exceptions/api_exception.rb

@@ -6,5 +6,16 @@
 module ShellEv
   # Class for exceptions when there is a network error, status code error, etc.
   class APIException < CoreLibrary::ApiException
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} status_code: #{@response_code}, reason: #{@reason}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} status_code: #{@response_code.inspect}, reason: #{@reason.inspect}>"
+    end
   end
 end

data/lib/shell_ev/exceptions/bad_request_exception.rb

@@ -48,5 +48,18 @@ module ShellEv
 
       @errors = SKIP unless hash.key?('errors')
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} request_id: #{@request_id}, status: #{@status}, errors: #{@errors}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} request_id: #{@request_id.inspect}, status: #{@status.inspect}, errors:"\
+      " #{@errors.inspect}>"
+    end
   end
 end

data/lib/shell_ev/exceptions/internal_server_error_exception.rb

@@ -53,5 +53,19 @@ module ShellEv
       @errors = SKIP unless hash.key?('errors')
       @details = hash.key?('details') ? hash['details'] : SKIP
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} request_id: #{@request_id}, status: #{@status}, errors: #{@errors},"\
+      " details: #{@details}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} request_id: #{@request_id.inspect}, status: #{@status.inspect}, errors:"\
+      " #{@errors.inspect}, details: #{@details.inspect}>"
+    end
   end
 end

data/lib/shell_ev/exceptions/not_found_exception.rb

@@ -50,5 +50,18 @@ module ShellEv
 
       @errors = SKIP unless hash.key?('errors')
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} request_id: #{@request_id}, status: #{@status}, errors: #{@errors}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} request_id: #{@request_id.inspect}, status: #{@status.inspect}, errors:"\
+      " #{@errors.inspect}>"
+    end
   end
 end

data/lib/shell_ev/exceptions/o_auth_provider_exception.rb

@@ -44,5 +44,19 @@ module ShellEv
         hash.key?('error_description') ? hash['error_description'] : SKIP
       @error_uri = hash.key?('error_uri') ? hash['error_uri'] : SKIP
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} error: #{@error}, error_description: #{@error_description}, error_uri:"\
+      " #{@error_uri}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} error: #{@error.inspect}, error_description: #{@error_description.inspect},"\
+      " error_uri: #{@error_uri.inspect}>"
+    end
   end
 end

data/lib/shell_ev/exceptions/serviceunavailable_exception.rb

@@ -48,5 +48,18 @@ module ShellEv
 
       @errors = SKIP unless hash.key?('errors')
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} request_id: #{@request_id}, status: #{@status}, errors: #{@errors}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} request_id: #{@request_id.inspect}, status: #{@status.inspect}, errors:"\
+      " #{@errors.inspect}>"
+    end
   end
 end

data/lib/shell_ev/exceptions/too_many_requests_exception.rb

@@ -48,5 +48,18 @@ module ShellEv
 
       @errors = SKIP unless hash.key?('errors')
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} request_id: #{@request_id}, status: #{@status}, errors: #{@errors}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} request_id: #{@request_id.inspect}, status: #{@status.inspect}, errors:"\
+      " #{@errors.inspect}>"
+    end
   end
 end

data/lib/shell_ev/exceptions/unauthorized_exception.rb

@@ -47,5 +47,18 @@ module ShellEv
 
       @errors = SKIP unless hash.key?('errors')
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} request_id: #{@request_id}, status: #{@status}, errors: #{@errors}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} request_id: #{@request_id.inspect}, status: #{@status.inspect}, errors:"\
+      " #{@errors.inspect}>"
+    end
   end
 end

data/lib/shell_ev/models/accessibility.rb

@@ -55,5 +55,17 @@ module ShellEv
       Accessibility.new(status,
                         remark)
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} status: #{@status}, remark: #{@remark}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} status: #{@status.inspect}, remark: #{@remark.inspect}>"
+    end
   end
 end

data/lib/shell_ev/models/active_response200_json.rb

@@ -14,11 +14,13 @@ module ShellEv
     # @return [UUID | String]
     attr_accessor :request_id
 
-    # Indicates overall status of the request
-    # @return [ActiveResponse200JsonStatusEnum]
+    # Mandatory UUID (according to RFC 4122 standards) for requests and
+    # responses. This will be played back in the response from the request.
+    # @return [GetChargeSessionRetrieveResponse200JsonStatusEnum]
     attr_accessor :status
 
-    # Indicates overall status of the request
+    # Mandatory UUID (according to RFC 4122 standards) for requests and
+    # responses. This will be played back in the response from the request.
     # @return [Array[DataActive]]
     attr_accessor :data
 
@@ -72,5 +74,18 @@ module ShellEv
                                 status,
                                 data)
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} request_id: #{@request_id}, status: #{@status}, data: #{@data}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} request_id: #{@request_id.inspect}, status: #{@status.inspect}, data:"\
+      " #{@data.inspect}>"
+    end
   end
 end

data/lib/shell_ev/models/address.rb

@@ -75,5 +75,19 @@ module ShellEv
                   city,
                   country)
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} street_and_number: #{@street_and_number}, postal_code: #{@postal_code},"\
+      " city: #{@city}, country: #{@country}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} street_and_number: #{@street_and_number.inspect}, postal_code:"\
+      " #{@postal_code.inspect}, city: #{@city.inspect}, country: #{@country.inspect}>"
+    end
   end
 end

data/lib/shell_ev/models/bad_request_err_msg.rb

@@ -78,5 +78,19 @@ module ShellEv
                            description,
                            details)
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} code: #{@code}, message: #{@message}, description: #{@description},"\
+      " details: #{@details}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} code: #{@code.inspect}, message: #{@message.inspect}, description:"\
+      " #{@description.inspect}, details: #{@details.inspect}>"
+    end
   end
 end