README.md in monetize-1.4.0 vs README.md in monetize-1.5.0

- old
+ new

@@ -1,13 +1,13 @@ # Monetize -[![Gem Version](https://badge.fury.io/rb/monetize.png)](http://badge.fury.io/rb/monetize) -[![Build Status](https://travis-ci.org/RubyMoney/monetize.png?branch=master)](https://travis-ci.org/RubyMoney/monetize) -[![Code Climate](https://codeclimate.com/github/RubyMoney/monetize.png)](https://codeclimate.com/github/RubyMoney/monetize) -[![Coverage Status](https://coveralls.io/repos/RubyMoney/monetize/badge.png)](https://coveralls.io/r/RubyMoney/monetize) -[![Dependency Status](https://gemnasium.com/RubyMoney/monetize.png)](https://gemnasium.com/RubyMoney/monetize) -[![License](http://img.shields.io/license/MIT.png?color=green)](http://opensource.org/licenses/MIT) +[![Gem Version](https://badge.fury.io/rb/monetize.svg)](http://badge.fury.io/rb/monetize) +[![Build Status](https://travis-ci.org/RubyMoney/monetize.svg?branch=master)](https://travis-ci.org/RubyMoney/monetize) +[![Code Climate](https://codeclimate.com/github/RubyMoney/monetize.svg)](https://codeclimate.com/github/RubyMoney/monetize) +[![Coverage Status](https://coveralls.io/repos/RubyMoney/monetize/badge.svg)](https://coveralls.io/r/RubyMoney/monetize) +[![Dependency Status](https://gemnasium.com/RubyMoney/monetize.svg)](https://gemnasium.com/RubyMoney/monetize) +[![License](https://img.shields.io/badge/license-MIT-green.svg)](http://opensource.org/licenses/MIT) A library for converting various objects into `Money` objects. ## Installation @@ -29,9 +29,19 @@ Monetize.parse("USD 100") == Money.new(100_00, "USD") Monetize.parse("EUR 100") == Money.new(100_00, "EUR") Monetize.parse("GBP 100") == Money.new(100_00, "GBP") "100".to_money == Money.new(100_00, "USD") +``` + +`parse` will return `nil` if it is unable to parse the input. Use `parse!` instead if you want a `Monetize::Error` (or one of the subclasses) to be raised instead: + +```ruby +>> Monetize.parse('OMG 100') +=> nil + +>> Monetize.parse!('OMG 100') +Monetize::ParseError: Unknown currency 'omg' ``` Optionally, enable the ability to assume the currency from a passed symbol. Otherwise, currency symbols will be ignored, and USD used as the default currency: ```ruby