ev-recharge-sdk 1.3.0 → 2.0.0

data/lib/shell_ev/models/{location_respone_object.rb → location_respone_object_v2.rb}

@@ -1,17 +1,17 @@
 # shell_ev
 #
-# This file was automatically generated by APIMATIC v2.0
-# ( https://apimatic.io ).
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
 
 module ShellEv
-  # LocationResponeObject Model.
-  class LocationResponeObject < BaseModel
+  # LocationResponeObjectV2 Model.
+  class LocationResponeObjectV2 < BaseModel
     SKIP = Object.new
     private_constant :SKIP
 
     # Unique Internal identifier used to refer to this Location by Shell
     # Recharge
-    # @return [Integer]
+    # @return [String]
     attr_accessor :uid
 
     # Identifier as given by the Shell Recharge Operator, unique for that
@@ -32,11 +32,11 @@ module ShellEv
     attr_accessor :address
 
     # Accessibility of the Location
-    # @return [Accessibility]
+    # @return [AccessibilityV2]
     attr_accessor :accessibility
 
     # Accessibility of the Location
-    # @return [Array[EvseVO]]
+    # @return [Array[EvseV2]]
     attr_accessor :evses
 
     # Optional Opening Hours of the Location. Please note that it is not
@@ -48,14 +48,18 @@ module ShellEv
     # @return [String]
     attr_accessor :updated
 
-    # optional Operator-wide arbitrary text (eg promotional, warning)
-    # @return [String]
-    attr_accessor :operator_comment
-
     # the type of the location. Could be "UNKNOWN".
     # @return [String]
     attr_accessor :location_type
 
+    # Unique Id of the operator
+    # @return [String]
+    attr_accessor :operator_id
+
+    # Whether the location is open 24/7
+    # @return [TrueClass | FalseClass]
+    attr_accessor :open_twenty_four_seven
+
     # A mapping from model property names to API property names.
     def self.names
       @_hash = {} if @_hash.nil?
@@ -68,8 +72,9 @@ module ShellEv
       @_hash['evses'] = 'evses'
       @_hash['opening_hours'] = 'openingHours'
       @_hash['updated'] = 'updated'
-      @_hash['operator_comment'] = 'operatorComment'
       @_hash['location_type'] = 'locationType'
+      @_hash['operator_id'] = 'operatorId'
+      @_hash['open_twenty_four_seven'] = 'openTwentyFourSeven'
       @_hash
     end
 
@@ -85,8 +90,9 @@ module ShellEv
         evses
         opening_hours
         updated
-        operator_comment
         location_type
+        operator_id
+        open_twenty_four_seven
       ]
     end
 
@@ -98,7 +104,8 @@ module ShellEv
     def initialize(uid = SKIP, external_id = SKIP, coordinates = SKIP,
                    operator_name = SKIP, address = SKIP, accessibility = SKIP,
                    evses = SKIP, opening_hours = SKIP, updated = SKIP,
-                   operator_comment = SKIP, location_type = SKIP)
+                   location_type = SKIP, operator_id = SKIP,
+                   open_twenty_four_seven = SKIP)
       @uid = uid unless uid == SKIP
       @external_id = external_id unless external_id == SKIP
       @coordinates = coordinates unless coordinates == SKIP
@@ -108,8 +115,9 @@ module ShellEv
       @evses = evses unless evses == SKIP
       @opening_hours = opening_hours unless opening_hours == SKIP
       @updated = updated unless updated == SKIP
-      @operator_comment = operator_comment unless operator_comment == SKIP
       @location_type = location_type unless location_type == SKIP
+      @operator_id = operator_id unless operator_id == SKIP
+      @open_twenty_four_seven = open_twenty_four_seven unless open_twenty_four_seven == SKIP
     end
 
     # Creates an instance of the object from a hash.
@@ -122,13 +130,13 @@ module ShellEv
       coordinates = Coordinates.from_hash(hash['coordinates']) if hash['coordinates']
       operator_name = hash.key?('operatorName') ? hash['operatorName'] : SKIP
       address = Address.from_hash(hash['address']) if hash['address']
-      accessibility = Accessibility.from_hash(hash['accessibility']) if hash['accessibility']
+      accessibility = AccessibilityV2.from_hash(hash['accessibility']) if hash['accessibility']
       # Parameter is an array, so we need to iterate through it
       evses = nil
       unless hash['evses'].nil?
         evses = []
         hash['evses'].each do |structure|
-          evses << (EvseVO.from_hash(structure) if structure)
+          evses << (EvseV2.from_hash(structure) if structure)
         end
       end
 
@@ -144,22 +152,45 @@ module ShellEv
 
       opening_hours = SKIP unless hash.key?('openingHours')
       updated = hash.key?('updated') ? hash['updated'] : SKIP
-      operator_comment =
-        hash.key?('operatorComment') ? hash['operatorComment'] : SKIP
       location_type = hash.key?('locationType') ? hash['locationType'] : SKIP
+      operator_id = hash.key?('operatorId') ? hash['operatorId'] : SKIP
+      open_twenty_four_seven =
+        hash.key?('openTwentyFourSeven') ? hash['openTwentyFourSeven'] : SKIP
 
       # Create object from extracted values.
-      LocationResponeObject.new(uid,
-                                external_id,
-                                coordinates,
-                                operator_name,
-                                address,
-                                accessibility,
-                                evses,
-                                opening_hours,
-                                updated,
-                                operator_comment,
-                                location_type)
+      LocationResponeObjectV2.new(uid,
+                                  external_id,
+                                  coordinates,
+                                  operator_name,
+                                  address,
+                                  accessibility,
+                                  evses,
+                                  opening_hours,
+                                  updated,
+                                  location_type,
+                                  operator_id,
+                                  open_twenty_four_seven)
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} uid: #{@uid}, external_id: #{@external_id}, coordinates: #{@coordinates},"\
+      " operator_name: #{@operator_name}, address: #{@address}, accessibility: #{@accessibility},"\
+      " evses: #{@evses}, opening_hours: #{@opening_hours}, updated: #{@updated}, location_type:"\
+      " #{@location_type}, operator_id: #{@operator_id}, open_twenty_four_seven:"\
+      " #{@open_twenty_four_seven}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} uid: #{@uid.inspect}, external_id: #{@external_id.inspect}, coordinates:"\
+      " #{@coordinates.inspect}, operator_name: #{@operator_name.inspect}, address:"\
+      " #{@address.inspect}, accessibility: #{@accessibility.inspect}, evses: #{@evses.inspect},"\
+      " opening_hours: #{@opening_hours.inspect}, updated: #{@updated.inspect}, location_type:"\
+      " #{@location_type.inspect}, operator_id: #{@operator_id.inspect}, open_twenty_four_seven:"\
+      " #{@open_twenty_four_seven.inspect}>"
     end
   end
 end

data/lib/shell_ev/models/locations_markers_authorization_methods_enum.rb

@@ -1,7 +1,7 @@
 # shell_ev
 #
-# This file was automatically generated by APIMATIC v2.0
-# ( https://apimatic.io ).
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
 
 module ShellEv
   # Filter by Locations that support the given Authorization Methods
@@ -22,5 +22,19 @@ module ShellEv
 
       LOCATIONS_MARKERS_AUTHORIZATION_METHODS_ENUM.include?(value)
     end
+
+    def self.from_value(value, default_value = NEWMOTIONAPP)
+      return default_value if value.nil?
+
+      str = value.to_s.strip
+
+      case str.downcase
+      when 'newmotionapp' then NEWMOTIONAPP
+      when 'rfidtoken' then RFIDTOKEN
+      when 'pnc' then PNC
+      else
+        default_value
+      end
+    end
   end
 end

data/lib/shell_ev/models/locations_markers_connector_types_enum.rb

@@ -1,7 +1,7 @@
 # shell_ev
 #
-# This file was automatically generated by APIMATIC v2.0
-# ( https://apimatic.io ).
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
 
 module ShellEv
   # Filter by Locations that have Connectors with the set of Connector Types
@@ -67,5 +67,34 @@ module ShellEv
 
       LOCATIONS_MARKERS_CONNECTOR_TYPES_ENUM.include?(value)
     end
+
+    def self.from_value(value, default_value = AVCON)
+      return default_value if value.nil?
+
+      str = value.to_s.strip
+
+      case str.downcase
+      when 'avcon' then AVCON
+      when 'domestic' then DOMESTIC
+      when 'industrial2pdc' then INDUSTRIAL2PDC
+      when 'industrialpneac' then INDUSTRIALPNEAC
+      when 'industrial3peac' then INDUSTRIAL3PEAC
+      when 'industrial3penac' then INDUSTRIAL3PENAC
+      when 'type1' then TYPE1
+      when 'type1combo' then TYPE1COMBO
+      when 'type2' then TYPE2
+      when 'type2combo' then TYPE2COMBO
+      when 'type3' then TYPE3
+      when 'lpi' then LPI
+      when 'nema520' then NEMA520
+      when 'saej1772' then SAEJ1772
+      when 'spi' then SPI
+      when 'tepcochademo' then TEPCOCHADEMO
+      when 'tesla' then TESLA
+      when 'unspecified' then UNSPECIFIED
+      else
+        default_value
+      end
+    end
   end
 end

data/lib/shell_ev/models/locations_markers_evse_status_enum.rb

@@ -1,7 +1,7 @@
 # shell_ev
 #
-# This file was automatically generated by APIMATIC v2.0
-# ( https://apimatic.io ).
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
 
 module ShellEv
   # Filter by Locations that have the given status
@@ -25,5 +25,20 @@ module ShellEv
 
       LOCATIONS_MARKERS_EVSE_STATUS_ENUM.include?(value)
     end
+
+    def self.from_value(value, default_value = AVAILABLE)
+      return default_value if value.nil?
+
+      str = value.to_s.strip
+
+      case str.downcase
+      when 'available' then AVAILABLE
+      when 'occupied' then OCCUPIED
+      when 'unavailable' then UNAVAILABLE
+      when 'unknown' then UNKNOWN
+      else
+        default_value
+      end
+    end
   end
 end

data/lib/shell_ev/models/multi_location_marker.rb

@@ -1,7 +1,7 @@
 # shell_ev
 #
-# This file was automatically generated by APIMATIC v2.0
-# ( https://apimatic.io ).
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
 
 module ShellEv
   # A Marker is a place on the map that represent multiple Locations at the same
@@ -19,8 +19,8 @@ module ShellEv
     # @return [String]
     attr_accessor :unique_key
 
-    # Coordinates of the Shell Recharge Site Location
-    # @return [Coordinates]
+    # Uniquely identifies the marker object
+    # @return [Coordinates1]
     attr_accessor :coordinates
 
     # Number of Locations that this Marker represents in the given set of bounds
@@ -89,7 +89,7 @@ module ShellEv
       # Extract variables from the hash.
       marker_type = hash.key?('markerType') ? hash['markerType'] : nil
       unique_key = hash.key?('uniqueKey') ? hash['uniqueKey'] : SKIP
-      coordinates = Coordinates.from_hash(hash['coordinates']) if hash['coordinates']
+      coordinates = Coordinates1.from_hash(hash['coordinates']) if hash['coordinates']
       location_count = hash.key?('locationCount') ? hash['locationCount'] : SKIP
       evse_count = hash.key?('evseCount') ? hash['evseCount'] : SKIP
       max_power = hash.key?('maxPower') ? hash['maxPower'] : SKIP
@@ -118,5 +118,22 @@ module ShellEv
       APIHelper.valid_type?(value['markerType'],
                             ->(val) { val.instance_of? String })
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} marker_type: #{@marker_type}, unique_key: #{@unique_key}, coordinates:"\
+      " #{@coordinates}, location_count: #{@location_count}, evse_count: #{@evse_count},"\
+      " max_power: #{@max_power}, geo_hash: #{@geo_hash}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} marker_type: #{@marker_type.inspect}, unique_key: #{@unique_key.inspect},"\
+      " coordinates: #{@coordinates.inspect}, location_count: #{@location_count.inspect},"\
+      " evse_count: #{@evse_count.inspect}, max_power: #{@max_power.inspect}, geo_hash:"\
+      " #{@geo_hash.inspect}>"
+    end
   end
 end

data/lib/shell_ev/models/multi_location_marker_v2.rb

@@ -0,0 +1,126 @@
+# shell_ev
+#
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
+
+module ShellEv
+  # A Marker is a place on the map that represent multiple Locations at the same
+  # spot
+  class MultiLocationMarkerV2 < BaseModel
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # Coordinates of the Shell Recharge Site Location
+    # @return [Coordinates]
+    attr_accessor :coordinates
+
+    # Number of Locations that this Marker represents in the given set of bounds
+    # @return [Float]
+    attr_accessor :location_count
+
+    # Total number of Evses in Locations that this Marker represents
+    # @return [Float]
+    attr_accessor :evse_count
+
+    # Maximum power in kW across all locations grouped in this marker
+    # (disregarding availability)
+    # @return [Float]
+    attr_accessor :max_power
+
+    # Operator of this Shell Recharge Location
+    # @return [String]
+    attr_accessor :operator_name
+
+    # Type of the Marker, in this case it will always be MultiLocation
+    # @return [String]
+    attr_reader :marker_type
+
+    # A mapping from model property names to API property names.
+    def self.names
+      @_hash = {} if @_hash.nil?
+      @_hash['coordinates'] = 'coordinates'
+      @_hash['location_count'] = 'locationCount'
+      @_hash['evse_count'] = 'evseCount'
+      @_hash['max_power'] = 'maxPower'
+      @_hash['operator_name'] = 'operatorName'
+      @_hash['marker_type'] = 'markerType'
+      @_hash
+    end
+
+    # An array for optional fields
+    def self.optionals
+      %w[
+        coordinates
+        location_count
+        evse_count
+        max_power
+        operator_name
+      ]
+    end
+
+    # An array for nullable fields
+    def self.nullables
+      []
+    end
+
+    def initialize(coordinates = SKIP, location_count = SKIP, evse_count = SKIP,
+                   max_power = SKIP, operator_name = SKIP)
+      @coordinates = coordinates unless coordinates == SKIP
+      @location_count = location_count unless location_count == SKIP
+      @evse_count = evse_count unless evse_count == SKIP
+      @max_power = max_power unless max_power == SKIP
+      @operator_name = operator_name unless operator_name == SKIP
+      @marker_type = 'MultiLocation'
+    end
+
+    # Creates an instance of the object from a hash.
+    def self.from_hash(hash)
+      return nil unless hash
+
+      # Extract variables from the hash.
+      coordinates = Coordinates.from_hash(hash['coordinates']) if hash['coordinates']
+      location_count = hash.key?('locationCount') ? hash['locationCount'] : SKIP
+      evse_count = hash.key?('evseCount') ? hash['evseCount'] : SKIP
+      max_power = hash.key?('maxPower') ? hash['maxPower'] : SKIP
+      operator_name = hash.key?('operatorName') ? hash['operatorName'] : SKIP
+
+      # Create object from extracted values.
+      MultiLocationMarkerV2.new(coordinates,
+                                location_count,
+                                evse_count,
+                                max_power,
+                                operator_name)
+    end
+
+    # Validates an instance of the object from a given value.
+    # @param [MultiLocationMarkerV2 | Hash] The value against the validation is performed.
+    def self.validate(value)
+      if value.instance_of? self
+        return APIHelper.valid_type?(value.marker_type,
+                                     ->(val) { val.instance_of? String })
+      end
+
+      return false unless value.instance_of? Hash
+
+      APIHelper.valid_type?(value['markerType'],
+                            ->(val) { val.instance_of? String })
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} coordinates: #{@coordinates}, location_count: #{@location_count},"\
+      " evse_count: #{@evse_count}, max_power: #{@max_power}, operator_name: #{@operator_name},"\
+      " marker_type: #{@marker_type}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} coordinates: #{@coordinates.inspect}, location_count:"\
+      " #{@location_count.inspect}, evse_count: #{@evse_count.inspect}, max_power:"\
+      " #{@max_power.inspect}, operator_name: #{@operator_name.inspect}, marker_type:"\
+      " #{@marker_type.inspect}>"
+    end
+  end
+end

data/lib/shell_ev/models/nearby_locations_authorization_methods_enum.rb

@@ -1,7 +1,7 @@
 # shell_ev
 #
-# This file was automatically generated by APIMATIC v2.0
-# ( https://apimatic.io ).
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
 
 module ShellEv
   # Filter by Locations that support the given Authorization Methods
@@ -22,5 +22,19 @@ module ShellEv
 
       NEARBY_LOCATIONS_AUTHORIZATION_METHODS_ENUM.include?(value)
     end
+
+    def self.from_value(value, default_value = NEWMOTIONAPP)
+      return default_value if value.nil?
+
+      str = value.to_s.strip
+
+      case str.downcase
+      when 'newmotionapp' then NEWMOTIONAPP
+      when 'rfidtoken' then RFIDTOKEN
+      when 'pnc' then PNC
+      else
+        default_value
+      end
+    end
   end
 end

data/lib/shell_ev/models/nearby_locations_connector_types_enum.rb

@@ -1,7 +1,7 @@
 # shell_ev
 #
-# This file was automatically generated by APIMATIC v2.0
-# ( https://apimatic.io ).
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
 
 module ShellEv
   # Filter by Locations that have Connectors with these Connector Types
@@ -67,5 +67,34 @@ module ShellEv
 
       NEARBY_LOCATIONS_CONNECTOR_TYPES_ENUM.include?(value)
     end
+
+    def self.from_value(value, default_value = AVCON)
+      return default_value if value.nil?
+
+      str = value.to_s.strip
+
+      case str.downcase
+      when 'avcon' then AVCON
+      when 'domestic' then DOMESTIC
+      when 'industrial2pdc' then INDUSTRIAL2PDC
+      when 'industrialpneac' then INDUSTRIALPNEAC
+      when 'industrial3peac' then INDUSTRIAL3PEAC
+      when 'industrial3penac' then INDUSTRIAL3PENAC
+      when 'type1' then TYPE1
+      when 'type1combo' then TYPE1COMBO
+      when 'type2' then TYPE2
+      when 'type2combo' then TYPE2COMBO
+      when 'type3' then TYPE3
+      when 'lpi' then LPI
+      when 'nema520' then NEMA520
+      when 'saej1772' then SAEJ1772
+      when 'spi' then SPI
+      when 'tepcochademo' then TEPCOCHADEMO
+      when 'tesla' then TESLA
+      when 'unspecified' then UNSPECIFIED
+      else
+        default_value
+      end
+    end
   end
 end

data/lib/shell_ev/models/nearby_locations_evse_status_enum.rb

@@ -1,7 +1,7 @@
 # shell_ev
 #
-# This file was automatically generated by APIMATIC v2.0
-# ( https://apimatic.io ).
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
 
 module ShellEv
   # Filter by Locations that have the given status
@@ -25,5 +25,20 @@ module ShellEv
 
       NEARBY_LOCATIONS_EVSE_STATUS_ENUM.include?(value)
     end
+
+    def self.from_value(value, default_value = AVAILABLE)
+      return default_value if value.nil?
+
+      str = value.to_s.strip
+
+      case str.downcase
+      when 'available' then AVAILABLE
+      when 'occupied' then OCCUPIED
+      when 'unavailable' then UNAVAILABLE
+      when 'unknown' then UNKNOWN
+      else
+        default_value
+      end
+    end
   end
 end

data/lib/shell_ev/models/not_found_err_msg.rb

@@ -1,7 +1,7 @@
 # shell_ev
 #
-# This file was automatically generated by APIMATIC v2.0
-# ( https://apimatic.io ).
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
 
 module ShellEv
   # NotFoundErrMsg Model.
@@ -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

data/lib/shell_ev/models/o_auth_provider_error_enum.rb

@@ -1,7 +1,7 @@
 # shell_ev
 #
-# This file was automatically generated by APIMATIC v2.0
-# ( https://apimatic.io ).
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
 
 module ShellEv
   # OAuth 2 Authorization error codes
@@ -41,5 +41,22 @@ module ShellEv
 
       O_AUTH_PROVIDER_ERROR_ENUM.include?(value)
     end
+
+    def self.from_value(value, default_value = INVALID_REQUEST)
+      return default_value if value.nil?
+
+      str = value.to_s.strip
+
+      case str.downcase
+      when 'invalid_request' then INVALID_REQUEST
+      when 'invalid_client' then INVALID_CLIENT
+      when 'invalid_grant' then INVALID_GRANT
+      when 'unauthorized_client' then UNAUTHORIZED_CLIENT
+      when 'unsupported_grant_type' then UNSUPPORTED_GRANT_TYPE
+      when 'invalid_scope' then INVALID_SCOPE
+      else
+        default_value
+      end
+    end
   end
 end

data/lib/shell_ev/models/o_auth_token.rb

@@ -1,7 +1,7 @@
 # shell_ev
 #
-# This file was automatically generated by APIMATIC v2.0
-# ( https://apimatic.io ).
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
 
 module ShellEv
   # OAuth 2 Authorization endpoint response

data/lib/shell_ev/models/opening_hours_object.rb

@@ -1,7 +1,7 @@
 # shell_ev
 #
-# This file was automatically generated by APIMATIC v2.0
-# ( https://apimatic.io ).
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
 
 module ShellEv
   # OpeningHoursObject Model.
@@ -9,7 +9,7 @@ module ShellEv
     SKIP = Object.new
     private_constant :SKIP
 
-    # TODO: Write general description for this method
+    # 3 letter day of the week
     # @return [OpeningHoursObjectWeekDayEnum]
     attr_accessor :week_day
 
@@ -64,5 +64,19 @@ module ShellEv
                              start_time,
                              end_time)
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} week_day: #{@week_day}, start_time: #{@start_time}, end_time:"\
+      " #{@end_time}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} week_day: #{@week_day.inspect}, start_time: #{@start_time.inspect},"\
+      " end_time: #{@end_time.inspect}>"
+    end
   end
 end