they-yahoo_stock 1.0.8

data/History.txt

@@ -0,0 +1,98 @@
+=== 0.1.1 2009-08-31
+
+* 1 major enhancement:
+  * Initial release
+
+=== 0.1.2 2009-09-01
+
+* 1 minor change:
+  * changed method name YahooStock::Quote#get_data to get
+
+=== 0.1.3 2009-09-05
+
+* 3 additions:
+  * adds a new class called YahooStock::ScripSymbol that allows to 
+    find out the stock symbol for a company
+  * adds specs for previous and new code
+  * adds 
+
+=== 0.1.4 2009-09-05
+
+* 2 changes related with ruby 1.9:
+  * modifies quote class to be compatible with ruby 1.9
+  * modifies interface class to be compatible with 1.9
+
+=== 0.1.5 2009-09-06
+
+* 1 changes related with ruby 1.9:
+  * modifies ScripSymbol class to be compatible with ruby 1.9
+
+=== 0.1.6 2009-09-07
+
+* 1 addition:
+  * adds convenience methods Quote#realtime, standard and extended to 
+    fetch relevant stock values
+
+=== 1.0.1 2009-09-10
+
+* 1 addition:
+  * adds feature to retrieve historical stock data
+
+=== 1.0.2 2009-10-04
+Major changes in the public API. Check the README.rdoc file and individual classes for more information
+
+* 8 addition:
+  * adds YahooStock::Interface::History
+  * adds YahooStock::Interface::Quote
+  * adds YahooStock::Interface::ScripSymbol
+  * adds YahooStock::Result as a superclass for all formatter classes
+  * adds array format, Result::ArrayFormat, to generate results as an array
+  * adds hash format, Result::ArrayFormat, to generate results as key value pairs
+  * adds base class as parent for public facing classes
+  * adds observers to check when it is required to send request to yahoo again to get fresh data
+
+* 7 changes:
+  * changes YahooStock::Interface to be the main interface class. Other interface classes will inherit from this
+  * changes YahooStock::ScripSymbol to use YahooStock::Interface::ScripSymbol
+  * removes all history interface logic from YahooStock::History and uses YahooStock::Interface::History
+  * changes YahooStock::Quote, YahooStock::History, YahooStock::ScripSymbol to extend from YahooStock::Base
+  * sorts url parameters before sending request to yahoo
+  * YahooInterface::Quote#realtime, extended, and standard methods should return self to allow calling different format output method calls
+  * do not discard any empty values when finding scrip symbol options for a company as this interferes with different format options
+
+=== 1.0.3 2009-10-04
+
+* 2 changes:
+  * changes README file to add reference for gemcutter
+  * changes gemspec to use nas-yahoo_stock
+
+=== 1.0.4 2009-10-23
+
+* 2 addition:
+	* adds support for xml format
+	* adds cucumber features
+	
+* 1 changes:
+  * changes README file to remove git source add for github
+
+=== 1.0.5 2010-05-07
+
+* 1 change:
+  * made the case statement in YahooStock::Interface::History on line 86 ruby 1.9.1 compatible
+
+=== 1.0.6 2010-11-13
+
+* 2 addition:
+  * adds dividend query option by Ryan Sandridge
+  * adds cucumber rake task
+
+* 1 changes:
+  * Make sure all tests are run with rspec 2.1.0
+
+=== 1.0.7 2010-11-14
+
+* Some refactoring after the addition of dividend option to the history
+
+=== 1.0.8 2011-05-25
+
+* Parse csv data correctly using CSV gem instead to reinventing the wheel

data/Manifest.txt

@@ -0,0 +1,37 @@
+History.txt
+Manifest.txt
+README.rdoc
+Rakefile
+lib/yahoo_stock/base.rb
+lib/yahoo_stock/history.rb
+lib/yahoo_stock/interface.rb
+lib/yahoo_stock/interface/history.rb
+lib/yahoo_stock/interface/quote.rb
+lib/yahoo_stock/interface/scrip_symbol.rb
+lib/yahoo_stock/quote.rb
+lib/yahoo_stock/result.rb
+lib/yahoo_stock/result/array_format.rb
+lib/yahoo_stock/result/hash_format.rb
+lib/yahoo_stock/result/xml_format.rb
+lib/yahoo_stock/scrip_symbol.rb
+lib/yahoo_stock.rb
+spec/spec_helper.rb
+spec/yahoo_stock/base_spec.rb
+spec/yahoo_stock/interface_spec.rb
+spec/yahoo_stock/interface/history_spec.rb
+spec/yahoo_stock/interface/quote_spec.rb
+spec/yahoo_stock/interface/scrip_symbol_spec.rb
+spec/yahoo_stock/quote_spec.rb
+spec/yahoo_stock/history_spec.rb
+spec/yahoo_stock/result_spec.rb
+spec/yahoo_stock/result/array_format_spec.rb
+spec/yahoo_stock/result/hash_format_spec.rb
+spec/yahoo_stock/result/xml_format_spec.rb
+spec/yahoo_stock/scrip_symbol_spec.rb
+features/history.feature
+features/quotes.feature
+features/script_symbol.feature
+features/step_definitions/history_steps.rb
+features/step_definitions/quotes_steps.rb
+features/step_definitions/script_symbol_steps.rb
+

data/README.rdoc

@@ -0,0 +1,151 @@
+= yahoo_stock
+
+	* http://github.com/nas/yahoo_stock
+
+== DESCRIPTION:
+
+Provides an interface to yahoo finance to get stock related data. For instance, latest trade related data, volume, 50 day moving average, market cap, etc, virtually any thing that yahoo finance provides.
+
+If you don't know the stock / scrip symbol of the company then you can find that out by using the YahooStock::ScripSymbol class. The methods are mentioned in the Usage section below. For instance, YHOO for yahoo, GOOG for google, etc.
+The kind of parameters to be passed can be found after initializing the
+YahooStock::Quote object and passing valid_parameters message to the quote object, example is given below in the USAGE section.
+
+For details : http://nasir.wordpress.com/2009/10/28/ruby-gem-for-finance-data
+
+
+== INSTALL:
+
+	gem sources -a http://gemcutter.org
+
+	sudo gem install nas-yahoo_stock
+
+
+== USAGE:
+
+	require 'rubygems'
+	require 'yahoo_stock'
+
+* Initialize quote object:
+
+	quote = YahooStock::Quote.new(:stock_symbols => ['YHOO', 'GOOG'])
+
+* To view the valid parameters that can be passed:
+
+	quote.valid_parameters
+
+* To view the current parameters used:
+
+	quote.current_parameters
+
+* To view the current stock symbols used:
+
+	quote.current_symbols
+
+* To add more stocks to the list:
+
+	quote.add_symbols('MSFT', 'AAPL')
+
+* To remove stocks from list:
+
+	quote.remove_symbols('MSFT', 'AAPL')
+
+* To find data for all stocks, this will give a string containing all values:
+
+	quote.results.output
+
+* To return an array instead of a string use:
+
+	quote.results(:to_array).output
+
+* To return a hash, use:
+
+	quote.results(:to_hash).output
+
+* To return xml, use:
+
+	quote.results(:to_xml).output
+
+* to store results in a file, use:
+
+	quote.results.store('filename')
+
+* To find out the stock symbol for a company:
+
+	symbol = YahooStock::ScripSymbol.new('Yahoo')
+
+* To find all symbols for that company, this will give a string containing all values:
+
+	symbol.results.output
+
+* Similarly to YahooStock::Quote, results can be converted to an array, a hash, xml, or stored in a file:
+
+	symbol.results(:to_array).output
+	symbol.results(:to_hash).output
+	symbol.results(:to_xml).output
+	symbol.results.store('filename')
+
+* To find symbols for multiple companies:
+
+	symbols = YahooStock::ScripSymbol.results('Yahoo', 'Company1', 'Company3')
+
+* To find historical data for a stock:
+
+	history = YahooStock::History.new(:stock_symbol => 'yhoo', :start_date => Date.today-20, :end_date => Date.today-2)
+
+* As with regular quotes and symbol lookups, the results can be returned in various formats:
+
+	history.results.output
+	history.results(:to_array).output
+	history.results(:to_hash).output
+	history.results(:to_xml).output
+	history.results.store('filename')
+
+* History results include 7 values for each day, i.e. date itself, Open, High, Low, Close, Volume and Adj.
+
+* To get comma separated values with line breaks including header use:
+
+  history.values_with_header
+  (writing this to a file will give a CSV)
+
+==Docs
+
+http://rdoc.info/projects/nas/yahoo_stock
+
+== TESTS:
+
+To run all tests 'rspec spec' from the root directory. It requires rspec >= 2.1.0
+
+To run cucumber features "rake cucumber". It requires cucumber >= 0.9.4
+
+Cucumber Test html output is logged in log/features.html
+
+==Thanks
+
+* Thanks to {Ryan Sandridge}[http://github.com/dissolved] for adding the dividend query option.
+* Thanks to {Justin Campbell} [https://github.com/JustinCampbell] for refactoring CSV parsing.
+
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2009 Nasir Jamal
+
+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,12 @@
+require 'rubygems'
+
+require 'cucumber'
+require 'cucumber/rake/task'
+
+desc 'Run Cucumber features and generate an HTML summary'
+Cucumber::Rake::Task.new(:cucumber) do |t|
+  t.cucumber_opts = ["--no-color",
+                     "--format html -o log/features.html",
+                     "--format progress"]
+end
+

data/features/history.feature

@@ -0,0 +1,23 @@
+Feature: Find historical stock data for a stock
+	As a user
+	I want to find historical data for a stock
+	So that I can use the historical data
+	Scenario: Get historical data
+		Given I do not have any historical data for the symbol "msft"
+		When I get historical data for "msft"
+		Then I should be able to get history results as a comma separated values in a string
+	
+	Scenario: Get results in array format
+		Given I have the history results for the symbol "yhoo"
+		When I want to get the history results in array format
+		Then I should get an array of history values
+	
+	Scenario: Get results in hash format
+		Given I have the history results for the symbol "yhoo"
+		When I want to get the history results in hash format
+		Then I should get an array of hash key values for history
+	
+	Scenario: Get results in xml format
+		Given I have the history results for the symbol "yhoo"
+		When I want to get the history results in xml format
+		Then I should be able to get history result as xml

data/features/quotes.feature

@@ -0,0 +1,23 @@
+Feature: Get quotes for a stock
+	As a user
+	I want to get the stock quotes
+	So that I can use them in different formats
+	Scenario: Get stock quotes
+		Given I do not have any quote results
+		When I want to get the quotes for the symbol "yhoo"
+		Then I should be able to get results as a comma separated values in a string
+	
+	Scenario: Get results in array format
+		Given I have the results for the symbol "yhoo"
+		When I want to get the results in array format
+		Then I should get an array of values
+	
+	Scenario: Get results in hash format
+		Given I have the results for the symbol "yhoo"
+		When I want to get the results in hash format
+		Then I should get an array of hash key values
+	
+	Scenario: Get results in xml format
+		Given I have the results for the symbol "yhoo"
+		When I want to get the results in xml format
+		Then I should be able to get result as xml

data/features/script_symbol.feature

@@ -0,0 +1,23 @@
+Feature: Find Script Symbols
+	As a user
+	I want to find the script symbols for a company
+	So that I can use in other classes
+	Scenario: Find Scrip Symbols
+		Given I know the name of the company "Yahoo"
+		When I try to find the scrip symbols for "Yahoo"
+		Then I should be able to get scrip symbol results as a comma separated values in a string
+		
+	Scenario: Get symbol results in array format
+		Given I have the scrip symbol results for the symbol "yhoo"
+		When I want to get the scrip symbol results in array format
+		Then I should get an array of values for scrip symbol
+
+	Scenario: Get symbol results in hash format
+		Given I have the scrip symbol results for the symbol "yhoo"
+		When I want to get the scrip symbol results in hash format
+		Then I should get an array of hash key values for scrip symbol
+
+	Scenario: Get symbol results in xml format
+		Given I have the scrip symbol results for the symbol "yhoo"
+		When I want to get the scrip symbol results in xml format
+		Then I should be able to get scrip symbol result as xml

data/features/step_definitions/history_steps.rb

@@ -0,0 +1,44 @@
+Given /^I do not have any historical data for the symbol "([^\"]*)"$/ do |scrip_symbol|
+  @history = nil
+end
+
+When /^I get historical data for "([^\"]*)"$/ do |arg1|
+  @history = YahooStock::History.new(:stock_symbol => 'msft', 
+                                     :start_date => Date.today-10, 
+                                     :end_date => Date.today-2)
+  @results = @history.results
+end
+
+Then /^I should be able to get history results as a comma separated values in a string$/ do
+  @results.output.should =~ /.*,.*/
+end
+
+Given /^I have the history results for the symbol "([^\"]*)"$/ do |stock_symbol|
+  @history_format = YahooStock::History.new(:stock_symbol => stock_symbol,
+                                            :start_date => Date.today-4, 
+                                            :end_date => Date.today-2)
+end
+
+When /^I want to get the history results in array format$/ do
+  @array_output = @history_format.results(:to_array).output
+end
+
+Then /^I should get an array of history values$/ do
+  @array_output.should_not be_empty
+end
+
+When /^I want to get the history results in hash format$/ do
+  @hash_output = @history_format.results(:to_hash).output
+end
+
+Then /^I should get an array of hash key values for history$/ do
+  @hash_output.first.keys.should_not be_nil
+end
+
+When /^I want to get the history results in xml format$/ do
+  @xml_output = @history_format.results(:to_xml).output
+end
+
+Then /^I should be able to get history result as xml$/ do
+  @xml_output.should =~ /^\<xml*/
+end

data/features/step_definitions/quotes_steps.rb

@@ -0,0 +1,45 @@
+Given /^I do not have any quote results$/ do
+  @quote = nil
+end
+
+When /^I want to get the quotes for the symbol "([^\"]*)"$/ do |stock_symbol|
+  @quote = YahooStock::Quote.new(:stock_symbols => stock_symbol)
+  @results = @quote.results
+end
+
+Then /^I should be able to get results as a comma separated values in a string$/ do
+  @results.output.should =~ /.*,.*/
+end
+
+Given /^I have the results for the symbol "([^\"]*)"$/ do |stock_symbol|
+  @quote_format = YahooStock::Quote.new(:stock_symbols => stock_symbol)
+end
+
+When /^I want to get the results in array format$/ do
+  @array_output = @quote_format.results(:to_array).output
+end
+
+Then /^I should get an array of values$/ do
+  @array_output.should_not be_empty
+end
+
+Then /^by default there should only be two values$/ do
+  @array_output.size.should eql(2)
+end
+
+When /^I want to get the results in hash format$/ do
+  @hash_output = @quote_format.results(:to_hash).output
+end
+
+Then /^I should get an array of hash key values$/ do
+  @hash_output.first.keys.should include(:last_trade_price_only, :last_trade_date)
+end
+
+When /^I want to get the results in xml format$/ do
+  @xml_output = @quote_format.results(:to_xml).output
+end
+
+Then /^I should be able to get result as xml$/ do
+  @xml_output.should =~ /^\<xml*/
+end
+