minting 1.9.3 → 1.9.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f42e86d079045c4e58c7aee230b1faf32eadc6f6ff33c455f2cfb81fce2894c6
-  data.tar.gz: a06f2900dfe2f743fead4ca7927fdc81b4f9e30e5a51accce428fc78a2315a5e
+  metadata.gz: e784f15a78d9890f02c3b44c95ab975bd8a12647c27d87531059603fa0e5cab5
+  data.tar.gz: 83e28899e8e8cedcd98a93fd2b787470485d8f440ba82f63138499dc1ba33c20
 SHA512:
-  metadata.gz: 46c5191a5990bf2fec8ca67dcac3cab9fade07d6638b817cf91ce49df40dc63c0e1efbc22eabd776c48d7559912ec7ed82f9ea47d8c7915a5fb76fa9a3e85a9a
-  data.tar.gz: bd11d6eab450a072a299949157ec18b3d23c9c4283fbd06180121a29c01ed1c953f9ba69aceaf0d4261c1438aa330ff0aa56a044a5e724e4b834c100524586dd
+  metadata.gz: dc823a1170e16ae3ef0751d2e35200b681e89c42d8480d7dfb6117c9f7b6dbe8b6d5cec2fa47a57755e0f52eeb0324a5dd560a359729307aa19186625490f6fc
+  data.tar.gz: a281aae01fc2e2472c0697ea02f6d68f21c64ecb9acb9c8704a70bba35a8e7dafa0523f8d6696c93c818c67488c81c6c2b3d117cc48a5f0720eeaaa31607dac1

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
@@ -110,7 +110,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)
@@ -227,33 +227,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/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/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.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/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.4'
 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.4
 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