minting 1.7.3 → 1.8.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7ebe31c2ae1b9febafa3a6a4ccea1392cb089242746a933d530121b08f55cd4e
-  data.tar.gz: 80f1eb17f62b7a7924df8b2fedb79d864bcadd5ea5e8432e5149b14fb0d9af0c
+  metadata.gz: baca6fa666461ab6bc9f1e0ebed40d7ae0ac56af88993b5d243d25f1ad9bbad3
+  data.tar.gz: e54ad7a337df49a298e0e6236ec98d46a902ddd18b62538d395992609eca533b
 SHA512:
-  metadata.gz: 44147d3523485fc36491bb62f24df5f4040fe3ddda673201d5b6fc9a5e005bda94cd3300b4e84682f4378cb9eedb851ad16c247a2dfeb9de264fd24a6b1714ca
-  data.tar.gz: 5f41672831c8c722e47de8b8e94549bb633c48b677fc8e63eca9f10233062f32a0acd276b31271a4f0ac4417779b03db7f034a9b9afcfbd39c0cbadb16886dbf
+  metadata.gz: eff34626e551613b9dc312caf42698951869333aaf62440551e44eb681a8b2407e0a36ed24b02ba6f6ef03afc68dd1c7b6ac86aa85d3fafb45155f3637b70a04
+  data.tar.gz: b1d2f0f9228ef185ce8b86d4474a1d53151960d7796619ba53ff19fe0db53a9ad990e3f77f924b59c90cd984d144fb62f2fba56059f9e40dfeb5893f790e84cd

data/README.md

@@ -21,29 +21,19 @@ total.to_s                             #=> "$21.59"
 total.currency_code                    #=> "USD"
 ```
 
-## Why Minting?
-
-|                    | Minting                                   |
-|--------------------|-------------------------------------------|
-| **Precision**      | Rational-based, zero floating-point error |
-| **Performance**    | **2× faster** (10×+ formatting)           |
-| **Ruby support**   | 3.3+ (including Ruby 4.0)                 |
-| **Rails**          | Dedicated companion gem                   |
-| **Code quality**   | 100% coverage, 93/100 RubyCritic          |
-
-### 🎯 Exact precision
+### Exact precision
 Amounts are stored as `Rational` and rounded to the currency subunit. No floating-point surprises, ever.
 
-### ⚡ Blazing performance
-Minting is **2× faster** than the Money gem for everyday operations and **over 10× faster for formatting**. See full benchmarks in the [Performance Guide](test/performance/README.md).
+### Blazing performance
+Minting is faster than the Money gem for everyday operations and **over 10× faster for formatting**. See full benchmarks in the [Performance Guide](test/performance/README.md).
 
-### 🧼 Clean, modern API
+### Clean, modern API
 Intuitive interface, descriptive error messages, and sensible defaults. Works the way you expect.
 
-### 🚆 Rails-ready
+### Rails-ready
 Use with the [minting-rails](https://github.com/gferraz/minting-rails) companion gem for drop-in ActiveRecord type casting, validators, and form helpers.
 
-### 🏆 Quality you can trust
+### Quality code
 - **100% test coverage** — every line exercised
 - **93/100 RubyCritic score** — clean, maintainable code
 - **CI-tested on Ruby 3.3 and 4.0**
@@ -176,12 +166,12 @@ Notes:
 
 ```ruby
 # By ISO code (direct hash lookup, string only)
-Mint.currency_for_code('USD')        #=> #<Currency code="USD" ...>
+Mint::Currency.for_code('USD')        #=> #<Currency code="USD" ...>
 
 # By display symbol (highest-priority currency for ambiguous symbols)
-Mint.currency_for_symbol('$')        #=> #<Currency code="USD" ...>
-Mint.currency_for_symbol('R$')       #=> #<Currency code="BRL" ...>
-Mint.currency_for_symbol('€')        #=> #<Currency code="EUR" ...>
+Mint::Currency.for_symbol('$')        #=> #<Currency code="USD" ...>
+Mint::Currency.for_symbol('R$')       #=> #<Currency code="BRL" ...>
+Mint::Currency.for_symbol('€')        #=> #<Currency code="EUR" ...>
 
 ```
 
@@ -189,15 +179,25 @@ Mint.currency_for_symbol('€')        #=> #<Currency code="EUR" ...>
 
 **Exact amounts** — Amounts are stored as `Rational` and rounded to the currency subunit.
 
+**Rounding modes** — Wrap operations in `Mint.with_rounding(mode)` to change how amounts are rounded to the subunit:
+
+```ruby
+Mint.with_rounding(:half_down) { Mint.money(1.005, 'USD') }  #=> [USD 1.00]
+Mint.with_rounding(:ceil)      { Mint.money(1.001, 'USD') }  #=> [USD 1.01]
+Mint.with_rounding(:floor)     { Mint.parse('1.009', 'USD') } #=> [USD 1.00]
+```
+
+Modes: `:half_up` (default), `:half_down`, `:floor`, `:ceil`, `:truncate`, `:down`. Applies to construction, parsing, `change`, `split`, and `allocate`. Restores the previous mode when the block exits, even on exception.
+
 **Refinements** — `10.dollars` and similar helpers require `using Mint` in the current scope (see Usage above).
 
 **Division** — `money / 5` returns new `Money`; `money / other_money` returns a numeric ratio, not money.
 
 **Zero equality** — Any zero amount is considered equal across currencies and to numeric zero (`Mint.money(0, 'USD') == Mint.money(0, 'EUR')` is intentionally `true`). Non-zero amounts must match currency and value.
 
-**Zero helper** — `Mint.zero('USD')` returns a frozen zero-Money, useful as a default value for discounts, totals, or counters.
+**Zero helper** — `Currency.zero('USD')` returns a frozen zero-Money, useful as a default value for discounts, totals, or counters.
 
-**Registered currencies** — `Mint.register_currency(code:, subunit:, symbol:, priority:)` adds custom currencies. Only registered codes and symbols are recognized by the parser.
+**Registered currencies** — `Currency.register(code:, subunit:, symbol:, priority:)` adds custom currencies. Only registered codes and symbols are recognized by the parser.
 
 **Built-in currencies** — 150+ ISO-4217 world currencies ship in `lib/minting/data/currencies.yaml` and load when the registry is first accessed.
 
@@ -216,11 +216,18 @@ Or at runtime:
 Minting.use_top_level_constants!
 ```
 
+For Rails applications, you can enable the top-level constants in an initializer:
+
+```ruby
+# config/initializers/minting.rb
+require "minting/dsl"
+```
+
 After opting in:
 
 ```ruby
-price = Money.create(10, "USD")     # equivalent to Mint::Money.create
-tax   = Money.money(2.50, "USD")
+price = Money.from(10, "USD")                   # equivalent to Mint::Money.from
+tax   = Money.from(2.50, "USD")
 cur   = Currency.new(code: "EUR", symbol: "€", subunit: 2, priority: 0)
 ```
 

data/Rakefile

@@ -16,7 +16,7 @@ end
 
 Rake::TestTask.new('bench:all') do |t|
   t.libs = %w[lib test]
-  t.pattern = 'test/performance/**/*_benchmark.rb'
+  t.pattern = 'test/performance/{core,memory,regression,competitive/money}/*_benchmark.rb'
 end
 
 Rake::TestTask.new('bench:core') do |t|
@@ -34,9 +34,20 @@ Rake::TestTask.new('bench:regression') do |t|
   t.pattern = 'test/performance/regression/*_benchmark.rb'
 end
 
-Rake::TestTask.new('bench:competitive') do |t|
-  t.libs = %w[lib test]
-  t.pattern = 'test/performance/competitive/**/*_benchmark.rb'
+desc 'Run competitive benchmarks (Money gem)'
+task 'bench:competitive' do
+  sh 'bundle exec ruby -Ilib -Itest -e "Dir[File.join(__dir__, \"test/performance/competitive/money/**/*_benchmark.rb\")].each { |f| require f }"'
+end
+
+desc 'Run competitive benchmarks (Shopify Money)'
+task 'bench:competitive:shopify' do
+  sh 'BUNDLE_WITHOUT=money_bench bundle exec ruby -Ilib -Itest -e "Dir[File.join(__dir__, \"test/performance/competitive/shopify/**/*_benchmark.rb\")].each { |f| require f }"'
+end
+
+desc 'Run all competitive benchmarks (both Money and Shopify)'
+task 'bench:competitive:all' do
+  sh 'bundle exec ruby -Ilib -Itest -e "Dir[File.join(__dir__, \"test/performance/competitive/money/**/*_benchmark.rb\")].each { |f| require f }"'
+  sh 'BUNDLE_WITHOUT=money_bench bundle exec ruby -Ilib -Itest -e "Dir[File.join(__dir__, \"test/performance/competitive/shopify/**/*_benchmark.rb\")].each { |f| require f }"'
 end
 
 desc 'Run core benchmarks and update the baseline'