money 3.1.0.pre3 → 3.1.0

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: money
 version: !ruby/object:Gem::Version 
-  hash: -502734836
-  prerelease: true
+  hash: 3
+  prerelease: false
   segments: 
   - 3
   - 1
   - 0
-  - pre3
-  version: 3.1.0.pre3
+  version: 3.1.0
 platform: ruby
 authors: 
 - Tobias Luetke
@@ -20,7 +19,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-08-31 00:00:00 -04:00
+date: 2010-09-13 00:00:00 -04:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -31,16 +30,14 @@ dependencies:
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        hash: 13
+        hash: 3
         segments: 
-        - 1
-        - 2
-        - 9
-        version: 1.2.9
+        - 0
+        version: "0"
   type: :development
   version_requirements: *id001
 - !ruby/object:Gem::Dependency 
-  name: hanna
+  name: yard
   prerelease: false
   requirement: &id002 !ruby/object:Gem::Requirement 
     none: false
@@ -50,30 +47,34 @@ dependencies:
         hash: 3
         segments: 
         - 0
-        - 1
-        - 12
-        version: 0.1.12
+        version: "0"
   type: :development
   version_requirements: *id002
-description: Money and currency exchange support library.
-email: hongli@phusion.nl
+- !ruby/object:Gem::Dependency 
+  name: json
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id003
+description: This library aids one in handling money and different currencies.
+email: 
+- hongli@phusion.nl
+- semmons99+RubyMoney@gmail.com
 executables: []
 
 extensions: []
 
-extra_rdoc_files: 
-- CHANGELOG.rdoc
-- LICENSE
-- README.rdoc
+extra_rdoc_files: []
+
 files: 
-- .document
-- .gitignore
-- CHANGELOG.rdoc
-- LICENSE
-- README.rdoc
-- Rakefile
-- VERSION
-- lib/money.rb
 - lib/money/bank/base.rb
 - lib/money/bank/variable_exchange.rb
 - lib/money/core_extensions.rb
@@ -81,21 +82,17 @@ files:
 - lib/money/defaults.rb
 - lib/money/deprecations.rb
 - lib/money/money.rb
-- money.gemspec
-- spec/bank/base_spec.rb
-- spec/bank/variable_exchange_spec.rb
-- spec/core_extensions_spec.rb
-- spec/currency_spec.rb
-- spec/deprecations_spec.rb
-- spec/money_spec.rb
-- spec/spec_helper.rb
+- lib/money.rb
+- CHANGELOG.md
+- LICENSE
+- README.md
 has_rdoc: true
-homepage: http://money.rubyforge.org/
+homepage: http://money.rubyforge.org
 licenses: []
 
 post_install_message: 
-rdoc_options: 
-- --charset=UTF-8
+rdoc_options: []
+
 require_paths: 
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement 
@@ -110,26 +107,20 @@ required_ruby_version: !ruby/object:Gem::Requirement
 required_rubygems_version: !ruby/object:Gem::Requirement 
   none: false
   requirements: 
-  - - ">"
+  - - ">="
     - !ruby/object:Gem::Version 
-      hash: 25
+      hash: 21
       segments: 
       - 1
       - 3
-      - 1
-      version: 1.3.1
-requirements: []
-
+      - 7
+      version: 1.3.7
+requirements: 
+- json if you plan to import/export rates formatted as json
 rubyforge_project: money
 rubygems_version: 1.3.7
 signing_key: 
 specification_version: 3
-summary: Money and currency exchange support library
-test_files: 
-- spec/bank/base_spec.rb
-- spec/bank/variable_exchange_spec.rb
-- spec/core_extensions_spec.rb
-- spec/currency_spec.rb
-- spec/deprecations_spec.rb
-- spec/money_spec.rb
-- spec/spec_helper.rb
+summary: Money and currency exchange support library.
+test_files: []
+

data/.document

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

data/.gitignore

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

data/CHANGELOG.rdoc

@@ -1,68 +0,0 @@
-== Money 3.1.0.pre3
- * added google_currency.gem to list of Currency Exchange Implementations
- * updated HKD :subunit_to_unit from 10 to 100 (closes #20)
- * added #(export/import)_rates to Money::Bank::VariableExchange (closes #21)
-
-== Money 3.1.0.pre2
- * moved @rounding_method from Money::Bank::VariableExchange to
-   Money::Bank::Base (closes #18)
- * added #setup and call after #initialize in Money::Bank::Base (closes #19)
- * update/fix documentation (closes #17)
-
-== Money 3.1.0.pre1
- * Implemented Money::Bank::Base (closes #14)
- * Added Bank::Base#exchange_with
- * Deprecated Bank::Base#exchange (removal in 3.2.0)
- * Implented Money::Bank::VariableExchange
- * Deprecated Money::VariableExchangeBank (removal in 3.2.0)
- * Set Money::SYMBOLS, Money::SEPARATORS and Money::DELIMITERS
-   deprecation target to Money 3.2.0. (closes #16)
- * Fixed rounding error in Numeric#to_money (closes #15)
- * Implemented #has for Money and Money::Currency
- * Refactored test suite to conform to RSpec conventions
- * Moved project from github.com/FooBarWidget to github.com/RubyMoney
- * Added Simone Carletti to list of authors
-
-== Money 3.0.5
- * Added Money#abs
- * Updated Currency#subunit_to_unit documentation (it's an integer not a string)
- * Fixed issue when exchanging currencies with different :subunit_to_unit values
- * Added ability to pass a block to VariableExchangeBank#new or #exchange,
-   specifying a custom truncation method
- * Added optional currency argument to Numeric#to_money
- * Added optional currency argument to String#to_money
- * Numeric#to_money now respects :subunit_to_unit
- * Use '¤' as the default currency symbol
-
-== Money 3.0.4
- * Updated #exchange to avoid floating point rounding errors
- * Use :subunit_to_unit in #to_s, #to_f and #format
- * Added :separator and :delimiter to Currency
- * Deprecated Money#SEPARATORS and Money#DELIMITERS
- * Updated the attributes of the Chilean Peso
-
-== Money 3.0.3
- * Added #currency_as_string and #currency_as_string= for easier integration
-   with ActiveRecord/Rails
-
-== Money 3.0.2
- * Added #div, #divmod, #modulo, #% and #remainder methods
-
-== Money 3.0.1
- * Added #eql? method
- * Updated Numeric#to_money to work with all children of Numeric
-   (BigDecimal, Integer, Fixnum, etc)
-
-== Money 3.0.0
- * Version Bump due to compatibility changes with ActiveRecord. See
-   http://github.com/RubyMoney/money/issues#issue/4/comment/224880 for more information.
-
-== Money 2.3.0
- * Currency is now represented by a Currency Object instead of a string.
-
-== Money 2.2.0
- * Can now divide two Money objects by one another [#/]
- * Can now convert a Money object to a float [#to_f]
- * Users can now specify Seperators and Delimiters [#format]
- * Support for Brazilian Real [Money.new(1_00, :BRL)]
- * Migrated to Jeweler

data/README.rdoc

@@ -1,212 +0,0 @@
-= Introduction
-
-This library aids one in handling money and different currencies. Features:
-
-- Provides a <tt>Money</tt> class which encapsulates all information about an certain
-  amount of money, such as its value and its currency.
-- Provides a <tt>Money::Currency</tt> class which encapsulates all information about
-  a monetary unit.
-- Represents monetary values as integers, in cents. This avoids floating point
-  rounding errors.
-- Represents currency as <tt>Money::Currency</tt> instances providing an high level of flexibility.
-- Provides APIs for exchanging money from one currency to another.
-- Has the ability to parse a money and currency strings
-  into the corresponding Money/Currency object.
-
-Resources:
-
-- Website: http://money.rubyforge.org
-- RDoc API: http://money.rubyforge.org
-- Git repository: http://github.com/RubyMoney/money
-
-== Attention
-
-Starting in v3.1.0 we will be making two changes to the exchange process. First
-a new `Bank::Base` class will be available. This will allow users to more
-easily create custom `Bank` classes. Secondly the default `#exchange` method
-will be depreciated and a new `#exchange_with` method will be used. Currently
-`#exchange` passes the `cents` attribute. `#exchange_with` will pass the
-actual `Money` object instead.
-
-== Download
-
-Install stable releases with the following command:
-
-  gem install money
-
-The development version (hosted on Github) can be installed with:
-
-  git clone git://github.com/RubyMoney/money.git
-  cd money
-  rake install
-
-== Usage
-
-=== Synopsis
-
-  require 'money'
-  
-  # 10.00 USD
-  money = Money.new(1000, "USD")
-  money.cents     # => 1000
-  money.currency  # => Currency.new("USD")
-  
-  # Comparisons
-  Money.new(1000, "USD") == Money.new(1000, "USD")   # => true
-  Money.new(1000, "USD") == Money.new(100, "USD")    # => false
-  Money.new(1000, "USD") == Money.new(1000, "EUR")   # => false
-  Money.new(1000, "USD") != Money.new(1000, "EUR")   # => true
-  
-  # Arithmetic
-  Money.new(1000, "USD") + Money.new(500, "USD") == Money.new(1500, "USD")
-  Money.new(1000, "USD") - Money.new(200, "USD") == Money.new(800, "USD")
-  Money.new(1000, "USD") / 5                     == Money.new(200, "USD")
-  Money.new(1000, "USD") * 5                     == Money.new(5000, "USD")
-  
-  # Currency conversions
-  some_code_to_setup_exchange_rates
-  Money.new(1000, "USD").exchange_to("EUR")  == Money.new(some_value, "EUR")
-
-=== Currency
-
-Currencies are consistently represented as instances of <tt>Money::Currency</tt>.
-The most part of <tt>Money</tt> APIs allows you to supply either a <tt>String</tt> or a <tt>Money::Currency</tt>.
-
-  Money.new(1000, "USD") == Money.new(900, Currency.new("USD"))
-  Money.new(1000, "EUR").currency == Currency.new("EUR")
-
-A <tt>Money::Currency</tt> instance holds all the information about the currency, 
-including the currency symbol, name and much more.
-
-  currency = Money.new(1000, "USD").currency
-  currency.iso_code
-  # => "USD"
-  currency.name
-  # => "United States Dollar"
-
-To define a new <tt>Money::Currency</tt> simply add a new item to the <tt>Money::Currency::TABLE</tt> hash,
-where the key is the identifier for the currency object and the value is a hash
-containing all the currency attributes.
-
-  Money::Currency::TABLE[:usd] = {
-    :priority => 1,
-    :iso_code => "USD",
-    :name     => "United States Dollar",
-    :symbol   => "$",
-    :subunit  => "Cent"
-    :subunit_to_unit => 100,
-    :separator => ".",
-    :delimiter => ","
-  }
-
-The pre-defined set of attributes includes:
-
-- priority: a numerical value you can use to sort/group the currency list
-- iso_code: the international 3-letter code as defined by the ISO 4217 standard
-- name: the currency name
-- symbol: the currency symbol (UTF-8 encoded)
-- subunit: the name of the fractional monetary unit
-- subunit_to_unit: the proportion between the unit and the subunit
-- separator: character between the whole and fraction amounts
-- delimiter: character between each thousands place
-
-All attributes are optional. Some attributes, such as <tt>:symbol</tt>, are used by the Money class
-to print out a representation of the object. Other attributes, such as <tt>:name</tt> or <tt>:priority</tt>,
-exist to provide a basic API you can take advantage of to build your application.
-
-==== priority
-
-The priority attribute is an arbitrary numerical value you can assign to the <tt>Money::Currency</tt>
-and use in sorting/grouping operation.
-
-For instance, let's assume your Rails application needs to render a currency selector
-like the one available at http://finance.yahoo.com/currency-converter/
-You can create a couple of custom methods to return the list of major_currencies
-and all_currencies as follows:
-
-  # Returns an array of currency id where
-  # priority < 10
-  def major_currencies(hash)
-    hash.inject([]) do |array, (id, attributes)|
-      priority = attributes[:priority]
-      if priority && priority < 10
-        array[priority] ||= []
-        array[priority] << id
-      end
-      array
-    end.compact.flatten
-  end
-  
-  # Returns an array of all currency id
-  def all_currencies(hash)
-    hash.keys
-  end
-  
-  major_currencies(Money::Currency::TABLE)
-  # => [ :usd, :eur, :bgp, :cad ]
-  
-  all_currencies(Money::Currency::TABLE)
-  # => [ :aed, :afn, all, ... ]
-
-
-=== Default Currency
-
-By default <tt>Money</tt> defaults to USD as its currency. This can be overwritten using
-
-  Money.default_currency = Money::Currency.new("CAD")
-
-If you use Rails, then <tt>environment.rb</tt> is a very good place to put this. 
-
-=== Currency Exchange
-
-Exchanging money is performed through an exchange bank object. The default
-exchange bank object requires one to manually specify the exchange rate. Here's
-an example of how it works:
-
-  Money.add_rate("USD", "CAD", 1.24515)
-  Money.add_rate("CAD", "USD", 0.803115)
-  
-  Money.us_dollar(100).exchange_to("CAD")  # => Money.new(124, "CAD")
-  Money.ca_dollar(100).exchange_to("USD")  # => Money.new(80, "USD")
-
-Comparison and arithmetic operations work as expected:
-
-  Money.new(1000, "USD") <=> Money.new(900, "USD")   # => 1; 9.00 USD is smaller
-  Money.new(1000, "EUR") + Money.new(10, "EUR") == Money.new(1010, "EUR")
-  
-  Money.add_rate("USD", "EUR", 0.5)
-  Money.new(1000, "EUR") + Money.new(1000, "USD") == Money.new(1500, "EUR")
-
-There is nothing stopping you from creating bank objects which scrapes
-www.xe.com for the current rates or just returns <tt>rand(2)</tt>:
-
-  Money.default_bank = ExchangeBankWhichScrapesXeDotCom.new
-
-=== Currency Exchange (Money::Bank::*) Implementations
-
-The following is a list of Money.gem compatible currency exchange rate
-implementations.
-
-* eu_central_bank.gem: http://github.com/RubyMoney/eu_central_bank
-* google_currency.gem: http://github.com/RubyMoney/google_currency
-
-=== Ruby on Rails
-
-Use the +compose_of+ helper to let Active Record deal with embedding the money
-object in your models. The following example requires a +cents+ and a +currency+
-field.
-
-  composed_of :price,
-    :class_name => "Money",
-    :mapping => [%w(cents cents), %w(currency currency_as_string)],
-    :constructor => Proc.new { |cents, currency| Money.new(cents || 0, currency || Money.default_currency) }
-
-For Money 2.2.x and previous versions, simply use the following
-<tt>composed_of</tt> definition:
-
-  composed_of :price,
-    :class_name => "Money",
-    :mapping => [%w(cents cents), %w(currency currency)],
-    :constructor => Proc.new { |cents, currency| Money.new(cents || 0, currency || Money.default_currency) }
-
-For further details read the full discussion at http://github.com/RubyMoney/money/issues/4#comment_224880