minting 1.7.2 → 1.7.3

data/lib/minting/mint/registry/zeros.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Mint
+  # :nodoc:
+  module Registry
+    # Returns the cached zero-Money for a currency, creating it if needed.
+    #
+    # @param currency [Currency] the currency object
+    # @return [Money] a frozen zero-Money
+    # @api private
+    def self.zero_for(currency)
+      MUTEX.synchronize do
+        @zeros ||= {}
+        @zeros[currency] ||= Mint::Money.send(:new, 0, currency)
+      end
+    end
+  end
+end

data/lib/minting/mint.rb

@@ -1,27 +1,15 @@
 # frozen_string_literal: true
 
-require 'minting/currency/currency'
-require 'minting/currency/currency_registry'
-require 'minting/currency/world_currencies'
-
-require 'minting/mint/dsl/numeric'
-require 'minting/mint/dsl/range'
-require 'minting/mint/dsl/string'
-require 'minting/mint/dsl/top_level'
-
-require 'minting/mint/mint'
-require 'minting/mint/parser/parser'
-require 'minting/mint/parser/separators'
-
-require 'minting/money/allocation/allocation'
-require 'minting/money/allocation/split'
-require 'minting/money/arithmetics/methods'
-require 'minting/money/arithmetics/operators'
-require 'minting/money/clamp'
-require 'minting/money/coercion'
-require 'minting/money/comparable'
-require 'minting/money/constructors'
-require 'minting/money/conversion'
-require 'minting/money/format/formatting'
-require 'minting/money/format/to_s'
-require 'minting/money/money'
+require_relative 'currency/currency'
+
+require_relative 'mint/dsl/numeric'
+require_relative 'mint/dsl/range'
+require_relative 'mint/dsl/string'
+require_relative 'mint/dsl/top_level'
+require_relative 'mint/locale_backend'
+require_relative 'mint/mint'
+require_relative 'mint/parser/parser'
+require_relative 'mint/parser/separators'
+require_relative 'mint/registry/registry'
+
+require_relative 'money/money'

data/lib/minting/money/constructors.rb

@@ -10,12 +10,10 @@ module Mint
     def self.create(amount, currency)
       raise ArgumentError, 'amount must be Numeric' unless amount.is_a?(Numeric)
 
-      checked_currency = Mint.currency(currency)
-      raise ArgumentError, "Currency not found (#{currency})" unless checked_currency
+      currency = Currency.resolve!(currency)
+      amount = currency.normalize_amount(amount)
 
-      amount = checked_currency.normalize_amount(amount)
-
-      amount.zero? ? Mint.zero(checked_currency) : new(amount, checked_currency)
+      amount.zero? ? Mint.zero(currency) : new(amount, currency)
     end
 
     # Builds a Money from a fractional (smallest-unit) Integer amount.
@@ -39,12 +37,9 @@ module Mint
     def self.from_fractional(fractional, currency)
       raise ArgumentError, 'fractional must be an Integer' unless fractional.is_a?(Integer)
 
-      checked_currency = Mint.currency(currency)
-      raise ArgumentError, "Currency not found (#{currency})" unless checked_currency
-
-      amount = Rational(fractional, checked_currency.fractional_multiplier)
-
-      amount.zero? ? Mint.zero(checked_currency) : new(amount, checked_currency)
+      currency = Currency.resolve!(currency)
+      amount = Rational(fractional, currency.fractional_multiplier)
+      amount.zero? ? Mint.zero(currency) : new(amount, currency)
     end
 
     # Returns a new Money object with the specified amount, or self if unchanged.

data/lib/minting/money/format/formatting.rb

@@ -5,6 +5,22 @@ module Mint
   class Money
     private
 
+    # Resolves format/decimal/thousand from locale_backend when not explicitly given.
+    # @private
+    def resolve_locale_for(format, decimal, thousand)
+      locale = locale_backend
+      [format || locale[:format] || '%<symbol>s%<amount>f',
+       decimal || locale[:decimal] || '.',
+       thousand || locale[:thousand] || ',']
+    end
+
+    def locale_backend
+      bk = Mint.locale_backend
+      return {} unless bk.respond_to?(:call)
+
+      bk.call
+    end
+
     # Selects the appropriate format template and value based on the amount's sign.
     # @private
     def select_format(format)

data/lib/minting/money/format/to_s.rb

@@ -5,7 +5,7 @@ module Mint
   class Money
     # Formats money as a string with customizable format, thousand delimiter, and decimal
     #
-    # @param format [String, Hash] Either a Format string with placeholders
+    # @param format [String, Hash, nil] Either a Format string with placeholders
     #   (%<symbol>s, %<amount>f, %<currency>s), or a Hash with per-sign keys
     #   (:positive, :negative, :zero) each holding a format string. A Hash
     #   is convenient for sign-aware formats such as accounting parentheses:
@@ -15,8 +15,12 @@ module Mint
     #   Missing keys fall back to the module default, so a Hash with only
     #   :negative will still format positives sensibly. The valid keys are
     #   :positive, :negative, :zero; anything else raises ArgumentError.
-    # @param thousand [String, false] Thousands delimiter (e.g., ',' for 1,000)
-    # @param decimal [String] Decimal separator (e.g., '.' or ',')
+    #   When +nil+, falls back to +Mint.locale_backend+ if set, otherwise
+    #   +"%<symbol>s%<amount>f"+.
+    # @param thousand [String, false, nil] Thousands delimiter (e.g., ',' for 1,000).
+    #   When +nil+, falls back to +Mint.locale_backend+ if set, otherwise +","+.
+    # @param decimal [String, nil] Decimal separator (e.g., '.' or ',').
+    #   When +nil+, falls back to +Mint.locale_backend+ if set, otherwise +"."+.
     # @return [String] Formatted money string
     #
     # @raise [ArgumentError] if +format+ is not a String or Hash, the Hash
@@ -43,7 +47,12 @@ module Mint
     #   money.to_s(format: '%<amount>10.2f')                #=> "   1234.56"
     #   money.to_s(format: '%<symbol>s%<amount>010.2f')     #=> "$0001234.56"
     #
-    def to_s(format: '%<symbol>s%<amount>f', decimal: '.', thousand: ',', width: nil)
+    # @example Locale-aware formatting (with Mint.locale_backend set)
+    #   money.to_s  # decimal and thousand come from locale_backend
+    #
+    def to_s(format: nil, decimal: nil, thousand: nil, width: nil)
+      format, decimal, thousand = resolve_locale_for(format, decimal, thousand)
+
       case format
       when {}, '' then raise ArgumentError, 'format must not be empty'
       when Hash   then validate_format_hash(format)

data/lib/minting/money/money.rb

@@ -1,5 +1,17 @@
 # frozen_string_literal: true
 
+require_relative 'allocation/allocation'
+require_relative 'allocation/split'
+require_relative 'arithmetics/methods'
+require_relative 'arithmetics/operators'
+require_relative 'clamp'
+require_relative 'coercion'
+require_relative 'comparable'
+require_relative 'constructors'
+require_relative 'conversion'
+require_relative 'format/formatting'
+require_relative 'format/to_s'
+
 module Mint
   # Money constructors
   class Money

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.2'
+  VERSION = '1.7.3'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: minting
 version: !ruby/object:Gem::Version
-  version: 1.7.2
+  version: 1.7.3
 platform: ruby
 authors:
 - Gilson Ferraz
@@ -41,14 +41,16 @@ files:
 - doc/Mint/CurrencyRegistry.html
 - doc/Mint/Money.html
 - doc/Mint/RangeStepPatch.html
+- doc/Mint/Registry.html
 - doc/Mint/UnknownCurrency.html
 - doc/Minting.html
 - doc/_index.html
-- doc/agents/AGENTS.md
-- doc/agents/copilot-instructions.md
-- doc/agents/gemini_gem_evaluation.md
-- doc/agents/recommendations.md
-- doc/agents/rubocop-issues.md
+- doc/agents/api_review-2026-06-15.md
+- doc/agents/expired/AGENTS.md
+- doc/agents/expired/copilot-instructions.md
+- doc/agents/expired/gemini_gem_evaluation.md
+- doc/agents/expired/recommendations.md
+- doc/agents/expired/rubocop-issues.md
 - doc/class_list.html
 - doc/css/common.css
 - doc/css/full_list.css
@@ -64,8 +66,6 @@ files:
 - 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
@@ -73,9 +73,14 @@ files:
 - lib/minting/mint/dsl/range.rb
 - lib/minting/mint/dsl/string.rb
 - lib/minting/mint/dsl/top_level.rb
+- lib/minting/mint/locale_backend.rb
 - lib/minting/mint/mint.rb
 - lib/minting/mint/parser/parser.rb
 - lib/minting/mint/parser/separators.rb
+- lib/minting/mint/registry/registration.rb
+- lib/minting/mint/registry/registry.rb
+- lib/minting/mint/registry/symbols.rb
+- lib/minting/mint/registry/zeros.rb
 - lib/minting/money/allocation/allocation.rb
 - lib/minting/money/allocation/split.rb
 - lib/minting/money/arithmetics/methods.rb

data/lib/minting/currency/currency_registry.rb

@@ -1,67 +0,0 @@
-# frozen_string_literal: true
-
-require 'yaml'
-
-# Mint currency store (internal)
-module Mint
-  # Internal currency registry
-  # Manages the registry cache and currency symbol lookups.
-  module CurrencyRegistry
-    extend self
-
-    # Returns the hash of all registered currencies.
-    #
-    # @return [Hash{String => Currency}] registered currencies mapped by code
-    # @api private
-    def currencies
-      @currencies ||= Mint.world_currencies.dup
-    end
-
-    # Registered symbols sorted for detection: longest match wins, then parser priority.
-    #
-    # @return [Array<Array<String, Currency>>] sorted symbol-to-currency mappings
-    # @api private
-    def currency_symbols
-      @currency_symbols ||= begin
-        currencies.values
-                  .reject { |c| c.symbol.empty? }
-                  .map { |currency| [currency.symbol, currency] }
-                  .sort_by { |symbol, currency| [-symbol.length, -currency.priority] }
-      end.freeze
-    end
-
-    # Registers a new currency, raising a KeyError if already registered.
-    #
-    # @param code [String] the unique currency code
-    # @param subunit [Integer] the decimal subunit precision, defaults to 0
-    # @param symbol [String] the display symbol
-    # @param priority [Integer] parser precedence priority
-    # @return [Currency] the newly registered Currency instance
-    # @raise [ArgumentError] if the code contains invalid characters
-    # @raise [KeyError] if the currency code is already registered
-    def register(code:, subunit: 0, symbol: '', priority: 0)
-      raise ArgumentError, 'Currency code must be String' unless code.is_a? String
-      unless code.match?(/^[A-Z_]+$/)
-        raise ArgumentError,
-              "Currency code must have only letters or '_' ('USD',, 'MY_COIN')"
-      end
-
-      currencies = CurrencyRegistry.currencies
-      raise KeyError, "Currency: #{code} already registered" if currencies[code]
-
-      currency = currencies[code] = Currency.new(code:, subunit:, symbol:, priority:)
-      invalidate_symbols_cache
-      currency
-    end
-
-    private
-
-    # Clears and refreshes the currency symbol cache.
-    # Called when currencies are registered.
-    #
-    # @api private
-    def invalidate_symbols_cache
-      @currency_symbols = nil
-    end
-  end
-end

data/lib/minting/currency/world_currencies.rb

@@ -1,16 +0,0 @@
-# frozen_string_literal: true
-
-# Mint list of world currencies
-module Mint
-  # Loads ISO world currencies from YAML file into the registry.
-  #
-  # @return [Hash{String => Currency}] ISO-4217 world currencies mapped by code
-  # @api private
-  def self.world_currencies
-    @world_currencies ||= begin
-      path = File.join(File.expand_path('../data', __dir__), 'world-currencies.yaml')
-
-      YAML.load_file(path).to_h { |entry| [entry['code'], Currency.new(**entry.transform_keys(&:to_sym))] }
-    end.freeze
-  end
-end