stocks 0.0.4 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 911fce4a35b7e344b06251c4ea2fc44ca0c9e817
-  data.tar.gz: 26f40e4ef0111cff2adcdf6093db36984e1e6d13
+  metadata.gz: 8fe77a236eb3ca2f989553caf4d57cbfa165de57
+  data.tar.gz: 955e7bc142a46587bc745b4ad37f8bc849931610
 SHA512:
-  metadata.gz: 032e3ff200dea1284fe9b1bed083185ed04cb12f591f42a6cde96404270e2b5006a8216c8b17dd6075a89c596db2282788fbc4ae971688592380d266e035fbc1
-  data.tar.gz: efaf177ee08f5ee4ad964264e5be6f21e9de71ea945f91a1c35162b7f46bdfb6d80b84cb86c1a41c668202440eb502e40e69fcf88694ac790517a43293a8365b
+  metadata.gz: 0353ff677cc636d391d2e7c5e3c1d91a83ad94248069fd37fe46310c38bc8e30f78f67fb58f8045775e880708327b7806f6ca3e3f3c77b7a2e863a1eb621b649
+  data.tar.gz: 1462b1b44059f65a4b89b8754993abddfaeffab4d1b6b228497d97545e2385c09cb9ea182604815e673a2d3093e56733fe872363f9682b2c59e2b129d235aa0d

data/lib/stocks.rb

@@ -34,43 +34,8 @@ module Stocks
     raise RetrievalError.new(symbol) if !Stocks.exists?(symbol)
   end
 
-  # Fetches the last trade for the provided symbol.
-  #
-  # ===== *Args*
-  # - +symbol+ The symbol to evaluate
-  # ===== *Returns*
-  # The last trade for the provided symbol
-  # ===== *Raises*
-  # - +RetrievalError+ If the provided symbol does not exist
-  def self.last_trade(symbol)
-    last_trade = quote(symbol)[:lastTrade]
-    raise RetrievalError.new(symbol) if last_trade.nil?
-    last_trade
-  end
-
-  # Fetches a quote for the provided symbol.
-  #
-  # ===== *Args*
-  # - +symbol+ The symbol to evaluate
-  # - +type+ The type of quote to retreive
-  # ===== *Returns*
-  # The quote for the provided symbol
-  # ===== *Raises*
-  # - +RetrievalError+ If the provided symbol does not exist
-  # - +UnsupportedError+ If the provided type is not supported
-  def self.quote(symbol, type = :standard)
-    raise UnsupportedError.new(type, Quote::TYPES.keys) if !Quote::TYPES.has_key?(type)
-
-    symbol.upcase!
-    quote = YahooFinance.send(Quote::TYPES[type], symbol)[symbol]
-    raise RetrievalError.new(symbol) if quote.name == NOT_AVAILABLE
-
-    Quote.new(quote)
-  end
-
   private
 
   EXISTS_CACHE = LRUCache.new(max_size: 500, ttl: 1.month) # :nodoc:
-  NOT_AVAILABLE = 'N/A' # :nodoc:
 end
 

data/lib/stocks/quote.rb

@@ -1,22 +1,54 @@
 # Author::    Matt Fornaciari (mailto:mattforni@gmail.com)
 # License::   MIT
 
-# Provides an instance of a stock quote.
 module Stocks
+  # Reprsents an instance of a stock quote. 
   class Quote < Hash
     # Mapping from base_quote type to YahooFinance method of retrieval
+    # (options: :extended, :standard)
     TYPES = {
       'extended': :get_extended_quotes,
       'standard': :get_standard_quotes
     }
 
+    # Fetches a quote for the provided symbols.
+    #
+    # ===== *Args*
+    # - +symbols+ The symbols for which to retrieve a quote
+    # - +type+ The type of quote to retreive (default: :standard)
+    # ===== *Returns*
+    # The quote for the provided symbol
+    # ===== *Raises*
+    # - +UnsupportedError+ If the provided type is not supported
+    def self.get(symbols, type = :standard)
+      raise UnsupportedError.new(type, Quote::TYPES.keys) if !Quote::TYPES.has_key?(type)
+
+      symbols = [symbols] if !symbols.is_a?(Array)
+      symbols = symbols.collect { |s| s.upcase }
+
+      quotes = YahooFinance.send(Quote::TYPES[type], symbols)
+      quotes.each_pair { |symbol, quote| quotes[symbol] = Quote.new(quote) }
+      quotes
+    end
+
+    # :nodoc:
     def initialize(base_quote)
       @base_quote = base_quote
-      get_fields.each { |field| self[field] = base_quote.send(field) }
+      get_fields.each { |field| self[field] = base_quote.send(field) } if valid?
+    end
+
+    # Determines whether or not the quote is valid. 
+    #
+    # ===== *Returns*
+    # Whether or not the quote is valid 
+    def valid?
+      @base_quote.name != NOT_AVAILABLE
     end
 
     private
 
+    NOT_AVAILABLE = 'N/A' # :nodoc:
+
     attr_accessor :base_quote
 
     # :nodoc:

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: stocks
 version: !ruby/object:Gem::Version
-  version: 0.0.4
+  version: 1.0.0
 platform: ruby
 authors:
 - Matthew Fornaciari
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-06-23 00:00:00.000000000 Z
+date: 2015-06-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord