market_beat 0.1.1 → 0.2.0

data/CHANGELOG

@@ -1,3 +1,6 @@
+0.2.0
+  - Added support for fetching historical stock quotes.
+
 0.1.1
   - Include YAML files when building the gem.
 

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    market_beat (0.1.0)
+    market_beat (0.2.0)
 
 GEM
   remote: http://rubygems.org/

data/LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2011 Michael Dvorkin
+Copyright (c) 2011-12 Michael Dvorkin
 twitter.com/mid
 %w(mike dvorkin.net) * "@" || %w(mike fatfreecrm.com) * "@"
 

data/README.md

@@ -31,6 +31,15 @@ Some methods return multiple values:
     >> MarketBeat.last_trade_with_time :IBM
     ["4:02pm", "181.47"]
 
+Fetching historical quotes returns array of hashes where each hash represents
+stock data for a given date:
+
+    >> MarketBeat.quotes(:AAPL, "2011-12-21", "2011-12-22")
+    [{:date=>#<Date: 2011-12-22 (4911835/2,0,2299161)>, :open=>"397.00",
+    :high=>"399.13", :low=>"396.10", :close=>"398.55", :volume=>"7227016"},
+    {:date=>#<Date: 2011-12-21 (4911833/2,0,2299161)>, :open=>"396.69",
+    :high=>"397.30", :low=>"392.01", :close=>"396.44", :volume=>"9390954"}]
+
 ### Available Methods (Real Time Data) ###
 
     MarketBeat.after_hours_change_real_time
@@ -133,6 +142,7 @@ Some methods return multiple values:
     MarketBeat.price_to_eps_estimate_current_year
     MarketBeat.price_to_eps_estimate_next_year
     MarketBeat.price_to_sales
+    MarketBeat.quotes
     MarketBeat.range_52_week
     MarketBeat.shares_owned
     MarketBeat.short_ratio
@@ -164,7 +174,7 @@ Some methods return multiple values:
 * Send me a pull request.
 
 ### License ###
-Copyright (c) 2011 Michael Dvorkin
+Copyright (c) 2011-12 Michael Dvorkin
 
 twitter.com/mid
 

data/lib/market_beat.rb

@@ -1,31 +1,42 @@
-# Copyright (c) 2011 Michael Dvorkin
+# Copyright (c) 2011-12 Michael Dvorkin
 #
 # Market Beat is freely distributable under the terms of MIT license.
 # See LICENSE file or http://www.opensource.org/licenses/mit-license.php
 #------------------------------------------------------------------------------
 require File.dirname(__FILE__) + '/market_beat/yahoo'
 require File.dirname(__FILE__) + '/market_beat/google'
+require File.dirname(__FILE__) + '/market_beat/historical'
 require File.dirname(__FILE__) + "/market_beat/version"
 
 module MarketBeat
   # Pre-cache available methods so we could use them within
   # method_missing where respond_to? gives false positives.
+  @@methods = { :historical => [ :quotes ] }
   if RUBY_VERSION < '1.9.0'
-    @@yahoo  = (Yahoo.methods  - Object.methods).map { |m| m.to_sym }
-    @@google = (Google.methods - Object.methods).map { |m| m.to_sym }
+    @@methods[:yahoo]  = (Yahoo.methods  - Object.methods).map { |m| m.to_sym }
+    @@methods[:google] = (Google.methods - Object.methods).map { |m| m.to_sym }
   else
-    @@yahoo  = Yahoo.methods  - Object.methods
-    @@google = Google.methods - Object.methods
+    @@methods[:yahoo]  = Yahoo.methods  - Object.methods
+    @@methods[:google] = Google.methods - Object.methods
   end
 
   # Proxy MarketBeat methods to either Google or Yahoo providers.
   def self.method_missing(method, *args, &blk)
-    if @@google.include?(method)
+    if @@methods[:google].include?(method)
       Google.send(method, *args)
-    elsif @@yahoo.include?(method)
+    elsif @@methods[:yahoo].include?(method)
       Yahoo.send(method, *args)
+    elsif @@methods[:historical].include?(method)
+      Historical.send(method, *args)
     else
       super
     end
   end
+
+  if RUBY_VERSION > '1.9'
+    # Make MarketBeat.respond_to? return true for all the methods above.
+    def self.respond_to_missing?(method, include_private)
+      super(method, include_private) || @@methods.values.flatten.include?(method)
+    end
+  end
 end

data/lib/market_beat/google.rb

@@ -1,4 +1,4 @@
-# Copyright (c) 2011 Michael Dvorkin
+# Copyright (c) 2011-12 Michael Dvorkin
 #
 # Market Beat is freely distributable under the terms of MIT license.
 # See LICENSE file or http://www.opensource.org/licenses/mit-license.php

data/lib/market_beat/google.yml

@@ -1,4 +1,4 @@
-# Copyright (c) 2011 Michael Dvorkin
+# Copyright (c) 2011-12 Michael Dvorkin
 #
 # Market Beat is freely distributable under the terms of MIT license.
 # See LICENSE file or http://www.opensource.org/licenses/mit-license.php

data/lib/market_beat/historical.rb

@@ -0,0 +1,56 @@
+# Copyright (c) 2011-12 Michael Dvorkin
+#
+# Market Beat is freely distributable under the terms of MIT license.
+# See LICENSE file or http://www.opensource.org/licenses/mit-license.php
+#------------------------------------------------------------------------------
+require "csv"
+require "date"
+
+module MarketBeat
+  class Historical
+    URL = "http://www.google.com/finance/historical?q=%s&startdate=%s&enddate=%s&output=csv"
+
+    class << self
+      private
+      #
+      # Fetch historical quotes. Return nil on error or an array of hashes
+      # representing stock data. Empty array means no data is available.
+      # Start and end date parameters should be either YYYY-MM-DD strings
+      # or Date objects.
+      #
+      def quotes(ticker, start_date, end_date = Date.today)
+        csv = fetch(ticker, start_date, end_date)
+        return nil unless csv
+
+        quotes = CSV.parse(csv)     # Parse comma-delimited data.
+        quotes[1..-1].map do |col|  # Skip header line.
+          #
+          # I guess Google finance folks are tight on data so they return year
+          # as two digits, ex: 23-Dec-11 or Apr-26-99. With the tweak below we
+          # should be good till year 2042 ;-)
+          #
+          date = *col[0].split("-")
+          date[2] = ((date[2] <= "42" ? "20" : "19") + date[2]) if date[2].size == 2
+          { :date   => Date.parse(date.join("-")),
+            :open   => col[1],
+            :high   => col[2],
+            :low    => col[3],
+            :close  => col[4],
+            :volume => col[5]
+          }
+        end
+      end
+      #
+      # Format the URL and fetch stock data.
+      #
+      def fetch(ticker, start_date, end_date)
+        uri = URI.parse(URL % [ ticker, start_date.to_s, end_date.to_s ])
+        response = Net::HTTP.get_response(uri)
+        response.body
+      rescue Exception => e
+        $stderr.puts "market_beat: error fetching quotes\n#{e.inspect}"
+        nil
+      end
+    end
+  end
+end

data/lib/market_beat/version.rb

@@ -1,10 +1,10 @@
-# Copyright (c) 2011 Michael Dvorkin
+# Copyright (c) 2011-12 Michael Dvorkin
 #
 # Market Beat is freely distributable under the terms of MIT license.
 # See LICENSE file or http://www.opensource.org/licenses/mit-license.php
 #------------------------------------------------------------------------------
 module MarketBeat
   def self.version
-    '0.1.1'
+    '0.2.0'
   end
 end

data/lib/market_beat/yahoo.rb

@@ -1,4 +1,4 @@
-# Copyright (c) 2011 Michael Dvorkin
+# Copyright (c) 2011-12 Michael Dvorkin
 #
 # Market Beat is freely distributable under the terms of MIT license.
 # See LICENSE file or http://www.opensource.org/licenses/mit-license.php

data/lib/market_beat/yahoo.yml

@@ -1,4 +1,4 @@
-# Copyright (c) 2011 Michael Dvorkin
+# Copyright (c) 2011-12 Michael Dvorkin
 #
 # Market Beat is freely distributable under the terms of MIT license.
 # See LICENSE file or http://www.opensource.org/licenses/mit-license.php

data/spec/google_spec.rb

@@ -1,4 +1,4 @@
-# Copyright (c) 2011 Michael Dvorkin
+# Copyright (c) 2011-12 Michael Dvorkin
 #
 # Market Beat is freely distributable under the terms of MIT license.
 # See LICENSE file or http://www.opensource.org/licenses/mit-license.php

data/spec/historical_spec.rb

@@ -0,0 +1,65 @@
+# Copyright (c) 2011-12 Michael Dvorkin
+#
+# Market Beat is freely distributable under the terms of MIT license.
+# See LICENSE file or http://www.opensource.org/licenses/mit-license.php
+#------------------------------------------------------------------------------
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+require "stringio"
+require "date"
+
+describe "MarketBeat::Historical" do
+  before(:all) do
+    @csv = File.read(File.dirname(__FILE__) + '/fixtures/AAPL.csv')
+  end
+
+  it "should return correct data when using strings as start/end dates" do
+    response = mock(:body => @csv)
+    Net::HTTP.should_receive(:get_response).once.and_return(response)
+    quotes = MarketBeat.quotes(:aapl, "2011-12-21", "2011-12-23")
+    quotes.size.should == 3
+    quotes[0].keys.map(&:to_s).sort.should == %w(close date high low open volume)
+    quotes[0][:open].should      == "403.43"
+    quotes[0][:high].should      == "403.43"
+    quotes[0][:low].should       == "403.43"
+    quotes[0][:close].should     == "403.43"
+    quotes[0][:volume].should    == "0"
+    quotes[0][:date].to_s.should == "2011-12-23"
+    quotes[1][:date].to_s.should == "2011-12-22"
+    quotes[2][:date].to_s.should == "2011-12-21"
+  end
+
+  it "should return correct data when using Date as start/end dates" do
+    response = mock(:body => @csv)
+    Net::HTTP.should_receive(:get_response).once.and_return(response)
+    quotes = MarketBeat.quotes(:aapl, Date.parse("2011-12-21"), Date.parse("2011-12-23"))
+    quotes.size.should == 3
+    quotes[2].keys.map(&:to_s).sort.should == %w(close date high low open volume)
+    quotes[2][:open].should      == "396.69"
+    quotes[2][:high].should      == "397.30"
+    quotes[2][:low].should       == "392.01"
+    quotes[2][:close].should     == "396.44"
+    quotes[2][:volume].should    == "9390954"
+    quotes[2][:date].to_s.should == "2011-12-21"
+    quotes[1][:date].to_s.should == "2011-12-22"
+    quotes[0][:date].to_s.should == "2011-12-23"
+  end
+
+  it "should return empty array when no data is available" do
+    response = mock(:body => @csv.split.first)  # Just the header row.
+    Net::HTTP.should_receive(:get_response).once.and_return(response)
+    MarketBeat.quotes(:aapl, "2011-12-21", "2011-12-23").should == []
+  end
+
+  it "should return nil on error" do
+    begin
+      stderr, $stderr = $stderr, StringIO.new
+      response = mock(:body => "")
+      Net::HTTP.should_receive(:get_response).once.and_raise(SocketError)
+      MarketBeat.quotes(:aapl, "2011-12-21", "2011-12-23").should == nil
+      $stderr.string.should =~ /^market_beat: error fetching quotes/m
+    ensure
+      $stderr = stderr
+    end
+  end
+end
+

data/spec/market_beat_spec.rb

@@ -1,4 +1,4 @@
-# Copyright (c) 2011 Michael Dvorkin
+# Copyright (c) 2011-12 Michael Dvorkin
 #
 # Market Beat is freely distributable under the terms of MIT license.
 # See LICENSE file or http://www.opensource.org/licenses/mit-license.php
@@ -9,6 +9,12 @@ require 'yaml'
 describe "MarketBeat Google Proxy" do
   metrics = YAML.load_file(File.dirname(__FILE__) + '/../lib/market_beat/google.yml')
   metrics.values.each do |method|
+    if RUBY_VERSION > '1.9'
+      it "MarketBeat should respond to :#{method}" do
+        MarketBeat.respond_to?(method).should == true
+      end
+    end
+
     it "Google.#{method}" do
       MarketBeat::Google.should_receive(method).once
       MarketBeat::Yahoo.should_not_receive(method)
@@ -21,6 +27,12 @@ describe "MarketBeat Yahoo Proxy" do
   yahoo_metrics  = YAML.load_file(File.dirname(__FILE__) + '/../lib/market_beat/yahoo.yml')
   google_metrics = YAML.load_file(File.dirname(__FILE__) + '/../lib/market_beat/google.yml')
   yahoo_metrics.values.each do |method|
+    if RUBY_VERSION > '1.9'
+      it "MarketBeat should respond to :#{method}" do
+        MarketBeat.respond_to?(method).should == true
+      end
+    end
+
     it "Yahoo.#{method}" do # If Yahoo and Google have the same method Google takes precedence.
       if google_metrics.values.include?(method)
         MarketBeat::Google.should_receive(method).once

data/spec/spec_helper.rb

@@ -1,4 +1,4 @@
-# Copyright (c) 2011 Michael Dvorkin
+# Copyright (c) 2011-12 Michael Dvorkin
 #
 # Market Beat is freely distributable under the terms of MIT license.
 # See LICENSE file or http://www.opensource.org/licenses/mit-license.php

data/spec/yahoo_spec.rb

@@ -1,4 +1,4 @@
-# Copyright (c) 2011 Michael Dvorkin
+# Copyright (c) 2011-12 Michael Dvorkin
 #
 # Market Beat is freely distributable under the terms of MIT license.
 # See LICENSE file or http://www.opensource.org/licenses/mit-license.php

metadata

@@ -1,34 +1,37 @@
---- !ruby/object:Gem::Specification
+--- !ruby/object:Gem::Specification 
 name: market_beat
-version: !ruby/object:Gem::Version
-  version: 0.1.1
+version: !ruby/object:Gem::Version 
   prerelease: 
+  version: 0.2.0
 platform: ruby
-authors:
+authors: 
 - Michael Dvorkin
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-12-21 00:00:00.000000000 Z
-dependencies:
-- !ruby/object:Gem::Dependency
+
+date: 2012-01-15 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
   name: rspec
-  requirement: &70119385118060 !ruby/object:Gem::Requirement
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
     none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
         version: 2.6.0
   type: :development
-  prerelease: false
-  version_requirements: *70119385118060
-description: Fetch real-time and delayed stock quotes and 100+ other financial and
-  market indicaors from publicly available sources.
+  version_requirements: *id001
+description: Fetch real-time and delayed stock quotes and 100+ other financial and market indicaors from publicly available sources.
 email: mike@dvorkin.net
 executables: []
+
 extensions: []
+
 extra_rdoc_files: []
-files:
+
+files: 
 - CHANGELOG
 - Gemfile
 - Gemfile.lock
@@ -36,42 +39,48 @@ files:
 - Rakefile
 - README.md
 - lib/market_beat/google.rb
+- lib/market_beat/historical.rb
 - lib/market_beat/version.rb
 - lib/market_beat/yahoo.rb
 - lib/market_beat.rb
 - lib/market_beat/google.yml
 - lib/market_beat/yahoo.yml
 - spec/google_spec.rb
+- spec/historical_spec.rb
 - spec/market_beat_spec.rb
 - spec/spec_helper.rb
 - spec/yahoo_spec.rb
 - .gitignore
 homepage: http://github.com/michaeldv/market_beat
 licenses: []
+
 post_install_message: 
 rdoc_options: []
-require_paths:
+
+require_paths: 
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement
+required_ruby_version: !ruby/object:Gem::Requirement 
   none: false
-  requirements:
-  - - ! '>='
-    - !ruby/object:Gem::Version
-      version: '0'
-required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
   none: false
-  requirements:
-  - - ! '>='
-    - !ruby/object:Gem::Version
-      version: '0'
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
 requirements: []
+
 rubyforge_project: market_beat
-rubygems_version: 1.8.11
+rubygems_version: 1.8.5
 signing_key: 
 specification_version: 3
 summary: Fetch up-to-date stock quotes and 100+ financial and market indicators.
-test_files:
+test_files: 
 - spec/google_spec.rb
+- spec/historical_spec.rb
 - spec/market_beat_spec.rb
 - spec/spec_helper.rb
 - spec/yahoo_spec.rb