minting 1.7.0 → 1.7.2

data/lib/minting/money/money.rb

@@ -43,63 +43,5 @@ module Mint
     # @param other [Currency] the target currency to compare
     # @return [Boolean] true if currencies match, false otherwise
     def same_currency?(other) = other.currency == currency
-
-    # Constrains +self+ to the inclusive range [+min+, +max+].
-    #
-    # Bounds may be:
-    # - nil meaning no boundary
-    # - same-currency {Money} or Range
-    # - Numeric amount, or Range
-    #
-    # Numeric is interpreted as an amount in +self+'s currency, so the common
-    # pricing idiom +price.clamp(0, 100)+ reads as "0 to 100 in the same
-    # currency as +price+".
-    #
-    # When +self+ is already in range the receiver is returned (no new object
-    # allocated). When out of range, the nearest bound is returned as a new
-    # frozen {Money} in +self+'s currency.
-    #
-    # @param min_or_range [Money, Numeric, Range, nil] lower bound (inclusive), or range
-    # @param max [Money, Numeric, nil] upper bound (inclusive)
-    # @return [Money] +self+ if in range, otherwise the nearer bound
-    # @raise [ArgumentError] if +min+ or +max+ is not a Money, Numeric or nil; if
-    #   a Money operand has a different currency; if +min+ > +max+;
-    #   if min is a Range, and max is not nil
-    #
-    # @example In range
-    #   Mint.money(5, 'USD').clamp(0, 10) #=> [USD 5.00]  (returns self)
-    #
-    # @example Out of range, with Numeric bounds
-    #   Mint.money(50, 'USD').clamp(0, 10) #=> [USD 10.00]
-    #
-    # @example Out of range, with Money bounds
-    #   loss  = Mint.money(-5, 'USD')
-    #   floor = Mint.money(0,  'USD')
-    #   ceil  = Mint.money(10, 'USD')
-    #   loss.clamp(floor, ceil) #=> [USD 0.00]
-    #
-    # @example Subunit-0 currency (JPY)
-    #   Mint.money(500, 'JPY').clamp(0, 100) #=> [JPY 100]
-    def clamp(min_or_range, max = nil)
-      if min_or_range.is_a?(Range)
-        raise(ArgumentError, "Either amount range alone or two amounts accepted: #{max}") if max
-
-        min, max = min_or_range.minmax
-      else
-        min = min_or_range
-      end
-      mint(amount.clamp(normalize_boundary(min), normalize_boundary(max)))
-    end
-
-    private
-
-    def normalize_boundary(boundary)
-      case boundary
-      in NilClass | Numeric                then boundary
-      in Money if same_currency?(boundary) then boundary.amount
-      in Money                             then raise ArgumentError, "oundary currency must be: #{currency_code}"
-      else                                 raise ArgumentError, "Boundary must be Numeric or Money #{boundary}"
-      end
-    end
   end
 end

data/lib/minting/version.rb

@@ -3,5 +3,5 @@
 # Root namespace for the Minting library.
 module Minting
   # Current version of the Minting gem.
-  VERSION = '1.7.0'
+  VERSION = '1.7.2'
 end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: minting
 version: !ruby/object:Gem::Version
-  version: 1.7.0
+  version: 1.7.2
 platform: ruby
 authors:
 - Gilson Ferraz
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-06-12 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bigdecimal
@@ -33,6 +32,7 @@ files:
 - LICENSE
 - README.md
 - Rakefile
+- bin/bench_check
 - bin/check-currencies
 - bin/console
 - bin/setup
@@ -40,6 +40,7 @@ files:
 - doc/Mint/Currency.html
 - doc/Mint/CurrencyRegistry.html
 - doc/Mint/Money.html
+- doc/Mint/RangeStepPatch.html
 - doc/Mint/UnknownCurrency.html
 - doc/Minting.html
 - doc/_index.html
@@ -62,24 +63,30 @@ files:
 - doc/method_list.html
 - doc/top-level-namespace.html
 - lib/minting.rb
+- lib/minting/currency/currency.rb
+- lib/minting/currency/currency_registry.rb
+- lib/minting/currency/world_currencies.rb
 - lib/minting/data/world-currencies.yaml
 - lib/minting/mint.rb
 - lib/minting/mint/aliases.rb
-- lib/minting/mint/currency/currency.rb
-- lib/minting/mint/currency/currency_registry.rb
-- lib/minting/mint/currency/world_currencies.rb
+- lib/minting/mint/dsl/numeric.rb
 - lib/minting/mint/dsl/range.rb
-- lib/minting/mint/dsl/refinements.rb
+- lib/minting/mint/dsl/string.rb
 - lib/minting/mint/dsl/top_level.rb
 - lib/minting/mint/mint.rb
-- lib/minting/mint/parser.rb
-- lib/minting/money/allocation.rb
-- lib/minting/money/arithmetics.rb
+- lib/minting/mint/parser/parser.rb
+- lib/minting/mint/parser/separators.rb
+- lib/minting/money/allocation/allocation.rb
+- lib/minting/money/allocation/split.rb
+- lib/minting/money/arithmetics/methods.rb
+- lib/minting/money/arithmetics/operators.rb
+- lib/minting/money/clamp.rb
 - lib/minting/money/coercion.rb
 - lib/minting/money/comparable.rb
 - lib/minting/money/constructors.rb
 - lib/minting/money/conversion.rb
-- lib/minting/money/formatting.rb
+- lib/minting/money/format/formatting.rb
+- lib/minting/money/format/to_s.rb
 - lib/minting/money/money.rb
 - lib/minting/version.rb
 - minting.gemspec
@@ -94,7 +101,6 @@ metadata:
   source_code_uri: https://github.com/gferraz/minting
   allowed_push_host: https://rubygems.org
   rubygems_mfa_required: 'true'
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -109,8 +115,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.22
-signing_key:
+rubygems_version: 4.0.10
 specification_version: 4
 summary: Library to manipulate currency values
 test_files: []

data/lib/minting/mint/parser.rb

@@ -1,85 +0,0 @@
-# frozen_string_literal: true
-
-# Mint Money parsing
-module Mint
-  extend self
-
-  # Parses a human-readable money string into a {Money} object.
-  #
-  # @param input [String] Amount input, optionally including a currency symbol or code
-  # @param currency [String, Symbol, Currency, nil] ISO code when not present in +input+
-  # @return [Money]
-  # @raise [ArgumentError] when +input+ is invalid or currency cannot be determined
-  #
-  # @example With explicit currency
-  #   Money.parse('19.99', 'USD')    #=> [USD 19.99]
-  #   Money.parse('1.234,56', 'EUR') #=> [EUR 1234.56]
-  #
-  # @example With symbol or code in the string
-  #   Money.parse('$19.99')            #=> [USD 19.99]
-  #   Money.parse('19,99 €')         #=> [EUR 19.99]
-  #   Money.parse('USD 1,234.56')    #=> [USD 1234.56]
-  def parse(input, currency = nil)
-    raise ArgumentError, 'input must be a String' unless input.is_a?(String)
-
-    input = input.strip
-    raise ArgumentError, 'input cannot be empty' if input.empty?
-
-    currency = Mint.currency(currency) || parse_currency(input)
-    raise ArgumentError, "Currency [#{currency}] not registered" unless currency
-
-    amount = currency.normalize_amount(parse_amount(input))
-    Mint::Money.new(amount, currency)
-  end
-
-  private
-
-  # Extracts a numeric value from input that should only contain an amount.
-  def parse_amount(input)
-    # Remove any charater that is not a digit, comma or period
-    numeric = input.scan(/[\d.,-]/).join
-    numeric = normalize_separators(numeric)
-    Rational(numeric)
-  end
-
-  def classify_separators(numeric)
-    case [numeric.count(','), numeric.count('.')]
-    in [0, 0] | [0, 1]          then :decimal_period # e.g. "1500" or "34.21".
-    in [1, 0]                   then :decimal_comma  # Only one comma: decimal (e.g. 19,99 or 1,234).
-    in [c, p] if c > 1 && p > 1 then :ambiguous      # Both separators appear multiple times
-    in [c, p] if c > 0 && p > 0 then :mixed          # Commas and dots: the rightmost one is the decimal separator.
-    else                             :thousands_only # Multiple of the same separator only (e.g. 1,234,567)
-    end
-  end
-
-  # Converts locale-specific decimal/thousand separators into a plain decimal string.
-  def normalize_separators(numeric)
-    case classify_separators(numeric)
-    when :decimal_period then numeric              # Nothing to normalize (e.g. "1500" or "34.21").
-    when :decimal_comma  then numeric.tr(',', '.') # Only one comma: decimal (e.g. 19,99 or 1,234).
-    when :thousands_only then numeric.delete(',.')
-    when :ambiguous then raise ArgumentError, "could not distinguish decimal and thousand separators in '#{numeric}'"
-    when :mixed # Commas and dots: the rightmost one is the decimal separator.
-      if numeric.rindex(',') > numeric.rindex('.')
-        numeric.delete('.').tr(',', '.')
-      else
-        numeric.delete(',')
-      end
-    end
-  end
-
-  def parse_currency(input)
-    case input
-    when String
-      # Prefer an explicit ISO 4217 code (e.g. "USD 1,234.56") over symbol matching.
-      currency = Mint.currency(input[/\b([A-Z_]+)\b/, 1])
-      return currency if currency
-
-      # Fall back to registered symbols, longest first (HK$ before $).
-      CurrencyRegistry.currency_symbols.each do |symbol, currency|
-        return currency if input.include?(symbol)
-      end
-    end
-    raise ArgumentError, 'Currency could not be detected'
-  end
-end