money 6.19.0 → 7.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 331d852b12ab9a5e62108f3610d1ec5eed8f4fa9bb683be1aab2703cd2df26cd
-  data.tar.gz: 56e2bcad250542c80b800db800c2216dd2b3b10f1df5d8a77819d13153a77844
+  metadata.gz: 435fd498ba0ce70e5d0ee2079e0e99d93abc2c17440f7a6cacda1176641b7d3a
+  data.tar.gz: 81fdc617e20b27d8628ba2f4859fa2fd41a9cbc04c3a44ddf689036b4414f40b
 SHA512:
-  metadata.gz: ae6d529a7382aaab721a4ae933658828f975eaa4c9a0ad9444b74b28d8ff1141d59f3e264d08b650367e327987266be03dcd480e0a850fe224feb6cdca4163d1
-  data.tar.gz: bbb76570efd7bf4be700cc3f46d01e26945e9790f5f9f3fee666d4ac3164d1422f5ca1614622a429c430804a9047bcc8f5178886905e5ad814ce21ab4117f94a
+  metadata.gz: 9e2ef4767b6d9a50fa7d6eed46570249af8c2e2bade1c8b11aee93d737d1a8c484d74f1aaf837a880e28af8be44b1c5413a5bea854a015b936026032a3070dcd
+  data.tar.gz: 756de612cdebdb1e4cf3311f460a3f5118fd775a4f1760ad211c4fd6816804cc16f8b4c461bb8a0292031d7b03a22ae0f291844467791fbbc1a9f1bc46519060

data/CHANGELOG.md

@@ -1,12 +1,61 @@
 # Changelog
 
-## Upcoming
-
--
+## Unreleased
+
+## 7.0.0
+
+- **Breaking change**: Require Ruby >= 3.1 and i18n ~> 1.9
+- **Breaking change**: Remove deprecated formatting rules:
+  - `:html`
+  - `:html_wrap_symbol`
+  - `:symbol_position`
+  - `:symbol_before_without_space`
+  - `:symbol_after_without_space`
+- **Breaking change**: Remove deprecated methods:
+  - `Money.infinite_precision`.
+  - `Money.infinite_precision=`.
+  - `Money#currency_as_string`.
+  - `Money#currency_as_string=`.
+  - `Money.use_i18n` and `Money.use_i18n=` (use `Money.locale_backend = :i18n` instead).
+- **Breaking change**: Remove legacy locale backend. The default locale backend is now `:currency` which uses currency definitions for formatting.
+- **Breaking change**: Default currency is now `nil` instead of `USD`. If you want to keep the previous behavior, set `Money.default_currency = Money::Currency.new("USD")` in your initializer. Initializing a Money object will raise a `Currency::NoCurrency` if no currency is set.
+- **Breaking change**: The default rounding mode has changed from `BigDecimal::ROUND_HALF_EVEN` to `BigDecimal::ROUND_HALF_UP`. Set it explicitly using `Money.rounding_mode = BigDecimal::ROUND_HALF_EVEN` to keep the previous behavior.
+- **Potential breaking change**: Fix RSD (Serbian Dinar) formatting to be like `12.345,42 RSD`
+- **Potential breaking change**: Fix USDC decimals places from 2 to 6
+- **Potential breaking change**: Fix MGA (Malagasy Ariary) to be a zero-decimal currency (changing subunit_to_unit from 5 to 1)
+- **Potential breaking change**: Remove special handling for Japanese language only
+- **Potential breaking change**: Adjust formatting rules to use i18n translations for `:format`
+- **Potential breaking change**: Not allow divide by zero
+- Updated Armenian Dram sign and HTML entity
+- Updated the Turkmen Manat symbol and HTML entity and added disambiguation symbol for TMM
+- Expose Money::VERSION
+- Fix typo in ILS currency
+- Add Zimbabwe Gold (ZWG) currency
+- Update thousands_separator for CHF
+- Add Caribbean Guilder (XCG) as replacement for Netherlands Antillean Gulden (ANG)
+- Add `Money.strict_eql_compare = true` so that comparing zero amounts with different currencies using `Money#eql?` returns `false`
+    ```rb
+    Money.new(0, "USD").eql?(Money.new(0, "EUR")) #=> true
+    #> [DEPRECATION] Comparing 0 USD with 0 EUR using `#eql?` will return false…
+
+    Money.strict_eql_compare = true
+    Money.new(0, "USD").eql?(Money.new(0, "EUR")) #=> false
+    ```
+- Add `Money#to_nearest_cash_value` to return a rounded Money instance to the smallest denomination
+- Deprecate `Money#round_to_nearest_cash_value` in favor of calling `to_nearest_cash_value.fractional`
+- Deprecate `Money#dollars` in favor of `Money#amount`.
+- Deprecate `Money.from_dollars` in favor of `Money.from_amount`.
+- Add `Money::Currency#cents_based?` to check if currency is cents-based
+- Add ability to nest `Money.with_rounding_mode` blocks
+- Allow `nil` to be used as a default_currency
+- Improve performance of `find_by_iso_numeric` method
+- Add ability to nest `Money.with_bank` blocks
+- Refactor `Money::Allocation.generate` to support configurable per-split precision by accepting an Integer as a second argument, fixing allocation failures with large arrays and infinite decimal expansions.
 
 ## 6.19.0
 
 - Change Peruvian Sol (PEN) decimal mark and thousands separator.
+- Fix deprecation warning for BigDecimal being moved out from stdlib.
 - Improves Precision and Simplifies Allocation Logic
 - explicit declaration of i18n locales
 - Add space to CHF format
@@ -15,6 +64,7 @@
 ## 6.18.0
 
 - Add second dobra (STN) from São Tomé and Príncipe
+- Add Sierra Leonean (new) leone (SLE) from Sierra Leone
 - Correct South African Rand (ZAR) to use comma decimal mark, and space thousands separator
 - Use euro symbol as html_entity for euro currency
 - Update Georgian Lari symbol
@@ -211,7 +261,7 @@
    return `nil` as `Comparable#==` will not rescue exceptions in the next release.
  - Fix `Currency` specs for `#exponent` and `#decimal_places` not making assertions.
  - Fix a couple of Ruby warnings found in specs.
- - Fix `Money#-`,`Money#+` arithmetics for Ruby 2.3+ : check for zero value without using eql? with a Fixnum. (#577)
+ - Fix `Money#-`,`Money#+` arithmetic for Ruby 2.3+ : check for zero value without using eql? with a Fixnum. (#577)
  - Use `Money#decimal_mark` when formatting with `rounded_infinite_precision` rule
    set to `true`.
  - Replaced meta-defined `thousands_separator` and `decimal_mark` methods with regular methods. (#579)
@@ -258,7 +308,7 @@
  - Fix formatting of NGN - show symbol before amount
  - Switch default and alternate symbols for RUB currency
  - Fix symbol for TRY currency
- - Add `Money.default_formatting_rules` hash, meant to define default rules for everytime `Money#format` is called. They can be overwritten if provided on method call
+ - Add `Money.default_formatting_rules` hash, meant to define default rules for every time `Money#format` is called. They can be overwritten if provided on method call
  - Add support for the new official symbol for Russian Ruble (RUB) — «₽»
 
 ## 6.2.1
@@ -427,7 +477,7 @@ Features
 
 Bugfixes
 --------
-- EEK currency is no longer used, kept for BC ([#issue/110](http://github.com/RubyMoney/money/issues/110))
+- EEK currency is no longer used, kept for BC ([#issue/110](https://github.com/RubyMoney/money/issues/110))
 - Lithuanian Litas symbol position fixed (laurynas)
 - Fixed README typos (phlipper)
 - Fixed README typos (pwim)
@@ -553,11 +603,11 @@ 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))
+   ([#issue/37](https://github.com/RubyMoney/money/issues/37))
  - Fixed String#to_money for :subunit_to_unit != 100.
-   ([#issue/36](http://github.com/RubyMoney/money/issue/36))
+   ([#issue/36](https://github.com/RubyMoney/money/issues/36))
  - Removed duplicate currencies.
-   ([#issue/38](http://github.com/RubyMoney/money/issue/38))
+   ([#issue/38](https://github.com/RubyMoney/money/issues/38))
  - Fixed issue related to JRuby returning 2 for Math.log10(1000).floor instead
    of correctly returning 3.
 
@@ -568,22 +618,22 @@ Features
 --------
  - Added support for creating objects with the main monetary unit instead of
    cents.
-   ([#issue/25](http://github.com/RubyMoney/money/issues/25))
+   ([#issue/25](https://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))
+   ([#issue/31](https://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))
+   ([#issue/31](https://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))
+   ([#issue/29](https://github.com/RubyMoney/money/issues/29))
  - Update Money#parse to use :subunit_to_unit
-   ([#issue/30](http://github.com/RubyMoney/money/issues/30))
+   ([#issue/30](https://github.com/RubyMoney/money/issues/30))
 
 Bugfixes
 --------
  - Downgraded required_rubygems_version to >= 1.3.6.
-   ([#issue/26](http://github.com/RubyMoney/money/issues/26))
+   ([#issue/26](https://github.com/RubyMoney/money/issues/26))
  - Use BigDecimal when floating point calculations are needed.
  - Ruby 1.9.2 compatibility enhancements.
 
@@ -593,32 +643,32 @@ Money 3.1.0
 Features
 --------
  - Implemented `Money::Bank::Base`.
-   ([#issue/14](http://github.com/RubyMoney/money/issues/14))
+   ([#issue/14](https://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`
+ - Implemented `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))
+   ([#issue/16](https://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)
+ - Moved project from [FooBarWidget](https://github.com/FooBarWidget) to
+   [RubyMoney](https://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))
+   ([#issue/18](https://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
+   ([#issue/19](https://github.com/RubyMoney/money/issues/19))
+ - Added [google_currency](https://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))
+   ([#issue/21](https://github.com/RubyMoney/money/issues/21))
  - Added `#import_rates` to `Money::Bank::VariableExchange`.
-   ([#issue/21](http://github.com/RubyMoney/money/issues/21))
+   ([#issue/21](https://github.com/RubyMoney/money/issues/21))
  - Removed dependency on Jeweler.
  - Replaced usage of hanna with yardoc.
  - Rewrote/reformatted all documentation.
@@ -626,30 +676,30 @@ Features
 Bugfixes
 --------
  - Fixed incorrect URLs in documentation.
-   ([#issue/17](http://github.com/RubyMoney/money/issues/17))
+   ([#issue/17](https://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))
+   ([#issue/20](https://github.com/RubyMoney/money/issues/20))
  - Updated Ghanaian Cedi to use correct ISO Code, GHS.
-   ([#issue/22](http://github.com/RubyMoney/money/issues/22))
+   ([#issue/22](https://github.com/RubyMoney/money/issues/22))
  - Make `default` rake task call `spec`.
-   ([#issue/23](http://github.com/RubyMoney/money/issues/23))
+   ([#issue/23](https://github.com/RubyMoney/money/issues/23))
 
 Money 3.1.0.pre3
 ================
 
 Features
 --------
- - Added [google_currency](http://github.com/RubyMoney/google_currency) to list
+ - Added [google_currency](https://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))
+   ([#issue/21](https://github.com/RubyMoney/money/issues/21))
  - Added `#import_rates` to `Money::Bank::VariableExchange`.
-   ([#issue/21](http://github.com/RubyMoney/money/issues/21))
+   ([#issue/21](https://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))
+   ([#issue/20](https://github.com/RubyMoney/money/issues/20))
 
 Money 3.1.0.pre2
 ================
@@ -658,14 +708,14 @@ Features
 --------
  - Moved `@rounding_method` from `Money::Bank::VariableExchange` to
    `Money::Bank::Base`.
-   ([#issue/18](http://github.com/RubyMoney/money/issues/18))
+   ([#issue/18](https://github.com/RubyMoney/money/issues/18))
  - Added `#setup` to `Money::Bank::Base`. Called from `#initialize`.
-   ([#issue/19](http://github.com/RubyMoney/money/issues/19))
+   ([#issue/19](https://github.com/RubyMoney/money/issues/19))
 
 Bugfixes
 --------
  - Fixed incorrect URLs in documentation.
-   ([#issue/17](http://github.com/RubyMoney/money/issues/17))
+   ([#issue/17](https://github.com/RubyMoney/money/issues/17))
 
 Money 3.1.0.pre1
 ================
@@ -673,26 +723,26 @@ Money 3.1.0.pre1
 Features
 --------
  - Implemented `Money::Bank::Base`.
-   ([#issue/14](http://github.com/RubyMoney/money/issues/14))
+   ([#issue/14](https://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`
+ - Implemented `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))
+   ([#issue/16](https://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)
+ - Moved project from [FooBarWidget](https://github.com/FooBarWidget) to
+   [RubyMoney](https://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))
+   ([#issue/15](https://github.com/RubyMoney/money/issues/15))
 
 Money 3.0.5
 ===========
@@ -703,11 +753,11 @@ Features
  - 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))
+   ([#issue/11](https://github.com/RubyMoney/money/issues/11))
  - Added optional `currency` argument to `String#to_money`.
-   ([#issue/11](http://github.com/RubyMoney/money/issues/11))
+   ([#issue/11](https://github.com/RubyMoney/money/issues/11))
  - Use '¤' as the default currency symbol.
-   ([#issue/10](http://github.com/RubyMoney/money/issues/10))
+   ([#issue/10](https://github.com/RubyMoney/money/issues/10))
 
 Bugfixes
 --------
@@ -716,7 +766,7 @@ Bugfixes
  - 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))
+   ([#issue/12](https://github.com/RubyMoney/money/issues/12))
 
 Money 3.0.4
 ===========
@@ -763,7 +813,7 @@ Features
 --------
  - Version Bump due to compatibility changes with ActiveRecord. See
    conversation
-   [here](http://github.com/RubyMoney/money/issues#issue/4/comment/224880)
+   [here](https://github.com/RubyMoney/money/issues/4#issuecomment-224880)
    for more information.
 
 Money 2.3.0

data/LICENSE

@@ -2,7 +2,7 @@ MIT License
 
 Copyright (c) 2005 Tobias Lutke
 Copyright (c) 2008 Phusion
-Copyright (c) 2024 Shane Emmons
+Copyright (c) 2025 Shane Emmons
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -2,17 +2,16 @@
 
 [![Gem Version](https://badge.fury.io/rb/money.svg)](https://rubygems.org/gems/money)
 [![Ruby](https://github.com/RubyMoney/money/actions/workflows/ruby.yml/badge.svg)](https://github.com/RubyMoney/money/actions/workflows/ruby.yml)
-[![Code Climate](https://codeclimate.com/github/RubyMoney/money.svg)](https://codeclimate.com/github/RubyMoney/money)
-[![Inline docs](https://inch-ci.org/github/RubyMoney/money.svg)](https://inch-ci.org/github/RubyMoney/money)
-[![License](https://img.shields.io/github/license/RubyMoney/money.svg)](https://opensource.org/licenses/MIT)
+[![Inline docs](https://img.shields.io/badge/docs-github.io-green.svg)](https://rubymoney.github.io/money/)
+[![License](https://img.shields.io/github/license/RubyMoney/money.svg)](https://opensource.org/license/MIT)
 
-:warning: Please read the [migration notes](#migration-notes) before upgrading to a new major version.
+:warning: Please read the [upgrade guides](#upgrade-guides) before upgrading to a new major version.
 
 If you miss String parsing, check out the new [monetize gem](https://github.com/RubyMoney/monetize).
 
 ## Contributing
 
-See the [Contribution Guidelines](https://github.com/RubyMoney/money/blob/master/CONTRIBUTING.md)
+See the [Contribution Guidelines](https://github.com/RubyMoney/money/blob/main/CONTRIBUTING.md)
 
 ## Introduction
 
@@ -33,15 +32,13 @@ A Ruby Library for dealing with money and currency conversion.
 ### Resources
 
 - [Website](https://rubymoney.github.io/money/)
-- [API Documentation](http://www.rubydoc.info/gems/money/frames)
+- [API Documentation](https://www.rubydoc.info/gems/money/frames)
 - [Git Repository](https://github.com/RubyMoney/money)
 
 ### Notes
 
 - Your app must use UTF-8 to function with this library. There are a
   number of non-ASCII currency attributes.
-- This app requires JSON. If you're using JRuby < 1.7.0
-  you'll need to add `gem "json"` to your Gemfile or similar.
 
 ## Downloading
 
@@ -57,7 +54,7 @@ The development version (hosted on Github) can be installed with:
 
 ## Usage
 
-``` ruby
+```ruby
 require 'money'
 
 # explicitly define locales
@@ -105,7 +102,7 @@ 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`.
 
-``` ruby
+```ruby
 Money.from_cents(1000, "USD") == Money.from_cents(1000, Money::Currency.new("USD"))
 Money.from_cents(1000, "EUR").currency == Money::Currency.new("EUR")
 ```
@@ -113,16 +110,17 @@ Money.from_cents(1000, "EUR").currency == Money::Currency.new("EUR")
 A `Money::Currency` instance holds all the information about the currency,
 including the currency symbol, name and much more.
 
-``` ruby
+```ruby
 currency = Money.from_cents(1000, "USD").currency
-currency.iso_code #=> "USD"
-currency.name     #=> "United States Dollar"
+currency.iso_code     #=> "USD"
+currency.name         #=> "United States Dollar"
+currency.cents_based? #=> true
 ```
 
 To define a new `Money::Currency` use `Money::Currency.register` as shown
 below.
 
-``` ruby
+```ruby
 curr = {
   priority:            1,
   iso_code:            "USD",
@@ -166,7 +164,7 @@ selector like the one available
 custom methods to return the list of major currencies and all currencies as
 follows:
 
-``` ruby
+```ruby
 # Returns an array of currency id where
 # priority < 10
 def major_currencies(hash)
@@ -194,23 +192,22 @@ all_currencies(Money::Currency.table)
 
 ### Default Currency
 
-By default `Money` defaults to USD as its currency. This can be overwritten
-using:
+A default currency is not set by default. If a default currency is not set, it will raise an error when you try to initialize a `Money` object without explicitly passing a currency or parse a string that does not contain a currency. You can set a default currency for your application by using:
 
-``` ruby
+```ruby
 Money.default_currency = Money::Currency.new("CAD")
 ```
 
-If you use [Rails](https://github.com/RubyMoney/money/tree/master#ruby-on-rails), then `config/initializers/money.rb` is a very good place to put this.
+If you use [Rails](https://github.com/RubyMoney/money/tree/main#ruby-on-rails), then `config/initializers/money.rb` is a very good place to put this.
 
 ### Currency Exponent
 
 The exponent of a money value is the number of digits after the decimal
 separator (which separates the major unit from the minor unit). See e.g.
-[ISO 4217](https://www.currency-iso.org/en/shared/amendments/iso-4217-amendment.html) for more
+[ISO 4217](https://www.iso.org/iso-4217-currency-codes.html) for more
 information. You can find the exponent (as an `Integer`) by
 
-``` ruby
+```ruby
 Money::Currency.new("USD").exponent  # => 2
 Money::Currency.new("JPY").exponent  # => 0
 Money::Currency.new("MGA").exponent  # => 1
@@ -220,7 +217,7 @@ Money::Currency.new("MGA").exponent  # => 1
 
 To find a given currency by ISO 4217 numeric code (three digits) you can do
 
-``` ruby
+```ruby
 Money::Currency.find_by_iso_numeric(978) #=> Money::Currency.new(:eur)
 ```
 
@@ -230,7 +227,7 @@ 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:
 
-``` ruby
+```ruby
 Money.add_rate("USD", "CAD", 1.24515)
 Money.add_rate("CAD", "USD", 0.803115)
 
@@ -240,7 +237,7 @@ Money.ca_dollar(100).exchange_to("USD")  # => Money.from_cents(80, "USD")
 
 Comparison and arithmetic operations work as expected:
 
-``` ruby
+```ruby
 Money.from_cents(1000, "USD") <=> Money.from_cents(900, "USD")   # => 1; 9.00 USD is smaller
 Money.from_cents(1000, "EUR") + Money.from_cents(10, "EUR") == Money.from_cents(1010, "EUR")
 
@@ -348,14 +345,13 @@ end
 The following example implements a `Redis` store to save exchange rates to a redis database.
 
 ```ruby
-
 class RedisRateStore
   INDEX_KEY_SEPARATOR = '_TO_'.freeze
-  
+
   # Using second db of the redis instance
   # because sidekiq uses the first db
   REDIS_DATABASE = 1
-  
+
   # Using Hash to store rates data
   REDIS_STORE_KEY = 'rates'
 
@@ -410,9 +406,9 @@ Money.from_cents(1000, 'USD').exchange_to('CAD') #=> #<Money fractional:900 curr
 ```
 
 There is nothing stopping you from creating store objects which scrapes
-[XE](http://www.xe.com) for the current rates or just returns `rand(2)`:
+[XE](https://www.xe.com) for the current rates or just returns `rand(2)`:
 
-``` ruby
+```ruby
 Money.default_bank = Money::Bank::VariableExchange.new(StoreWhichScrapesXeDotCom.new)
 ```
 
@@ -426,7 +422,7 @@ Money.default_bank = MyCustomBank.new(Money::RatesStore::Memory.new)
 If you wish to disable automatic currency conversion to prevent arithmetic when
 currencies don't match:
 
-``` ruby
+```ruby
 Money.disallow_currency_conversion!
 ```
 
@@ -448,9 +444,9 @@ implementations.
 
 ## Formatting
 
-There are several formatting rules for when `Money#format` is called. For more information, check out the [formatting module source](https://github.com/RubyMoney/money/blob/master/lib/money/money/formatter.rb), or read the latest release's [rdoc version](http://www.rubydoc.info/gems/money/Money/Formatter).
+There are several formatting rules for when `Money#format` is called. For more information, check out the [formatting module source](https://github.com/RubyMoney/money/blob/main/lib/money/money/formatter.rb), or read the latest release's [rdoc version](https://www.rubydoc.info/gems/money/Money/Formatter).
 
-If you wish to format money according to the EU's [Rules for expressing monetary units](http://publications.europa.eu/code/en/en-370303.htm#position) in either English, Irish, Latvian or Maltese:
+If you wish to format money according to the EU's [Rules for expressing monetary units](https://style-guide.europa.eu/en/content/-/isg/topic?identifier=7.3.3-rules-for-expressing-monetary-units#id370303__id370303_PositionISO) in either English, Irish, Latvian or Maltese:
 
 ```ruby
 m = Money.from_cents('123', :gbp) # => #<Money fractional:123 currency:GBP>
@@ -474,23 +470,31 @@ Money.from_amount(2.34567).format #=> "$2.34567"
 
 To round to the nearest cent (or anything more precise), you can use the `round` method. However, note that the `round` method on a `Money` object does not work the same way as a normal Ruby `Float` object. Money's `round` method accepts different arguments. The first argument to the round method is the rounding mode, while the second argument is the level of precision relative to the cent.
 
-```
+```ruby
 # Float
 2.34567.round     #=> 2
 2.34567.round(2)  #=> 2.35
 
 # Money
 Money.default_infinite_precision = true
-Money.from_cents(2.34567).format       #=> "$0.0234567"
+Money.from_cents(2.34567).format #=> "$0.0234567"
 Money.from_cents(2.34567).round.format #=> "$0.02"
-Money.from_cents(2.34567).round(BigDecimal::ROUND_HALF_UP, 2).format #=> "$0.0235"
+Money.from_cents(2.34567).round(BigDecimal::ROUND_DOWN, 2).format #=> "$0.0234"
 ```
 
 You can set the default rounding mode by passing one of the `BigDecimal` mode enumerables like so:
+
 ```ruby
 Money.rounding_mode = BigDecimal::ROUND_HALF_EVEN
 ```
-See [BigDecimal::ROUND_MODE](https://ruby-doc.org/stdlib-2.5.1/libdoc/bigdecimal/rdoc/BigDecimal.html#ROUND_MODE) for more information
+
+See [BigDecimal::ROUND_MODE](https://ruby-doc.org/3.4.1/gems/bigdecimal/BigDecimal.html#ROUND_MODE) for more information.
+
+To round to the nearest cash value in currencies without small denominations:
+
+```ruby
+Money.from_cents(11_11, "CHF").to_nearest_cash_value.format # => "CHF 11.10"
+```
 
 ## Ruby on Rails
 
@@ -506,7 +510,7 @@ In order to localize formatting you can use `I18n` gem:
 Money.locale_backend = :i18n
 ```
 
-With this enabled a thousands seperator and a decimal mark will get looked up in your `I18n` translation files. In a Rails application this may look like:
+With this enabled a thousands separator and a decimal mark will get looked up in your `I18n` translation files. In a Rails application this may look like:
 
 ```yml
 # config/locale/en.yml
@@ -530,7 +534,7 @@ This will work seamlessly with [rails-i18n](https://github.com/svenfuchs/rails-i
 
 If you wish to disable this feature and use defaults instead:
 
-``` ruby
+```ruby
 Money.locale_backend = nil
 ```
 
@@ -598,7 +602,7 @@ If you don't have some locale and don't want to get a runtime error such as:
     I18n::InvalidLocale: :en is not a valid locale
 
 Set the following:
-``` ruby
+```ruby
 I18n.enforce_available_locales = false
 ```
 
@@ -606,18 +610,11 @@ I18n.enforce_available_locales = false
 
 Prior to v6.9.0 heuristic analysis of string input was part of this gem. Since then it was extracted in to [money-heuristics gem](https://github.com/RubyMoney/money-heuristics).
 
-## Migration Notes
-
-#### Version 6.0.0
-
-- The `Money#dollars` and `Money#amount` methods now return instances of
-  `BigDecimal` rather than `Float`. We should avoid representing monetary
-  values with floating point types so to avoid a whole class of errors relating
-  to lack of precision. There are two migration options for this change:
-  * The first is to test your application and where applicable update the
-    application to accept a `BigDecimal` return value. This is the recommended
-    path.
-  * The second is to migrate from the `#amount` and `#dollars` methods to use
-    the `#to_f` method instead. This option should only be used where `Float`
-    is the desired type and nothing else will do for your application's
-    requirements.
+## Upgrade Guides
+
+When upgrading between major versions, please refer to the appropriate upgrade guide:
+
+- **[Upgrading to 7.0](UPGRADING-7.0.md)** - Guide for migrating from 6.x to 7.0
+- **[Upgrading to 6.0](UPGRADING-6.0.md)** - Guide for upgrading to version 6.0
+
+These guides provide detailed information about breaking changes, new features, and step-by-step migration instructions.

data/config/currency_backwards_compatible.json

@@ -115,6 +115,7 @@
     "iso_code": "TMM",
     "name": "Turkmenistani Manat",
     "symbol": "m",
+    "disambiguate_symbol": "TMM",
     "alternate_symbols": [],
     "subunit": "Tennesi",
     "subunit_to_unit": 100,