money 6.13.4 → 6.19.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: ca21de22dba51f2c9b00ca1301f5d21ea936767a
-  data.tar.gz: 1cfb4f822e6f7a948f8ff31955422372658c0394
+SHA256:
+  metadata.gz: 331d852b12ab9a5e62108f3610d1ec5eed8f4fa9bb683be1aab2703cd2df26cd
+  data.tar.gz: 56e2bcad250542c80b800db800c2216dd2b3b10f1df5d8a77819d13153a77844
 SHA512:
-  metadata.gz: 207a714b183381a90c2c46f1b4cef2a9246e5a8be0f0c30a088b4d71c98fbdc814e356cb3dac8d2301eefd7d18cf7f70914f6ef9e314975039edbe5bc2b2a7c8
-  data.tar.gz: 8dca4236991ae835e822cd09bc4e0a6fbeb0b2fee52bb85be3dbb38cfa07f7fa60bbde94045b9a643071435126954324da1aa00065af9ab79f2cd961ee50b7d9
+  metadata.gz: ae6d529a7382aaab721a4ae933658828f975eaa4c9a0ad9444b74b28d8ff1141d59f3e264d08b650367e327987266be03dcd480e0a850fe224feb6cdca4163d1
+  data.tar.gz: bbb76570efd7bf4be700cc3f46d01e26945e9790f5f9f3fee666d4ac3164d1422f5ca1614622a429c430804a9047bcc8f5178886905e5ad814ce21ab4117f94a

data/CHANGELOG.md

@@ -1,5 +1,76 @@
 # Changelog
 
+## Upcoming
+
+-
+
+## 6.19.0
+
+- Change Peruvian Sol (PEN) decimal mark and thousands separator.
+- 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
+- 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 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
+
+- Allow true for `thousands_separator`
+
+## 6.16.0
+
+- Add `Money.from_cents` alias as a more explicit initializer, it's the same as `Money.new`
+
+## 6.15.0
+
+- Add :delimiter_pattern option to the Formatter
+
+## 6.14.1
+
+- Fix CHF format regression introduced in v6.14.0
+- Fix deprecation warning in #format_decimal_part
+
+## 6.14.0
+
+- Fix Bahraini dinar symbol
+- Raise exception when default currency is not set or passed as parameter
+- Allow specifying default_bank as a lambda
+- Allow passing a default format in currencies definition only valid without symbol_position
+- Always allow comparison with zero Money
+- Rename Money.infinite_precision to default_infinite_precision
+- Add Currency.reset! method to reload all the default currency definitions
+- Fix edgecase for Money#allocate when applying to array of all zero values
+
+## 6.13.8
+- Update symbol for XOF
+- Update UYU currency symbol
+- Allow double conversion using same bank
+- Warn when using unsafe serializer for rate import
+- Move Icelandic symbol after the amount
+
+## 6.13.7
+- Improve deprecation warnings for the upcoming major release
+
+## 6.13.6
+- Fix a regression introduced in 6.13.5 that broken RatesStore::Memory subclasses
+
+## 6.13.5
+- Raise warning on using Money.default_currency
+- Raise warning on using default Money.rounding_mode
+- Add Second Ouguiya MRU 929 to currency iso file
+- Add symbol for UZS
+- Use monitor for recursive mutual exclusion in RatesStore::Memory
+- Allow passing store as a string to Money::Bank::VariableExchange (to support Rails 6)
+
 ## 6.13.4
 - Update currency config for Zambian Kwacha (ZMW)
 - Do not modify options passed to FormattingRules
@@ -46,7 +117,7 @@
 - Wrap all amount parts when `:html_wrap` option is used
 - Deprecate `#currency_as_string` and `#currency_as_string=` (in favour of `#with_currency`)
 - Add `#with_currency` for swapping the currency
-- Rewrite allocate/split (fixing some penny loosing issues)
+- Rewrite allocate/split (fixing some penny losing issues)
 
 ## 6.11.3
 - Fix regression: if enabled use i18n locales in Money#to_s
@@ -65,7 +136,7 @@
 - Added new symbol for bitcoin denomination
 - Specify custom rounding precision when using `infinite_precision`
 - Allow splits with sums greater than 1
-- Prevent arithmetic methods from loosing reference to the bank
+- Prevent arithmetic methods from losing reference to the bank
 - Fix coerced zero numeric subtraction
 - Fix south asian formatting to support whole numbers
 - Refactor formatting logic

data/LICENSE

@@ -1,23 +1,23 @@
-The MIT License (MIT)
+MIT License
 
 Copyright (c) 2005 Tobias Lutke
 Copyright (c) 2008 Phusion
+Copyright (c) 2024 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 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:
+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 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.
+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

@@ -1,9 +1,8 @@
 # RubyMoney - Money
 
 [![Gem Version](https://badge.fury.io/rb/money.svg)](https://rubygems.org/gems/money)
-[![Build Status](https://travis-ci.org/RubyMoney/money.svg?branch=master)](https://travis-ci.org/RubyMoney/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)
-[![Coverage Status](https://coveralls.io/repos/RubyMoney/money/badge.svg?branch=master)](https://coveralls.io/r/RubyMoney/money?branch=master)
 [![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)
 
@@ -21,7 +20,7 @@ A Ruby Library for dealing with money and currency conversion.
 
 ### Features
 
-- Provides a `Money` class which encapsulates all information about an certain
+- Provides a `Money` class which encapsulates all information about a certain
   amount of money, such as its value and its currency.
 - Provides a `Money::Currency` class which encapsulates all information about
   a monetary unit.
@@ -61,39 +60,43 @@ The development version (hosted on Github) can be installed with:
 ``` ruby
 require 'money'
 
+# explicitly define locales
+I18n.config.available_locales = :en
+Money.locale_backend = :i18n
+
 # 10.00 USD
-money = Money.new(1000, "USD")
+money = Money.from_cents(1000, "USD")
 money.cents     #=> 1000
 money.currency  #=> Currency.new("USD")
 
 # Comparisons
-Money.new(1000, "USD") == Money.new(1000, "USD")   #=> true
-Money.new(1000, "USD") == Money.new(100, "USD")    #=> false
-Money.new(1000, "USD") == Money.new(1000, "EUR")   #=> false
-Money.new(1000, "USD") != Money.new(1000, "EUR")   #=> true
+Money.from_cents(1000, "USD") == Money.from_cents(1000, "USD")   #=> true
+Money.from_cents(1000, "USD") == Money.from_cents(100, "USD")    #=> false
+Money.from_cents(1000, "USD") == Money.from_cents(1000, "EUR")   #=> false
+Money.from_cents(1000, "USD") != Money.from_cents(1000, "EUR")   #=> true
 
 # Arithmetic
-Money.new(1000, "USD") + Money.new(500, "USD") == Money.new(1500, "USD")
-Money.new(1000, "USD") - Money.new(200, "USD") == Money.new(800, "USD")
-Money.new(1000, "USD") / 5                     == Money.new(200, "USD")
-Money.new(1000, "USD") * 5                     == Money.new(5000, "USD")
+Money.from_cents(1000, "USD") + Money.from_cents(500, "USD") == Money.from_cents(1500, "USD")
+Money.from_cents(1000, "USD") - Money.from_cents(200, "USD") == Money.from_cents(800, "USD")
+Money.from_cents(1000, "USD") / 5                            == Money.from_cents(200, "USD")
+Money.from_cents(1000, "USD") * 5                            == Money.from_cents(5000, "USD")
 
 # Unit to subunit conversions
-Money.from_amount(5, "USD") == Money.new(500, "USD")  # 5 USD
-Money.from_amount(5, "JPY") == Money.new(5, "JPY")    # 5 JPY
-Money.from_amount(5, "TND") == Money.new(5000, "TND") # 5 TND
+Money.from_amount(5, "USD") == Money.from_cents(500, "USD")  # 5 USD
+Money.from_amount(5, "JPY") == Money.from_cents(5, "JPY")    # 5 JPY
+Money.from_amount(5, "TND") == Money.from_cents(5000, "TND") # 5 TND
 
 # Currency conversions
 some_code_to_setup_exchange_rates
-Money.new(1000, "USD").exchange_to("EUR") == Money.new(some_value, "EUR")
+Money.from_cents(1000, "USD").exchange_to("EUR") == Money.from_cents(some_value, "EUR")
 
 # Swap currency
-Money.new(1000, "USD").with_currency("EUR") == Money.new(1000, "EUR")
+Money.from_cents(1000, "USD").with_currency("EUR") == Money.from_cents(1000, "EUR")
 
 # Formatting (see Formatting section for more options)
-Money.new(100, "USD").format #=> "$1.00"
-Money.new(100, "GBP").format #=> "£1.00"
-Money.new(100, "EUR").format #=> "€1.00"
+Money.from_cents(100, "USD").format #=> "$1.00"
+Money.from_cents(100, "GBP").format #=> "£1.00"
+Money.from_cents(100, "EUR").format #=> "€1.00"
 ```
 
 ## Currency
@@ -103,15 +106,15 @@ The most part of `Money` APIs allows you to supply either a `String` or a
 `Money::Currency`.
 
 ``` ruby
-Money.new(1000, "USD") == Money.new(1000, Money::Currency.new("USD"))
-Money.new(1000, "EUR").currency == Money::Currency.new("EUR")
+Money.from_cents(1000, "USD") == Money.from_cents(1000, Money::Currency.new("USD"))
+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
-currency = Money.new(1000, "USD").currency
+currency = Money.from_cents(1000, "USD").currency
 currency.iso_code #=> "USD"
 currency.name     #=> "United States Dollar"
 ```
@@ -231,18 +234,18 @@ an example of how it works:
 Money.add_rate("USD", "CAD", 1.24515)
 Money.add_rate("CAD", "USD", 0.803115)
 
-Money.us_dollar(100).exchange_to("CAD")  # => Money.new(124, "CAD")
-Money.ca_dollar(100).exchange_to("USD")  # => Money.new(80, "USD")
+Money.us_dollar(100).exchange_to("CAD")  # => Money.from_cents(124, "CAD")
+Money.ca_dollar(100).exchange_to("USD")  # => Money.from_cents(80, "USD")
 ```
 
 Comparison and arithmetic operations work as expected:
 
 ``` ruby
-Money.new(1000, "USD") <=> Money.new(900, "USD")   # => 1; 9.00 USD is smaller
-Money.new(1000, "EUR") + Money.new(10, "EUR") == Money.new(1010, "EUR")
+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")
 
 Money.add_rate("USD", "EUR", 0.5)
-Money.new(1000, "EUR") + Money.new(1000, "USD") == Money.new(1500, "EUR")
+Money.from_cents(1000, "EUR") + Money.from_cents(1000, "USD") == Money.from_cents(1500, "EUR")
 ```
 
 ### Exchange rate stores
@@ -316,11 +319,10 @@ The following example implements an `ActiveRecord` store to save exchange rates
 ```ruby
 # rails g model exchange_rate from:string to:string rate:float
 
-# for Rails 5 replace ActiveRecord::Base with ApplicationRecord
-class ExchangeRate < ActiveRecord::Base
+class ExchangeRate < ApplicationRecord
   def self.get_rate(from_iso_code, to_iso_code)
     rate = find_by(from: from_iso_code, to: to_iso_code)
-    rate.present? ? rate.rate : nil
+    rate&.rate
   end
 
   def self.add_rate(from_iso_code, to_iso_code, rate)
@@ -328,12 +330,75 @@ class ExchangeRate < ActiveRecord::Base
     exrate.rate = rate
     exrate.save!
   end
+
+  def self.each_rate
+    return find_each unless block_given?
+
+    find_each do |rate|
+      yield rate.from, rate.to, rate.rate
+    end
+  end
+
+  def self.marshal_dump
+    [self]
+  end
+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'
+
+  def initialize
+    conn_url = "#{Rails.application.credentials.redis_server}/#{REDIS_DATABASE}"
+    @connection = Redis.new(url: conn_url)
+  end
+
+  def add_rate(iso_from, iso_to, rate)
+    @connection.hset(REDIS_STORE_KEY, rate_key_for(iso_from, iso_to), rate)
+  end
+
+  def get_rate(iso_from, iso_to)
+    @connection.hget(REDIS_STORE_KEY, rate_key_for(iso_from, iso_to))
+  end
+
+  def each_rate
+    rates = @connection.hgetall(REDIS_STORE_KEY)
+    return to_enum(:each_rate) unless block_given?
+
+    rates.each do |key, rate|
+      iso_from, iso_to = key.split(INDEX_KEY_SEPARATOR)
+      yield iso_from, iso_to, rate
+    end
+  end
+
+  def transaction
+    yield
+  end
+
+  private
+
+  def rate_key_for(iso_from, iso_to)
+    [iso_from, iso_to].join(INDEX_KEY_SEPARATOR).upcase
+  end
 end
 ```
 
 Now you can use it with the default bank.
 
 ```ruby
+# For Rails 6 pass model name as a string to make it compatible with zeitwerk
+# Money.default_bank = Money::Bank::VariableExchange.new("ExchangeRate")
 Money.default_bank = Money::Bank::VariableExchange.new(ExchangeRate)
 
 # Add to the underlying store
@@ -341,7 +406,7 @@ Money.default_bank.add_rate('USD', 'CAD', 0.9)
 # Retrieve from the underlying store
 Money.default_bank.get_rate('USD', 'CAD') # => 0.9
 # Exchanging amounts just works.
-Money.new(1000, 'USD').exchange_to('CAD') #=> #<Money fractional:900 currency:CAD>
+Money.from_cents(1000, 'USD').exchange_to('CAD') #=> #<Money fractional:900 currency:CAD>
 ```
 
 There is nothing stopping you from creating store objects which scrapes
@@ -388,7 +453,7 @@ There are several formatting rules for when `Money#format` is called. For more i
 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:
 
 ```ruby
-m = Money.new('123', :gbp) # => #<Money fractional:123 currency:GBP>
+m = Money.from_cents('123', :gbp) # => #<Money fractional:123 currency:GBP>
 m.format(symbol: m.currency.to_s + ' ') # => "GBP 1.23"
 ```
 
@@ -403,7 +468,7 @@ Money.from_amount(2.34567).format #=> "$2.35"
 To retain the additional precision, you will also need to set `infinite_precision` to `true`.
 
 ```ruby
-Money.infinite_precision = true
+Money.default_infinite_precision = true
 Money.from_amount(2.34567).format #=> "$2.34567"
 ```
 
@@ -415,11 +480,17 @@ To round to the nearest cent (or anything more precise), you can use the `round`
 2.34567.round(2)  #=> 2.35
 
 # Money
-Money.infinite_precision = true
-Money.new(2.34567).format       #=> "$0.0234567"
-Money.new(2.34567).round.format #=> "$0.02"
-Money.new(2.34567).round(BigDecimal::ROUND_HALF_UP, 2).format #=> "$0.0235"
+Money.default_infinite_precision = true
+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"
+```
+
+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
 
 ## Ruby on Rails
 
@@ -452,7 +523,7 @@ en:
       separator: "."
 ```
 
-For this example `Money.new(123456789, "SEK").format` will return `1,234,567.89
+For this example `Money.from_cents(123456789, "SEK").format` will return `1,234,567.89
 kr` which otherwise would have returned `1 234 567,89 kr`.
 
 This will work seamlessly with [rails-i18n](https://github.com/svenfuchs/rails-i18n) gem that already has a lot of locales defined.
@@ -476,12 +547,22 @@ Money.locale_backend = :i18n
 
 # example (using default localization from rails-i18n):
 I18n.locale = :en
-Money.new(10_000_00, 'USD').format # => $10,000.00
-Money.new(10_000_00, 'EUR').format # => €10,000.00
+Money.from_cents(10_000_00, 'USD').format # => $10,000.00
+Money.from_cents(10_000_00, 'EUR').format # => €10,000.00
 
 I18n.locale = :es
-Money.new(10_000_00, 'USD').format # => $10.000,00
-Money.new(10_000_00, 'EUR').format # => €10.000,00
+Money.from_cents(10_000_00, 'USD').format # => $10.000,00
+Money.from_cents(10_000_00, 'EUR').format # => €10.000,00
+```
+
+If you need to localize the position of the currency symbol, you
+have to pass it manually. *Note: this will become the default formatting
+behavior in the next version.*
+
+```ruby
+I18n.locale = :fr
+format = I18n.t :format, scope: 'number.currency.format'
+Money.from_cents(10_00, 'EUR').format(format: format) # => 10,00 €
 ```
 
 For the legacy behaviour of "per currency" localization (formatting depends only on currency):
@@ -490,8 +571,8 @@ For the legacy behaviour of "per currency" localization (formatting depends only
 Money.locale_backend = :currency
 
 # example:
-Money.new(10_000_00, 'USD').format # => $10,000.00
-Money.new(10_000_00, 'EUR').format # => €10.000,00
+Money.from_cents(10_000_00, 'USD').format # => $10,000.00
+Money.from_cents(10_000_00, 'EUR').format # => €10.000,00
 ```
 
 In case you don't need localization and would like to use default values (can be redefined using
@@ -501,8 +582,8 @@ In case you don't need localization and would like to use default values (can be
 Money.locale_backend = nil
 
 # example:
-Money.new(10_000_00, 'USD').format # => $10000.00
-Money.new(10_000_00, 'EUR').format # => €10000.00
+Money.from_cents(10_000_00, 'USD').format # => $10000.00
+Money.from_cents(10_000_00, 'EUR').format # => €10000.00
 ```
 
 ## Collection

data/config/currency_backwards_compatible.json

@@ -8,6 +8,7 @@
     "subunit": "Sent",
     "subunit_to_unit": 100,
     "symbol_first": false,
+    "format": "%n %u",
     "html_entity": "",
     "decimal_mark": ".",
     "thousands_separator": ",",
@@ -30,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",
@@ -39,6 +56,7 @@
     "subunit": "Centas",
     "subunit_to_unit": 100,
     "symbol_first": false,
+    "format": "%n %u",
     "html_entity": "",
     "decimal_mark": ".",
     "thousands_separator": ",",
@@ -60,6 +78,23 @@
     "iso_numeric": "428",
     "smallest_denomination": 1
   },
+  "mro": {
+    "priority": 100,
+    "iso_code": "MRO",
+    "name": "Mauritanian Ouguiya",
+    "symbol": "UM",
+    "disambiguate_symbol": "A-UM",
+    "alternate_symbols": [],
+    "subunit": "Khoums",
+    "subunit_to_unit": 5,
+    "symbol_first": false,
+    "format": "%n %u",
+    "html_entity": "",
+    "decimal_mark": ".",
+    "thousands_separator": ",",
+    "iso_numeric": "478",
+    "smallest_denomination": 1
+  },
   "mtl": {
     "priority": 100,
     "iso_code": "MTL",
@@ -84,6 +119,7 @@
     "subunit": "Tennesi",
     "subunit_to_unit": 100,
     "symbol_first": false,
+    "format": "%n %u",
     "html_entity": "",
     "decimal_mark": ".",
     "thousands_separator": ",",