minting 1.9.4 → 1.9.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e784f15a78d9890f02c3b44c95ab975bd8a12647c27d87531059603fa0e5cab5
-  data.tar.gz: 83e28899e8e8cedcd98a93fd2b787470485d8f440ba82f63138499dc1ba33c20
+  metadata.gz: 429ae46c67aa4b6bb032a9e9be85cbf02b2ee0576cce83c0ad4f36aa0c46e08c
+  data.tar.gz: a5a1c37ad5f6b8ced5e62323803431cd7385577c7a15963b0a29c92f7f7907b8
 SHA512:
-  metadata.gz: dc823a1170e16ae3ef0751d2e35200b681e89c42d8480d7dfb6117c9f7b6dbe8b6d5cec2fa47a57755e0f52eeb0324a5dd560a359729307aa19186625490f6fc
-  data.tar.gz: a281aae01fc2e2472c0697ea02f6d68f21c64ecb9acb9c8704a70bba35a8e7dafa0523f8d6696c93c818c67488c81c6c2b3d117cc48a5f0720eeaaa31607dac1
+  metadata.gz: ad956434a0dd03f554a638466d44ce049cd7b16e1592f07507954d331d32b5ede3a3f9cb635b6fe9ad6204fe44f840240cbd6d8d49d5c18afcf7b4401328ecab
+  data.tar.gz: 5c81f05414ea2c8f4e6b68daaf5a48a76ab7109c68581246333d99e488d9eec3faf5f5e6dc7e8293f2dfb2d6fb51f01b43ddc49770fde62cb49c05288496a7be

data/README.md

@@ -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]
@@ -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.

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

metadata

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