minting 1.9.3 → 1.9.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f42e86d079045c4e58c7aee230b1faf32eadc6f6ff33c455f2cfb81fce2894c6
-  data.tar.gz: a06f2900dfe2f743fead4ca7927fdc81b4f9e30e5a51accce428fc78a2315a5e
+  metadata.gz: 429ae46c67aa4b6bb032a9e9be85cbf02b2ee0576cce83c0ad4f36aa0c46e08c
+  data.tar.gz: a5a1c37ad5f6b8ced5e62323803431cd7385577c7a15963b0a29c92f7f7907b8
 SHA512:
-  metadata.gz: 46c5191a5990bf2fec8ca67dcac3cab9fade07d6638b817cf91ce49df40dc63c0e1efbc22eabd776c48d7559912ec7ed82f9ea47d8c7915a5fb76fa9a3e85a9a
-  data.tar.gz: bd11d6eab450a072a299949157ec18b3d23c9c4283fbd06180121a29c01ed1c953f9ba69aceaf0d4261c1438aa330ff0aa56a044a5e724e4b834c100524586dd
+  metadata.gz: ad956434a0dd03f554a638466d44ce049cd7b16e1592f07507954d331d32b5ede3a3f9cb635b6fe9ad6204fe44f840240cbd6d8d49d5c18afcf7b4401328ecab
+  data.tar.gz: 5c81f05414ea2c8f4e6b68daaf5a48a76ab7109c68581246333d99e488d9eec3faf5f5e6dc7e8293f2dfb2d6fb51f01b43ddc49770fde62cb49c05288496a7be

data/README.md

@@ -30,7 +30,7 @@ Minting is faster than the Money gem for everyday operations and **over 10× fas
 Intuitive interface, descriptive error messages, and sensible defaults. Works the way you expect.
 
 ### 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.
+Use with the [attribute-money](https://github.com/gferraz/attribute-money) companion gem for drop-in ActiveRecord type casting, validators, and form helpers.
 
 ### Quality code
 - **100% test coverage** — every line exercised
@@ -57,9 +57,6 @@ require 'minting'
 # Create money
 ten = Mint.money(10, 'USD')            #=> [USD 10.00]
 
-# Create money using Numeric refinements
-using Mint
-
 1.dollar == Mint.money(1, 'USD') #=> true
 ten = 10.dollars                 #=> [USD 10.00]
 4.to_money('USD')                #=> [USD 4.00]
@@ -110,7 +107,7 @@ price_in_euros.to_formatted_s(format: '%<symbol>2s%<amount>+10f')    #=> " €
 
 # Integral & fractional parts
 price.to_formatted_s(format: '%<integral>d %<fractional>d/100')        #=> "9 99/100"
-Mint.money(0.99, 'USD').to_s(format: '%<integral>d dollars and %<fractional>02d cents')
+Mint.money(0.99, 'USD').to_fs(format: '%<integral>d dollars and %<fractional>02d cents')
 #=> "0 dollars and 99 cents"
 
 # Per-sign Hash format (e.g. accounting parentheses for losses)
@@ -213,8 +210,6 @@ Modes: `:half_up` (default), `:half_down`, `:floor`, `:ceil`, `:truncate`, `:dow
 
 > **Performance note:** Rounding-mode support is not loaded by default — `require 'minting'` uses the fastest possible rounding (equivalent to `:half_up`) with zero dispatch overhead. The first call to `Mint.with_rounding` loads the rounding module and patches `Currency#normalize_amount`, adding ~10–35 ns per money creation or mutation. If your application never uses custom rounding modes (the common case), there is **no performance cost**.
 
-**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.
@@ -227,33 +222,32 @@ Modes: `:half_up` (default), `:half_down`, `:floor`, `:ceil`, `:truncate`, `:dow
 
 ## Optional top-level `Money` and `Currency`
 
-By default, Minting keeps everything namespaced under `Mint` to coexist nicely with other gems. If you prefer shorter constants, opt in:
+By default, `require "minting"` exposes `Mint::Money` as the top-level `Money` constant, so you can write `Money.from(10, "USD")` directly:
 
 ```ruby
 require "minting"
-require "minting/dsl"  # opt‑in top‑level Money / Currency
+
+price = Money.from(10, "USD")                   # equivalent to Mint::Money.from
+tax   = Money.from(2.50, "USD")
 ```
 
-Or at runtime:
+`Currency` is **not** auto-bound, because application domain models are commonly named `Currency` (e.g. a Rails model). To opt in to the top-level `Currency` constant:
 
 ```ruby
-Minting.use_top_level_constants!
+require "minting"
+require "minting/mint/aliases"  # opt-in top-level Currency
+
+cur = Currency.new(code: "EUR", symbol: "€", subunit: 2, priority: 0)
 ```
 
-For Rails applications, you can enable the top-level constants in an initializer:
+For Rails applications, you can enable the top-level `Currency` constant in an initializer:
 
 ```ruby
 # config/initializers/minting.rb
-require "minting/dsl"
+require "minting/mint/aliases"
 ```
 
-After opting in:
-
-```ruby
-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)
-```
+If another `Money` is already defined when `require "minting"` runs (e.g. the `money` gem was loaded first), Minting warns and skips the auto-bind — use `Mint::Money` in that case. The same applies to `Currency` via `minting/mint/aliases`.
 
 **Good fit:** Application code, especially Rails apps.
 **Not recommended:** Reusable gems/libraries — stick to `Mint::Money` to avoid conflicts.

data/doc/agents/api_review-2026-06-15.md

@@ -294,7 +294,7 @@ Your README is already strong. To push it over the top vs. `money` gem and frien
      - Always-exact `Rational` amounts.
      - Currency-agnostic zero.
      - Faster formatting (link benchmarks).
-     - Separate `minting-rails` companion for clean Rails integration.
+     - Separate `attribute-money` companion for clean Rails integration.
 
 2. **Add “Common tasks” cheatsheet**
 
@@ -314,7 +314,7 @@ Your README is already strong. To push it over the top vs. `money` gem and frien
 
 3. **Prominent “Rails” heading**
 
-   Right now you just mention `minting-rails`. Make it a full section:
+   Right now you just mention `attribute-money`. Make it a full section:
 
    - How to add gem.
    - Example migration / attribute definition (even if in the other repo, mirror one snippet here).

data/doc/agents/expired/recommendations.md

@@ -253,7 +253,7 @@ Multi-PR epic:
 1. `Mint::Bank` interface with `#exchange(money, target)`.
 2. `Mint::Bank::MemoryStore` (in-memory, good for tests).
 3. `Mint::Bank::ECB` or `Mint::Bank::OpenExchangeRates` (network).
-4. Update `minting-rails` to expose bank config in the Railtie.
+4. Update `attribute-money` to expose bank config in the Railtie.
 
 ### P2-3 Reek / RuboCop tightening
 

data/lib/minting/currency/currency.rb

@@ -88,9 +88,11 @@ module Mint
   #
   # @param object [String, Currency, Money, nil] a currency code, object, or +nil+
   # @return [Currency] the resolved Currency
-  # @raise [ArgumentError] if +object+ cannot be resolved into a registered currency
+  # @raise [Mint::UnknownCurrency] if +object+ cannot be resolved into a
+  #   registered currency. +Mint::UnknownCurrency+ inherits from +ArgumentError+,
+  #   so existing +rescue ArgumentError+ handlers continue to work.
   def Currency.resolve!(object)
-    resolve(object) or raise ArgumentError, "Could not resolve (#{object}) into a currency"
+    resolve(object) or raise Mint::UnknownCurrency, "Could not resolve (#{object}) into a currency"
   end
 
   # Looks up a registered currency by its alpha code.
@@ -114,6 +116,6 @@ module Mint
   #
   # @param currency [String, Currency] a currency code or object
   # @return [Money] a frozen zero-Money
-  # @raise [ArgumentError] if the currency can't be resolved
+  # @raise [Mint::UnknownCurrency] if the currency can't be resolved
   def Currency.zero(currency) = Registry.zero_for(Currency.resolve!(currency))
 end

data/lib/minting/mint/aliases.rb

@@ -1,10 +1,16 @@
 # frozen_string_literal: true
 
-# Optional top‑level aliases for application use.
-# Not required automatically.
-
-# Alias for {Mint::Money} — enables `Money.new(...)` shorthand.
-Money = Mint::Money
-
-# Alias for {Mint::Currency} — enables `Currency.new(...)` shorthand.
-Currency = Mint::Currency
+# Optional top-level alias for Mint::Currency.
+#
+# Mint::Money is auto-bound as the top-level Money constant by
+# `require 'minting'` (see lib/minting.rb). Currency is not auto-bound
+# because application domain models are commonly named Currency (e.g. a
+# Rails model). Require this file to opt in:
+#
+#   require 'minting/mint/aliases'
+#
+if defined?(Currency) && Currency != Mint::Currency
+  warn "minting: top-level Currency is already defined (#{Currency}); skipping alias."
+else
+  Currency = Mint::Currency unless defined?(Currency)
+end

data/lib/minting/mint/dsl/numeric.rb

@@ -1,23 +1,21 @@
 # frozen_string_literal: true
 
-# Mint Numeric refinements
-module Mint
-  refine Numeric do
-    # @return [Money] self interpreted as BRL
-    def reais = Mint::Money.from(self, 'BRL')
+# Core extension: adds money-conversion helpers to Numeric.
+class Numeric
+  # @return [Money] self interpreted as BRL
+  def reais = Mint::Money.from(self, 'BRL')
 
-    # @return [Money] self interpreted as USD
-    def dollars = Mint::Money.from(self, 'USD')
+  # @return [Money] self interpreted as USD
+  def dollars = Mint::Money.from(self, 'USD')
 
-    # @return [Money] self interpreted as EUR
-    def euros = Mint::Money.from(self, 'EUR')
+  # @return [Money] self interpreted as EUR
+  def euros = Mint::Money.from(self, 'EUR')
 
-    # @param currency [String, Symbol, Currency] target currency
-    # @return [Money] self interpreted as the given currency
-    def to_money(currency) = Mint::Money.from(self, currency)
+  # @param currency [String, Symbol, Currency] target currency
+  # @return [Money] self interpreted as the given currency
+  def to_money(currency) = Mint::Money.from(self, currency)
 
-    alias_method :dollar, :dollars
-    alias_method :euro, :euros
-    alias_method :mint, :to_money
-  end
+  alias dollar dollars
+  alias euro euros
+  alias mint to_money
 end

data/lib/minting/mint/dsl/string.rb

@@ -1,12 +1,10 @@
 # frozen_string_literal: true
 
-# Mint String refinement
-module Mint
-  refine String do
-    # Parses self as a numeric string and creates a Money in the given currency.
-    #
-    # @param currency [String, Symbol, Currency] target currency
-    # @return [Money]
-    def to_money(currency) = Mint::Money.from(to_r, currency)
-  end
+# Core extension: adds money-parsing helper to String.
+class String
+  # Parses self as a numeric string and creates a Money in the given currency.
+  #
+  # @param currency [String, Symbol, Currency] target currency
+  # @return [Money]
+  def to_money(currency = nil) = Mint::Money.parse(self, currency)
 end

data/lib/minting/mint/i18n.rb

@@ -13,7 +13,7 @@ module Mint
     # When set, +#to_formatted_s+ and +#format+ use these values as fallbacks when the
     # corresponding parameter is not explicitly provided.
     #
-    # @example Rails I18n integration (in minting-rails railtie)
+    # @example Rails I18n integration (in attribute-money railtie)
     #   Mint.locale_backend = -> {
     #     fmt = I18n.t('number.currency.format')
     #     {

data/lib/minting/mint/mint.rb

@@ -2,8 +2,11 @@
 
 # Mint currency registration and factory (public API)
 module Mint
-  # Unknown currency excpetion
-  class UnknownCurrency < StandardError
+  # Raised when a currency cannot be resolved from a code or object.
+  #
+  # Inherits from +ArgumentError+ so existing +rescue ArgumentError+ handlers
+  # continue to work; rescue +Mint::UnknownCurrency+ for the specific case.
+  class UnknownCurrency < ArgumentError
   end
 
   # Creates a new {Money} instance with the given amount and currency code.
@@ -11,7 +14,9 @@ module Mint
   # @param amount [Numeric] the financial value
   # @param currency_code [Currency, String] Currency code
   # @return [Money] the instantiated Money object
-  # @raise [ArgumentError] if the currency code is not registered
+  # @raise [ArgumentError] if the amount is not a Numeric
+  # @raise [Mint::UnknownCurrency] if the currency code is not registered.
+  #   +Mint::UnknownCurrency+ inherits from +ArgumentError+.
   def self.money(amount, currency_code) = Money.from(amount, currency_code)
 
   # @return [Hash{String => Currency}] the frozen world-currencies hash

data/lib/minting/mint.rb

@@ -5,7 +5,6 @@ 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/i18n'
 require_relative 'mint/mint'
 require_relative 'mint/parser/parser'

data/lib/minting/money/constructors.rb

@@ -7,7 +7,8 @@ module Mint
     # @param amount [Numeric] The monetary amount
     # @param currency [Currency, String] The currency code or currency object
     # @return [Money] the new Money instance
-    # @raise [ArgumentError] If amount is not numeric or currency is invalid
+    # @raise [ArgumentError] If amount is not numeric
+    # @raise [Mint::UnknownCurrency] If currency cannot be resolved
     # @example
     #   Money.from(10, 'USD')  #=> [USD 10.00]
     def self.from(amount, currency)
@@ -61,16 +62,9 @@ module Mint
     #
     # @param currency [String, Currency] a currency code or object
     # @return [Money] a frozen zero-Money
-    # @raise [ArgumentError] if the currency can't be resolved
+    # @raise [Mint::UnknownCurrency] if the currency can't be resolved
     def self.zero(currency) = Currency.resolve!(currency).zero
 
-    # Backwards-compatible alias for previous API
-    # TODO: deprecate in a future major release
-    def self.create(amount, currency)
-      warn 'Money.create is now deprecated. Use Money.from'
-      from(amount, currency)
-    end
-
     # Builds a Money from a subunit (smallest-unit) Integer amount.
     # This is the inverse of {#subunits}: for USD, the subunit is
     # 1 cent; for JPY it is 1 yen; for IQD it is 1 dinar (subunit 3).
@@ -79,8 +73,8 @@ module Mint
     #   smallest unit (e.g. cents). Must be an Integer to preserve exactness.
     # @param currency [String, Symbol, Currency] the currency identifier
     # @return [Money] the resulting Money instance
-    # @raise [ArgumentError] if +subunits+ is not an Integer or +currency+
-    #   is not registered
+    # @raise [ArgumentError] if +subunits+ is not an Integer
+    # @raise [Mint::UnknownCurrency] if +currency+ is not registered
     #
     # @example USD cents
     #   Money.from_subunits(123_456, 'USD') #=> [USD 1234.56]

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.9.3'
+  VERSION = '1.9.5'
 end

data/lib/minting.rb

@@ -2,3 +2,13 @@
 
 require 'minting/mint'
 require 'minting/version'
+
+# By default, expose Mint::Money as the top-level Money constant for
+# convenience. If Money is already defined (e.g. by the `money` gem), warn
+# and skip so both libraries can coexist in the same process without
+# corrupting either class.
+if defined?(Money) && Money != Mint::Money
+  warn "minting: top-level Money is already defined (#{Money}); skipping auto-bind. Use Mint::Money."
+else
+  Money = Mint::Money unless defined?(Money)
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: minting
 version: !ruby/object:Gem::Version
-  version: 1.9.3
+  version: 1.9.5
 platform: ruby
 authors:
 - Gilson Ferraz
@@ -74,7 +74,6 @@ files:
 - lib/minting/mint/dsl/numeric.rb
 - lib/minting/mint/dsl/range.rb
 - lib/minting/mint/dsl/string.rb
-- lib/minting/mint/dsl/top_level.rb
 - lib/minting/mint/i18n.rb
 - lib/minting/mint/mint.rb
 - lib/minting/mint/parser/parser.rb

data/lib/minting/mint/dsl/top_level.rb

@@ -1,17 +0,0 @@
-# frozen_string_literal: true
-
-# Mint refinements
-module Mint
-  # Registers top-level ::Money and ::Currency constants as aliases for Mint's classes.
-  #
-  # @raise [NameError] if ::Money or ::Currency are already defined and differ
-  def self.use_top_level_constants!
-    if !defined?(::Money) && !defined?(::Currency)
-      require 'minting/mint/aliases'
-    elsif ::Money == Mint::Money && ::Currency == Mint::Currency
-      warn 'Warning: Money and Currency already defined as Mint aliases, skipping'
-    else
-      raise NameError, 'Cannot define top-level Money or Currency constants: already defined'
-    end
-  end
-end