papercavalier-money 3.7.1

data/CHANGELOG.md

@@ -0,0 +1,344 @@
+Money 3.7.0
+===========
+
+Features
+--------
+- add Money#to_d (thanks Andrew White)
+- Add Money.use_i18n, this allows you to enable/disable i18n from being used,
+  even if it's required in your app.
+
+Money 3.6.2
+===========
+
+Features
+--------
+- i18n enhancements (thanks eloyesp [link](https://github.com/RubyMoney/money/commit/b2cab76c78ae04f40251fa20c4ab18faa968dc53))
+- README updates (thanks pconnor)
+- Break into modules
+- Added `:no_cents_if_whole` format option
+- Update HKD from Ho to Cent
+- Performance improvements (thanks weppos)
+- Added Symbol#to_currency
+- Added Gemfile for development
+- Updated HUF currency to use `symbol_first => false`
+- Updated "Turkish New Lira" to "Turkish Lira"
+
+Money 3.6.1
+===========
+
+Bugfixes
+--------
+ - Floating point comparison needs to Epsilon aware (thanks Tobias Luetke)
+ - reimplement fix for #issue/43, enable Marshal.(load/dump)
+
+Money 3.6.0
+===========
+
+Features
+--------
+ - Add a symbol position option for Money#format (thanks Romain, Gil and
+   Julien)
+ - Updated CNY to use "Fen" and subunit_to_unit of 100
+ - Updates to work with gem-testers.org
+
+Bugfixes
+--------
+ - Fixed issue with #format(:no_cents => true) (thanks Romain & Julien)
+
+Money 3.5.5
+===========
+
+Features
+--------
+ - Enhancements to Money::Currency (thanks Matthew McEachen)
+   - Replace delimiter with thousands_separator
+   - Replace separator with decimal_mark
+   - Added symbol_first and html_entity
+ - Added allocation algorithm for fair(ish) splitting of money between parties
+   without loosing pennies (thanks Tobias Luetke)
+
+Bugfixes
+--------
+ - Always store cents as an Integer (thanks Abhay Kumar)
+ - Fixed TypeError in rate exchange (thanks Christian Billen)
+ - Cleanup #parse (thanks Tom Lianza)
+
+Money 3.5.4
+===========
+
+Features
+--------
+ - Added Currency#decimal_places.
+
+Bugfixes
+--------
+ - Fixed error with Money#to_s error with negative amounts that are only cents.
+
+Money 3.5.3
+===========
+
+Bugfixes
+--------
+ - Fixed an error in #to_s when cents is negative
+
+Money 3.5.2
+===========
+
+Bugfixes
+--------
+ - Fixed an error in #to_s which appended extra 0s incorrectly
+
+Money 3.5.1
+===========
+
+Bugfixes
+--------
+ - Removed erroneous require.
+
+Money 3.5.0
+===========
+
+Features
+--------
+ - Updated to RSpec2.
+ - Use i18n to lookup separator and delimiter signs.
+ - Removed all deprecated methods up to v3.5.0, including the following:
+   - Using Money#format with params instead of a Hash.
+   - Using a Hash with Money#new.
+   - Using Bank#exchange, use Bank#exchange_with instead.
+
+Bugfixes
+--------
+ - Updated Money#to_s to respect :separator and :subunit_to_unit.
+ - Fixed Money#format for :subunit_to_unit != 100.
+   ([#issue/37](http://github.com/RubyMoney/money/issue/37))
+ - Fixed String#to_money for :subunit_to_unit != 100.
+   ([#issue/36](http://github.com/RubyMoney/money/issue/36))
+ - Removed duplicate currencies.
+   ([#issue/38](http://github.com/RubyMoney/money/issue/38))
+ - Fixed issue related to JRuby returning 2 for Math.log10(1000).floor instead
+   of correctly returning 3.
+
+Money 3.1.5
+===========
+
+Features
+--------
+ - Added support for creating objects with the main monetary unit instead of
+   cents.
+   ([#issue/25](http://github.com/RubyMoney/money/issues/25))
+ - Deprecated `Money#format` with separate params instead of Hash. Deprecation
+   target set to Money 3.5.0.
+   ([#issue/31](http://github.com/RubyMoney/money/issues/31))
+ - Deprecated `Money#new(0, :currency => "EUR")` in favor of
+   `Money#new(0, "EUR")`. Deprecation target set to Money 3.5.0.
+   ([#issue/31](http://github.com/RubyMoney/money/issues/31))
+ - Throw ArgumentError when trying to multiply two Money objects together.
+   ([#issue/29](http://github.com/RubyMoney/money/issues/29))
+ - Update Money#parse to use :subunit_to_unit
+   ([#issue/30](http://github.com/RubyMoney/money/issues/30))
+
+Bugfixes
+--------
+ - Downgraded required_rubygems_version to >= 1.3.6.
+   ([#issue/26](http://github.com/RubyMoney/money/issues/26))
+ - Use BigDecimal when floating point calculations are needed.
+ - Ruby 1.9.2 compatibility enhancements.
+
+
+Money 3.1.0
+===========
+
+Features
+--------
+ - Implemented `Money::Bank::Base`.
+   ([#issue/14](http://github.com/RubyMoney/money/issues/14))
+ - Added `Money::Bank::Base#exchange_with`.
+ - Deprecated `Money::Bank::Base#exchange`. Deprecation target set to Money
+   3.2.0.
+ - Implented `Money::Bank::VariableExchange`
+ - Deprecated `Money::VariableExchangeBank`. Deprecation target set to Money
+   3.2.0.
+ - Deprecate `Money::SYMBOLS`, `Money::SEPARATORS` and `Money::DELIMITERS`.
+   Deprecation target set to Money 3.2.0.
+   ([#issue/16](http://github.com/RubyMoney/money/issues/16))
+ - Implemented `#has` for `Money` and `Money::Currency`.
+ - Refactored test suite to conform to RSpec conventions.
+ - Moved project from [FooBarWidget](http://github.com/FooBarWidget) to
+   [RubyMoney](http://github.com/RubyMoney)
+ - Added Simone Carletti to list of authors.
+ - Moved `@rounding_method` from `Money::Bank::VariableExchange` to
+   `Money::Bank::Base`.
+   ([#issue/18](http://github.com/RubyMoney/money/issues/18))
+ - Added `#setup` to `Money::Bank::Base`. Called from `#initialize`.
+   ([#issue/19](http://github.com/RubyMoney/money/issues/19))
+ - Added [google_currency](http://github.com/RubyMoney/google_currency) to list
+   of Currency Exchange Implementations.
+ - Added `#export_rates` to `Money::Bank::VariableExchange`.
+   ([#issue/21](http://github.com/RubyMoney/money/issues/21))
+ - Added `#import_rates` to `Money::Bank::VariableExchange`.
+   ([#issue/21](http://github.com/RubyMoney/money/issues/21))
+ - Removed dependency on Jeweler.
+ - Replaced usage of hanna with yardoc.
+ - Rewrote/reformatted all documentation.
+
+Bugfixes
+--------
+ - Fixed incorrect URLs in documentation.
+   ([#issue/17](http://github.com/RubyMoney/money/issues/17))
+ - Updated `:subunit_to_unit` for HKD from 10 to 100.
+   ([#issue/20](http://github.com/RubyMoney/money/issues/20))
+ - Updated Ghanaian Cedi to use correct ISO Code, GHS.
+   ([#issue/22](http://github.com/RubyMoney/money/issues/22))
+ - Make `default` rake task call `spec`.
+   ([#issue/23](http://github.com/RubyMoney/money/issues/23))
+
+Money 3.1.0.pre3
+================
+
+Features
+--------
+ - Added [google_currency](http://github.com/RubyMoney/google_currency) to list
+   of Currency Exchange Implementations.
+ - Added `#export_rates` to `Money::Bank::VariableExchange`.
+   ([#issue/21](http://github.com/RubyMoney/money/issues/21))
+ - Added `#import_rates` to `Money::Bank::VariableExchange`.
+   ([#issue/21](http://github.com/RubyMoney/money/issues/21))
+
+Bugfixes
+--------
+ - Updated `:subunit_to_unit` for HKD from 10 to 100.
+   ([#issue/20](http://github.com/RubyMoney/money/issues/20))
+
+Money 3.1.0.pre2
+================
+
+Features
+--------
+ - Moved `@rounding_method` from `Money::Bank::VariableExchange` to
+   `Money::Bank::Base`.
+   ([#issue/18](http://github.com/RubyMoney/money/issues/18))
+ - Added `#setup` to `Money::Bank::Base`. Called from `#initialize`.
+   ([#issue/19](http://github.com/RubyMoney/money/issues/19))
+
+Bugfixes
+--------
+ - Fixed incorrect URLs in documentation.
+   ([#issue/17](http://github.com/RubyMoney/money/issues/17))
+
+Money 3.1.0.pre1
+================
+
+Features
+--------
+ - Implemented `Money::Bank::Base`.
+   ([#issue/14](http://github.com/RubyMoney/money/issues/14))
+ - Added `Money::Bank::Base#exchange_with`.
+ - Deprecated `Money::Bank::Base#exchange`. Deprecation target set to Money
+   3.2.0.
+ - Implented `Money::Bank::VariableExchange`
+ - Deprecated `Money::VariableExchangeBank`. Deprecation target set to Money
+   3.2.0.
+ - Deprecate `Money::SYMBOLS`, `Money::SEPARATORS` and `Money::DELIMITERS`.
+   Deprecation target set to Money 3.2.0.
+   ([#issue/16](http://github.com/RubyMoney/money/issues/16))
+ - Implemented `#has` for `Money` and `Money::Currency`.
+ - Refactored test suite to conform to RSpec conventions.
+ - Moved project from [FooBarWidget](http://github.com/FooBarWidget) to
+   [RubyMoney](http://github.com/RubyMoney)
+ - Added Simone Carletti to list of authors.
+
+Bugfixes
+--------
+ - Fixed rounding error in `Numeric#to_money`.
+   ([#issue/15](http://github.com/RubyMoney/money/issues/15))
+
+Money 3.0.5
+===========
+
+Features
+--------
+ - Added `Money#abs`.
+ - Added ability to pass a block to `VariableExchangeBank#new` or `#exchange`,
+   specifying a custom truncation method
+ - Added optional `currency` argument to` Numeric#to_money`.
+   ([#issue/11](http://github.com/RubyMoney/money/issues/11))
+ - Added optional `currency` argument to `String#to_money`.
+   ([#issue/11](http://github.com/RubyMoney/money/issues/11))
+ - Use '¤' as the default currency symbol.
+   ([#issue/10](http://github.com/RubyMoney/money/issues/10))
+
+Bugfixes
+--------
+ - Updated `Currency#subunit_to_unit` documentation (it's an integer not a
+   string).
+ - Fixed issue when exchanging currencies with different `:subunit_to_unit`
+   values.
+ - `Numeric#to_money` now respects `:subunit_to_unit`.
+   ([#issue/12](http://github.com/RubyMoney/money/issues/12))
+
+Money 3.0.4
+===========
+
+Features
+--------
+ - Use `:subunit_to_unit` in `#to_s`, `#to_f` and `#format`.
+ - Deprecated `Money#SEPARATORS` and `Money#DELIMITERS`.
+
+Bugfixes
+--------
+ - Updated `#exchange` to avoid floating point rounding errors.
+ - Added `:separator` and `:delimiter` to `Currency`
+ - Updated the attributes of the Chilean Peso.
+
+Money 3.0.3
+===========
+
+Features
+--------
+ - Added `#currency_as_string` and `#currency_as_string=` for easier
+   integration with ActiveRecord/Rails
+
+Money 3.0.2
+===========
+
+Features
+--------
+ - Added `#div`, `#divmod`, `#modulo`, `#%` and `#remainder` to `Money`.
+
+Money 3.0.1
+===========
+
+Features
+--------
+ - Added `#eql?` to `Money`
+ - Updated `Numeric#to_money` to work with all children of `Numeric` (i.e.
+   `BigDecimal`, `Integer`, `Fixnum`, `Float`, etc)
+
+Money 3.0.0
+===========
+
+Features
+--------
+ - Version Bump due to compatibility changes with ActiveRecord. See
+   conversation
+   [here](http://github.com/RubyMoney/money/issues#issue/4/comment/224880)
+   for more information.
+
+Money 2.3.0
+===========
+
+Features
+--------
+ - Currency is now represented by a `Currency` Object instead of a `String`.
+
+Money 2.2.0
+===========
+
+Features
+--------
+ - Can now divide two Money objects by one another using `#/`.
+ - Can now convert a Money object to a float using `#to_f`.
+ - Users can now specify Separators and Delimiters when using `#format`.
+ - Support for Brazilian Real `Money.new(1_00, :BRL)`
+ - Migrated to Jeweler

data/LICENSE

@@ -0,0 +1,21 @@
+Copyright (c) 2005 Tobias Lutke
+Copyright (c) 2008 Phusion
+
+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.md

@@ -0,0 +1,214 @@
+# RubyMoney - Money
+
+## Introduction
+
+This library aids one in handling money and different currencies.
+
+### Features
+
+- Provides a `Money` class which encapsulates all information about an certain
+  amount of money, such as its value and its currency.
+- Provides a `Money::Currency` 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 `Money::Currency` 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)
+- [API Documentation](http://money.rubyforge.org)
+- [Git Repository](http://github.com/RubyMoney/money)
+
+## Downloading
+
+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
+
+    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 `Money::Currency`.
+The most part of `Money` APIs allows you to supply either a `String` or a
+`Money::Currency`.
+
+    Money.new(1000, "USD") == Money.new(900, Currency.new("USD"))
+    Money.new(1000, "EUR").currency == Currency.new("EUR")
+
+A `Money::Currency` 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 `Money::Currency` simply add a new item to the
+`Money::Currency::TABLE` 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 `:symbol`, are used by
+the Money class to print out a representation of the object. Other attributes,
+such as `:name` or `:priority`, 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
+`Money::Currency` and use in sorting/grouping operation.
+
+For instance, let's assume your Rails application needs to render a currency
+selector like the one available
+[here](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 `Money` defaults to USD as its currency. This can be overwritten
+using:
+
+    Money.default_currency = Money::Currency.new("CAD")
+
+If you use Rails, then `environment.rb` 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
+[XE](http://www.xe.com) for the current rates or just returns `rand(2)`:
+
+    Money.default_bank = ExchangeBankWhichScrapesXeDotCom.new
+
+### Implementations
+
+The following is a list of Money.gem compatible currency exchange rate
+implementations.
+
+- [eu_central_bank](http://github.com/RubyMoney/eu_central_bank)
+- [google_currency](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 2 columns:
+
+    :price_cents, :integer, :default => 0, :null => false
+    :currency, :string
+
+Then in your model file:
+
+    composed_of :price,
+      :class_name => "Money",
+      :mapping => [%w(price_cents cents), %w(currency currency_as_string)],
+      :constructor => Proc.new { |cents, currency| Money.new(cents || 0, currency || Money.default_currency) },
+      :converter => Proc.new { |value| value.respond_to?(:to_money) ? value.to_money : raise(ArgumentError, "Can't convert #{value.class} to Money") }
+
+
+For Money 2.2.x and previous versions, simply use the following `composed_of`
+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
+[here](http://github.com/RubyMoney/money/issues/4#comment_224880).