smartcar 0.1.1 → 1.0.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 77763e723a789174f3bab09883c2c4770019d73f6984acc2a20ab5580b71683d
-  data.tar.gz: 72ea1a37d4864c8f1e2251e15afcb8510ed07a910bdffe12abba2e6b17ff48fe
+  metadata.gz: 726e54a0eb8a7ebe98749b6765e8bf6302c4faccc42695d9d75fd3dd3cb5b544
+  data.tar.gz: d5ff12b61c36f1f151a3eb161ef8134fe55c6d0bf98cb71d0de8c4138dac4045
 SHA512:
-  metadata.gz: c8ca779368dc98843d5e623b1faa52fda1503077b932727da4ac84fd6ce2d9b35670e15c82427ee4074ea821fc025a46158ac42d63e9441eb5af25d8a12d26ad
-  data.tar.gz: 55c56eb58615e9ef19dfff70a8d25ec4cd61b3ac90152b63555ceb7218b15230a533302887d827b502d8b0b6f06dc3010412ae13d66e9d6757cd71aefcfaeaf7
+  metadata.gz: dd45d1487f7ee1247831d5af2eae9bba2dcf1de43ee4f748243b03bce7a09721de3ce3e4a3a79946bbcaa4bdcc19a92036978a052666a279b3f40447d1dffd4a
+  data.tar.gz: 4c44d4439be32d51be9b1bbc8bb0a27b1a8dfdfb00aff6ebcdfba945e05d4f0d62406dacc370f8560ca0d80474de7900bce001a9fafa822c76d139301c5dc59d

data/.travis.yml

@@ -1,7 +1,28 @@
----
 sudo: false
 language: ruby
 cache: bundler
+services:
+- xvfb
+addons:
+  firefox: latest
 rvm:
-  - 2.5.5
-before_install: gem install bundler -v 2.0.2
+- 2.5
+- 2.6
+- 2.7
+before_install:
+  - gem install bundler -v 2.1.2
+  - wget https://github.com/mozilla/geckodriver/releases/download/v0.26.0/geckodriver-v0.26.0-linux64.tar.gz
+  - mkdir geckodriver
+  - tar -xzf geckodriver-v0.26.0-linux64.tar.gz -C geckodriver
+  - export PATH=$PATH:$PWD/geckodriver
+# install:
+# - firefox -headless &
+deploy:
+  provider: rubygems
+  api_key: $RUBYGEMSAPI_KEY
+  gem: smartcar
+  on:
+    tags: true
+    branch: master
+    rvm: 2.5
+  skip_cleanup: 'true'

data/.yardopts

@@ -0,0 +1,2 @@
+--markup=markdown
+--no-private

data/CODE_OF_CONDUCT.md

@@ -55,7 +55,7 @@ further defined and clarified by project maintainers.
 ## Enforcement
 
 Instances of abusive, harassing, or otherwise unacceptable behavior may be
-reported by contacting the project team at Ashwin.Subramanian@ooma.com. All
+reported by contacting the project team at support@smartcar.com. All
 complaints will be reviewed and investigated and will result in a response that
 is deemed necessary and appropriate to the circumstances. The project team is
 obligated to maintain confidentiality with regard to the reporter of an incident.

data/Gemfile.lock

@@ -1,41 +1,47 @@
 PATH
   remote: .
   specs:
-    smartcar (0.1.1)
+    smartcar (1.0.5)
       oauth2 (~> 1.4)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    byebug (11.0.1)
+    byebug (11.1.3)
+    childprocess (3.0.0)
     diff-lcs (1.3)
-    faraday (0.17.0)
+    faraday (1.0.1)
       multipart-post (>= 1.2, < 3)
-    jwt (2.2.1)
-    multi_json (1.14.1)
+    jwt (2.2.2)
+    multi_json (1.15.0)
     multi_xml (0.6.0)
     multipart-post (2.1.1)
-    oauth2 (1.4.2)
+    oauth2 (1.4.4)
       faraday (>= 0.8, < 2.0)
       jwt (>= 1.0, < 3.0)
       multi_json (~> 1.3)
       multi_xml (~> 0.5)
       rack (>= 1.2, < 3)
-    rack (2.0.8)
-    rake (13.0.1)
-    rspec (3.8.0)
-      rspec-core (~> 3.8.0)
-      rspec-expectations (~> 3.8.0)
-      rspec-mocks (~> 3.8.0)
-    rspec-core (3.8.2)
-      rspec-support (~> 3.8.0)
-    rspec-expectations (3.8.4)
+    rack (2.2.3)
+    rake (12.3.3)
+    redcarpet (3.5.0)
+    rspec (3.9.0)
+      rspec-core (~> 3.9.0)
+      rspec-expectations (~> 3.9.0)
+      rspec-mocks (~> 3.9.0)
+    rspec-core (3.9.2)
+      rspec-support (~> 3.9.3)
+    rspec-expectations (3.9.2)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.8.0)
-    rspec-mocks (3.8.1)
+      rspec-support (~> 3.9.0)
+    rspec-mocks (3.9.1)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.8.0)
-    rspec-support (3.8.2)
+      rspec-support (~> 3.9.0)
+    rspec-support (3.9.3)
+    rubyzip (2.3.0)
+    selenium-webdriver (3.142.7)
+      childprocess (>= 0.5, < 4.0)
+      rubyzip (>= 1.2.2)
 
 PLATFORMS
   ruby
@@ -43,8 +49,10 @@ PLATFORMS
 DEPENDENCIES
   bundler (~> 2.0)
   byebug (~> 11.0)
-  rake (>= 12.3.3)
+  rake (~> 12.3, >= 12.3.3)
+  redcarpet (~> 3.5.0)
   rspec (~> 3.0)
+  selenium-webdriver (~> 3.142)
   smartcar!
 
 BUNDLED WITH

data/README.md

@@ -1,7 +1,57 @@
 
+# Smartcar Ruby SDK [![Gem Version][gem-url]][gem-image]
 
 Ruby gem library to quickly get started with the Smartcar API.
 
+## Overview
+
+The [Smartcar API](https://smartcar.com/docs) lets you read vehicle data
+(location, odometer) and send commands to vehicles (lock, unlock) using HTTP requests.
+
+To make requests to a vehicle from a web or mobile application, the end user
+must connect their vehicle using
+[Smartcar Connect](https://smartcar.com/docs/api#smartcar-connect).
+This flow follows the OAuth spec and will return a `code` which can be used to
+obtain an access token from Smartcar.
+
+The Smartcar Ruby Gem provides methods to:
+
+1. Generate the link to redirect to Connect.
+2. Make a request to Smartcar with the `code` obtained from Connect to obtain an
+   access and refresh token
+3. Make requests to the Smartcar API to read vehicle data and send commands to
+   vehicles using the access token obtained in step 2.
+
+Before integrating with Smartcar's SDK, you'll need to register an application
+in the [Smartcar Developer portal](https://developer.smartcar.com). If you do
+not have access to the dashboard, please
+[request access](https://smartcar.com/subscribe).
+
+### Flow
+
+- Create a new `AuthClient` object with your `clientId`, `clientSecret`,
+  `redirectUri`, and required `scope`.
+- Redirect the user to Smartcar Connect using `getAuthUrl` or one
+  of our frontend SDKs.
+- The user will login, and then accept or deny your `scope`'s permissions.
+- Handle the get request to `redirectUri`.
+  - If the user accepted your permissions, `req.query.code` will contain an
+    authorization code.
+    - Use `exchangeCode` with this code to obtain an access object
+      containing an access token (lasting 2 hours) and a refresh token
+      (lasting 60 days).
+      - Save this access object.
+    - If the user denied your permissions, `req.query.error` will be set
+      to `"access_denied"`.
+    - If you passed a state parameter to `getAuthUrl`, `req.query.state` will
+      contain the state value.
+- Get the user's vehicles with `getVehicleIds`.
+- Create a new `Vehicle` object using a `vehicleId` from the previous response,
+  and the `access_token`.
+- Make requests to the Smartcar API.
+- Use `exchangeRefreshToken` on your saved `refreshToken` to retrieve a new token
+  when your `accessToken` expires.
+
 ## Installation
 
 Add this line to your application's Gemfile:
@@ -20,29 +70,38 @@ Or install it yourself as:
 
 ## Usage
 
-Setup the environment variables for CLIENT_ID and CLIENT_SECRET. 
+Setup the environment variables for CLIENT_ID and CLIENT_SECRET.
 ```bash
 # Get your API keys from https://dashboard.smartcar.com/signup
 export CLIENT_ID=<client id>
 export CLIENT_SECRET=<client secret>
-``` 
+```
 
 Example Usage for calling the reports API with oAuth token
 ```ruby
-2.5.5 :003 > require 'smartcar'
+2.5.7 :001 > require 'smartcar'
  => true
-2.5.5 :009 > ids =  Smartcar::Vehicle.all_vehicle_ids(token: token)
- => ["35e8a7c4-9e5c-4eb6-b552-7509e371669a", "c3332c35-fdeb-4780-a84b-706b7364979a", "d10ad5cf-5469-467e-972e-90427981873f", "fab5a744-6488-40d8-a6dd-41f0a804d44f"]
-2.5.5 :010 > vehicle = Smartcar::Vehicle.new(token: token, id: ids.first)
- => #<Smartcar::Vehicle:0x00007fbad71aa2b8 @token="56801a5e-6a0b-4d05-a43e-52a4d5e6648f", @id="35e8a7c4-9e5c-4eb6-b552-7509e371669a", @unit_system="imperial">
-2.5.5 :011 > vehicle.permissions
- => ["control_security", "read_battery", "read_charge", "read_location", "read_odometer", "read_vehicle_info", "read_vin"]
-2.5.5 :012 > vehicle.odometer
- => #<Smartcar::Odometer:0x00007fbad718a3f0 @distance=74988.44443760936>
-2.5.5 :013 > vehicle.battery
- => #<Smartcar::Battery:0x00007fbad50f4c80 @range=134.35, @percentRemaining=0.02>
-2.5.5 :014 > vehicle.charge
- => #<Smartcar::Charge:0x00007fbad787e620 @state="FULLY_CHARGED", @isPluggedIn=true>
+2.5.7 :003 > ids =  Smartcar::Vehicle.all_vehicle_ids(token: token)
+ => ["4bb777b2-bde7-4305-8952-25956f8c0868"]
+2.5.7 :004 > vehicle = Smartcar::Vehicle.new(token: token, id: ids.first)
+ => #<Smartcar::Vehicle:0x00005564211a7c48 @token="5ae77cb0-7c1a-486a-ac20-00c76d2fd1aa", @id="4bb777b2-bde7-4305-8952-25956f8c0868", @unit_system="imperial">
+2.5.7 :006 > vehicle.odometer
+ => #<Smartcar::Odometer:0x00005564211330f0 @distance=17966.94802354251, @meta={"date"=>"Fri, 12 Jun 2020 06:04:32 GMT", "content-type"=>"application/json; charset=utf-8", "content-length"=>"30", "connection"=>"keep-alive", "access-control-allow-origin"=>"*", "sc-data-age"=>"2020-06-12T06:04:28.843Z", "sc-unit-system"=>"imperial", "sc-request-id"=>"3c447e9e-4cf7-43cb-b688-fba8db3d3582"}>
+2.5.7 :007 > vehicle.battery
+ => #<Smartcar::Battery:0x00005564210fcb18 @range=105.63, @percentRemaining=0.98, @meta={"date"=>"Fri, 12 Jun 2020 06:04:44 GMT", "content-type"=>"application/json; charset=utf-8", "content-length"=>"40", "connection"=>"keep-alive", "access-control-allow-origin"=>"*", "sc-data-age"=>"2020-06-12T06:04:28.843Z", "sc-unit-system"=>"imperial", "sc-request-id"=>"455ed4b0-b768-4961-86d7-436ad71cf0fa"}>
+2.5.7 :009 > vehicle.lock!
+ => true
+2.5.7 :010 > vehicle.batch(["charge","battery"])
+=> {:charge=>#<Smartcar::Charge:0x000055853d1fd7c8 @state="NOT_CHARGING", @isPluggedIn=false, @meta={"sc-data-age"=>"2020-06-12T06:18:50.581Z"}>, :battery=>#<Smartcar::Battery:0x000055853d1fd638 @range=105.63, @percentRemaining=0.98, @meta={"sc-data-age"=>"2020-06-12T06:18:50.581Z", "sc-unit-system"=>"imperial"}>}
+2.5.7 :011 > vehicle.start_charge!
+Traceback (most recent call last):
+        5: from /usr/share/rvm/rubies/ruby-2.5.7/bin/irb:11:in `<main>'
+        4: from (irb):5
+        3: from /home/st-2vgpnn2/.rvm/gems/ruby-2.5.7/gems/smartcar-1.0.0/lib/smartcar/vehicle.rb:118:in `start_charge!'
+        2: from /home/st-2vgpnn2/.rvm/gems/ruby-2.5.7/gems/smartcar-1.0.0/lib/smartcar/vehicle.rb:290:in `start_or_stop_charge!'
+        1: from /home/st-2vgpnn2/.rvm/gems/ruby-2.5.7/gems/smartcar-1.0.0/lib/smartcar/base.rb:39:in `block (2 levels) in <class:Base>'
+Smartcar::ExternalServiceError (API error - {"error":"vehicle_state_error","message":"Charging plug is not connected to the vehicle.","code":"VS_004"})
+
 ```
 
 Example Usage for oAuth -
@@ -64,8 +123,18 @@ Example Usage for oAuth -
 
 ## Development
 
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and  create a git tag for the version, push git commits and tags. When merging to master if it finds the tag it will deploy to rubygems automatically
 
+To run tests, make sure you have the env variables setup for client id and secret.
+```shell
+export INTEGRATION_CLIENT_ID=<client id>
+export INTEGRATION_CLIENT_SECRET=<client secret>
+```
+
+Tests can be run using either default rake command OR specific rspec command.
+```ruby
+bundle exec rake spec
+```
 ## Contributing
 
 To contribute, please:
@@ -73,3 +142,6 @@ To contribute, please:
 1. Open an issue for the feature (or bug) you would like to resolve.
 2. Resolve the issue and add tests in your feature branch.
 3. Open a PR from your feature branch into `develop` that tags the issue.
+
+[gem-image]: https://badge.fury.io/rb/smartcar
+[gem-url]: https://badge.fury.io/rb/smartcar.svg

data/lib/smartcar.rb

@@ -11,26 +11,43 @@ require "smartcar/location"
 require "smartcar/odometer"
 require "smartcar/tire_pressure"
 require "smartcar/vin"
+require "smartcar/vehicle_attributes"
 require "smartcar/vehicle"
 require "smartcar/user"
 
 
-module Smartcar
+  # Main Smartcar umbrella module
+  module Smartcar
+  # Error raised when a config is not found
   class ConfigNotFound < StandardError; end
+  # Error raised when Smartcar returns non 400, 404, 401, 200 or 204 response
   class ExternalServiceError < StandardError; end
+  # Error raised when Smartcar returns 404
   class ServiceUnavailableError < ExternalServiceError; end
+  # Error raised when Smartcar returns Authentication Error with status 401
   class AuthenticationError < ExternalServiceError; end
-  class ParserError < ExternalServiceError; end
+  # Error raised when Smartcar returns 400 response
   class BadRequestError < ExternalServiceError; end
+  # Smartcar API version being used
   API_VERSION = "v1.0".freeze
+  # Host to connect to smartcar
   SITE = "https://api.smartcar.com/".freeze
 
   # Path for smartcar oauth
   OAUTH_PATH = "https://connect.smartcar.com/oauth/authorize".freeze
   %w(success code test live force auto metric imperial).each do |constant|
+    # Constant to represent the value
     const_set(constant.upcase, constant.freeze)
   end
+
+  # Lock value sent in request body
   LOCK = "LOCK".freeze
+  # Unlock value sent in request body
   UNLOCK = "UNLOCK".freeze
+  # Start charge value sent in request body
+  START_CHARGE = "START".freeze
+  # Stop charge value sent in request body
+  STOP_CHARGE = "STOP".freeze
+  # Constant for units
   UNITS = [IMPERIAL,METRIC]
 end

data/lib/smartcar/base.rb

@@ -3,21 +3,26 @@ require 'base64'
 module Smartcar
   # The Base class for all of the other class.
   # Let other classes inherit from here and put common methods here.
-  #
-  # @author [ashwin]
-  #
   class Base
+    include Utils
+
+    # Error raised when an invalid parameter is passed.
     class InvalidParameterValue < StandardError; end
+    # Constant for Bearer auth type
     BEARER = 'BEARER'.freeze
+    # Constant for Basic auth type
     BASIC = 'BASIC'.freeze
+    # Number of seconds to wait for response
+    REQUEST_TIMEOUT = 310
+
+    attr_accessor :token, :error, :meta
 
-    attr_accessor :token
-    # meta programming and define all Restful methods.
-    # @param path [String] the path to hit for the request.
-    # @param token [String] the access token to be used.
-    #
-    # @return [Hash] The response Json parsed as a hash.
     %i{get post patch put delete}.each do |verb|
+      # meta programming and define all Restful methods.
+      # @param path [String] the path to hit for the request.
+      # @param data [Hash] request body if needed.
+      #
+      # @return [Hash] The response Json parsed as a hash.
       define_method verb do |path, data=nil|
         response = service.send(verb) do |request|
           request.headers['Authorization'] = "BEARER #{token}"
@@ -29,21 +34,19 @@ module Smartcar
             request.url complete_path, data
           else
             request.url complete_path
-            request.body = data if data
+            request.body = data.to_json if data
           end
         end
-        status = response.status
-        raise ServiceUnavailableError.new, "Service Unavailable - #{response.body}" if status == 404
-        raise BadRequestError.new, "Bad Request - #{response.body}" if status == 400
-        raise AuthenticationError.new, "Authentication error" if status == 401
-        raise ExternalServiceError.new, "API error - #{response.body}" unless [200,204].include?(status)
-        JSON.parse(response.body)
+        error = get_error(response)
+        raise error if error
+        [JSON.parse(response.body), response.headers]
       end
     end
 
     # This requires a proc 'PATH' to be defined in the class
-    # @param token [String] Access token
-    # @param token [String] Vechicle ID
+    # @param path [String] resource path
+    # @param options [Hash] query params
+    # @param auth [String] type of auth
     #
     # @return [Object]
     def fetch(path: , options: {}, auth: 'BEARER')
@@ -58,15 +61,14 @@ module Smartcar
     #
     # @return [String] Base64 encoding of CLIENT:SECRET
     def get_basic_auth
-      Base64.strict_encode64("#{ENV['CLIENT_ID']}:#{ENV['CLIENT_SECRET']}")
+      Base64.strict_encode64("#{get_config('CLIENT_ID')}:#{get_config('CLIENT_SECRET')}")
     end
 
     # gets a smartcar API service/client
-    # @param token [String] Access token.
     #
     # @return [OAuth2::AccessToken] An initialized AccessToken instance that acts as service client
     def service
-      @service ||= Faraday.new(url: SITE)
+      @service ||= Faraday.new(url: SITE, request: { timeout: REQUEST_TIMEOUT })
     end
   end
-end
+end

data/lib/smartcar/battery.rb

@@ -1,12 +1,11 @@
 module Smartcar
-  # class to represent battery info
-  #
-  # @author [ashwin]
-  #
+  # class to represent Battery info
+  #@attr [Number] percentRemaining Decimal value representing the remaining charge percent.
+  #@attr [Number] range Remaining range of the vehicle.
   class Battery < Base
-    include Utils
+    # Path Proc for hitting battery end point
     PATH = Proc.new{|id| "/vehicles/#{id}/battery"}
-    attr_accessor :percentRemaining, :range
+    attr_reader :percentRemaining, :range
 
     # just to have Ruby-esque method names
     alias_method :percentage_remaining, :percentRemaining

data/lib/smartcar/charge.rb

@@ -1,12 +1,11 @@
 module Smartcar
   # class to represent Charge info
-  #
-  # @author [ashwin]
-  #
+  #@attr [Boolean] isPluggedIn Specifies if the vehicle is plugged in.
+  #@attr [String] state Charging state of the vehicle.
   class Charge < Base
-    include Utils
+    # Path Proc for hitting charge end point
     PATH = Proc.new{|id| "/vehicles/#{id}/charge"}
-    attr_accessor :isPluggedIn, :state
+    attr_reader :isPluggedIn, :state
 
     # just to have Ruby-esque method names
     alias_method :is_plugged_in?, :isPluggedIn

data/lib/smartcar/engine_oil.rb

@@ -1,12 +1,10 @@
 module Smartcar
-  # class to represent Engine oil life
-  #
-  # @author [ashwin]
-  #
+  # class to represent Engine oil info
+  #@attr [Number] lifeRemaining Remaining life of the engine oil
   class EngineOil < Base
-    include Utils
+    # Path Proc for hitting engine oil end point
     PATH = Proc.new{|id| "/vehicles/#{id}/engine/oil"}
-    attr_accessor :lifeRemaining
+    attr_reader :lifeRemaining
 
     # just to have Ruby-esque method names
     alias_method :life_remaining, :lifeRemaining