Sha256: eadcd8ec1d1e5374cdf36a5bb139b04025bf3f1e3eac767e2e8e928756a3c623
Contents?: true
Size: 1.97 KB
Versions: 2
Compression:
Stored size: 1.97 KB
Contents
#simple_currency A really simple currency converter using XavierMedia API. Compatible with Ruby 1.8, 1.9, JRuby 1.5.3 and Rubinius 1.1. ##Notes Since version 1.2, simple_currency no longer uses Xurrency API in its background, due to restrictions on the number of daily requests. If you would like to use it, please use the [fork by Alfonso Jiménez](http://github.com/alfonsojimenez/simple_currency), author and maintainer of xurrency.com service. ##Usage Just require it and all your numeric stuff gets this fancy DSL for free: 30.eur.to_usd # => 38.08 150.eur.to_usd # => 190.4 239.usd.to_eur # => 187.98 # These don't even hit the Internets! # (They take advantage of Rails cache) 70.usd.to_chf # => 71.9 But what if you want to do the currency exchange according to a specific date in the past? Just do this: # You can use any time or date object 42.eur.at(1.year.ago).to_usd # => 60.12 42.eur.at(Time.parse('2009-09-01')).to_usd # => 60.12 You can also add an subtract money expressions, which will return a result converted to the former currency of the expression: 42.eur + 30.usd # => The same as adding 42 and 30.usd.to_eur 10.gbp + 1.eur # => The same as adding 10 and 1.eur.to_gbp ##Installation ###Rails 3 In your Gemfile: gem "simple_currency" ###Not using Rails? Then you have to manually install the gem: gem install simple_currency And manually require it as well: require "simple_currency" ##Note on Patches/Pull Requests * Fork the project. * Make your feature addition or bug fix. * Add specs 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) 2010 Codegram. See LICENSE for details.
Version data entries
2 entries across 2 versions & 1 rubygems
Version | Path |
---|---|
simple_currency-1.3.1 | README.md |
simple_currency-1.3.0 | README.md |