edmunds 0.0.5 → 0.0.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 1344f0bd011e7414e7e8d61633f8d6e4138244b6
-  data.tar.gz: 99f01d3fa5e0ec85c904c1a1ed76e600e337224b
+  metadata.gz: 210055290ec0dcd043bfa54a7d763137ff6d20fb
+  data.tar.gz: 555399acb19d97445abeef73a6c27e105dd47bcf
 SHA512:
-  metadata.gz: 5b77c3fa390cdb4792ee925d23102cf95189ebd88b8f416699ab1a7a46d8a7dbc32f624d185dbde28cfc79f8bfaefa02db28324c91c210478a7ddf953cb98542
-  data.tar.gz: 59ab4ce5eeea4c4c2f4d85f62167e4c2ae93531ab14ccb80bd9ebb4e8d8cd73d5a21320d312848f26200abcae8578fe66e640fcf04f0ca332edfc252c3fc9ef0
+  metadata.gz: 2e310fca939433ed0a4f60c161fba186445f8ac89700912dfe564f66cc8ec0e395174f179d7b1314c08a83d83818d004a519b0e9cfb480555f9289f68ab1c4be
+  data.tar.gz: f089f5e839ed148eaa28491244ab4f70a1331283252e5c67b9e718f10f2854a0b5ab654a4b68cbf49884361033e5ab705339264dcd1cbb0b00b25435f123cfc7

data/lib/edmunds.rb

@@ -1,5 +1,6 @@
 require_relative 'edmunds/version'
 require_relative 'edmunds/api'
+require_relative 'edmunds/api/request'
 require_relative 'edmunds/vehicle'
 require_relative 'edmunds/vehicle/specification/make'
 require_relative 'edmunds/vehicle/specification/model'
@@ -8,6 +9,7 @@ require_relative 'edmunds/vehicle/specification/style'
 require_relative 'edmunds/vehicle/specification/color'
 require_relative 'edmunds/vehicle/specification/option'
 require_relative 'edmunds/vehicle/specification/vin_decoding'
+require_relative 'edmunds/vehicle/specification/equipment'
 
 module Edmunds
 end

data/lib/edmunds/api.rb

@@ -4,10 +4,10 @@ module Edmunds
     URL_V1 = "#{URL}/v1"
 
     # Wrapper around Faraday.get that passses the API key
-    def self.get(url, api_params = {})
-      api_key_hash = { api_key: ENV['EDMUNDS_API_KEY'] }
-      api_params = api_params.merge(api_key_hash)
-      response = Faraday.get(url, api_params)
+    def self.get(url)
+      request = Request.new(url)
+      yield request
+      response = request.get
 
       if not response.success?
         raise Exception.new(response)

data/lib/edmunds/api/request.rb

@@ -0,0 +1,76 @@
+require 'active_support/core_ext/hash'
+
+module Edmunds
+  module Api
+    class Request
+      attr_writer :raw_parameters, :allowed_parameters, :default_parameters, :required_parameters
+      attr_reader :path
+
+      def initialize(path)
+        @path = path
+      end
+
+      def parameters
+        sanitized_parameters
+      end
+
+      def get
+        Faraday.get(@path, parameters)
+      end
+
+      private
+
+      def sanitized_parameters
+        @allowed_parameters = @allowed_parameters.with_indifferent_access
+        params = @raw_parameters.with_indifferent_access
+
+        # merge in default parameters
+        params.reverse_merge! @default_parameters
+
+        # throw away unknown parameters
+        params.slice! *@allowed_parameters.keys
+
+        # confirm required parameters are present
+        check_required(params)
+
+        # confirm parameter values are allowed
+        check_values(params)
+
+        # merge or override api_key
+        params.merge! api_key
+      end
+
+      def check_required(params)
+        @required_parameters.each do |param|
+          raise "missing required parameter #{param}" if params[param].blank?
+        end
+        params
+      end
+
+      def check_values(params)
+        params.each do |param, value|
+          raise "bad parameter value #{value} for param #{param}" unless valid_param?(param, value)
+        end
+        params
+      end
+
+      def valid_param?(param, value)
+        constraint = @allowed_parameters[param]
+
+        if constraint == :anything
+          true
+        elsif constraint.respond_to?(:cover?)
+          constraint.cover?(value)
+        elsif constraint.respond_to?(:match)
+          !! constraint.match(value)
+        else
+          constraint.include?(value)
+        end
+      end
+
+      def api_key
+        { api_key: ENV['EDMUNDS_API_KEY'] }
+      end
+    end
+  end
+end

data/lib/edmunds/vehicle.rb

@@ -2,7 +2,30 @@ require 'edmunds'
 
 module Edmunds
   module Vehicle
-    API_URL_V1 = Edmunds::Api::URL_V1 + '/vehicle'
+    # Static Vehicle API data
     API_URL_V2 = Edmunds::Api::URL + '/vehicle/v2'
+    VEHICLE_TYPES      = %w[ Car Truck SUV Van Minivan ]
+    VEHICLE_CATEGORIES = %w[ 4dr\ Hatchback 2dr\ Hatchback 2dr\ SUV 4dr\ SUV
+                            Cargo\ Minivan Cargo\ Van Convertible Convertible\ SUV
+                            Coupe Crew\ Cab\ Pickup Extended\ Cab\ Pickup Passenger\ Minivan
+                            Passenger\ Van Regular\ Cab\ Pickup Sedan Wagon ]
+    VEHICLE_SIZES      = %w[ Compact Midsize Large ]
+    FUEL_TYPES         = %w[ Electric Natural-gas-cng gas hybrid Flex-fuel-ffv diesel]
+    DRIVEN_WHEELS      = %w[ all-wheel-drive four-wheel-drive front-wheel-drive rear-wheel-drive ]
+
+                          #http://rubular.com/r/QODEdKNxjB
+    SUBMODEL_REGEX     = /^[A-Za-z0-9]+(?:-[A-Za-z0-9]+)*$/
+    EQUIPMENT_AVAILABILITY = %w[ standard optional used]
+    EQUIPMENT_TYPE = %w[ AUDIO_SYSTEM COLOR ENGINE MANUFACTURER MIRRORS OPTION OTHER TELEMATICS TIRES]
+    EQUIPMENT_NAME = %w[ 1ST_ROW_SEATS 2ND_ROW_SEATS 3RD_ROW_SEATS 4TH_ROW_SEATS 5TH_ROW_SEATS AIR_CONDITIONING
+                        AIRBAGS AUDIO_SYSTEM BRAKE_SYSTEM CARGO_DIMENSIONS COLLISION_SAFETY_SYSTEM COLOR 
+                        CONVERTIBLE_ROOF DIFFERENTIAL DOORS DRIVE_TYPE DRIVER_SEAT ENGINE EXTERIOR_DIMENSIONS 
+                        EXTERIOR_LIGHTS FRONT_PASSENGER_SEAT INSTRUMENTATION INTERIOR_DIMENSIONS MANUFACTURER 
+                        MIRRORS MOBILE_CONNECTIVITY NAVIGATION_SYSTEM PARKING_AID POWER_OUTLETS SEATBELTS
+                        SEATING_CONFIGURATION SECURITY SPARE_TIRE/WHEEL SPECIFICATIONS STEERING STEERING_WHEEL 
+                        STORAGE SUSPENSION TECHNOLOGY_FEATURE TELEMATICS TIRES TRAILER_TOWING_EQUIPMENT 
+                        TRANSMISSION TRUCK_BED TRUNK VIDEO_SYSTEM WARRANTY WHEELS WINDOWS]
+
+    ENGINE_AVAILABILITY = %w[ standard optional ]
   end
 end

data/lib/edmunds/vehicle/specification/color.rb

@@ -18,7 +18,19 @@ module Edmunds
           end
 
           def self.find(style_id, api_params = {})
-            response = Edmunds::Api.get("#{STYLE_API_URL}/#{style_id}/colors", api_params)
+            response = Edmunds::Api.get("#{STYLE_API_URL}/#{style_id}/colors") do |request|
+              request.raw_parameters = api_params
+
+              request.allowed_parameters = {
+                  category: %w[Interior Exterior],
+                  fmt: %w[json]
+              }
+
+              request.default_parameters = { fmt: 'json' }
+
+              request.required_parameters = %w[fmt]
+            end
+
             attributes = JSON.parse(response.body)
             new(attributes)
           end
@@ -47,7 +59,18 @@ module Edmunds
           end
 
           def self.find(color_id, api_params = {})
-            response = Edmunds::Api.get("#{COLORS_API_URL}/#{color_id}", api_params)
+            response = Edmunds::Api.get("#{COLORS_API_URL}/#{color_id}") do |request|
+              request.raw_parameters = api_params
+
+              request.allowed_parameters = {
+                  fmt: %w[json]
+              }
+
+              request.default_parameters = { fmt: 'json' }
+
+              request.required_parameters = %w[fmt]
+            end
+
             attributes = JSON.parse(response.body)
             new(attributes)
           end

data/lib/edmunds/vehicle/specification/engine.rb

@@ -0,0 +1,69 @@
+require 'faraday'
+require 'json'
+
+ENGINE_API_URL = Edmunds::Vehicle::API_URL_V2 + '/engines'
+STYLE_API_URL = Edmunds::Vehicle::API_URL_V2 + '/styles'
+
+module Edmunds
+  module Vehicle
+    module Specification
+      module Engine
+        
+        class EngineByStyle
+          attr_reader :id
+
+          def initialize(attributes)
+            @id = attributes['id']
+            #TODO
+          end
+
+          def self.find(style_id, api_params = {})
+            response = Edmunds::Api.get("#{STYLE_API_URL}/#{style_id}/engines") do |request|
+              request.raw_parameters = api_params
+
+              request.allowed_parameters = {
+                availability: Edmunds::Vehicle::ENGINE_AVAILABILITY, 
+                name: /^s+/,
+                fmt:  %w[json]
+              }
+
+              request.default_parameters = { fmt: 'json', availability: 'standard' }
+
+              request.required_parameters = %w[fmt]
+            end
+
+            attributes = JSON.parse(response.body)
+            new(attributes)
+          end
+        end
+
+        class Engine
+          attr_reader :id
+
+          def initialize(attributes)
+            @id = attributes['id']
+            #TODO
+          end
+
+          def self.find(engine_id, api_params = {})
+            response = Edmunds::Api.get("#{ENGINE_API_URL}/#{engine_id}") do |request|
+              request.raw_parameters = api_params
+
+              request.allowed_parameters = {
+                fmt:  %w[json]
+              }
+
+              request.default_parameters = { fmt: 'json' }
+
+              request.required_parameters = %w[fmt]
+            end
+
+            attributes = JSON.parse(response.body)
+            new(attributes)
+          end
+        end
+
+      end
+    end
+  end
+end

data/lib/edmunds/vehicle/specification/equipment.rb

@@ -0,0 +1,70 @@
+require 'faraday'
+require 'json'
+
+EQUIPMENT_API_URL = Edmunds::Vehicle::API_URL_V2 + '/equipment'
+STYLES_API_URL = Edmunds::Vehicle::API_URL_V2 + '/styles'
+
+module Edmunds
+  module Vehicle
+    module Specification
+      module Equipment
+        
+        class EquipmentByStyle
+          attr_reader :id
+
+          def initialize(attributes)
+            @id = attributes['id']
+            #TODO
+          end
+
+          def self.find(style_id, api_params = {})
+            response = Edmunds::Api.get("#{STYLES_API_URL}/#{style_id}/equipment") do |request|
+              request.raw_parameters = api_params
+
+              request.allowed_parameters = {
+                availability: Edmunds::Vehicle::EQUIPMENT_AVAILABILITY, 
+                equipmentType: Edmunds::Vehicle::EQUIPMENT_TYPE,
+                name: Edmunds::Vehicle::EQUIPMENT_NAME,
+                fmt:  %w[json]
+              }
+
+              request.default_parameters = { fmt: 'json', availability: 'standard', equipmentType: 'OTHER' }
+
+              request.required_parameters = %w[fmt]
+            end
+
+            attributes = JSON.parse(response.body)
+            new(attributes)
+          end
+        end
+
+        class Equipment
+          attr_reader :id
+
+          def initialize(attributes)
+            @id = attributes['id']
+            #TODO
+          end
+
+          def self.find(equipment_id, api_params = {})
+            response = Edmunds::Api.get("#{EQUIPMENT_API_URL}/#{equipment_id}") do |request|
+              request.raw_parameters = api_params
+
+              request.allowed_parameters = {
+                fmt:  %w[json]
+              }
+
+              request.default_parameters = { fmt: 'json' }
+
+              request.required_parameters = %w[fmt]
+            end
+
+            attributes = JSON.parse(response.body)
+            new(attributes)
+          end
+        end
+
+      end
+    end
+  end
+end

data/lib/edmunds/vehicle/specification/make.rb

@@ -17,7 +17,21 @@ module Edmunds
           end
 
           def self.find(api_params = {})
-            response = Edmunds::Api.get("#{MAKES_API_URL}", api_params)
+            response = Edmunds::Api.get("#{MAKES_API_URL}") do |request|
+              request.raw_parameters = api_params
+
+              request.allowed_parameters = {
+                  state: %w[new used future],
+                  year:  ((1990.to_s)..(Date.current.year.to_s)),
+                  view:  %w[basic full],
+                  fmt: %w[json]
+              }
+
+              request.default_parameters = { view: 'basic', fmt: 'json' }
+
+              request.required_parameters = %w[fmt]
+            end
+
             attributes = JSON.parse(response.body)
             new(attributes)
           end
@@ -33,7 +47,21 @@ module Edmunds
           end
 
           def self.find(name, api_params = {})
-            response = Edmunds::Api.get("#{MAKE_API_URL}/#{name}", api_params)
+            response = Edmunds::Api.get("#{MAKE_API_URL}/#{name}") do |request|
+              request.raw_parameters = api_params
+
+              request.allowed_parameters = {
+                  state: %w[new used future],
+                  year: ((1990.to_s)..(Date.today.year.to_s)),
+                  view: %w[basic full],
+                  fmt: %w[json]
+              }
+
+              request.default_parameters = { view: 'basic', fmt: 'json' }
+
+              request.required_parameters = %w[fmt]
+            end
+
             attributes = JSON.parse(response.body)
             new(attributes)
           end
@@ -47,7 +75,23 @@ module Edmunds
           end
 
           def self.find(api_params = {})
-            response = Edmunds::Api.get("#{MAKES_COUNT_API_URL}", api_params)
+            response = Edmunds::Api.get("#{MAKES_COUNT_API_URL}") do |request|
+            
+              request.raw_parameters = api_params
+
+              request.allowed_parameters = {
+                  state: %w[new used future],
+                  year: ((1990.to_s)..(Date.today.year.to_s)),
+                  view: %w[basic full],
+                  fmt: %w[json]
+              }
+
+              request.default_parameters = { view: 'basic', fmt: 'json' }
+
+              request.required_parameters = %w[fmt]
+            end
+
+
             attributes = JSON.parse(response.body)
             new(attributes)
           end

data/lib/edmunds/vehicle/specification/model.rb

@@ -17,7 +17,23 @@ module Edmunds
           end
 
           def self.find(make_name, model_name, api_params = {})
-            response = Edmunds::Api.get("#{MODEL_API_URL}/#{make_name}/#{model_name}", api_params)
+            response = Edmunds::Api.get("#{MODEL_API_URL}/#{make_name}/#{model_name}") do |request|
+              request.raw_parameters = api_params
+
+              request.allowed_parameters = {
+                submodel: Edmunds::Vehicle::SUBMODEL_REGEX,
+                category: Edmunds::Vehicle::VEHICLE_CATEGORIES,
+                state: %w[new used future],
+                year: ((1990.to_s)..(Date.current.year.to_s)),
+                view: %w[basic full],
+                fmt:  %w[json]
+              }
+
+              request.default_parameters = { view: 'basic', fmt: 'json' }
+
+              request.required_parameters = %w[fmt]
+            end
+
             attributes = JSON.parse(response.body)
             new(attributes)
           end
@@ -32,7 +48,23 @@ module Edmunds
           end
 
           def self.find(make_name, api_params = {})
-            response = Edmunds::Api.get("#{MODEL_API_URL}/#{make_name}/models", api_params)
+            response = Edmunds::Api.get("#{MODEL_API_URL}/#{make_name}/models") do |request|
+              request.raw_parameters = api_params
+
+              request.allowed_parameters = {
+                submodel: Edmunds::Vehicle::SUBMODEL_REGEX,
+                category: Edmunds::Vehicle::VEHICLE_CATEGORIES,
+                state: %w[new used future],
+                year: ((1990.to_s)..(Date.current.year.to_s)),
+                view: %w[basic full],
+                fmt:  %w[json]
+              }
+
+              request.default_parameters = { view: 'basic', fmt: 'json' }
+
+              request.required_parameters = %w[fmt]
+            end
+
             attributes = JSON.parse(response.body)
             new(attributes)
           end
@@ -46,7 +78,23 @@ module Edmunds
           end
 
           def self.find(make_name, api_params = {})
-            response = Edmunds::Api.get("#{MODEL_API_URL}/#{make_name}/models/count", api_params)
+            response = Edmunds::Api.get("#{MODEL_API_URL}/#{make_name}/models/count") do |request|
+              request.raw_parameters = api_params
+
+              request.allowed_parameters = {
+                submodel: Edmunds::Vehicle::SUBMODEL_REGEX,
+                category: Edmunds::Vehicle::VEHICLE_CATEGORIES,
+                state: %w[new used future],
+                year: ((1990.to_s)..(Date.current.year.to_s)),
+                view: %w[basic full],
+                fmt:  %w[json]
+              }
+
+              request.default_parameters = { view: 'basic', fmt: 'json' }
+
+              request.required_parameters = %w[fmt]
+            end
+
             attributes = JSON.parse(response.body)
             new(attributes)
           end

data/lib/edmunds/vehicle/specification/model_year.rb

@@ -17,7 +17,23 @@ module Edmunds
           end
 
           def self.find(make_name, model_name, model_year, api_params = {})
-            response = Edmunds::Api.get("#{MODEL_API_URL}/#{make_name}/#{model_name}/#{model_year}", api_params)
+            response = Edmunds::Api.get("#{MODEL_API_URL}/#{make_name}/#{model_name}/#{model_year}") do |request|
+              request.raw_parameters = api_params
+
+              request.allowed_parameters = {
+                submodel: Edmunds::Vehicle::SUBMODEL_REGEX,
+                category: Edmunds::Vehicle::VEHICLE_CATEGORIES,
+                state: %w[new used future],
+                year: ((1990.to_s)..(Date.current.year.to_s)),
+                view: %w[basic full],
+                fmt:  %w[json]
+              }
+
+              request.default_parameters = { view: 'basic', fmt: 'json' }
+
+              request.required_parameters = %w[fmt]
+            end
+
             attributes = JSON.parse(response.body)
             new(attributes)
           end
@@ -32,7 +48,23 @@ module Edmunds
           end
 
           def self.find(make_name, model_name, api_params = {})
-            response = Edmunds::Api.get("#{MODEL_API_URL}/#{make_name}/#{model_name}/years", api_params)
+            response = Edmunds::Api.get("#{MODEL_API_URL}/#{make_name}/#{model_name}/years") do |request|
+              request.raw_parameters = api_params
+
+              request.allowed_parameters = {
+                submodel: Edmunds::Vehicle::SUBMODEL_REGEX,
+                category: Edmunds::Vehicle::VEHICLE_CATEGORIES,
+                state: %w[new used future],
+                year: ((1990.to_s)..(Date.current.year.to_s)),
+                view: %w[basic full],
+                fmt:  %w[json]
+              }
+
+              request.default_parameters = { view: 'basic', fmt: 'json' }
+
+              request.required_parameters = %w[fmt]
+            end
+
             attributes = JSON.parse(response.body)
             new(attributes)
           end
@@ -46,7 +78,23 @@ module Edmunds
           end
 
           def self.find(make_name, model_name, api_params = {})
-            response = Edmunds::Api.get("#{MODEL_API_URL}/#{make_name}/#{model_name}/years/count", api_params)
+            response = Edmunds::Api.get("#{MODEL_API_URL}/#{make_name}/#{model_name}/years/count") do |request|
+              request.raw_parameters = api_params
+
+              request.allowed_parameters = {
+                submodel: Edmunds::Vehicle::SUBMODEL_REGEX,
+                category: Edmunds::Vehicle::VEHICLE_CATEGORIES,
+                state: %w[new used future],
+                year: ((1990.to_s)..(Date.current.year.to_s)),
+                view: %w[basic full],
+                fmt:  %w[json]
+              }
+
+              request.default_parameters = { view: 'basic', fmt: 'json' }
+
+              request.required_parameters = %w[fmt]
+            end
+            
             attributes = JSON.parse(response.body)
             new(attributes)
           end

data/lib/edmunds/vehicle/specification/option.rb

@@ -19,7 +19,19 @@ module Edmunds
           end
 
           def self.find(style_id, api_params = {})
-            response = Edmunds::Api.get("#{STYLE_API_URL}/#{style_id}/options", api_params)
+            response = Edmunds::Api.get("#{STYLE_API_URL}/#{style_id}/options") do |request|
+              request.raw_parameters = api_params
+
+              request.allowed_parameters = {
+                  category: %w[Interior Exterior Roof Interior\ Trim Mechanical Package Additional\ Fees Other],
+                  fmt: %w[json]
+              }
+
+              request.default_parameters = { fmt: 'json' }
+
+              request.required_parameters = %w[fmt]
+            end
+
             attributes = JSON.parse(response.body)
             new(attributes)
           end
@@ -52,7 +64,18 @@ module Edmunds
           end
 
           def self.find(option_id, api_params = {})
-            response = Edmunds::Api.get("#{OPTIONS_API_URL}/#{option_id}", api_params)
+            response = Edmunds::Api.get("#{OPTIONS_API_URL}/#{option_id}") do |request|
+              request.raw_parameters = api_params
+
+              request.allowed_parameters = {
+                  fmt: %w[json]
+              }
+
+              request.default_parameters = { fmt: 'json' }
+
+              request.required_parameters = %w[fmt]
+            end
+
             attributes = JSON.parse(response.body)
             new(attributes)
           end

data/lib/edmunds/vehicle/specification/style.rb

@@ -23,7 +23,19 @@ module Edmunds
           end
 
           def self.find(id, api_params = {})
-            response = Edmunds::Api.get("#{STYLE_API_URL}/#{id}", api_params)
+            response = Edmunds::Api.get("#{STYLE_API_URL}/#{id}") do |request|
+              request.raw_parameters = api_params
+
+              request.allowed_parameters = {
+                view: %w[basic full],
+                fmt:  %w[json]
+              }
+
+              request.default_parameters = { view: 'basic', fmt: 'json' }
+
+              request.required_parameters = %w[fmt]
+            end
+
             attributes = JSON.parse(response.body)
             new(attributes)
           end
@@ -38,12 +50,29 @@ module Edmunds
           end
 
           def self.find(make_name, model_name, model_year, api_params = {})
-            response = Edmunds::Api.get("#{BASE_API_URL}/#{make_name}/#{model_name}/#{model_year}/styles", api_params)
+            response = Edmunds::Api.get("#{BASE_API_URL}/#{make_name}/#{model_name}/#{model_year}/styles") do |request|
+              request.raw_parameters = api_params
+
+              request.allowed_parameters = {
+                submodel: Edmunds::Vehicle::SUBMODEL_REGEX,
+                category: Edmunds::Vehicle::VEHICLE_CATEGORIES,
+                state: %w[new used future],
+                year: ((1990.to_s)..(Date.current.year.to_s)),
+                view: %w[basic full],
+                fmt:  %w[json]
+              }
+
+              request.default_parameters = { view: 'basic', fmt: 'json' }
+
+              request.required_parameters = %w[fmt]
+            end
+
             attributes = JSON.parse(response.body)
             new(attributes)
           end
         end
 
+        # TODO
         # UNAUTHORIZED
         # class StylesDetailsChrome
         #   attr_reader :styles, :count
@@ -68,7 +97,19 @@ module Edmunds
           end
 
           def self.find(make_name, model_name, model_year, api_params = {})
-            response = Edmunds::Api.get("#{BASE_API_URL}/#{make_name}/#{model_name}/#{model_year}/styles/count", api_params)
+            response = Edmunds::Api.get("#{BASE_API_URL}/#{make_name}/#{model_name}/#{model_year}/styles/count") do |request|
+              request.raw_parameters = api_params
+
+              request.allowed_parameters = {
+                state: %w[new used future],
+                fmt:  %w[json]
+              }
+
+              request.default_parameters = { fmt: 'json' }
+
+              request.required_parameters = %w[fmt]
+            end
+
             attributes = JSON.parse(response.body)
             new(attributes)
           end
@@ -82,7 +123,20 @@ module Edmunds
           end
 
           def self.find(make_name, model_name, api_params = {})
-            response = Edmunds::Api.get("#{BASE_API_URL}/#{make_name}/#{model_name}/styles/count", api_params)
+            response = Edmunds::Api.get("#{BASE_API_URL}/#{make_name}/#{model_name}/styles/count") do |request|
+
+              request.raw_parameters = api_params
+
+              request.allowed_parameters = {
+                state: %w[new used future],
+                fmt:  %w[json]
+              }
+
+              request.default_parameters = { fmt: 'json' }
+
+              request.required_parameters = %w[fmt]
+            end
+
             attributes = JSON.parse(response.body)
             new(attributes)
           end
@@ -96,7 +150,19 @@ module Edmunds
           end
 
           def self.find(make_name, api_params = {})
-            response = Edmunds::Api.get("#{BASE_API_URL}/#{make_name}/styles/count", api_params)
+            response = Edmunds::Api.get("#{BASE_API_URL}/#{make_name}/styles/count") do |request|
+              request.raw_parameters = api_params
+
+              request.allowed_parameters = {
+                state: %w[new used future],
+                fmt:  %w[json]
+              }
+
+              request.default_parameters = { fmt: 'json' }
+
+              request.required_parameters = %w[fmt]
+            end
+
             attributes = JSON.parse(response.body)
             new(attributes)
           end
@@ -110,7 +176,19 @@ module Edmunds
           end
 
           def self.find(api_params = {})
-            response = Edmunds::Api.get("#{STYLE_API_URL}/count", api_params)
+            response = Edmunds::Api.get("#{STYLE_API_URL}/count") do |request|
+              request.raw_parameters = api_params
+
+              request.allowed_parameters = {
+                state: %w[new used future],
+                fmt:  %w[json]
+              }
+
+              request.default_parameters = { fmt: 'json' }
+
+              request.required_parameters = %w[fmt]
+            end
+
             attributes = JSON.parse(response.body)
             new(attributes)
           end

data/lib/edmunds/vehicle/specification/vin_decoding.rb

@@ -1,33 +1,12 @@
 require 'faraday'
 require 'json'
 
-BASIC_API_URL = Edmunds::Vehicle::API_URL_V1 + '/vin'
 FULL_API_URL = Edmunds::Vehicle::API_URL_V2 + '/vins'
 
 module Edmunds
   module Vehicle
     module Specification
       module VinDecoding
-        class Basic
-          attr_reader :make, :model, :year
-
-          def initialize(attributes)
-            @make = attributes['make']['name']
-            @model = attributes['model']['name']
-            @year = attributes['year']
-          end
-
-          # Get vehicle make, model, year, type, fuel type, number of cylinders and list of styles by decoding the vehicle's VIN.
-          #
-          # @param [String] vin number of the vehicle to search for
-          # @return [Basic] object holding the results of the query
-          def self.find(vin)
-            response = Edmunds::Api.get("#{BASIC_API_URL}/#{vin}/configuration")
-            attributes = JSON.parse(response.body)
-            new(attributes)
-          end
-        end
-
         class Full
           attr_reader :make, :model, :years, :mpg_highway, :mpg_city
 
@@ -43,8 +22,20 @@ module Edmunds
           #
           # @param [String] vin number of the vehicle to search for
           # @return [Basic] object holding the results of the query
-          def self.find(vin)
-            response = Edmunds::Api.get("#{FULL_API_URL}/#{vin}")
+          def self.find(vin, api_params = {})
+            response = Edmunds::Api.get("#{FULL_API_URL}/#{vin}") do |request|
+              request.raw_parameters = api_params
+
+              request.allowed_parameters = {
+                # OEM CODE
+                fmt:  %w[json]
+              }
+
+              request.default_parameters = {fmt: 'json' }
+
+              request.required_parameters = %w[fmt]
+            end
+
             attributes = JSON.parse(response.body)
             new(attributes)
           end

data/lib/edmunds/version.rb

@@ -1,3 +1,3 @@
 module Edmunds
-  VERSION = '0.0.5'
+  VERSION = '0.0.6'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: edmunds
 version: !ruby/object:Gem::Version
-  version: 0.0.5
+  version: 0.0.6
 platform: ruby
 authors:
 - Jason Parraga
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-03-08 00:00:00.000000000 Z
+date: 2015-08-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -122,6 +122,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: Gem to wrap Edmunds.com API
 email:
 - Sovietaced@gmail.com
@@ -132,13 +146,17 @@ files:
 - README.md
 - lib/edmunds.rb
 - lib/edmunds/api.rb
+- lib/edmunds/api/request.rb
 - lib/edmunds/vehicle.rb
 - lib/edmunds/vehicle/specification/color.rb
+- lib/edmunds/vehicle/specification/engine.rb
+- lib/edmunds/vehicle/specification/equipment.rb
 - lib/edmunds/vehicle/specification/make.rb
 - lib/edmunds/vehicle/specification/model.rb
 - lib/edmunds/vehicle/specification/model_year.rb
 - lib/edmunds/vehicle/specification/option.rb
 - lib/edmunds/vehicle/specification/style.rb
+- lib/edmunds/vehicle/specification/transmission.rb
 - lib/edmunds/vehicle/specification/vin_decoding.rb
 - lib/edmunds/version.rb
 homepage: ''