currencies 0.2.1 → 0.3.0

data/.rvmrc

@@ -0,0 +1 @@
+rvm ruby@currencies

data/Gemfile

@@ -0,0 +1,6 @@
+source :rubygems
+
+gem 'jeweler', '=1.4.0'
+gem 'rspec', '=1.3.1'
+
+# /* vim: set filetype=ruby : */

data/Gemfile.lock

@@ -0,0 +1,20 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    gemcutter (0.6.1)
+    git (1.2.5)
+    jeweler (1.4.0)
+      gemcutter (>= 0.1.0)
+      git (>= 1.2.5)
+      rubyforge (>= 2.0.0)
+    json_pure (1.4.6)
+    rspec (1.3.1)
+    rubyforge (2.0.4)
+      json_pure (>= 1.1.7)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  jeweler (= 1.4.0)
+  rspec (= 1.3.1)

data/Rakefile

@@ -31,8 +31,6 @@ Spec::Rake::SpecTask.new(:rcov) do |spec|
   spec.rcov = true
 end
 
-task :spec => :check_dependencies
-
 task :default => :spec
 
 begin

data/VERSION

@@ -1 +1 @@
-0.2.1
+0.3.0

data/currencies.gemspec

@@ -1,61 +1,68 @@
 # Generated by jeweler
 # DO NOT EDIT THIS FILE DIRECTLY
-# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
 # -*- encoding: utf-8 -*-
 
 Gem::Specification.new do |s|
   s.name = %q{currencies}
-  s.version = "0.2.1"
+  s.version = "0.3.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["hexorx"]
-  s.date = %q{2010-03-30}
+  s.date = %q{2011-01-10}
   s.description = %q{If you are tracking any kind of assets the currencies gem is for you. It contains every currency in the ISO 4217 standard and allows you to add your own as well. So if you decide to take sparkly buttons as a form of payment you can use currencies to display the shiny button unicode symbol ☼ (disclaimer: ☼ may not look like a shiny button to everyone.) when used with something like the money gem. Speaking of the money gem, currencies gives you an ExchangeBank that the money gem can use to convert from one currency to another. There are plans to have ExchangeRate provider plugin system. Right now the rates are either set manually or pulled from Yahoo Finance.}
   s.email = %q{hexorx@gmail.com}
   s.extra_rdoc_files = [
     "LICENSE",
-     "README.markdown"
+    "README.markdown"
   ]
   s.files = [
     ".document",
-     ".gitignore",
-     "LICENSE",
-     "README.markdown",
-     "Rakefile",
-     "VERSION",
-     "currencies.gemspec",
-     "lib/currencies.rb",
-     "lib/currencies/currency.rb",
-     "lib/currencies/exchange_bank.rb",
-     "lib/currencies/extentions.rb",
-     "lib/data/iso4217.yaml",
-     "spec/currency_spec.rb",
-     "spec/exchange_bank_spec.rb",
-     "spec/spec_helper.rb"
+    ".rvmrc",
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE",
+    "README.markdown",
+    "Rakefile",
+    "VERSION",
+    "currencies.gemspec",
+    "lib/currencies.rb",
+    "lib/currencies/currency.rb",
+    "lib/currencies/exchange_bank.rb",
+    "lib/currencies/extentions.rb",
+    "lib/data/iso4217.yaml",
+    "spec/currency_spec.rb",
+    "spec/exchange_bank_spec.rb",
+    "spec/spec_helper.rb"
   ]
   s.homepage = %q{http://github.com/hexorx/currencies}
-  s.rdoc_options = ["--charset=UTF-8"]
   s.require_paths = ["lib"]
-  s.rubygems_version = %q{1.3.6}
+  s.rubygems_version = %q{1.3.7}
   s.summary = %q{Simple gem for working with currencies. It is extracted from the countries gem and contains all the currency information in the ISO 4217 standard.}
   s.test_files = [
     "spec/currency_spec.rb",
-     "spec/exchange_bank_spec.rb",
-     "spec/spec_helper.rb"
+    "spec/exchange_bank_spec.rb",
+    "spec/spec_helper.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
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<jeweler>, ["= 1.4.0"])
+      s.add_runtime_dependency(%q<rspec>, ["= 1.3.1"])
       s.add_development_dependency(%q<rspec>, [">= 0"])
       s.add_development_dependency(%q<yard>, [">= 0"])
     else
+      s.add_dependency(%q<jeweler>, ["= 1.4.0"])
+      s.add_dependency(%q<rspec>, ["= 1.3.1"])
       s.add_dependency(%q<rspec>, [">= 0"])
       s.add_dependency(%q<yard>, [">= 0"])
     end
   else
+    s.add_dependency(%q<jeweler>, ["= 1.4.0"])
+    s.add_dependency(%q<rspec>, ["= 1.3.1"])
     s.add_dependency(%q<rspec>, [">= 0"])
     s.add_dependency(%q<yard>, [">= 0"])
   end

data/lib/currencies/currency.rb

@@ -2,6 +2,7 @@ class Currency
   class << self
     attr_accessor :currencies
     attr_accessor :base_currency
+    attr_accessor :major_codes
     attr_accessor :import_exchange_rates
   end
   
@@ -46,7 +47,41 @@ class Currency
   def self.from_code(code)
     self.currencies[code.to_s.upcase]
   end
-    
+
+  def self.major_currencies_selection(currencies)
+    currencies.select { |code, currency| Currency.major_codes.include?(code) }.first
+  end
+
+  def self.best_from_currencies(currencies)
+    return if currencies.nil? || currencies.empty?
+    self.major_currencies_selection(currencies) ? self.major_currencies_selection(currencies)[1] : currencies.first[1]
+  end
+
+  def self.list_from_name(name)
+    self.currencies.select { |code, currency| currency.name == name }
+  end
+
+  def self.list_from_symbol(symbol)
+    self.currencies.select { |code, currency| currency.symbol == symbol }
+  end
+
+  def self.best_from_name(name)
+    self.best_from_currencies(self.list_from_name(name))
+  end
+
+  def self.best_from_symbol(symbol)
+    self.best_from_currencies(self.list_from_symbol(symbol))
+  end
+
+  def self.best_guess(str)
+    return if str.nil? || str.empty?
+    self.from_code(str) || self.best_from_symbol(str) || self.best_from_name(str)
+  end
+
+  def self.code_from_best_guess(str)
+    self.best_guess(str).try(:code)
+  end
+
   def self.add(new_currency)
     self.currencies ||= {}
     self.currencies[new_currency.code] = new_currency
@@ -54,5 +89,6 @@ class Currency
   
   load_file(File.join(File.dirname(__FILE__), '..', 'data', 'iso4217.yaml'))
   self.base_currency = 'USD'
+  self.major_codes = [ "USD", "EUR", "GBP" ]
   self.import_exchange_rates = true
-end
+end

data/spec/currency_spec.rb

@@ -63,4 +63,278 @@ describe Currency do
       Currency.from_code(Currency.base_currency).exchange_rate.should == 1.0
     end
   end
-end
+
+  describe ".major_currencies_selection" do
+    let(:usd) { [ "USD", mock ] }
+    let(:aud) { [ "AUD", mock ] }
+    let(:currencies) { [ usd, aud ] }
+
+    context "with default settings" do
+      subject do
+        Currency.major_currencies_selection(currencies)
+      end
+
+      it { should == usd }
+    end
+
+    context "with changed major currency to AUD" do
+      subject do
+        Currency.major_codes = [ "AUD" ]
+        Currency.major_currencies_selection(currencies)
+      end
+
+      it { should == aud }
+    end
+  end
+
+  describe ".best_from_currencies" do
+    let(:usd) { mock }
+    let(:pln) { mock }
+    let(:aud) { mock }
+
+    context "when given currencies is nil" do
+      subject { Currency.best_from_currencies(nil) }
+
+      it { should be_nil }
+    end
+
+    context "when given currencies is empty array" do
+      subject { Currency.best_from_currencies([]) }
+
+      it { should be_nil }
+    end
+
+    context "when major currency exist within currencies" do
+      let(:valid_currencies) { mock(:nil? => false, :empty? => false) }
+      subject do
+        Currency.stub!(:major_currencies_selection => [mock, usd])
+        Currency.best_from_currencies(valid_currencies)
+      end
+
+      it { should == usd }
+    end
+
+    context "when major currency does not exist within currencies" do
+      let(:valid_currencies) { [ [mock, pln], [mock, aud] ] }
+      subject do
+        Currency.stub!(:major_currencies_selection => nil)
+        Currency.best_from_currencies(valid_currencies)
+      end
+
+      it { should == pln }
+    end
+  end
+
+  describe ".list_from_name" do
+    let(:euro_currency) { mock(:name => "Euro") }
+    let(:euro) { [ [ "EUR", euro_currency ] ] }
+    let(:dollar_currency) { mock(:name => "Dollars") }
+    let(:dollars) { [
+      [ "USD", dollar_currency ],
+      [ "AUD", dollar_currency ]
+    ] }
+    let(:currencies) { euro + dollars }
+
+    subject do
+      Currency.stub!(:currencies => currencies)
+      Currency.list_from_name("Dollars")
+    end
+
+    it { should == dollars }
+  end
+
+  describe ".list_from_symbol" do
+    let(:euro_currency) { mock(:symbol => "€") }
+    let(:euro) { [ [ "EUR", euro_currency ] ] }
+    let(:dollar_currency) { mock(:symbol => "$") }
+    let(:dollars) { [
+      [ "USD", dollar_currency ],
+      [ "AUD", dollar_currency ]
+    ] }
+    let(:currencies) { euro + dollars }
+
+    subject do
+      Currency.stub!(:currencies => currencies)
+      Currency.list_from_symbol("$")
+    end
+
+    it { should == dollars }
+  end
+
+  describe ".best_from_name" do
+    let(:name) { mock }
+    let(:list_from_name) { mock }
+    describe "behavior" do
+      before do
+        Currency.stub!(
+          :best_from_currencies => nil,
+          :list_from_name => list_from_name
+        )
+      end
+      after { Currency.best_from_name(name) }
+
+      it "should select best from list of currencies with given name" do
+        Currency.should_receive(:best_from_currencies).with(list_from_name)
+      end
+
+      it "should select list of currencies with given name" do
+        Currency.should_receive(:list_from_name).with(name).and_return(list_from_name)
+      end
+    end
+
+    describe "returns" do
+      let(:best_from_currencies) { mock }
+      subject do
+        Currency.stub!(
+          :best_from_currencies => best_from_currencies,
+          :list_from_name => list_from_name
+        )
+        Currency.best_from_name(name)
+      end
+
+      it { should == best_from_currencies }
+    end
+  end
+
+  describe ".best_from_symbol" do
+    let(:symbol) { mock }
+    let(:list_from_symbol) { mock }
+    describe "behavior" do
+      before do
+        Currency.stub!(
+          :best_from_currencies => nil,
+          :list_from_symbol => list_from_symbol
+        )
+      end
+      after { Currency.best_from_symbol(symbol) }
+
+      it "should select best from list of currencies with given symbol" do
+        Currency.should_receive(:best_from_currencies).with(list_from_symbol)
+      end
+
+      it "should select list of currencies with given symbol" do
+        Currency.should_receive(:list_from_symbol).with(symbol).and_return(list_from_symbol)
+      end
+    end
+
+    describe "returns" do
+      let(:best_from_currencies) { mock }
+      subject do
+        Currency.stub!(
+          :best_from_currencies => best_from_currencies,
+          :list_from_symbol => list_from_symbol
+        )
+        Currency.best_from_symbol(symbol)
+      end
+
+      it { should == best_from_currencies }
+    end
+  end
+
+  describe ".best_guess" do
+    let(:eur) { mock }
+    let(:string) { mock(:nil? => false, :empty? => false) }
+
+    context "when string not given" do
+      subject { Currency.best_guess(nil) }
+
+      it { should be_nil }
+    end
+
+    context "when given empty string" do
+      subject { Currency.best_guess("") }
+
+      it { should be_nil }
+    end
+
+    context "when code equal to string exist" do
+      subject do
+        Currency.stub!(:from_code).with(string).and_return(eur)
+        Currency.best_guess(string)
+      end
+
+      it { should == eur }
+    end
+
+    context "when best symbol equal to string exist" do
+      subject do
+        Currency.stub!(:from_code).with(string).and_return(nil)
+        Currency.stub!(:best_from_symbol).with(string).and_return(eur)
+        Currency.best_guess(string)
+      end
+
+      it { should == eur }
+    end
+
+    context "when best name equal to string exist" do
+      subject do
+        Currency.stub!(:from_code).with(string).and_return(nil)
+        Currency.stub!(:best_from_symbol).with(string).and_return(nil)
+        Currency.stub!(:best_from_name).with(string).and_return(eur)
+        Currency.best_guess(string)
+      end
+
+      it { should == eur }
+    end
+
+    context "when string not exist in any form" do
+      subject do
+        Currency.stub!(:from_code).with(string).and_return(nil)
+        Currency.stub!(:best_from_symbol).with(string).and_return(nil)
+        Currency.stub!(:best_from_name).with(string).and_return(nil)
+        Currency.best_guess(string)
+      end
+
+      it { should be_nil }
+    end
+
+    describe "behavior" do
+      it "should run methods in proper order" do
+        Currency.should_receive(:from_code).ordered.with("string").and_return(nil)
+        Currency.should_receive(:best_from_symbol).ordered.with("string").and_return(nil)
+        Currency.should_receive(:best_from_name).ordered.with("string").and_return(nil)
+        Currency.best_guess("string")
+      end
+    end
+  end
+
+  describe ".code_from_best_guess" do
+    let(:string) { mock }
+    let(:code) { mock }
+    let(:best_guess) { mock(:try => code) }
+
+    context "when there is best guess" do
+      subject do
+        Currency.stub!(:best_guess).with(string).and_return(best_guess)
+        Currency.code_from_best_guess(string)
+      end
+
+      it { should == code }
+    end
+
+    context "when there is no best guess" do
+      let(:best_guess) { mock(:try => nil) }
+
+      subject do
+        Currency.stub!(:best_guess).with(string).and_return(best_guess)
+        Currency.code_from_best_guess(string)
+      end
+
+      it { should be_nil }
+    end
+
+    describe "behavior" do
+      before { Currency.stub!(:best_guess).with(string).and_return(best_guess) }
+      after { Currency.code_from_best_guess(string) }
+
+      it "should call .best_guess" do
+        Currency.should_receive(:best_guess).with(string).and_return(best_guess)
+      end
+
+      it "should call #code on best guessed" do
+        best_guess.should_receive(:try).with(:code)
+      end
+    end
+  end
+
+end

metadata

@@ -1,12 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: currencies
 version: !ruby/object:Gem::Version 
+  hash: 19
   prerelease: false
   segments: 
   - 0
-  - 2
-  - 1
-  version: 0.2.1
+  - 3
+  - 0
+  version: 0.3.0
 platform: ruby
 authors: 
 - hexorx
@@ -14,33 +15,69 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-03-30 00:00:00 -06:00
+date: 2011-01-10 00:00:00 -07:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
+  type: :runtime
+  prerelease: false
+  name: jeweler
+  version_requirements: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - "="
+      - !ruby/object:Gem::Version 
+        hash: 7
+        segments: 
+        - 1
+        - 4
+        - 0
+        version: 1.4.0
+  requirement: *id001
+- !ruby/object:Gem::Dependency 
+  type: :runtime
+  prerelease: false
   name: rspec
+  version_requirements: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - "="
+      - !ruby/object:Gem::Version 
+        hash: 25
+        segments: 
+        - 1
+        - 3
+        - 1
+        version: 1.3.1
+  requirement: *id002
+- !ruby/object:Gem::Dependency 
+  type: :development
   prerelease: false
-  requirement: &id001 !ruby/object:Gem::Requirement 
+  name: rspec
+  version_requirements: &id003 !ruby/object:Gem::Requirement 
+    none: false
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
+        hash: 3
         segments: 
         - 0
         version: "0"
-  type: :development
-  version_requirements: *id001
+  requirement: *id003
 - !ruby/object:Gem::Dependency 
-  name: yard
+  type: :development
   prerelease: false
-  requirement: &id002 !ruby/object:Gem::Requirement 
+  name: yard
+  version_requirements: &id004 !ruby/object:Gem::Requirement 
+    none: false
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
+        hash: 3
         segments: 
         - 0
         version: "0"
-  type: :development
-  version_requirements: *id002
+  requirement: *id004
 description: "If you are tracking any kind of assets the currencies gem is for you. It contains every currency in the ISO 4217 standard and allows you to add your own as well. So if you decide to take sparkly buttons as a form of payment you can use currencies to display the shiny button unicode symbol \xE2\x98\xBC (disclaimer: \xE2\x98\xBC may not look like a shiny button to everyone.) when used with something like the money gem. Speaking of the money gem, currencies gives you an ExchangeBank that the money gem can use to convert from one currency to another. There are plans to have ExchangeRate provider plugin system. Right now the rates are either set manually or pulled from Yahoo Finance."
 email: hexorx@gmail.com
 executables: []
@@ -52,7 +89,9 @@ extra_rdoc_files:
 - README.markdown
 files: 
 - .document
-- .gitignore
+- .rvmrc
+- Gemfile
+- Gemfile.lock
 - LICENSE
 - README.markdown
 - Rakefile
@@ -71,28 +110,32 @@ homepage: http://github.com/hexorx/currencies
 licenses: []
 
 post_install_message: 
-rdoc_options: 
-- --charset=UTF-8
+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: 
-rubygems_version: 1.3.6
+rubygems_version: 1.3.7
 signing_key: 
 specification_version: 3
 summary: Simple gem for working with currencies. It is extracted from the countries gem and contains all the currency information in the ISO 4217 standard.

data/.gitignore

@@ -1,6 +0,0 @@
-*.sw?
-.DS_Store
-coverage
-rdoc
-pkg
-.rake_tasks~