money_helper 1.0.0 → 3.0.0

checksums.yaml

@@ -1,15 +1,7 @@
 ---
-!binary "U0hBMQ==":
-  metadata.gz: !binary |-
-    ZWIyMmI3OTU3NmUxMjQ2OTBhMDMwMWE3OGI0YTZmYWNlMWIxM2I5MA==
-  data.tar.gz: !binary |-
-    MGFjMWQ5MTRlMzVkYWRjMTA0ZGI1NDQxNjk3NzUzNDRjZWEzM2ZmOA==
+SHA256:
+  metadata.gz: 8fc38d5c4921667c0f06286f5058378d60658b3f991dd7a343f5ab597384560c
+  data.tar.gz: c88db16a193d5674d9f902466aace23c8b7b1a0f71b89733589a05be7059049b
 SHA512:
-  metadata.gz: !binary |-
-    OWIzN2QxZDUwOTMyNWFiMTZmZTdhNzIwZDMwZDBkMmJmMWMzMjQ5YjNiMGE4
-    YzgxYWRlN2YyMGYyODJkNDI4NmI4ZjliZmM4MTM0ZTMzYTc1MWRjOWFlOTE4
-    YmJiY2NiMmU4YzFhM2JlNjM0M2EyYzE2ZGI3MmIzY2YwOGQ3MDA=
-  data.tar.gz: !binary |-
-    ZTVkOWYyZDMzOWM1NmY5NDc1MTRlYmFkNDIwNjk3N2VkNDUwNDI5YWZkZGVi
-    NTAzM2ZhYmQzZWJmNDA3YTllYTg5ZTg1MDcwYjQ0ZmY2MjJlMmI2MGEyMTFj
-    M2NlMjllZDczMDgxZWE2NDhiMzMwYTc0MGZmMzYxMzlhYTUzMDU=
+  metadata.gz: 1c258cca4d8ac444695faedd9245d1f805bcb5534bcf6f864dffdcfe330bf8f54f6c10caf800e32c1c2621bc523f6277acde3821a16c6a11edf31b777cdbdc6b
+  data.tar.gz: 8133b959081243c17b6d160ec72a802ed79648989c60ebaca8546a8509cc145b1148f89de4cc1e4ee89cc51459cc0e54fcf58f29a7d5fd412b4f1a93a85744fa

data/.circleci/config.yml

@@ -0,0 +1,45 @@
+version: 2.1
+
+references:
+  set_env: &set_env
+    run:
+      name: Set up environment
+      command: |
+        echo "export BUNDLE_GEMFILE=$(pwd)/gemfiles/activesupport_$ACTIVESUPPORT_VERSION.gemfile" >> $BASH_ENV
+  bundle: &bundle
+    run:
+      name: Install dependencies
+      command: bundle install
+  test: &test
+    run:
+      name: Run test suite
+      command: bundle exec rake
+
+jobs:
+  test:
+    docker:
+      - image: "cimg/ruby:<< parameters.ruby_version >>"
+    parameters:
+      ruby_version:
+        type: string
+      activesupport_version:
+        type: string
+    environment:
+      ACTIVESUPPORT_VERSION: << parameters.activesupport_version >>
+    steps:
+      - checkout
+      - <<: *set_env
+      - <<: *bundle
+      - <<: *test
+
+workflows:
+  default:
+    jobs:
+      - test:
+          matrix:
+            parameters:
+              ruby_version: ["2.6", "2.7", "3.0"]
+              activesupport_version: ["52", "60", "61", "edge"]
+            exclude:
+              - ruby_version: "2.6"
+                activesupport_version: "edge"

data/.gitignore

@@ -0,0 +1,6 @@
+Gemfile.lock
+gemfiles/*.lock
+gemfiles/.bundle
+gemfiles/vendor
+pkg
+.DS_Store

data/.rubocop.yml

@@ -0,0 +1,23 @@
+inherit_from: .rubocop_todo.yml
+
+AllCops:
+  Exclude:
+    - vendor/**/*
+    - gemfiles/vendor/**/*
+  NewCops: enable
+  SuggestExtensions: false
+
+Layout/LineLength:
+  Max: 512
+
+Metrics:
+  Enabled: false
+
+Style/Documentation:
+  Enabled: false
+
+Naming/MethodName:
+  Enabled: false
+
+Style/AsciiComments:
+  Enabled: false

data/.rubocop_todo.yml

@@ -0,0 +1,14 @@
+# This configuration was generated by
+# `rubocop --auto-gen-config`
+# on 2021-09-21 17:26:48 UTC using RuboCop version 1.21.0.
+# The point is for the user to remove these configuration records
+# one by one as the offenses are removed from the code base.
+# Note that changes in the inspected code, or installation of new
+# versions of RuboCop, may require this file to be generated again.
+
+# Offense count: 1
+# Configuration parameters: Include.
+# Include: **/*.gemspec
+Gemspec/RequiredRubyVersion:
+  Exclude:
+    - 'money_helper.gemspec'

data/Appraisals

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+appraise 'activesupport_52' do
+  gem 'activesupport', '~> 5.2.6'
+end
+
+appraise 'activesupport_60' do
+  gem 'activesupport', '~> 6.0.4'
+end
+
+appraise 'activesupport_61' do
+  gem 'activesupport', '~> 6.1.4'
+end
+
+appraise 'activesupport_edge' do
+  git 'git://github.com/rails/rails.git' do
+    gem 'activesupport', require: 'active_support'
+  end
+end

data/CHANGELOG.md

@@ -0,0 +1,50 @@
+### 3.0.0 (Next)
+
+* [#27](https://github.com/artsy/money_helper/pull/27): Update `money_to_text` to pass `format` options to `Money#format` for additional features such as `no_cents` - [@agrberg](https://github.com/agrberg).
+* Your contribution here.
+
+### 2.0.0 (2021-09-20)
+
+#### Breaking Changes
+
+* [#20](https://github.com/artsy/money_helper/pull/20): Update `money_to_text` and `money_range_to_text` to expect amounts in minor unit and simplify formatting; drop support for Ruby 2.3 and 2.4 - [@starsirius](https://github.com/starsirius)
+
+### 1.0.2 (2019-04-19)
+
+* [#16](https://github.com/artsy/money_helper/pull/16): Remove deprecation warnings - [@sweir27](https://github.com/sweir27).
+* [#15](https://github.com/artsy/money_helper/pull/15): Added Rubocop - [@dblock](https://github.com/dblock).
+
+### 1.0.1 (2017-04-03)
+
+* Relaxed activesupport version dependency - [@dblock](https://github.com/dblock).
+* The `money_to_text` method now takes options - [@mzikherman](https://github.com/mzikherman).
+* Added `symbol_with_optional_iso_code` - [@mzikherman](https://github.com/mzikherman).
+
+### 1.0.0 (2015-03-07)
+
+* Added compatibility with Money 6.5.1+, including new currency symbols - [@syakhmi](https://github.com/syakhmi).
+
+### 0.0.5 (2014-04-12)
+
+* Added compatibility with Money 6.1+ - [@syakhmi](https://github.com/syakhmi).
+* Dropped support for pre 6.0 versions of Money - [@syakhmi](https://github.com/syakhmi).
+
+### 0.0.4 (2014-01-08)
+
+* Added compatibility with Money 6.x - [@dblock](https://github.com/dblock).
+* Avoid failing on deprecated currencies (such as ITL) - [@joeyAghion](https://github.com/joeyAghion).
+
+### 0.0.3 (2013-07-17)
+
+* Added support for currencies that don't have a symbol, eg. Uzbekistan Som (UZS) - [@dblock](https://github.com/dblock).
+
+### 0.0.2 (2013-07-16)
+
+* Added unit tests - [@syakhmi](https://github.com/syakhmi).
+* Added support for Cambodian riel - [@syakhmi](https://github.com/syakhmi).
+* Added dependencies to gemspec - [@syakhmi](https://github.com/syakhmi).
+* Now defaults to USD when currency not specified - [@syakhmi](https://github.com/syakhmi).
+
+### 0.0.1 (2013-07-12)
+
+* Initial public release - [@syakhmi](https://github.com/syakhmi).

data/Gemfile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+source 'http://rubygems.org'
+
+gemspec
+
+# pinned so that the lock files stay in sync
+gem 'rubocop', '1.21.0'

data/LICENSE.md

@@ -0,0 +1,20 @@
+The MIT License (MIT)
+
+Copyright (c) 2013-2018 Artsy, Sahil Yakhmi, Joey Aghion, and contributors.
+
+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,49 @@
+MoneyHelper [![CircleCI][ci_badge]][circleci]
+============
+
+A simple module to assist in formatting unambiguous prices and price ranges in international currencies in a Roman Script environment.
+
+Usage
+-----
+
+Examples:
+
+``` ruby
+money_to_text(10000, currency: 'AUD')
+#=> 'AUD $100.00'
+
+money_to_text(10000, currency: 'AUD', with_currency: false, with_symbol: false)
+#=> '100.00'
+
+money_range_to_text(10000, 40000, currency: 'AUD')
+#=> 'AUD $100.00 - 400.00'
+
+money_range_to_text(10000, 40000, currency: 'AUD', delimiter: ' ... ')
+#=> 'AUD $100.00 ... 400.00'
+```
+
+Defaults
+--------
+
+As of [#16][#16] this library explicitly specifies the `Money.locale_backend = :currency` default.
+
+Contributing
+------------
+
+Fork the project. Make your feature addition or bug fix with tests. Send a pull request.
+
+Copyright and License
+---------------------
+
+MIT License, see [LICENSE][license] for details.
+
+(c) 2013-2018 [Artsy][artsy], [Sahil Yakhmi][sahil_yakhmi], [Joey Aghion][joey_aghion] and [contributors][contributors].
+
+[ci_badge]: https://circleci.com/gh/artsy/money_helper/tree/main.svg?style=svg
+[circleci]: https://circleci.com/gh/artsy/money_helper/tree/main
+[#16]: https://github.com/artsy/money_helper/pull/16
+[license]: LICENSE.md
+[artsy]: https://github.com/artsy
+[sahil_yakhmi]: https://github.com/syakhmi
+[joey_aghion]: https://github.com/joeyAghion
+[contributors]: CHANGELOG.md

data/RELEASING.md

@@ -0,0 +1,65 @@
+# Releasing money_helper
+
+There are no hard rules about when to release money_helper. Release bug fixes frequently, features not so frequently and breaking API changes rarely.
+
+### Release
+
+Run tests, check that all tests succeed locally.
+
+```
+bundle install
+rake
+```
+
+Check that the last build succeeded on [CI][ci] for all supported platforms.
+
+Change "Next" in [CHANGELOG.md][changelog] to the current date.
+
+```
+### 0.2.2 (2015/7/10)
+```
+
+Remove the line with "Your contribution here.", since there will be no more contributions to this release.
+
+Commit your changes.
+
+```
+git add CHANGELOG.md
+git commit -m "Preparing for release, 0.2.2."
+git push origin master
+```
+
+Release.
+
+```
+$ rake release
+
+money_helper 0.2.2 built to pkg/money_helper-0.2.2.gem.
+Tagged v0.2.2.
+Pushed git commits and tags.
+Pushed money_helper 0.2.2 to rubygems.org.
+```
+
+### Prepare for the Next Version
+
+Add the next release to [CHANGELOG.md][changelog].
+
+```
+### 0.2.3 (Next)
+
+* Your contribution here.
+```
+
+Increment the third version number in [lib/version.rb][version].
+
+Commit your changes.
+
+```
+git add CHANGELOG.md lib/version.rb
+git commit -m "Preparing for next development iteration, 0.2.3."
+git push origin master
+```
+
+[ci]: https://circleci.com/gh/artsy/money_helper/tree/master
+[changelog]: CHANGELOG.md
+[version]: lib/version.rb

data/Rakefile

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+require 'rubygems'
+require 'bundler'
+require 'bundler/gem_tasks'
+
+Bundler.setup :default, :development
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+
+require 'rubocop/rake_task'
+RuboCop::RakeTask.new
+
+task default: %i[rubocop spec]

data/UPGRADING.md

@@ -0,0 +1,44 @@
+Upgrading MoneyHelper
+=====================
+
+### Upgrading to >= 3.0.0
+
+#### `money_to_text` format options
+
+Prior to 3.0.0 `money_to_text` took a named argument `with_symbol`. The default value was `true` and assing `false` would omit the currency symbol.
+
+This data was later passed to the `Money#format` method with a default `format` string of `'%u%n'`. Users of `MoneyHelper` could not modify the format string or utilize additional format options, such as `no_cents: false`.
+
+In 3.0.0 this was changed so `money_to_text` can take an optional `format` argument which is eventually passed to `Money#format` with only the slight modification of adding in `format: '%u%n'` if this key is not present.
+
+### Upgrading to >= 2.0.0
+
+#### `money_to_text` amount is now given in minor units
+
+Prior to 2.0.0 `money_to_text` took an amount in a currency's major units and converted this value internally before passing to `Money#new` which expects values in their minor unit (i.e. For USD the major unit is Dollars and the minor unit is Cents). This version removes the autoscaling so `money_to_text` can take amounts in their minor units.
+
+Additionally, `currency`, `number_only`, and `options` were removed as postional arguments and replaced with named arguments `currency`, `with_currency`, and `with_symbol` with `'USD'`, `true` and `true` as their default arguments respectively.
+
+One minor difference is that `currency` can be omited completely where as in < 2.0.0 `''` or `nil` was required to be passed for the default of `'USD'` to be used.
+
+Finally the automatic omission of certain currency codes (USD, GBP, EUR, and MYR) is no longer supported. To replicate this behavior you must explicitly specify `with_currency: false`.
+
+The following illustrates the primary difference in usage.
+
+```ruby
+# Before 2.0.0
+
+MoneyHelper.money_to_text(123, 'USD')
+# => $123
+
+# After 2.0.0
+
+MoneyHelper.money_to_text(123) # `currency: 'USD'` is the default
+# => USD $1.23
+
+# to replicate previous behavior almost exactly
+MoneyHelper.money_to_text(12300, with_currency: false)
+# => $123.00
+
+# Note the inclusion of the cents. The ability to remove this was added in 3.0.0 as another breaking change
+```

data/gemfiles/activesupport_52.gemfile

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+# This file was generated by Appraisal
+
+source 'http://rubygems.org'
+
+gem 'activesupport', '~> 5.2.6'
+gem 'rubocop', '1.21.0'
+
+gemspec path: '../'

data/gemfiles/activesupport_60.gemfile

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+# This file was generated by Appraisal
+
+source 'http://rubygems.org'
+
+gem 'activesupport', '~> 6.0.4'
+gem 'rubocop', '1.21.0'
+
+gemspec path: '../'

data/gemfiles/activesupport_61.gemfile

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+# This file was generated by Appraisal
+
+source 'http://rubygems.org'
+
+gem 'activesupport', '~> 6.1.4'
+gem 'rubocop', '1.21.0'
+
+gemspec path: '../'

data/gemfiles/activesupport_edge.gemfile

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+# This file was generated by Appraisal
+
+source 'http://rubygems.org'
+
+git 'git://github.com/rails/rails.git' do
+  gem 'activesupport', require: 'active_support'
+end
+
+gem 'rubocop', '1.21.0'
+
+gemspec path: '../'

data/lib/money_helper.rb

@@ -1,15 +1,18 @@
-# encoding: UTF-8
+# frozen_string_literal: true
+
+require_relative 'version'
 
 require 'active_support/core_ext/object/blank'
 require 'money'
 
 module MoneyHelper
+  Money.locale_backend = :currency
   I18n.enforce_available_locales = false
 
-  SYMBOL_ONLY = %w{USD GBP EUR MYR} #don't use ISO code
-  OK_SYMBOLS = %w{
+  SYMBOL_ONLY = %w[USD GBP EUR MYR].freeze # don't use ISO code
+  OK_SYMBOLS = %w[
     $ £ € ¥ 元 р. L ƒ ৳ P R$ K ₡ D ლ ₵ Q G ₹ Rp ₪ ₩ ₭ R RM ₨ ₮ դր. C$ ₦ ₲ ₱ T ฿ T$ m ₴ ₫ ៛ ₺ E ₽
-  } #ok to include in string
+  ].freeze # ok to include in string
 
   ##
   # Formats a single amount in the given currency into a price string. Defaults to USD if currency not
@@ -17,27 +20,38 @@ module MoneyHelper
   #
   # = Example
   #
-  #   $10,000; HKD $10,000 for (10000, "USD") and (10000, "HKD"), respectively
+  #   MoneyHelper.money_to_text(30_175_93, currency: 'USD')  #=> 'USD $30,175.93'
+  #   MoneyHelper.money_to_text(30_175_93, currency: 'EUR')  #=> 'EUR €30.175,93'
+  #   MoneyHelper.money_to_text(30_175_93)                   #=> 'USD $30,175.93'
   #
   # = Arguments
   #
-  #   amount: (Float)
-  #   currency: (String)
-  #   number_only: (Boolean) optional flag to exclude currency indicators (retains number formatting
-  #     specific to currency)
-  def self.money_to_text(amount, currency, number_only = false)
-    return nil unless amount.present?
-    currency = "USD" if currency.blank?
-    valid_currency = code_valid?(currency) ? currency : "USD"
+  #   amount_minor: (Integer) amount in minor unit
+  #   currency: (String) optional ISO currency code, defaulting to USD
+  #   with_currency: (Boolean) optional flag to include ISO currency code, defaulting to true
+  # 　format: (Hash) optional formatting options to pass to `Money#format` e.g.:
+  #     no_cents: (Boolean) optional flag to exclude cents, defaulting to false
+  #     symbol: (Boolean) optional flag to include currency symbol, defaulting to true
+  def self.money_to_text(amount_minor, currency: 'USD', with_currency: true, format: {})
+    return '' if amount_minor.blank?
+
+    format_options = { format: '%u%n' }.merge(format)
+
+    formatted_amount = Money.new(amount_minor, currency).format(format_options)
+    formatted_currency = with_currency ? currency.upcase : ''
+
+    "#{formatted_currency} #{formatted_amount}".strip
+  end
+
+  def self.symbol_with_optional_iso_code(currency = 'USD')
     symbol = symbol_for_code(currency)
-    include_symbol = !number_only && symbol.present? && OK_SYMBOLS.include?(symbol)
-    subunit_factor = Money::Currency.new(valid_currency).subunit_to_unit
-    (number_only || SYMBOL_ONLY.include?(currency) ? "" : currency + " ") +
-      Money.new(amount*subunit_factor.ceil, valid_currency).format({
-        no_cents: true,
-        symbol_position: :before,
-        symbol: include_symbol
-      }).delete(' ')
+    if SYMBOL_ONLY.include?(currency)
+      symbol
+    elsif symbol && OK_SYMBOLS.include?(symbol)
+      "#{iso_for_currency(currency)} #{symbol}"
+    else
+      iso_for_currency(currency).to_s
+    end
   end
 
   ##
@@ -45,42 +59,50 @@ module MoneyHelper
   #
   # = Example
   #
-  #   $10,000 - 20,000 for (10000, 20000, "USD")
-  #   HKD $10,000 - 20,000 for (10000, 20000, "HKD")
-  #   $10,000 ... 20,000 for (10000, 20000, "USD", " ... ")
-  #   HKD $10,000 ... 20,000 for (10000, 20000, "HKD", " ... ")
+  #   MoneyHelper.money_range_to_text(30_175_93, 40_983_27, currency: 'USD')     #=> 'USD $30,175.93 - 40,983.27'
+  #   MoneyHelper.money_range_to_text(30_175_93, 40_983_27)                      #=> 'USD $30,175.93 - 40,983.27'
+  #   MoneyHelper.money_range_to_text(30_175_93, 40_983_27, currency: 'EUR')     #=> 'EUR €30.175,93 - 40.983,27'
+  #   MoneyHelper.money_range_to_text(30_175_93, 40_983_27, delimiter: ' ... ')  #=> 'USD $30,175.93 ... 40,983.27'
   #
   # = Arguments
   #
-  #   low: (Float)
-  #   high: (Float)
-  #   currency: (String)
+  #   low: (Integer) amount in minor unit
+  #   high: (Integer) amount in minor unit
+  #   currency: (String) optional ISO currency code, defaulting to USD
   #   delimiter: (String) optional
-  def self.money_range_to_text(low, high, currency, delimiter = ' - ')
+  def self.money_range_to_text(low, high, currency: 'USD', delimiter: ' - ')
     if low.blank? && high.blank?
-      nil
+      ''
     elsif low.blank?
-      "Under " + money_to_text(high, currency)
+      "Under #{money_to_text(high, currency: currency)}"
     elsif high.blank?
-      money_to_text(low, currency) + " and up"
+      "#{money_to_text(low, currency: currency)} and up"
     elsif low == high
-      money_to_text(low, currency)
+      money_to_text(low, currency: currency)
     else
-      [ money_to_text(low, currency), money_to_text(high, currency, true) ].compact.join(delimiter)
+      formatted_low = money_to_text(low, currency: currency)
+      formatted_high = money_to_text(high, currency: currency, with_currency: false, format: { symbol: false })
+      [formatted_low, formatted_high].compact.join(delimiter)
     end
   end
 
-  private
-
   def self.code_valid?(code)
     Money::Currency.stringified_keys.include?(code.downcase)
   end
 
+  def self.iso_for_currency(code)
+    return unless code && code_valid?(code)
+
+    Money::Currency.new(code).iso_code.tap do |iso_code|
+      iso_code.strip! if iso_code.present?
+    end
+  end
+
   def self.symbol_for_code(code)
     return unless code && code_valid?(code)
+
     Money::Currency.new(code).symbol.tap do |symbol|
       symbol.strip! if symbol.present?
     end
   end
-
 end

data/lib/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module MoneyHelper
+  VERSION = '3.0.0'
+end

data/money_helper.gemspec

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+$LOAD_PATH.push File.expand_path('lib', __dir__)
+require 'version'
+
+Gem::Specification.new do |s|
+  s.name = 'money_helper'
+  s.version = MoneyHelper::VERSION
+  s.summary = 'MoneyHelper international price formatting utility.'
+  s.description = 'A simple module to assist in formatting unambiguous prices and price ranges in international currencies in a Roman Script context.'
+  s.authors = ['Sahil Yakhmi', 'Joey Aghion', 'Matt Zikherman', 'Sarah Weir']
+  s.email = 'matt@artsymail.com'
+  s.platform = Gem::Platform::RUBY
+  s.required_rubygems_version = '>= 1.3.6'
+  s.files = `git ls-files`.split("\n")
+  s.test_files = `git ls-files -- spec/*`.split("\n")
+  s.require_paths = ['lib']
+  s.homepage = 'https://github.com/artsy/money_helper'
+  s.add_dependency('activesupport')
+  s.add_dependency('money', '6.16.0')
+  s.add_development_dependency('appraisal')
+  s.add_development_dependency('rspec', '~> 3')
+  s.licenses = ['MIT']
+end

data/spec/money_helper_spec.rb

@@ -1,178 +1,244 @@
-# encoding: UTF-8
+# frozen_string_literal: true
 
-require 'money_helper'
+require 'spec_helper'
 
 describe MoneyHelper do
-  describe "money_to_text" do
-    it "includes only symbol for well-recognizable currencies" do
-      expect(MoneyHelper.money_to_text(30000, "EUR")).to eql("€30.000")
-      expect(MoneyHelper.money_to_text(30000, "GBP")).to eql("£30,000")
-      expect(MoneyHelper.money_to_text(30000, "MYR")).to eql("RM30,000")
-      expect(MoneyHelper.money_to_text(30000, "TRY")).to eql("TRY ₺30.000")
-      expect(MoneyHelper.money_to_text(30000, "USD")).to eql("$30,000")
-    end
-    it "includes ISO code and symbol for ambiguous currencies" do
-      expect(MoneyHelper.money_to_text(30000, "AUD")).to eql("AUD $30,000")
-      expect(MoneyHelper.money_to_text(30000, "ARS")).to eql("ARS $30.000")
-      expect(MoneyHelper.money_to_text(30000, "BBD")).to eql("BBD $30,000")
-      expect(MoneyHelper.money_to_text(30000, "BMD")).to eql("BMD $30,000")
-      expect(MoneyHelper.money_to_text(30000, "BND")).to eql("BND $30,000")
-      expect(MoneyHelper.money_to_text(30000, "BSD")).to eql("BSD $30,000")
-      expect(MoneyHelper.money_to_text(30000, "BZD")).to eql("BZD $30,000")
-      expect(MoneyHelper.money_to_text(30000, "CAD")).to eql("CAD $30,000")
-      expect(MoneyHelper.money_to_text(30000, "CLP")).to eql("CLP $30.000")
-      expect(MoneyHelper.money_to_text(30000, "COP")).to eql("COP $30.000")
-      expect(MoneyHelper.money_to_text(30000, "CUC")).to eql("CUC $30,000")
-      expect(MoneyHelper.money_to_text(30000, "CUP")).to eql("CUP $30,000")
-      expect(MoneyHelper.money_to_text(30000, "DOP")).to eql("DOP $30,000")
-      expect(MoneyHelper.money_to_text(30000, "FJD")).to eql("FJD $30,000")
-      expect(MoneyHelper.money_to_text(30000, "GYD")).to eql("GYD $30,000")
-      expect(MoneyHelper.money_to_text(30000, "HKD")).to eql("HKD $30,000")
-      expect(MoneyHelper.money_to_text(30000, "JMD")).to eql("JMD $30,000")
-      expect(MoneyHelper.money_to_text(30000, "KYD")).to eql("KYD $30,000")
-      expect(MoneyHelper.money_to_text(30000, "LRD")).to eql("LRD $30,000")
-      expect(MoneyHelper.money_to_text(30000, "MXN")).to eql("MXN $30,000")
-      expect(MoneyHelper.money_to_text(30000, "NAD")).to eql("NAD $30,000")
-      expect(MoneyHelper.money_to_text(30000, "NZD")).to eql("NZD $30,000")
-      expect(MoneyHelper.money_to_text(30000, "SBD")).to eql("SBD $30,000")
-      expect(MoneyHelper.money_to_text(30000, "SGD")).to eql("SGD $30,000")
-      expect(MoneyHelper.money_to_text(30000, "SRD")).to eql("SRD $30,000")
-      expect(MoneyHelper.money_to_text(30000, "TWD")).to eql("TWD $30,000")
-      expect(MoneyHelper.money_to_text(30000, "TTD")).to eql("TTD $30,000")
-      expect(MoneyHelper.money_to_text(30000, "UYU")).to eql("UYU $30.000")
-      expect(MoneyHelper.money_to_text(30000, "XCD")).to eql("XCD $30,000")
-      expect(MoneyHelper.money_to_text(30000, "ZWL")).to eql("ZWL $30,000")
-
-      expect(MoneyHelper.money_to_text(30000, "FKP")).to eql("FKP £30,000")
-      expect(MoneyHelper.money_to_text(30000, "GIP")).to eql("GIP £30,000")
-      expect(MoneyHelper.money_to_text(30000, "SDG")).to eql("SDG £30,000")
-      expect(MoneyHelper.money_to_text(30000, "SHP")).to eql("SHP £30,000")
-
-      expect(MoneyHelper.money_to_text(30000, "CNY")).to eql("CNY ¥30,000")
-      expect(MoneyHelper.money_to_text(30000, "JPY")).to eql("JPY ¥30,000")
-
-      expect(MoneyHelper.money_to_text(30000, "ALL")).to eql("ALL L30,000")
-      expect(MoneyHelper.money_to_text(30000, "HNL")).to eql("HNL L30,000")
-      expect(MoneyHelper.money_to_text(30000, "LSL")).to eql("LSL L30,000")
-      expect(MoneyHelper.money_to_text(30000, "MDL")).to eql("MDL L30,000")
-      expect(MoneyHelper.money_to_text(30000, "RON")).to eql("RON 30.000")
-      expect(MoneyHelper.money_to_text(30000, "SZL")).to eql("SZL E30,000")
-
-      expect(MoneyHelper.money_to_text(30000, "ANG")).to eql("ANG ƒ30.000")
-      expect(MoneyHelper.money_to_text(30000, "AWG")).to eql("AWG ƒ30,000")
-
-      expect(MoneyHelper.money_to_text(30000, "BWP")).to eql("BWP P30,000")
-      expect(MoneyHelper.money_to_text(30000, "MOP")).to eql("MOP P30,000")
-
-      expect(MoneyHelper.money_to_text(30000, "CRC")).to eql("CRC ₡30.000")
-      expect(MoneyHelper.money_to_text(30000, "SVC")).to eql("SVC ₡30,000")
-
-      expect(MoneyHelper.money_to_text(30000, "MUR")).to eql("MUR ₨30,000")
-      expect(MoneyHelper.money_to_text(30000, "NPR")).to eql("NPR ₨30,000")
-      expect(MoneyHelper.money_to_text(30000, "PKR")).to eql("PKR ₨30,000")
-      expect(MoneyHelper.money_to_text(30000, "SCR")).to eql("SCR ₨30,000")
-    end
-    it "includes ISO code and symbol for difficult to recognize symbols" do
-      expect(MoneyHelper.money_to_text(30000, "AMD")).to eql("AMD դր.30,000")
-      expect(MoneyHelper.money_to_text(30000, "BDT")).to eql("BDT ৳30,000")
-      expect(MoneyHelper.money_to_text(30000, "BRL")).to eql("BRL R$30.000")
-      expect(MoneyHelper.money_to_text(30000, "GMD")).to eql("GMD D30,000")
-      expect(MoneyHelper.money_to_text(30000, "GEL")).to eql("GEL ლ30,000")
-      expect(MoneyHelper.money_to_text(30000, "GHS")).to eql("GHS ₵30,000")
-      expect(MoneyHelper.money_to_text(30000, "GTQ")).to eql("GTQ Q30,000")
-      expect(MoneyHelper.money_to_text(30000, "HTG")).to eql("HTG G30,000")
-      expect(MoneyHelper.money_to_text(30000, "IDR")).to eql("IDR Rp30.000")
-      expect(MoneyHelper.money_to_text(30000, "ILS")).to eql("ILS ₪30,000")
-      expect(MoneyHelper.money_to_text(30000, "INR")).to eql("INR ₹30,000")
-      expect(MoneyHelper.money_to_text(30000, "KHR")).to eql("KHR ៛30,000")
-      expect(MoneyHelper.money_to_text(30000, "KPW")).to eql("KPW ₩30,000")
-      expect(MoneyHelper.money_to_text(30000, "LAK")).to eql("LAK ₭30,000")
-      expect(MoneyHelper.money_to_text(30000, "MNT")).to eql("MNT ₮30,000")
-      expect(MoneyHelper.money_to_text(30000, "NIO")).to eql("NIO C$30,000")
-      expect(MoneyHelper.money_to_text(30000, "NGN")).to eql("NGN ₦30,000")
-      expect(MoneyHelper.money_to_text(30000, "PGK")).to eql("PGK K30,000")
-      expect(MoneyHelper.money_to_text(30000, "PHP")).to eql("PHP ₱30,000")
-      expect(MoneyHelper.money_to_text(30000, "PYG")).to eql("PYG ₲30,000")
-      expect(MoneyHelper.money_to_text(30000, "RUB")).to eql("RUB ₽30.000")
-      expect(MoneyHelper.money_to_text(30000, "THB")).to eql("THB ฿30,000")
-      expect(MoneyHelper.money_to_text(30000, "TOP")).to eql("TOP T$30,000")
-      expect(MoneyHelper.money_to_text(30000, "TMT")).to eql("TMT T30,000")
-      expect(MoneyHelper.money_to_text(30000, "UAH")).to eql("UAH ₴30,000")
-      expect(MoneyHelper.money_to_text(30000, "VND")).to eql("VND ₫30.000")
-      expect(MoneyHelper.money_to_text(30000, "WST")).to eql("WST T30,000")
-      expect(MoneyHelper.money_to_text(30000, "ZAR")).to eql("ZAR R30,000")
-    end
-    it "includes only ISO code for currencies that don't have a symbol" do
-      expect(MoneyHelper.money_to_text(30000, "UZS")).to eql("UZS 30,000")
-    end
-    it "includes only ISO code for RTL symbols" do
-      expect(MoneyHelper.money_to_text(30000, "AFN")).to eql("AFN 30,000")
-      expect(MoneyHelper.money_to_text(30000, "DZD")).to eql("DZD 30,000")
-      expect(MoneyHelper.money_to_text(30000, "BHD")).to eql("BHD 30,000")
-      expect(MoneyHelper.money_to_text(30000, "EGP")).to eql("EGP 30,000")
-      expect(MoneyHelper.money_to_text(30000, "IRR")).to eql("IRR 30,000")
-      expect(MoneyHelper.money_to_text(30000, "IQD")).to eql("IQD 30,000")
-      expect(MoneyHelper.money_to_text(30000, "JOD")).to eql("JOD 30,000")
-      expect(MoneyHelper.money_to_text(30000, "KWD")).to eql("KWD 30,000")
-      expect(MoneyHelper.money_to_text(30000, "LBP")).to eql("LBP 30,000")
-      expect(MoneyHelper.money_to_text(30000, "LYD")).to eql("LYD 30,000")
-      expect(MoneyHelper.money_to_text(30000, "MAD")).to eql("MAD 30,000")
-      expect(MoneyHelper.money_to_text(30000, "OMR")).to eql("OMR 30,000")
-      expect(MoneyHelper.money_to_text(30000, "JOD")).to eql("JOD 30,000")
-      expect(MoneyHelper.money_to_text(30000, "QAR")).to eql("QAR 30,000")
-      expect(MoneyHelper.money_to_text(30000, "SAR")).to eql("SAR 30,000")
-      expect(MoneyHelper.money_to_text(30000, "SYP")).to eql("SYP 30,000")
-      expect(MoneyHelper.money_to_text(30000, "TND")).to eql("TND 30,000")
-      expect(MoneyHelper.money_to_text(30000, "AED")).to eql("AED 30,000")
-      expect(MoneyHelper.money_to_text(30000, "YER")).to eql("YER 30,000")
-    end
-    it "defaults to USD when an empty string or nil is passed as the currency" do
-      expect(MoneyHelper.money_to_text(30000, "")).to eql("$30,000")
-      expect(MoneyHelper.money_to_text(30000, nil)).to eql("$30,000")
-    end
-    it "returns only the formatted numeral when number_only = true" do
-      expect(MoneyHelper.money_to_text(30000, "EUR", true)).to eql("30.000")
-      expect(MoneyHelper.money_to_text(30000, "AUD", true)).to eql("30,000")
-      expect(MoneyHelper.money_to_text(30000, "AMD", true)).to eql("30,000")
-      expect(MoneyHelper.money_to_text(30000, "AFN", true)).to eql("30,000")
-    end
-    it "returns nil if amount passed in is whitespace, empty string, or nil" do
-      expect(MoneyHelper.money_to_text(" ", "USD")).to be_nil
-      expect(MoneyHelper.money_to_text("", "USD")).to be_nil
-      expect(MoneyHelper.money_to_text(nil, "USD")).to be_nil
-    end
-    it "falls back to ISO code when currency can't be found" do
-      expect(MoneyHelper.money_to_text(10_000, "ITL")).to eql("ITL 10,000")
-      expect(MoneyHelper.money_to_text(10_000, "ITL", true)).to eql("10,000")
+  describe 'money_to_text' do
+    it 'includes ISO code and symbol' do
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'AUD')).to eql('AUD $30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'ARS')).to eql('ARS $30.175,93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'BBD')).to eql('BBD $30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'BMD')).to eql('BMD $30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'BND')).to eql('BND $30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'BSD')).to eql('BSD $30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'BZD')).to eql('BZD $30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'CAD')).to eql('CAD $30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'CLP')).to eql('CLP $3.017.593')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'COP')).to eql('COP $30.175,93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'CUC')).to eql('CUC $30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'CUP')).to eql('CUP $30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'DOP')).to eql('DOP $30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'FJD')).to eql('FJD $30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'GYD')).to eql('GYD $30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'HKD')).to eql('HKD $30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'JMD')).to eql('JMD $30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'KYD')).to eql('KYD $30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'LRD')).to eql('LRD $30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'MXN')).to eql('MXN $30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'NAD')).to eql('NAD $30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'NZD')).to eql('NZD $30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'SBD')).to eql('SBD $30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'SGD')).to eql('SGD $30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'SRD')).to eql('SRD $30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'TWD')).to eql('TWD $30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'TTD')).to eql('TTD $30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'UYU')).to eql('UYU $U30.175,93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'USD')).to eql('USD $30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'XCD')).to eql('XCD $30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'ZWL')).to eql('ZWL $30,175.93')
+
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'EUR')).to eql('EUR €30.175,93')
+
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'FKP')).to eql('FKP £30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'GBP')).to eql('GBP £30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'GIP')).to eql('GIP £30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'SDG')).to eql('SDG £30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'SHP')).to eql('SHP £30,175.93')
+
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'CNY')).to eql('CNY ¥30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'JPY')).to eql('JPY ¥3,017,593')
+
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'ALL')).to eql('ALL L30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'HNL')).to eql('HNL L30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'LSL')).to eql('LSL L30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'MDL')).to eql('MDL L30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'MYR')).to eql('MYR RM30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'RON')).to eql('RON Lei30.175,93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'SZL')).to eql('SZL E30,175.93')
+
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'ANG')).to eql('ANG ƒ30.175,93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'AWG')).to eql('AWG ƒ30,175.93')
+
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'BWP')).to eql('BWP P30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'MOP')).to eql('MOP P30,175.93')
+
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'CRC')).to eql('CRC ₡30.175,93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'SVC')).to eql('SVC ₡30,175.93')
+
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'MUR')).to eql('MUR ₨30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'NPR')).to eql('NPR Rs.30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'PKR')).to eql('PKR ₨30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'SCR')).to eql('SCR ₨30,175.93')
+
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'AMD')).to eql('AMD դր.30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'BDT')).to eql('BDT ৳30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'BRL')).to eql('BRL R$30.175,93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'GEL')).to eql('GEL ლ30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'GHS')).to eql('GHS ₵30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'GMD')).to eql('GMD D30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'GTQ')).to eql('GTQ Q30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'HTG')).to eql('HTG G30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'IDR')).to eql('IDR Rp30.175,93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'ILS')).to eql('ILS ₪30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'INR')).to eql('INR ₹30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'KHR')).to eql('KHR ៛30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'KPW')).to eql('KPW ₩30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'LAK')).to eql('LAK ₭30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'MNT')).to eql('MNT ₮30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'NGN')).to eql('NGN ₦30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'NIO')).to eql('NIO C$30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'PGK')).to eql('PGK K30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'PHP')).to eql('PHP ₱30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'PYG')).to eql('PYG ₲3,017,593')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'RUB')).to eql('RUB ₽30.175,93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'THB')).to eql('THB ฿30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'TMT')).to eql('TMT T30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'TOP')).to eql('TOP T$30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'TRY')).to eql('TRY ₺30.175,93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'UAH')).to eql('UAH ₴30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'VND')).to eql('VND ₫3.017.593')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'WST')).to eql('WST T30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'ZAR')).to eql('ZAR R30,175.93')
+    end
+
+    it "respects currency's thousands separator and decimal mark" do
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'USD')).to eql('USD $30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'EUR')).to eql('EUR €30.175,93')
+    end
+
+    it "converts from currency's minor unit to major unit" do
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'USD')).to eql('USD $30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'JPY')).to eql('JPY ¥3,017,593')
+    end
+
+    it 'displays LTR for RTL symbols' do
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'AFN')).to eql('AFN ؋30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'DZD')).to eql('DZD د.ج30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'BHD')).to eql('BHD د.ب3,017.593')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'EGP')).to eql('EGP ج.م30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'IRR')).to eql('IRR ﷼30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'IQD')).to eql('IQD ع.د3,017.593')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'JOD')).to eql('JOD د.ا3,017.593')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'LYD')).to eql('LYD ل.د3,017.593')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'MAD')).to eql('MAD د.م.30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'QAR')).to eql('QAR ر.ق30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'SYP')).to eql('SYP £S30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'TND')).to eql('TND د.ت3,017.593')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'AED')).to eql('AED د.إ30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'YER')).to eql('YER ﷼30,175.93')
+    end
+
+    it 'defaults to USD' do
+      expect(MoneyHelper.money_to_text(30_175_93)).to eql('USD $30,175.93')
+    end
+
+    it 'omits ISO code when with_currency is false' do
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'EUR', with_currency: false)).to eql('€30.175,93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'AUD', with_currency: false)).to eql('$30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'AMD', with_currency: false)).to eql('դր.30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'AFN', with_currency: false)).to eql('؋30,175.93')
+    end
+
+    it 'omits symbol when `format: symbol:` is false' do
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'EUR', format: { symbol: false })).to eql('EUR 30.175,93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'AUD', format: { symbol: false })).to eql('AUD 30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'AMD', format: { symbol: false })).to eql('AMD 30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'AFN', format: { symbol: false })).to eql('AFN 30,175.93')
+    end
+
+    it 'omits ISO code and symbol when both `with_currency` and `format: symbol:` are false' do
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'EUR', with_currency: false, format: { symbol: false })).to eql('30.175,93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'AUD', with_currency: false, format: { symbol: false })).to eql('30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'AMD', with_currency: false, format: { symbol: false })).to eql('30,175.93')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'AFN', with_currency: false, format: { symbol: false })).to eql('30,175.93')
+    end
+
+    it 'omits cents when `format: no_cents:` is true' do
+      expect(MoneyHelper.money_to_text(30_175_93, with_currency: false, format: { no_cents: true, symbol: false })).to eql('30,175')
+      expect(MoneyHelper.money_to_text(30_175_93, currency: 'EUR', with_currency: false, format: { no_cents: true, symbol: false })).to eql('30.175')
+    end
+
+    it 'returns an empty string if amount passed in is whitespace, empty string, or nil' do
+      expect(MoneyHelper.money_to_text(' ')).to eql('')
+      expect(MoneyHelper.money_to_text('')).to eql('')
+      expect(MoneyHelper.money_to_text(nil)).to eql('')
+    end
+
+    it "raises an exception when currency can't be found" do
+      expect do
+        MoneyHelper.money_to_text(30_175_93, currency: 'AAA')
+      end.to raise_error(Money::Currency::UnknownCurrency, "Unknown currency 'aaa'")
+    end
+  end
+
+  describe 'symbol_with_optional_iso_code' do
+    it 'just includes the symbol for USD GBP EUR and MYR' do
+      expect(MoneyHelper.symbol_with_optional_iso_code('EUR')).to eql('€')
+      expect(MoneyHelper.symbol_with_optional_iso_code('GBP')).to eql('£')
+      expect(MoneyHelper.symbol_with_optional_iso_code('MYR')).to eql('RM')
+      expect(MoneyHelper.symbol_with_optional_iso_code('USD')).to eql('$')
+    end
+
+    it 'includes the iso code as well for other currencies' do
+      expect(MoneyHelper.symbol_with_optional_iso_code('AUD')).to eql('AUD $')
+      expect(MoneyHelper.symbol_with_optional_iso_code('UZS')).to eql('UZS')
+      expect(MoneyHelper.symbol_with_optional_iso_code('JPY')).to eql('JPY ¥')
     end
   end
-  describe "money_range_to_text" do
-    it "includes no indicator for currency for the upper amount in range" do
-      expect(MoneyHelper.money_range_to_text(30000, 40000, "USD")).to eql("$30,000 - 40,000")
-      expect(MoneyHelper.money_range_to_text(30000, 40000, "AUD")).to eql("AUD $30,000 - 40,000")
-      expect(MoneyHelper.money_range_to_text(30000, 40000, "AMD")).to eql("AMD դր.30,000 - 40,000")
-      expect(MoneyHelper.money_range_to_text(30000, 40000, "AFN")).to eql("AFN 30,000 - 40,000")
-    end
-    it "uses the special range amount delimeter when supplied" do
-      expect(MoneyHelper.money_range_to_text(30000, 40000, "USD", "-")).to eql("$30,000-40,000")
-      expect(MoneyHelper.money_range_to_text(30000, 40000, "AUD", "-")).to eql("AUD $30,000-40,000")
-      expect(MoneyHelper.money_range_to_text(30000, 40000, "AMD", "-")).to eql("AMD դր.30,000-40,000")
-      expect(MoneyHelper.money_range_to_text(30000, 40000, "AFN", "-")).to eql("AFN 30,000-40,000")
+
+  describe 'money_range_to_text' do
+    it 'includes no indicator for currency for the upper amount in range' do
+      expect(MoneyHelper.money_range_to_text(30_175_93, 40_983_27, currency: 'USD')).to eql('USD $30,175.93 - 40,983.27')
+      expect(MoneyHelper.money_range_to_text(30_175_93, 40_983_27, currency: 'AUD')).to eql('AUD $30,175.93 - 40,983.27')
+      expect(MoneyHelper.money_range_to_text(30_175_93, 40_983_27, currency: 'AMD')).to eql('AMD դր.30,175.93 - 40,983.27')
+      expect(MoneyHelper.money_range_to_text(30_175_93, 40_983_27, currency: 'AFN')).to eql('AFN ؋30,175.93 - 40,983.27')
+    end
+
+    it 'uses the special range amount delimeter when supplied' do
+      expect(MoneyHelper.money_range_to_text(30_175_93, 40_983_27, currency: 'USD', delimiter: '-')).to eql('USD $30,175.93-40,983.27')
+      expect(MoneyHelper.money_range_to_text(30_175_93, 40_983_27, currency: 'AUD', delimiter: '-')).to eql('AUD $30,175.93-40,983.27')
+      expect(MoneyHelper.money_range_to_text(30_175_93, 40_983_27, currency: 'AMD', delimiter: '-')).to eql('AMD դր.30,175.93-40,983.27')
+      expect(MoneyHelper.money_range_to_text(30_175_93, 40_983_27, currency: 'AFN', delimiter: '-')).to eql('AFN ؋30,175.93-40,983.27')
     end
+
     it "prefixes the text 'Under ' when low amount not given" do
-      expect(MoneyHelper.money_range_to_text(nil, 40000, "USD")).to eql("Under $40,000")
+      expect(MoneyHelper.money_range_to_text(nil, 40_983_27, currency: 'USD')).to eql('Under USD $40,983.27')
     end
+
     it "appends the text ' and up' when high amount not given" do
-      expect(MoneyHelper.money_range_to_text(30000, nil, "USD")).to eql("$30,000 and up")
+      expect(MoneyHelper.money_range_to_text(30_175_93, nil, currency: 'USD')).to eql('USD $30,175.93 and up')
+    end
+
+    it 'treats as a single price when low amount and high amount are identical' do
+      expect(MoneyHelper.money_range_to_text(30_175_93, 30_175_93, currency: 'USD')).to eql('USD $30,175.93')
+    end
+
+    it 'returns empty string when both amounts are nil' do
+      expect(MoneyHelper.money_range_to_text(nil, nil, currency: 'USD')).to eql('')
     end
-    it "treats as a single price when low amount and high amount are identical" do
-      expect(MoneyHelper.money_range_to_text(30000, 30000, "USD")).to eql("$30,000")
+
+    it "raises an exception when currency can't be found" do
+      expect do
+        MoneyHelper.money_range_to_text(10_000, 20_000, currency: 'ITL')
+      end.to raise_error(Money::Currency::UnknownCurrency, "Unknown currency 'itl'")
+    end
+  end
+
+  describe 'symbol_with_optional_iso_code' do
+    it 'returns the symbol only if currency is in SYMBOL_ONLY list' do
+      expect(MoneyHelper.symbol_with_optional_iso_code('EUR')).to eql('€')
+      expect(MoneyHelper.symbol_with_optional_iso_code('USD')).to eql('$')
     end
-    it "returns nil when both amounts are nil" do
-      expect(MoneyHelper.money_range_to_text(nil, nil, "USD")).to be_nil
+
+    it 'returns iso code and symbol if symbol is in OK_SYMBOLS' do
+      expect(MoneyHelper.symbol_with_optional_iso_code('INR')).to eql('INR ₹')
+      expect(MoneyHelper.symbol_with_optional_iso_code('KHR')).to eql('KHR ៛')
+      expect(MoneyHelper.symbol_with_optional_iso_code('KPW')).to eql('KPW ₩')
     end
-    it "falls back to ISO code when currency can't be found" do
-      expect(MoneyHelper.money_range_to_text(10_000, 20_000, "ITL")).to eql("ITL 10,000 - 20,000")
+
+    it 'returns only the iso code if symbol is not in OK_SYMBOLS' do
+      expect(MoneyHelper.symbol_with_optional_iso_code('CHF')).to eql('CHF')
+      expect(MoneyHelper.symbol_with_optional_iso_code('YER')).to eql('YER')
     end
   end
 end

data/spec/spec_helper.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..'))
+
+require 'rubygems'
+require 'rspec'
+
+require 'money_helper'

data/spec/version_spec.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+describe MoneyHelper do
+  it 'has a version' do
+    expect(MoneyHelper::VERSION).to_not be nil
+  end
+end

metadata

@@ -1,90 +1,127 @@
 --- !ruby/object:Gem::Specification
 name: money_helper
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 3.0.0
 platform: ruby
 authors:
 - Sahil Yakhmi
 - Joey Aghion
-autorequire: 
+- Matt Zikherman
+- Sarah Weir
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2015-03-07 00:00:00.000000000 Z
+date: 2022-02-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: money
+  name: activesupport
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '6.5'
+        version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '6.5'
+        version: '0'
 - !ruby/object:Gem::Dependency
-  name: activesupport
+  name: money
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - '='
       - !ruby/object:Gem::Version
-        version: '4'
+        version: 6.16.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 6.16.0
+- !ruby/object:Gem::Dependency
+  name: appraisal
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '4'
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '3'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '3'
 description: A simple module to assist in formatting unambiguous prices and price
   ranges in international currencies in a Roman Script context.
-email: sahil@artsymail.net
+email: matt@artsymail.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".circleci/config.yml"
+- ".gitignore"
+- ".rubocop.yml"
+- ".rubocop_todo.yml"
+- Appraisals
+- CHANGELOG.md
+- Gemfile
+- LICENSE.md
+- README.md
+- RELEASING.md
+- Rakefile
+- UPGRADING.md
+- gemfiles/activesupport_52.gemfile
+- gemfiles/activesupport_60.gemfile
+- gemfiles/activesupport_61.gemfile
+- gemfiles/activesupport_edge.gemfile
 - lib/money_helper.rb
+- lib/version.rb
+- money_helper.gemspec
 - spec/money_helper_spec.rb
-homepage: https://github.com/syakhmi/money_helper
+- spec/spec_helper.rb
+- spec/version_spec.rb
+homepage: https://github.com/artsy/money_helper
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 1.3.6
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.4.6
-signing_key: 
+rubygems_version: 3.2.27
+signing_key:
 specification_version: 4
-summary: MoneyHelper international price formatting utility
+summary: MoneyHelper international price formatting utility.
 test_files:
 - spec/money_helper_spec.rb
+- spec/spec_helper.rb
+- spec/version_spec.rb