active_exchange 0.1.0

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,21 @@
+## MAC OS
+.DS_Store
+
+## TEXTMATE
+*.tmproj
+tmtags
+
+## EMACS
+*~
+\#*
+.\#*
+
+## VIM
+*.swp
+
+## PROJECT::GENERAL
+coverage
+rdoc
+pkg
+
+## PROJECT::SPECIFIC

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 nerbie69
+
+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/README.rdoc

@@ -0,0 +1,36 @@
+= active_exchange
+
+Active Exchange is a Rails Engine based Gem that is using the XavierMedia API. You can now get daily Exchange rates that are then uploaded into your own ExchangeRate table in the Database for use inside your Rails app.
+
+Using a Rake task, that is ran once a day, you collect all the exchange rate information.
+
+Now inside your rails app, you can convert one currency into another, or save everything into one currency on the fly.
+
+By going to XavierMedia once a day, you get stable rates to use throughout the day, which should be sufficient enough for your online store.
+
+I personally wouldn't use this if my model was, say an F/X trader on a big time exchange where second by second data is needed, however.
+
+== Useage
+
+* add config.gem 'active_exchange' to your environment.rb file
+* Run the rake task : "sudo rake active_exchange:seed" (you may not need sudo... your call)
+  then you will have your migrations in place.
+* Run "rake db:migrate" to migrate the migration files.
+* Run the rake task : "sudo rake active_exchange:daily_seed" to get the latest Exchange Rate data.
+
+You can now integrate this into your app as you see fit.
+
+== Note on Patches/Pull Requests
+ 
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a
+  future version unintentionally.
+* Commit, do not mess with rakefile, version, or history.
+  (if you want to have your own version, that is fine but
+   bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+== Copyright
+
+Copyright (c) 2009 nerbie69. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,52 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "active_exchange"
+    gem.summary = %Q{Foreign Exchange for your rails app}
+    gem.description = %Q{Foreign Exchange for your Rails app.}
+    gem.email = "philipjingram@yahoo.com"
+    gem.homepage = "http://github.com/nerbie69/active_exchange"
+    gem.authors = ["nerbie69"]
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: sudo gem install jeweler"
+end
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+begin
+  require 'rcov/rcovtask'
+  Rcov::RcovTask.new do |test|
+    test.libs << 'test'
+    test.pattern = 'test/**/test_*.rb'
+    test.verbose = true
+  end
+rescue LoadError
+  task :rcov do
+    abort "RCov is not available. In order to run rcov, you must: sudo gem install spicycode-rcov"
+  end
+end
+
+task :test => :check_dependencies
+
+task :default => :test
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "active_exchange #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/active_exchange.gemspec

@@ -0,0 +1,55 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{active_exchange}
+  s.version = "0.1.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["nerbie69"]
+  s.date = %q{2009-10-26}
+  s.description = %q{Foreign Exchange for your Rails app.}
+  s.email = %q{philipjingram@yahoo.com}
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+     ".gitignore",
+     "LICENSE",
+     "README.rdoc",
+     "Rakefile",
+     "VERSION",
+     "active_exchange.gemspec",
+     "app/models/exchange_rate.rb",
+     "db/migrate/20091021192708_create_exchange_rates.rb",
+     "lib/active_exchange.rb",
+     "tasks/daily_exchange_rates.rake",
+     "tasks/data_migration_exchange_rates.rake",
+     "test/helper.rb",
+     "test/test_active_exchange.rb"
+  ]
+  s.homepage = %q{http://github.com/nerbie69/active_exchange}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{Foreign Exchange for your rails app}
+  s.test_files = [
+    "test/helper.rb",
+     "test/test_active_exchange.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end
+

data/app/models/exchange_rate.rb

@@ -0,0 +1,4 @@
+class ExchangeRate < ActiveRecord::Base
+  # Really this is just a shell isn't it.  A model to hold nested scopes for Exchange Rates like ExchangeRate.find_last_by_currency(arg).
+
+end

data/db/migrate/20091021192708_create_exchange_rates.rb

@@ -0,0 +1,14 @@
+class CreateExchangeRates < ActiveRecord::Migration
+  def self.up
+    create_table :exchange_rates do |t|
+      t.string :currency
+      t.float :rate
+
+      t.timestamps
+    end
+  end
+
+  def self.down
+    drop_table :exchange_rates
+  end
+end

data/lib/active_exchange.rb

@@ -0,0 +1,45 @@
+require "cgi"
+require "uri"
+require "net/https"
+require "rexml/document"
+require "date"
+
+module ActiveExchange
+  # Originially massaged from the web post of http://geoff.evason.name/2008/10/27/simple-currency-conversion-rate-api-consumption-for-ruby-rails/
+  # The active_exchange gem is used to go out to XavierMedia and pull quotes for the currencies they offer.
+  
+  # We'll need to have a task to look for new data and parse it into DB, to cut down calls.
+  def self.retrieve_data(date = Date.today)
+    url = URI.parse("http://api.finance.xaviermedia.com/api/#{date.year}/#{date.strftime("%m")}/#{date.strftime("%d")}.xml")
+    resp = Net::HTTP.get(url)
+    xml  = REXML::Document.new(resp)
+  end
+  
+  def self.get_daily_data
+    #Get data
+    daily_rates = ActiveExchange.retrieve_data
+    #put into database.  Run the migrations, obviously, before you do this.
+    if daily_rates.root.attributes["responsecode"] == "200"
+      daily_rates.elements.each("//exchange_rates/fx") { |element|
+        ExchangeRate.create(:currency => element.elements[1].text, :rate => element.elements[2].text)
+      }
+    end
+  end
+  
+  #used to find an exchange rate on a certain day. this will make a call to the api.
+  def self.exchange_rate_on(date, currency_from = "USD", currency_to = "AUD")
+    xml = retrieve_data(date)
+    us_to_eur = 1.0
+    au_to_eur = 1.0
+    xml.elements.each("//exchange_rates/fx") { |el|
+      if el.elements[1].text == currency_from
+        us_to_eur = el.elements[2].text.to_f rescue 1.0
+      end
+      if el.elements[1].text == currency_to
+        au_to_eur = el.elements[2].text.to_f rescue 1.0
+      end
+    }
+
+    return us_to_eur/au_to_eur
+  end
+end

data/tasks/daily_exchange_rates.rake

@@ -0,0 +1,12 @@
+require "active_exchange"
+namespace :active_exchange do
+  desc "Go out to Xavier and get the Exchange Data for Today and put it into the ExchangeRate db"
+  task :daily_seed => :environment do
+    daily_rates = ActiveExchange.retrieve_data
+  end
+  
+  desc "Sync migration files into existing RAILS app - to be done inside rails apps."
+  task :sync do
+    system "rsync -ruv #{File.expand_path(File.dirname(__FILE__) + "/db/migrate")} #{RAILS_ROOT}/db"
+  end
+end

data/tasks/data_migration_exchange_rates.rake

@@ -0,0 +1,6 @@
+namespace :active_exchange do
+  desc "Sync migration files into existing RAILS app - to be done inside rails apps."
+  task :sync do
+    system "rsync -ruv #{File.expand_path(File.dirname(__FILE__) + "/db/migrate")} #{RAILS_ROOT}/db"
+  end
+end

data/test/helper.rb

@@ -0,0 +1,9 @@
+require 'rubygems'
+require 'test/unit'
+
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+require 'active_exchange'
+
+class Test::Unit::TestCase
+end

data/test/test_active_exchange.rb

@@ -0,0 +1,13 @@
+require 'helper'
+
+class TestActiveExchange < Test::Unit::TestCase
+  def test_it_works
+    assert_nothing_thrown do
+      actual = ActiveExchange.exchange_rate_on(Date.today, currency_from = "CAD", currency_to = "AUD")
+    end
+  end
+  def test_for_amount_on_oct_seventh
+    actual = ActiveExchange.exchange_rate_on(Date.parse("10/07/2009"))
+    assert_equal("0.889898255813954", actual.to_s)
+  end
+end

metadata

@@ -0,0 +1,70 @@
+--- !ruby/object:Gem::Specification 
+name: active_exchange
+version: !ruby/object:Gem::Version 
+  version: 0.1.0
+platform: ruby
+authors: 
+- nerbie69
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-10-26 00:00:00 -04:00
+default_executable: 
+dependencies: []
+
+description: Foreign Exchange for your Rails app.
+email: philipjingram@yahoo.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.rdoc
+files: 
+- .document
+- .gitignore
+- LICENSE
+- README.rdoc
+- Rakefile
+- VERSION
+- active_exchange.gemspec
+- app/models/exchange_rate.rb
+- db/migrate/20091021192708_create_exchange_rates.rb
+- lib/active_exchange.rb
+- tasks/daily_exchange_rates.rake
+- tasks/data_migration_exchange_rates.rake
+- test/helper.rb
+- test/test_active_exchange.rb
+has_rdoc: true
+homepage: http://github.com/nerbie69/active_exchange
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: Foreign Exchange for your rails app
+test_files: 
+- test/helper.rb
+- test/test_active_exchange.rb