quotes 0.0.1

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format nested

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in quotes.gemspec
+gemspec

data/README.mdown

@@ -0,0 +1,103 @@
+# Quotes
+
+A simple and lightweight wrapper for the Yahoo stock quotes API.
+
+## Installation
+
+	[sudo] gem install quotes
+
+## Usage
+
+	quotes = Quotes.get("AAPL", "GOOG", "MSFT")
+	quotes["AAPL"].ask			# => AAPL ask price
+	quotes["AAPL"].bid			# => AAPL bid price
+	quotes["GOOG"].volume		# => GOOG volume
+	quotes["GOOG"].dayslow 		# => GOOG day's low
+	quotes["MSFT"].dayshigh 	# => MSFT day's high
+	quotes["MSFT"].open 		# => MSFT opening price
+	
+
+#### List of quote qualities
+
+    afterhourschangerealtime
+	annualizedgain
+	ask
+	askrealtime
+	averagedailyvolume
+	bid
+	bidrealtime
+	bookvalue
+	change
+	change_percentchange
+	changefromfiftydaymovingaverage
+	changefromtwohundreddaymovingaverage
+	changefromyearhigh
+	changefromyearlow
+	changeinpercent
+	changepercentrealtime
+	changerealtime
+	commission
+	dayshigh
+	dayslow
+	daysrange
+	daysrangerealtime
+	daysvaluechange
+	daysvaluechangerealtime
+	dividendpaydate
+	dividendshare
+	dividendyield
+	earningsshare
+	ebitda
+	epsestimatecurrentyear
+	epsestimatenextquarter
+	epsestimatenextyear
+	errorindicationreturnedforsymbolchangedinvalid
+	exdividenddate
+	fiftydaymovingaverage
+	highlimit
+	holdingsgain
+	holdingsgainpercent
+	holdingsgainpercentrealtime
+	holdingsgainrealtime
+	holdingsvalue
+	holdingsvaluerealtime
+	lasttradedate
+	lasttradepriceonly
+	lasttraderealtimewithtime
+	lasttradetime
+	lasttradewithtime
+	lowlimit
+	marketcapitalization
+	marketcaprealtime
+	moreinfo
+	name
+	notes
+	oneyrtargetprice
+	open
+	orderbookrealtime
+	pegratio
+	peratio
+	peratiorealtime
+	percebtchangefromyearhigh
+	percentchange
+	percentchangefromfiftydaymovingaverage
+	percentchangefromtwohundreddaymovingaverage
+	percentchangefromyearlow
+	previousclose
+	pricebook
+	priceepsestimatecurrentyear
+	priceepsestimatenextyear
+	pricepaid
+	pricesales
+	sharesowned
+	shortratio
+	stockexchange
+	symbol
+	symbol
+	tickertrend
+	tradedate
+	twohundreddaymovingaverage
+	volume
+	yearhigh
+	yearlow
+	yearrange

data/Rakefile

@@ -0,0 +1,2 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks

data/lib/quotes.rb

@@ -0,0 +1,50 @@
+require 'json'
+require 'open-uri'
+
+module Quotes
+  
+  # Yahoo API endpoint
+  ENDPOINT = "http://query.yahooapis.com/v1/public/yql?q="
+  
+  def self.get(*symbols)
+    if symbols.length == 0 || symbols.include?("")
+      raise ArgumentError, "Enter symbol(s). Example: Quote.get(\"AAPL\")"
+    end
+    
+    syms = symbols.map{|s| "\"#{s}\""}.join(", ")
+    url = ENDPOINT + URI.escape("select * from yahoo.finance.quotes where symbol in (#{syms})") + "&format=json&env=store%3A%2F%2Fdatatables.org%2Falltableswithkeys&callback="
+    resp = ''
+    open(url) do |f|
+      resp = f.read
+    end
+    
+    info = JSON.parse(resp)['query']['results']['quote']
+    
+    # returns a hash containing the ticker symbols as keys
+    if symbols.length == 1
+      quote = {}
+      quote[info['symbol']] = Quote.new(info)
+      return quote
+    else
+      quotes = {}
+      info.each_with_index do |q, i|
+        data = info[i]
+        quotes[data['symbol']] = Quote.new(data)
+      end
+      return quotes
+    end
+  end
+  
+  class Quote
+    
+    def initialize(data)
+      data.each do |k, v|
+        self.class.class_eval do
+          define_method("#{k.downcase}") { v }
+        end
+      end
+    end
+    
+  end
+  
+end

data/lib/quotes/version.rb

@@ -0,0 +1,3 @@
+module Quotes
+  VERSION = "0.0.1"
+end

data/quotes.gemspec

@@ -0,0 +1,23 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "quotes/version"
+
+Gem::Specification.new do |s|
+  s.name        = "quotes"
+  s.version     = Quotes::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Nizar Dhamani"]
+  s.email       = ["nizar.dhamani@gmail.com"]
+  s.homepage    = "https://github.com/nizardhamani/quotes"
+  s.summary     = %q{A lightweight wrapper for the Yahoo stock quotes API.}
+  s.description = %q{A lightweight wrapper for the Yahoo stock quotes API.}
+
+  s.rubyforge_project = "quotes"
+  
+  s.add_development_dependency('rspec', '>= 2.0.0')
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+end

data/spec/helper.rb

@@ -0,0 +1 @@
+require 'quotes'

data/spec/quotes/quotes_spec.rb

@@ -0,0 +1,22 @@
+require 'helper'
+
+describe "Quotes" do
+  it "should return the AAPL quote when requested" do
+    q = Quotes.get("AAPL")
+    q["AAPL"].should_not == nil
+  end
+  
+  it "should return a hash of 3 quotes when 3 quotes are requested" do
+    q = Quotes.get("AAPL", "GOOG", "MSFT")
+    q.size.should == 3
+  end
+  
+  it "should raise an ArgumentError when there are no arguments" do
+    lambda { Quotes.get() }.should raise_error(ArgumentError)
+  end
+  
+  it "should raise an ArgumentError if any of the quotes requested are blank" do
+    lambda { Quotes.get("AAPL", "", "MSFT") }.should raise_error(ArgumentError)
+    lambda { Quotes.get("") }.should raise_error(ArgumentError)
+  end
+end

metadata

@@ -0,0 +1,93 @@
+--- !ruby/object:Gem::Specification 
+name: quotes
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Nizar Dhamani
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-08-23 00:00:00 -05:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 15
+        segments: 
+        - 2
+        - 0
+        - 0
+        version: 2.0.0
+  type: :development
+  version_requirements: *id001
+description: A lightweight wrapper for the Yahoo stock quotes API.
+email: 
+- nizar.dhamani@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- .rspec
+- Gemfile
+- README.mdown
+- Rakefile
+- lib/quotes.rb
+- lib/quotes/version.rb
+- quotes.gemspec
+- spec/helper.rb
+- spec/quotes/quotes_spec.rb
+has_rdoc: true
+homepage: https://github.com/nizardhamani/quotes
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: quotes
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: A lightweight wrapper for the Yahoo stock quotes API.
+test_files: 
+- spec/helper.rb
+- spec/quotes/quotes_spec.rb