yahoo_stocks 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 4413bb3bad3157c0dd3193855dc13f3260921c76
+  data.tar.gz: 74a849cebc64821499c43470c9f83fd1ec27d75a
+SHA512:
+  metadata.gz: 831691bab71cce1ad7dfa18b7e76e72a6e2630c9975de74659914b49e1adf54fb891a0b819d29c516e4705f09632853013662d91792848bf8183fae1215f8f84
+  data.tar.gz: 767df3cbcb380fd62aeb4e82c856d5bc805a749e66aaa59800b27a65ca4d422e9eb192e982ca8d20b02f1e831db8a57379d553e2aaee55f3d2d0d1a3fa65ff74

data/LICENSE

@@ -0,0 +1,20 @@
+The MIT License (MIT)
+
+Copyright (c) 2013 Denis Redozubov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/Rakefile

@@ -0,0 +1,14 @@
+$LOAD_PATH << File.expand_path('./lib')
+require "yahoo_stocks"
+ 
+task :build do
+  system "gem build yahoo_stocks.gemspec"
+end
+ 
+task :release => :build do
+  system "gem push yahoo_stocks-#{YahooStocks::VERSION}"
+end
+
+task :test do
+  system "rspec spec"
+end

data/lib/yahoo_stocks.rb

@@ -0,0 +1,7 @@
+require 'yahoo_stocks/endpoint'
+require 'yahoo_stocks/quotes'
+require 'yahoo_stocks/version'
+
+module YahooStocks
+  include YahooStocks::Endpoint
+end

data/lib/yahoo_stocks/backend.rb

@@ -0,0 +1,3 @@
+require 'yahoo_stocks/backend/nmatrix.rb'
+require 'yahoo_stocks/backend/openstruct.rb'
+require 'yahoo_stocks/backend/array.rb'

data/lib/yahoo_stocks/backend/array.rb

@@ -0,0 +1,19 @@
+require 'yahoo_stocks/backend/basic'
+
+module YahooStocks
+  module Backend
+    class Array < YahooStocks::Backend::Basic
+
+      def produce(stream)
+        result = []
+
+        CSV.parse(stream.body, quote_char: '"') do |*values|
+          result << values.map { |v| v.to_f rescue v }
+        end
+
+        result.flatten
+      end
+
+    end
+  end
+end

data/lib/yahoo_stocks/backend/basic.rb

@@ -0,0 +1,14 @@
+require 'csv'
+
+module YahooStocks
+  module Backend
+    class Basic
+
+      def produce(*args)
+        raise NotImplementedError, 'backend not implemented'
+      end
+
+    end
+  end
+end
+

data/lib/yahoo_stocks/common.rb

@@ -0,0 +1,32 @@
+require 'yahoo_stocks/endpoint/tags'
+
+module YahooStocks
+  module Common
+
+    include YahooStocks::Endpoint::Tags
+
+    private
+
+    def get_values(values)
+      case values
+      when String then [values]
+      when Symbol then [values.to_s]
+      when Array then values.map(&:to_s)
+      end
+    end
+
+    def get_format(tags)
+      tags.map! do |tag|
+        tag = tag.to_sym
+        case tag
+        when *TAGS.keys then TAGS[tag]
+        when *TAGS.values then tag
+        else raise "invalid format: #{tag}"
+        end
+      end
+
+      tags.compact.join
+
+    end
+  end
+end

data/lib/yahoo_stocks/endpoint.rb

@@ -0,0 +1,38 @@
+require 'uri'
+require 'yahoo_stocks/common'
+
+module YahooStocks
+  module Endpoint
+
+    extend URI::Escape
+    extend YahooStocks::Common
+
+    ENDPOINT = 'http://download.finance.yahoo.com/d/quotes.csv?'
+    FORMAT = [:symbol, :last_trade_price_only, :change, :previous_close] #
+
+    def self.compose_quotes(symbols, format = nil)
+      format = get_format(format ? format : FORMAT)
+      symbols = get_values(symbols)
+      uri = get_uri(format, s: symbols)
+      URI.parse(uri)
+    end
+
+    private
+
+    def self.get_uri(format, options={})
+      ENDPOINT + joined(options) + "&f=#{format}"
+    end
+
+    def self.joined(options)
+      out = options.inject('') do |s, el|
+        option, values = el
+        values = get_values(values)
+        s << "#{option}=#{values.map{ |v| escape(v) }.join(',')}&"
+      end
+      out.chomp!('&')
+      out
+    end
+
+  end
+end
+

data/lib/yahoo_stocks/endpoint/tags.rb

@@ -0,0 +1,98 @@
+module YahooStocks
+  module Endpoint
+    module Tags
+      # format note:
+      # x0 same as x there
+      TAGS = {
+        after_hours_change_realtime: :c8,
+        annualized_gain: :g3,
+        ask: :a0,
+        ask_realtime: :b2,
+        ask_size: :a5,
+        average_daily_volume: :a2,
+        bid: :b0,
+        bid_realtime: :b3,
+        bid_size: :b6,
+        book_value_per_share: :b4,
+        change: :c1,
+        change__change_in_percent: :c0,
+        change_from_fiftyday_moving_average: :m7,
+        change_from_two_hundredday_moving_average: :m5,
+        change_from_year_high: :k4,
+        change_from_year_low: :j5,
+        change_in_percent: :p2,
+        change_in_percent_realtime: :k2,
+        change_realtime: :c6,
+        commission: :c3,
+        currency: :c4,
+        days_high: :h0,
+        days_low: :g0,
+        days_range: :m0,
+        days_range_realtime: :m2,
+        days_value_change: :w1,
+        days_value_change_realtime: :w4,
+        dividend_pay_date: :r1,
+        trailing_annual_dividend_yield: :d0,
+        trailing_annual_dividend_yield_in_percent: :y0,
+        diluted_eP_s: :e0,
+        e_bI_tD_a: :j4,
+        e_pS_estimate_current_year: :e7,
+        e_pS_estimate_next_quarter: :e9,
+        e_pS_estimate_next_year: :e8,
+        ex_dividend_date: :q0,
+        fiftyday_moving_average: :m3,
+        shares_float: :f6,
+        high_limit: :l2,
+        holdings_gain: :g4,
+        holdings_gain_percent: :g1,
+        holdings_gain_percent_realtime: :g5,
+        holdings_gain_realtime: :g6,
+        holdings_value: :v1,
+        holdings_value_realtime: :v7,
+        last_trade_date: :d1,
+        last_trade_price_only: :l1,
+        last_trade_realtime_with_time: :k1,
+        last_trade_size: :k3,
+        last_trade_time: :t1,
+        last_trade_with_time: :l0,
+        low_limit: :l3,
+        market_capitalization: :j1,
+        market_cap_realtime: :j3,
+        more_info: :i0,
+        name: :n0,
+        notes: :n4,
+        oneyr_target_price: :t8,
+        open: :o0,
+        order_book_realtime: :i5,
+        p_eG_ratio: :r5,
+        p_eRatio: :r0,
+        p_eRatio_realtime: :r2,
+        percent_change_from_fiftyday_moving_average: :m8,
+        percent_change_from_two_hundredday_moving_average: :m6,
+        change_in_percent_from_year_high: :k5,
+        percent_change_from_year_low: :j6,
+        previous_close: :p0,
+        price_book: :p6,
+        price_eP_sEstimate_current_year: :r6,
+        price_eP_sEstimate_next_year: :r7,
+        price_paid: :p1,
+        price_sales: :p5,
+        revenue: :s6,
+        shares_owned: :s1,
+        shares_outstanding: :j2,
+        short_ratio: :s7,
+        stock_exchange: :x0,
+        symbol: :s0,
+        ticker_trend: :t7,
+        trade_date: :d2,
+        trade_links: :t6,
+        trade_links_additional: :f0,
+        two_hundredday_moving_average: :m4,
+        volume: :v0,
+        year_high: :k0,
+        year_low: :j0,
+        year_range: :w0,
+      }
+    end
+  end
+end

data/lib/yahoo_stocks/http.rb

@@ -0,0 +1,11 @@
+require 'net/http'
+
+module YahooStocks
+  module Http
+
+    def http_get(uri)
+      Net::HTTP.get_response(uri)
+    end
+
+  end
+end

data/lib/yahoo_stocks/quotes.rb

@@ -0,0 +1,28 @@
+require 'yahoo_stocks/common'
+require 'yahoo_stocks/backend'
+require 'yahoo_stocks/endpoint'
+require 'yahoo_stocks/http'
+
+module YahooStocks
+  module Quotes
+
+    BACKEND = YahooStocks::Backend::Array
+
+    include YahooStocks::Endpoint
+    extend YahooStocks::Http
+
+    def self.get(symbols, format = nil)
+      uri = YahooStocks::Endpoint.compose_quotes(symbols, format)
+      response = http_get(uri)
+      BACKEND.new.produce(response)
+    end
+
+    def self.method_missing(symbol, format = nil)
+      # http://yehudakatz.com/2010/01/02/the-craziest-fing-bug-ive-ever-seen/
+      # http://stackoverflow.com/questions/8960685/ruby-why-does-puts-call-to-ary
+      super if symbol == :to_ary
+      get([symbol], format)
+    end
+
+  end
+end

data/lib/yahoo_stocks/version.rb

@@ -0,0 +1,3 @@
+module YahooStocks
+  VERSION = '0.0.1'
+end

data/spec/common_spec.rb

@@ -0,0 +1,41 @@
+require 'spec_helper'
+require 'yahoo_stocks/common'
+
+describe YahooStocks::Common do
+
+  include YahooStocks::Common
+
+  describe '.get_format' do
+
+    it "works with strings" do
+      expect { get_format("foo") }.to raise_error
+    end
+
+    it "works with array of symbols" do
+      get_format([:v1, :s1, :l1]).should == "v1s1l1"
+    end
+
+    it "works with array of strings" do
+      get_format(%W{v1 s1 l1}).should == "v1s1l1"
+    end
+
+  end
+
+  describe '.get_values' do
+
+    it "works with string" do
+      get_values("AAPL").should == %W{AAPL}
+    end
+
+    it "works with array of symbols" do
+      get_values([:AAPL, :GOOG]).should == %W{AAPL GOOG}
+    end
+
+    it "works with array of strings" do
+      get_values(%W{AAPL GOOG}).should == %W{AAPL GOOG}
+    end
+
+  end
+
+end
+

data/spec/endpoint_spec.rb

@@ -0,0 +1,35 @@
+require 'spec_helper'
+require 'uri'
+require 'yahoo_stocks/endpoint'
+
+describe YahooStocks::Endpoint do
+
+    let(:format) { YahooStocks::Endpoint::FORMAT }
+    let(:test_params) { "?s=AAPL&f=#{format}" }
+
+    describe "compose quotes uri" do
+      YahooStocks::Endpoint.compose_quotes(:AAPL).should == \
+        URI.parse('http://download.finance.yahoo.com/d/quotes.csv?s=AAPL&f=s0l1c1p0')
+    end
+
+    describe "get_uri with one symbol" do
+
+      it "as array of strings" do
+        subject.get_uri(format, s: %W{AAPL}).should end_with test_params
+      end
+
+      it "as array of strings" do
+        subject.get_uri(format, s: [:AAPL]).should end_with test_params
+      end
+
+      it "as symbol" do
+        subject.get_uri(format, s: :AAPL).should end_with test_params
+      end
+
+      it "as string" do
+        subject.get_uri(format, s: 'AAPL').should end_with test_params
+      end
+
+    end
+
+end

data/spec/quotes_spec.rb

@@ -0,0 +1,57 @@
+require 'spec_helper'
+require 'yahoo_stocks/quotes'
+
+describe YahooStocks::Quotes do
+
+  let(:symbol) { :AAPL }
+  let(:format) { [:l1, :v1] }
+
+  describe "dynamic calls" do
+
+    context "with format" do
+
+      specify 'upcase' do
+        subject.should_receive(symbol).with(kind_of(Array))
+        expect { subject.send(symbol, format) }.to_not raise_error
+      end
+
+      specify 'downcase' do
+        s = symbol.downcase.to_sym
+        subject.should_receive(s).with(kind_of(Array))
+        expect { subject.send(s, format) }.to_not raise_error
+      end
+
+    end
+
+    specify "without format" do
+      subject.should_receive(symbol)
+      expect { subject.send(symbol) }.to_not raise_error
+    end
+
+  end
+
+  describe '.get' do
+
+    context 'symbol as ' do
+
+      specify 'array of symbols' do
+        expect { subject.get([:AAPL, :GOOG], format) }.to_not raise_error
+      end
+
+      specify 'array of strings' do
+        expect { subject.get(%W{AAPL GOOG}, format) }.to_not raise_error
+      end
+
+      specify 'symbol' do
+        expect { subject.get(symbol, format) }.to_not raise_error
+      end
+
+      specify 'string' do
+        expect { subject.get(symbol.to_s, format) }.to_not raise_error
+      end
+
+    end
+
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,21 @@
+# This file was generated by the `rspec --init` command. Conventionally, all
+# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
+# Require this file using `require "spec_helper"` to ensure that it is only
+# loaded once.
+#
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+
+$LOAD_PATH << File.expand_path('../lib')
+#require 'yahoo_stocks'
+
+RSpec.configure do |config|
+  config.treat_symbols_as_metadata_keys_with_true_values = true
+  config.run_all_when_everything_filtered = true
+  config.filter_run :focus
+
+  # Run specs in random order to surface order dependencies. If you find an
+  # order dependency and want to debug it, you can fix the order by providing
+  # the seed, which is printed after each run.
+  #     --seed 1234
+  config.order = 'random'
+end

data/spec/yahoo_stocks_spec.rb

@@ -0,0 +1,6 @@
+require 'spec_helper'
+require 'yahoo_stocks'
+
+describe YahooStocks do
+end
+

metadata

@@ -0,0 +1,91 @@
+--- !ruby/object:Gem::Specification
+name: yahoo_stocks
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Denis Redozubov
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-02-17 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  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'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+description: 
+email: denis.redozubov@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- Rakefile
+- lib/yahoo_stocks.rb
+- lib/yahoo_stocks/backend.rb
+- lib/yahoo_stocks/backend/array.rb
+- lib/yahoo_stocks/backend/basic.rb
+- lib/yahoo_stocks/backend/hash.rb
+- lib/yahoo_stocks/backend/nmatrix.rb
+- lib/yahoo_stocks/backend/openstruct.rb
+- lib/yahoo_stocks/common.rb
+- lib/yahoo_stocks/endpoint.rb
+- lib/yahoo_stocks/endpoint/tags.rb
+- lib/yahoo_stocks/http.rb
+- lib/yahoo_stocks/quotes.rb
+- lib/yahoo_stocks/version.rb
+- spec/common_spec.rb
+- spec/endpoint_spec.rb
+- spec/quotes_spec.rb
+- spec/spec_helper.rb
+- spec/yahoo_stocks_spec.rb
+homepage: http://www.denisredozubov.com
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Sane Yahoo! Finance rubiesque client
+test_files: []