quovo 1.0.0

data/lib/quovo/models/challenge.rb

@@ -0,0 +1,34 @@
+module Quovo
+  module Models
+    class Challenge < Base
+      using Quovo::Refinements::Cast
+
+      fields %i(
+        account
+        type
+        is_answered
+        last_asked
+        should_answer
+        question
+        image
+        choices
+        image_choices
+      )
+
+      undef :image
+      def image
+        @image.cast(Image)
+      end
+
+      undef :choices
+      def choices
+        @choices.cast(Choice)
+      end
+
+      undef :image_choices
+      def image_choices
+        @image_choices.cast(Image)
+      end
+    end
+  end
+end

data/lib/quovo/models/choice.rb

@@ -0,0 +1,10 @@
+module Quovo
+  module Models
+    class Choice < Base
+      fields %i(
+        category
+        value
+      )
+    end
+  end
+end

data/lib/quovo/models/image.rb

@@ -0,0 +1,10 @@
+module Quovo
+  module Models
+    class Image < Base
+      fields %i(
+        html
+        source
+      )
+    end
+  end
+end

data/lib/quovo/models/portfolio.rb

@@ -0,0 +1,50 @@
+module Quovo
+  module Models
+    class Portfolio < Base
+      using Quovo::Refinements::ToTime
+      CATEGORIES = {
+        'Investment' => %w(
+          401a 401k 403b 457b 529
+          Brokerage\ Account
+          Education\ Savings\ Account
+          Health\ Savings\ Account
+          IRA
+          Non-Taxable\ Brokerage\ Account
+          Pension
+          Roth\ IRA Roth\ 401k Simple\ IRA SEP\ IRA
+          Thrift\ Savings\ Plan
+          Profit\ Sharing\ Plan
+        ),
+        'Banking'    => %w(Checking Credit\ Card Savings),
+        'Insurance'  => %w(Annuity Fixed\ Annuity Insurance Variable\ Annuity),
+        'Loan'       => %w(Loan Mortgage Student\ Loan),
+        'Unknown'    => %w(Unknown)
+      }.freeze
+
+      fields %i(
+        id
+        account
+        brokerage
+        brokerage_name
+        description
+        is_inactive
+        is_taxable
+        last_change
+        nickname
+        owner_type
+        portfolio_name
+        portfolio_type
+        portfolio_category
+        update_count
+        user
+        username
+        value
+      )
+
+      undef :last_change
+      def last_change
+        @last_change.to_time
+      end
+    end
+  end
+end

data/lib/quovo/models/position.rb

@@ -0,0 +1,36 @@
+module Quovo
+  module Models
+    class Position < Base
+      using Quovo::Refinements::ToTime
+
+      fields %i(
+        account
+        asset_class
+        cost_basis
+        cost_basis_type
+        currency
+        cusip
+        fxrate
+        id
+        last_purchase_date
+        market_code
+        portfolio
+        portfolio_name
+        price
+        quantity
+        sector
+        security_type
+        ticker
+        ticker_name
+        user
+        username
+        value
+      )
+
+      undef :last_purchase_date
+      def last_purchase_date
+        @last_purchase_date.to_time
+      end
+    end
+  end
+end

data/lib/quovo/models/progress.rb

@@ -0,0 +1,11 @@
+module Quovo
+  module Models
+    class Progress < Base
+      fields %i(
+        message
+        percent
+        state
+      )
+    end
+  end
+end

data/lib/quovo/models/sync.rb

@@ -0,0 +1,20 @@
+module Quovo
+  module Models
+    class Sync < Base
+      using Quovo::Refinements::Cast
+
+      fields %i(
+        account
+        has_realtime
+        config_instructions
+        progress
+        status
+      )
+
+      undef :progress
+      def progress
+        @progress.cast(Progress)
+      end
+    end
+  end
+end

data/lib/quovo/models/transaction.rb

@@ -0,0 +1,37 @@
+module Quovo
+  module Models
+    class Transaction < Base
+      using Quovo::Refinements::ToTime
+
+      fields %i(
+        account
+        currency
+        cusip
+        date
+        expense_category
+        fees
+        fxrate
+        id
+        memo
+        portfolio
+        price
+        quantity
+        ticker
+        ticker_name
+        tran_category
+        tran_type
+        user
+        value
+      )
+
+      undef :date
+      def date
+        @date.to_time
+      end
+
+      def sort_key
+        [date, id]
+      end
+    end
+  end
+end

data/lib/quovo/models/user.rb

@@ -0,0 +1,14 @@
+module Quovo
+  module Models
+    class User < Base
+      fields %i(
+        id
+        username
+        email
+        name
+        phone
+        value
+      )
+    end
+  end
+end

data/lib/quovo/refinements/cast.rb

@@ -0,0 +1,22 @@
+module Quovo
+  module Refinements
+    module Cast
+      refine Object do
+        def cast(model)
+          case self
+          when Hash
+            model.new(self)
+          when Array
+            map do |entry|
+              entry.cast(model)
+            end
+          when NilClass
+            nil
+          else
+            raise 'unknown source type for casting'
+          end
+        end
+      end
+    end
+  end
+end

data/lib/quovo/refinements/compact.rb

@@ -0,0 +1,11 @@
+module Quovo
+  module Refinements
+    module Compact
+      refine Hash do
+        def compact!
+          delete_if { |_, value| value.nil? }
+        end
+      end
+    end
+  end
+end

data/lib/quovo/refinements/permit.rb

@@ -0,0 +1,11 @@
+module Quovo
+  module Refinements
+    module Permit
+      refine Hash do
+        def permit!(*keys)
+          delete_if { |k, _| !keys.include?(k) }
+        end
+      end
+    end
+  end
+end

data/lib/quovo/refinements/require.rb

@@ -0,0 +1,20 @@
+module Quovo
+  module Refinements
+    module Require
+      refine Object do
+        def require!(*keys, as: 'parameter')
+          case self
+          when Hash
+            missing = keys - self.keys
+            if missing.any?
+              raise Quovo::ParamsError, "Bad params list. Expected: #{keys}, actual #{self.keys}"
+            end
+            keys.each { |k| self[k].require!(as: k) }
+          when NilClass
+            raise Quovo::ParamsError, "#{as} cannot be nil!"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/quovo/refinements/sensitive.rb

@@ -0,0 +1,38 @@
+module Quovo
+  module Refinements
+    module Sensitive
+      FILTER_KEYS = %w(username password question answer access_token choices questions).freeze
+      refine Object do
+        def strip_sensitive
+          case self
+          when Hash
+            {}.tap do |result|
+              each do |key, value|
+                result[key] = FILTER_KEYS.include?(key.to_s) ? '[FILTERED]' : value.strip_sensitive
+              end
+            end
+          when Array
+            block = -> (value) { value.strip_sensitive }
+            map(&block)
+          else
+            self
+          end
+        end
+
+        def sensitive?
+          case self
+          when Hash
+            each do |key, value|
+              return true if FILTER_KEYS.include?(key.to_s) || value.sensitive?
+            end
+          when Array
+            each do |value|
+              return true if value.sensitive?
+            end
+          end
+          false
+        end
+      end
+    end
+  end
+end

data/lib/quovo/refinements/to_time.rb

@@ -0,0 +1,18 @@
+module Quovo
+  module Refinements
+    module ToTime
+      refine Object do
+        def to_time
+          case self
+          when String
+            Time.parse(self + ' UTC')
+          when NilClass
+            nil
+          else
+            raise "cannot convert #{inspect} to time"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/quovo/request.rb

@@ -0,0 +1,114 @@
+module Quovo
+  module Request
+    using Quovo::Refinements::Sensitive
+
+    def request(method, path, params = {}, format = :plain, config = Quovo.config)
+      return fake_request(method, path, params, &Proc.new) if Quovo.fake?
+
+      request = build_http_request(config.endpoint, method, path, params)
+
+      yield(request) if block_given?
+
+      do_http_request(request, config.request_timeout, format) do |code, payload, elapsed|
+        Quovo.run_hooks!(
+          path,
+          method.to_s.upcase,
+          strip_sensitive(params, config),
+          code,
+          strip_sensitive(payload, config),
+          elapsed
+        )
+        payload
+      end
+    end
+
+    protected
+
+    def build_http_request(endpoint, method, path, params)
+      request = case method
+                when :get
+                  Net::HTTP::Get
+                when :post
+                  Net::HTTP::Post
+                when :put
+                  Net::HTTP::Put
+                when :delete
+                  Net::HTTP::Delete
+                else
+                  raise Quovo::HttpError, 'unsupported method'
+                end.new(URI(endpoint + path))
+
+      inject_http_params(request, method, params) if params.any?
+      request
+    end
+
+    def http_transport(uri)
+      Net::HTTP.new(uri.host, uri.port)
+    end
+
+    private
+
+    def do_http_request(request, timeout, format)
+      http              = http_transport(request.uri)
+      http.read_timeout = timeout
+      http.use_ssl      = true
+      http.verify_mode  = OpenSSL::SSL::VERIFY_NONE
+
+      http.start do |transport|
+        (code, payload), elapsed = with_timing { parse_response(transport.request(request), format) }
+        yield(code, payload, elapsed)
+      end
+    end
+
+    def inject_http_params(request, method, params)
+      if method == :get
+        request.uri.query = URI.encode_www_form(params)
+      else
+        request.body = params.to_json
+        request['Content-Type'] = 'application/json'
+      end
+    end
+
+    def parse_response(response, format)
+      code = response.code
+      body = response.body
+      payload = format == :json ? JSON.parse(body) : body
+      raise Quovo::NotFoundError,  body if code =~ /404/
+      raise Quovo::ForbiddenError, body if code =~ /403/
+      raise Quovo::HttpError,      body if code =~ /^[45]/
+      [code, payload]
+    end
+
+    def with_timing
+      start_at = Time.now
+      result   = yield
+      elapsed  = (Time.now - start_at).round(3)
+      [result, elapsed]
+    end
+
+    def strip_sensitive(data, config)
+      config.strip_sensitive_params ? data.strip_sensitive : data
+    end
+
+    class FakeRequest
+      attr_reader :username, :password
+      def basic_auth(username, password)
+        @username = username
+        @password = password
+      end
+
+      def []=(_, __)
+        {}
+      end
+    end
+
+    def fake_request(method, path, params)
+      fake = Quovo.fake_calls.find do |fake_method, fake_path, fake_params, _|
+        fake_method == method && fake_path == path && (fake_params == params || fake_params == '*')
+      end
+      raise StubNotFoundError, [method, path, params] unless fake
+      yield(FakeRequest.new) if block_given?
+      fake.last
+    end
+  end
+end