minting 1.1.1 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ef2574a0bffcbccb882faba1a839ef37369e047b23becf1ce405d2c1b883322a
-  data.tar.gz: 19ec197c01ceb083a2f6dcf2c6898b38f80ba7679749154b74b3d9fb2f2ffeda
+  metadata.gz: b05d1cbbf6c714102f38f165effba77384e4fc5cebf691d4b9ab75082c22b992
+  data.tar.gz: 2d5bb5aeb6e527a2d4419bcca35d79c426709797975e9ec38217558d875ea9b8
 SHA512:
-  metadata.gz: e8680da52ba5417cbe89f2c36615247fa1cc7302088c7d087aa782b6d1958bcd124a38f2b1027cd164810f9f04b02974cf8ac68cb61047d204c9189bf1943a6d
-  data.tar.gz: e85e786f6cb1f98b10e75742097651013e9fe57ddad4896a70fd85b836709e2eecfe26d0f0854b05423f931b1b5fc17b46dfa63c0e25f1a86ffa024de3748d05
+  metadata.gz: ce7311d97cbe60c2f71ba5f65d1313704084eebae842e012c2cd857230055ef56007575e8f89887f8ae157c004d205e43370ada8d2fc2b5f3ea00b7c21c8017a
+  data.tar.gz: e4903099bb997667472ddc0c26ff07b3894bb9fa5122221c94045d84f2699e28d203646429e341a8119177a07212991f04d36c5806a12c8388766a3a8aebb6eb

data/README.md

@@ -91,6 +91,11 @@ price_in_euros.to_s(format: '%<symbol>2s%<amount>+10f')    #=> " €    +12.34"
 
 price.to_json # => "{ "currency": "USD", "amount": "9.99" }"
 
+# Hash conversion
+
+price.to_hash #=> {currency: "USD", amount: "9.99"}
+
+
 # Proportional allocation and split
 
 ten.split(3)                           #=> [[USD 3.34], [USD 3.33], [USD 3.33]]
@@ -192,11 +197,6 @@ This gem includes a performance suite under `test/performance`:
 - Memory and GC pressure tests
 - Competitive benchmarks vs `money` gem
 
-On a typical machine, reference numbers are:
-
-- Money creation: ~1.6M ops/sec
-- Addition: ~1.7M ops/sec
-
 Run locally:
 
 ```bash
@@ -210,6 +210,49 @@ BENCH=true rake bench:competitive
 rake bench:regression
 ```
 
+## Benchmark Summary: Minting vs Money Gem
+
+Generated by Qwen from the latest benchmark run on Ruby 4.0.1. - 2026-05-30
+
+### Key Takeaways
+
+- **Mint is consistently faster** than the Money gem across all measured operations.
+- **Mint is 2.28x faster** in the 50,000-transaction simulation.
+- **Mint object creation is 2.76x faster** than `Money.from_amount`.
+- In formatting and conversion, Mint is often **10+x **.
+- Mint’s performance advantage is especially strong for numeric conversion, string formatting, comparisons, and high-volume transaction loops.
+
+### Performance Highlights
+
+| Category | Mint | Money | Approx. Ratio |
+| --- | --- | --- | --- |
+| High-volume transactions | 195,412 ops/sec | 85,882 ops/sec | 2.28x faster |
+| `Mint.money` creation | 1.14M ops/sec | — | 2.76x faster than `Money.from_amount` |
+| `some.dollars` creation | 990k ops/sec | — | 1.15x faster than `Mint.money` |
+| `Money.new` creation | — | 715k ops/sec | Mint 1.59x faster |
+| `to_f` formatting | 8.8M–9.3M ops/sec | 0.7M ops/sec | ~12x faster |
+| `to_d` conversion | 2.1M–2.3M ops/sec | 0.73M–0.79M ops/sec | ~3x faster |
+| `to_s` formatting | 300k–420k ops/sec | 109k–132k ops/sec | ~3x faster |
+| `inspect` formatting | ~2.6–2.9M ops/sec | ~1.1–1.16M ops/sec | ~2.5x faster |
+| `to_json` formatting | ~2.0–2.2M ops/sec | ~110k–126k ops/sec | ~17x faster |
+| Currency lookup `Mint.currency('USD')` | 3.82M ops/sec | — | 1.60x faster than `Money::Currency.new` |
+| Currency lookup `Money::Currency.find('USD')` | 3.63M ops/sec | 1.67M ops/sec | 2.29x faster |
+| Addition | 1.11M ops/sec | 0.37M ops/sec | 3.0x faster |
+| Subtraction | 1.11M ops/sec | 0.36M ops/sec | 3.0x faster |
+| Multiplication | 1.28M ops/sec | 0.51M ops/sec | 2.5x faster |
+| Division | 1.04M ops/sec | 0.37M ops/sec | 2.8x faster |
+| Ratio division | 2.94M ops/sec | 0.39M ops/sec | 7.6x faster |
+| Comparison (`==`, `<`, `>`) | 2.5M–4.1M ops/sec | 0.35M–0.38M ops/sec | 7x–10x faster |
+| Allocation (`Mint.allocate`) | 279k ops/sec | 146k ops/sec | 1.9x faster |
+| Split (`Mint.split`) | 215k ops/sec | 85k ops/sec | 3.3x faster |
+
+### Commands Used
+
+```sh
+BENCH=true bundle exec ruby -Ilib:test -r ./test/test_helper.rb test/performance/competitive_performance_benchmark.rb
+BENCH=true bundle exec ruby -Ilib:test -r ./test/test_helper.rb test/performance/competitive_memory_benchmark.rb
+```
+
 ## License
 
 MIT

data/Rakefile

@@ -12,15 +12,20 @@ Rake::TestTask.new(:test) do |t|
   t.ruby_opts << '-rtest_helper.rb'
 end
 
-Rake::TestTask.new(:bench) do |t|
+Rake::TestTask.new('bench') do |t|
   t.libs = %w[lib test]
-  t.pattern = 'test/**/*_benchmark.rb'
+  t.pattern = 'test/performance/*_benchmark.rb'
 end
 
-# Performance benchmark tasks
-Rake::TestTask.new('bench:performance') do |t|
+Rake::TestTask.new('bench:parse') do |t|
   t.libs = %w[lib test]
-  t.pattern = 'test/performance/*_benchmark.rb'
+  t.pattern = 'test/performance/parse_benchmark.rb'
+  t.ruby_opts << '-r test_helper.rb'
+end
+
+Rake::TestTask.new('bench:edge') do |t|
+  t.libs = %w[lib test]
+  t.pattern = 'test/performance/algorithm_benchmark.rb'
   t.ruby_opts << '-r test_helper.rb'
 end
 
@@ -32,12 +37,10 @@ end
 
 Rake::TestTask.new('bench:competitive') do |t|
   t.libs = %w[lib test]
-  t.pattern = 'test/performance/competitive_benchmark.rb'
+  t.pattern = 'test/performance/competitive_performance_benchmark.rb'
   t.ruby_opts << '-r test_helper.rb'
 end
 
-task 'bench:all' => ['bench', 'bench:performance']
-
 RuboCop::RakeTask.new(:cop)
 
 YARD::Rake::YardocTask.new do |t|

data/lib/minting/mint/currency.rb

@@ -3,7 +3,10 @@ module Mint
   #
   # @see https://www.iso.org/iso-4217-currency-codes.html
   class Currency
-    attr_reader :code, :subunit, :symbol, :priority, :minimum_amount, :country, :name
+    attr_reader :code, :subunit, :symbol,
+                :country,
+                :fractional_multiplier, :minimum_amount,
+                :name, :priority
 
     def inspect
       "<Currency:(#{code} #{symbol} #{subunit})>"
@@ -18,7 +21,8 @@ module Mint
       @priority = priority.to_i
       @country = country
       @name = name
-      @minimum_amount = 10r**-@subunit
+      @fractional_multiplier = 10**@subunit
+      @minimum_amount = 1r / fractional_multiplier
       freeze
     end
   end

data/lib/minting/mint/registry.rb

@@ -14,6 +14,9 @@ module Mint
     raise ArgumentError, "Currency [#{currency_code}] not registered. Check Mint.currencies"
   end
 
+  # Returns default zero, no currency money
+  def self.zero = @zero ||= Money.new(0, Mint.currency('XXX'))
+
   # Finds a registered currency by its code, symbol,
   # or retrieves it directly if already a Currency object.
   #
@@ -34,11 +37,11 @@ module Mint
   #
   # @param code [String, Symbol] the unique currency code (e.g. 'USD', :EUR)
   # @param subunit [Integer] the decimal subunit precision (defaults to 2)
-  # @param symbol [String] the display symbol (defaults to '$')
+  # @param symbol [String] the display symbol (defaults to '')
   # @param priority [Integer] parser precedence priority (defaults to 0)
   # @return [Currency] the registered or existing Currency instance
   # @raise [ArgumentError] if the code layout is invalid or register throws an error
-  def self.register_currency(code:, subunit: 2, symbol: '$', priority: 0)
+  def self.register_currency(code:, subunit: 2, symbol: '', priority: 0)
     code = code.to_s
     currencies[code] || register_currency!(code:, subunit:, symbol:, priority:)
   end

data/lib/minting/money/allocation.rb

@@ -14,7 +14,8 @@ module Mint
       raise ArgumentError, 'Need at least 1 proportion element' if proportions.empty?
       raise ArgumentError, 'Proportions total must not be zero' if whole.zero?
 
-      amounts = proportions.map { |rate| (amount * rate.to_r / whole).round(currency.subunit) }
+      subunit = currency.subunit
+      amounts = proportions.map { |rate| (amount * rate.to_r / whole).round(subunit) }
       allocate_left_over!(amounts: amounts, left_over: amount - amounts.sum)
     end
 

data/lib/minting/money/arithmetics.rb

@@ -3,7 +3,7 @@ module Mint
     # Returns the absolute value of the monetary amount as a new {Money} instance.
     #
     # @return [Money] the absolute value
-    def abs =     mint(amount.abs)
+    def abs = mint(amount.abs)
 
     # Returns true if the monetary amount is less than zero.
     #

data/lib/minting/money/conversion.rb

@@ -39,15 +39,17 @@ module Mint
       amount.to_i
     end
 
+    def to_hash
+      { currency: currency_code, amount: Kernel.format("%0.#{currency.subunit}f", amount) }
+    end
+
     # Serializes the money instance to a standard JSON object containing the amount and currency.
     # Highly optimized to run without external dependencies.
     #
     # @return [String] the JSON serialized string representation
     def to_json(*_args)
-      subunit = currency.subunit
       Kernel.format(
-        %({"currency": "#{currency_code}", "amount": "%0.#{subunit}f"}),
-        amount
+        %({"currency": "#{currency_code}", "amount": "%0.#{currency.subunit}f"}), amount
       )
     end
 

data/lib/minting/money/money.rb

@@ -24,6 +24,8 @@ module Mint
     # @return [String] the ISO currency code
     def currency_code = currency.code
 
+    def fractional = (amount * currency.fractional_multiplier).to_i
+
     # Generates a stable hash key for Money instances.
     #
     # @return [Integer] the calculated hash value
@@ -33,7 +35,7 @@ module Mint
     # @param new_amount [Numeric] The new amount
     # @return [Money] A new Money object or self
     def mint(new_amount)
-      new_amount.to_r == amount ? self : Money.new(new_amount, currency)
+      new_amount == amount ? self : Money.new(new_amount, currency)
     end
 
     # Returns a standard developer-oriented string inspection of the Money object.
@@ -48,8 +50,5 @@ module Mint
     # @param other [Object] the target object to compare
     # @return [Boolean] true if currencies match, false otherwise
     def same_currency?(other) = other.respond_to?(:currency) && other.currency == currency
-
-    # Returns default zero no currency money
-    def self.zero = @zero ||= new(0, Mint.currencies('XXX'))
   end
 end

data/lib/minting/money/parse.rb

@@ -32,7 +32,7 @@ module Mint
     # Extracts a numeric value from input that should only contain an amount.
     def self.parse_amount(input)
       # Remove any charater that is not a digit, comma or period
-      numeric = input.scan(/[\d.\-,]/).join
+      numeric = input.scan(/[\d.,-]/).join
       numeric = normalize_separators(numeric)
       Rational(numeric)
     end

data/lib/minting/version.rb

@@ -1,5 +1,5 @@
 # Root namespace for the Minting library.
 module Minting
   # Current version of the Minting gem.
-  VERSION = '1.1.1'.freeze
+  VERSION = '1.2.0'.freeze
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: minting
 version: !ruby/object:Gem::Version
-  version: 1.1.1
+  version: 1.2.0
 platform: ruby
 authors:
 - Gilson Ferraz