money 6.18.0 → 7.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 146c73332b26929014c71519d1a698b06aa8782651787d363c3bf6a495e5b6c5
-  data.tar.gz: 7dc290dc12bc060396c291d0b4f8615240d5e745d6dfb6ee493aec60296fceec
+  metadata.gz: 435fd498ba0ce70e5d0ee2079e0e99d93abc2c17440f7a6cacda1176641b7d3a
+  data.tar.gz: 81fdc617e20b27d8628ba2f4859fa2fd41a9cbc04c3a44ddf689036b4414f40b
 SHA512:
-  metadata.gz: a732f1abb1cac4bfeabd12a8541ef88704da0db312ef1a93e625c738724e272ef1848eb60d5fe50910c21ab4de57937e20bc332a752daadb459865c249322892
-  data.tar.gz: 4351c0c06eab76fdfff48a25447606513b525bc04c0cdb478bff472816b11e5d7c9201420e79c85a1697951678a1905530ee484a8c822412c93188c2853044f4
+  metadata.gz: 9e2ef4767b6d9a50fa7d6eed46570249af8c2e2bade1c8b11aee93d737d1a8c484d74f1aaf837a880e28af8be44b1c5413a5bea854a015b936026032a3070dcd
+  data.tar.gz: 756de612cdebdb1e4cf3311f460a3f5118fd775a4f1760ad211c4fd6816804cc16f8b4c461bb8a0292031d7b03a22ae0f291844467791fbbc1a9f1bc46519060

data/CHANGELOG.md

@@ -1,15 +1,76 @@
 # 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
+- Update deprecation message to suggest correct formatting.
+
+## 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
-- Add Ruby 3.1 to the CI matrix
-
-## 6.18.0
-
+- Add Ruby 3.1 and 3.2 to the CI matrix
 - Add `Money.from_dollars` alias as a more explicit initializer, it's the same as `Money.from_amount`
+- Mark Croatian Kuna (HRK) as obsolete by moving its definition to the backwards compatibility data source
 
 ## 6.17.0
 
@@ -200,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)
@@ -247,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
@@ -416,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)
@@ -542,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.
 
@@ -557,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.
 
@@ -582,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.
@@ -615,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
 ================
@@ -647,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
 ================
@@ -662,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
 ===========
@@ -692,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
 --------
@@ -705,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
 ===========
@@ -752,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) 2022 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,9 +54,13 @@ The development version (hosted on Github) can be installed with:
 
 ## Usage
 
-``` ruby
+```ruby
 require 'money'
 
+# explicitly define locales
+I18n.config.available_locales = :en
+Money.locale_backend = :i18n
+
 # 10.00 USD
 money = Money.from_cents(1000, "USD")
 money.cents     #=> 1000
@@ -101,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")
 ```
@@ -109,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",
@@ -162,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)
@@ -190,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
@@ -216,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)
 ```
 
@@ -226,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)
 
@@ -236,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")
 
@@ -344,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'
 
@@ -406,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)
 ```
 
@@ -422,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!
 ```
 
@@ -444,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>
@@ -470,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
 
@@ -502,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
@@ -526,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
 ```
 
@@ -594,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
 ```
 
@@ -602,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

@@ -31,6 +31,22 @@
     "iso_numeric": "288",
     "smallest_denomination": 1
   },
+  "hrk": {
+    "priority": 100,
+    "iso_code": "HRK",
+    "name": "Croatian Kuna",
+    "symbol": "kn",
+    "alternate_symbols": [],
+    "subunit": "Lipa",
+    "subunit_to_unit": 100,
+    "symbol_first": false,
+    "format": "%n %u",
+    "html_entity": "",
+    "decimal_mark": ",",
+    "thousands_separator": ".",
+    "iso_numeric": "191",
+    "smallest_denomination": 1
+  },
   "ltl": {
     "priority": 100,
     "iso_code": "LTL",
@@ -99,6 +115,7 @@
     "iso_code": "TMM",
     "name": "Turkmenistani Manat",
     "symbol": "m",
+    "disambiguate_symbol": "TMM",
     "alternate_symbols": [],
     "subunit": "Tennesi",
     "subunit_to_unit": 100,