medici 0.1.0

data/lib/medici/errors.rb

@@ -0,0 +1,13 @@
+module Medici
+  class StockSymbolError < RuntimeError
+    attr_reader :symbol
+
+    def initialize(symbol = nil, message = nil)
+      super(message)
+      @symbol = symbol
+    end
+  end
+
+  class HistoricalDataError < RuntimeError
+  end
+end

data/lib/medici/historical.rb

@@ -0,0 +1,52 @@
+require 'date'
+
+module Medici
+  class Historical
+    API_BASE_URL = 'http://www.google.com/finance/historical?'
+
+    attr_reader :date, :open, :high, :low, :close, :volume
+
+    def self.quote(symbol, start_date = nil, end_date = nil)
+      request = self.build_request(symbol, start_date, end_date)
+      response = Net::HTTP.get_response(URI.parse(request))
+      raise HistoricalDataError if response.code != '200'
+
+      self.parse(response.body)
+    end
+
+    private
+
+    def self.build_request(symbol, start_date, end_date)
+      params = {
+        q: symbol,
+        startdate: start_date,
+        enddate: end_date,
+        output: 'csv'
+      }
+
+      API_BASE_URL + params.each_with_object([]) do |(p, v), acc|
+        acc << "#{p}=#{v}" if not v.nil?
+      end.join('&')
+    end
+
+    def self.parse(response)
+      rows = response.split("\n")
+      rows.shift
+      rows.map do |row|
+        new(row.split(','))
+      end
+    end
+
+    private_class_method :new
+
+    def initialize(attributes)
+      @date = Date.parse(attributes[0])
+      @open = attributes[1].to_f
+      @high = attributes[2].to_f
+      @low = attributes[3].to_f
+      @close = attributes[4].to_f
+      @volume = attributes[5].to_i
+    end
+
+  end
+end

data/lib/medici/stock.rb

@@ -0,0 +1,92 @@
+require 'net/http'
+require 'xmlsimple'
+require 'date'
+require 'time'
+
+module Medici
+  class Stock
+    API_BASE_URL = 'http://www.google.com/ig/api?'
+
+    PARSERS = {
+      identity: lambda { |_| _ },
+      to_int:   lambda { |s| s.to_i },
+      to_float: lambda { |s| s.to_f },
+      to_date:  lambda { |s| s.empty? ? nil : Date.parse(s) },
+      to_time:  lambda { |s| s.empty? ? nil : Time.parse(s.scan(/.{2}/).join(':')) },
+      to_bool:  lambda { |s| s.match(/(true|t|yes|y|1)$/i) != nil }
+    }
+
+    QUOTE_ATTRIBUTES = [
+      :symbol, :pretty_symbol, :symbol_lookup_url, :company, :exchange, :exchange_timezone,
+      :exchange_utc_offset, :exchange_closing, :divisor, :currency, :last, :high, :low,
+      :volume, :avg_volume, :market_cap, :open, :y_close, :change, :perc_change, :delay,
+      :trade_timestamp, :trade_date_utc, :trade_time_utc, :current_date_utc, :current_time_utc,
+      :symbol_url, :chart_url, :disclaimer_url, :ecn_url, :isld_last, :isld_trade_date_utc,
+      :isld_trade_time_utc, :brut_last, :brut_trade_date_utc, :brut_trade_time_utc, :daylight_savings
+    ]
+
+    PARSE_MAP = {
+      exchange_closing:    PARSERS[:to_int],
+      divisor:             PARSERS[:to_int],
+      last:                PARSERS[:to_float],
+      high:                PARSERS[:to_float],
+      low:                 PARSERS[:to_float],
+      volume:              PARSERS[:to_int],
+      avg_volume:          PARSERS[:to_int],
+      market_cap:          PARSERS[:to_float],
+      open:                PARSERS[:to_float],
+      y_close:             PARSERS[:to_float],
+      change:              PARSERS[:to_float],
+      perc_change:         PARSERS[:to_float],
+      delay:               PARSERS[:to_int],
+      isld_last:           PARSERS[:to_float],
+      trade_date_utc:      PARSERS[:to_date],
+      trade_time_utc:      PARSERS[:to_time],
+      current_date_utc:    PARSERS[:to_date],
+      current_time_utc:    PARSERS[:to_time],
+      isld_trade_date_utc: PARSERS[:to_date],
+      isld_trade_time_utc: PARSERS[:to_time],
+      daylight_savings:    PARSERS[:to_bool]
+    }
+    PARSE_MAP.default = PARSERS[:identity]
+
+    QUOTE_ATTRIBUTES.each do |attribute|
+      attr_reader attribute
+    end
+
+    def self.quotes(symbols)
+      query = symbols.map { |symbol| "stock=#{symbol}" }.join('&')
+      response = Net::HTTP.get_response(URI.parse(API_BASE_URL + query))
+
+      self.parse(response.body)
+    end
+
+    def self.quote(symbol)
+      self.quotes([symbol]).first
+    end
+
+    private
+
+    def self.parse(xml_data)
+      doc = XmlSimple.xml_in(xml_data)
+      doc['finance'].map do |stock|
+        attributes = stock.each_with_object({}) do |(attribute, value), hash|
+          hash[attribute] = value.first['data'] if QUOTE_ATTRIBUTES.include? attribute.to_sym
+        end
+        raise StockSymbolError.new(attributes['symbol']) if attributes['exchange'] == 'UNKNOWN EXCHANGE'
+
+        new(attributes)
+      end
+    end
+
+    private_class_method :new
+
+    def initialize(attributes)
+      attributes.each do |attribute, value|
+        parser = PARSE_MAP[attribute.to_sym]
+        instance_variable_set("@#{attribute}", parser.call(value))
+      end
+    end
+
+  end
+end

data/lib/medici.rb

@@ -0,0 +1,18 @@
+require 'medici/stock'
+require 'medici/historical'
+
+module Medici
+  extend self
+
+  def quotes(symbols)
+    Stock.quotes(symbols)
+  end
+
+  def quote(symbol)
+    Stock.quote(symbol)
+  end
+
+  def historical(symbol, start_date = nil, end_date = nil)
+    Historical.quote(symbol, start_date, end_date)
+  end
+end

metadata

@@ -0,0 +1,68 @@
+--- !ruby/object:Gem::Specification
+name: medici
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+  prerelease: 
+platform: ruby
+authors:
+- Timothy Spratt
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-02-24 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: xml-simple
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Medici is a library for obtaining stock quotes and historical stock data
+  using the undocumented Google Finance API.
+email: tim@onlysix.co.uk
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/medici.rb
+- lib/medici/errors.rb
+- lib/medici/historical.rb
+- lib/medici/stock.rb
+homepage: http://github.com/timspratt/medici
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: ! '["Simple real-time stock quotes from the Google Finance API.", "Medici
+  is a library for obtaining stock quotes and historical stock data using the undocumented
+  Google Finance API.", ["Timothy Spratt"]]'
+test_files: []