minting 1.1.2 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9506e71f742812607fef378d4df90eaea6d2457f0d818b55b6e06b6167fa6876
-  data.tar.gz: 99b200de879dfb9ed4eaec21b02067a886c01d48116fcb669ca70b5dbf314264
+  metadata.gz: b05d1cbbf6c714102f38f165effba77384e4fc5cebf691d4b9ab75082c22b992
+  data.tar.gz: 2d5bb5aeb6e527a2d4419bcca35d79c426709797975e9ec38217558d875ea9b8
 SHA512:
-  metadata.gz: 01b120551584f7f6327f2db19731367dd091bfb3e7b9db91d98cd2ff0b7e1db41d4c190acc66d8cd611fe7689ddb8872b89bebe9db6506e267df121c60fbe6f1
-  data.tar.gz: 8cc6a7ffc780a555276298432de7c2929c5ffddadc4fc28b379a8c58245b70672a777e610e464b6ea485583a8b65eb7463b37e29ff422b9e065ecd1f565cb85a
+  metadata.gz: ce7311d97cbe60c2f71ba5f65d1313704084eebae842e012c2cd857230055ef56007575e8f89887f8ae157c004d205e43370ada8d2fc2b5f3ea00b7c21c8017a
+  data.tar.gz: e4903099bb997667472ddc0c26ff07b3894bb9fa5122221c94045d84f2699e28d203646429e341a8119177a07212991f04d36c5806a12c8388766a3a8aebb6eb

data/README.md

@@ -91,6 +91,11 @@ price_in_euros.to_s(format: '%<symbol>2s%<amount>+10f')    #=> " €    +12.34"
 
 price.to_json # => "{ "currency": "USD", "amount": "9.99" }"
 
+# Hash conversion
+
+price.to_hash #=> {currency: "USD", amount: "9.99"}
+
+
 # Proportional allocation and split
 
 ten.split(3)                           #=> [[USD 3.34], [USD 3.33], [USD 3.33]]

data/Rakefile

@@ -12,18 +12,23 @@ Rake::TestTask.new(:test) do |t|
   t.ruby_opts << '-rtest_helper.rb'
 end
 
-Rake::TestTask.new(:bench) do |t|
+Rake::TestTask.new('bench') do |t|
   t.libs = %w[lib test]
   t.pattern = 'test/performance/*_benchmark.rb'
 end
 
+Rake::TestTask.new('bench:parse') do |t|
+  t.libs = %w[lib test]
+  t.pattern = 'test/performance/parse_benchmark.rb'
+  t.ruby_opts << '-r test_helper.rb'
+end
+
 Rake::TestTask.new('bench:edge') do |t|
   t.libs = %w[lib test]
   t.pattern = 'test/performance/algorithm_benchmark.rb'
   t.ruby_opts << '-r test_helper.rb'
 end
 
-
 Rake::TestTask.new('bench:regression') do |t|
   t.libs = %w[lib test]
   t.pattern = 'test/performance/regression_benchmark.rb'

data/lib/minting/mint/currency.rb

@@ -3,7 +3,10 @@ module Mint
   #
   # @see https://www.iso.org/iso-4217-currency-codes.html
   class Currency
-    attr_reader :code, :subunit, :symbol, :priority, :minimum_amount, :country, :name
+    attr_reader :code, :subunit, :symbol,
+                :country,
+                :fractional_multiplier, :minimum_amount,
+                :name, :priority
 
     def inspect
       "<Currency:(#{code} #{symbol} #{subunit})>"
@@ -18,7 +21,8 @@ module Mint
       @priority = priority.to_i
       @country = country
       @name = name
-      @minimum_amount = 10r**-@subunit
+      @fractional_multiplier = 10**@subunit
+      @minimum_amount = 1r / fractional_multiplier
       freeze
     end
   end

data/lib/minting/mint/registry.rb

@@ -14,6 +14,9 @@ module Mint
     raise ArgumentError, "Currency [#{currency_code}] not registered. Check Mint.currencies"
   end
 
+  # Returns default zero, no currency money
+  def self.zero = @zero ||= Money.new(0, Mint.currency('XXX'))
+
   # Finds a registered currency by its code, symbol,
   # or retrieves it directly if already a Currency object.
   #
@@ -34,11 +37,11 @@ module Mint
   #
   # @param code [String, Symbol] the unique currency code (e.g. 'USD', :EUR)
   # @param subunit [Integer] the decimal subunit precision (defaults to 2)
-  # @param symbol [String] the display symbol (defaults to '$')
+  # @param symbol [String] the display symbol (defaults to '')
   # @param priority [Integer] parser precedence priority (defaults to 0)
   # @return [Currency] the registered or existing Currency instance
   # @raise [ArgumentError] if the code layout is invalid or register throws an error
-  def self.register_currency(code:, subunit: 2, symbol: '$', priority: 0)
+  def self.register_currency(code:, subunit: 2, symbol: '', priority: 0)
     code = code.to_s
     currencies[code] || register_currency!(code:, subunit:, symbol:, priority:)
   end

data/lib/minting/money/allocation.rb

@@ -14,7 +14,8 @@ module Mint
       raise ArgumentError, 'Need at least 1 proportion element' if proportions.empty?
       raise ArgumentError, 'Proportions total must not be zero' if whole.zero?
 
-      amounts = proportions.map { |rate| (amount * rate.to_r / whole).round(currency.subunit) }
+      subunit = currency.subunit
+      amounts = proportions.map { |rate| (amount * rate.to_r / whole).round(subunit) }
       allocate_left_over!(amounts: amounts, left_over: amount - amounts.sum)
     end
 

data/lib/minting/money/arithmetics.rb

@@ -3,7 +3,7 @@ module Mint
     # Returns the absolute value of the monetary amount as a new {Money} instance.
     #
     # @return [Money] the absolute value
-    def abs =     mint(amount.abs)
+    def abs = mint(amount.abs)
 
     # Returns true if the monetary amount is less than zero.
     #

data/lib/minting/money/conversion.rb

@@ -39,15 +39,17 @@ module Mint
       amount.to_i
     end
 
+    def to_hash
+      { currency: currency_code, amount: Kernel.format("%0.#{currency.subunit}f", amount) }
+    end
+
     # Serializes the money instance to a standard JSON object containing the amount and currency.
     # Highly optimized to run without external dependencies.
     #
     # @return [String] the JSON serialized string representation
     def to_json(*_args)
-      subunit = currency.subunit
       Kernel.format(
-        %({"currency": "#{currency_code}", "amount": "%0.#{subunit}f"}),
-        amount
+        %({"currency": "#{currency_code}", "amount": "%0.#{currency.subunit}f"}), amount
       )
     end
 

data/lib/minting/money/money.rb

@@ -24,6 +24,8 @@ module Mint
     # @return [String] the ISO currency code
     def currency_code = currency.code
 
+    def fractional = (amount * currency.fractional_multiplier).to_i
+
     # Generates a stable hash key for Money instances.
     #
     # @return [Integer] the calculated hash value
@@ -33,7 +35,7 @@ module Mint
     # @param new_amount [Numeric] The new amount
     # @return [Money] A new Money object or self
     def mint(new_amount)
-      new_amount.to_r == amount ? self : Money.new(new_amount, currency)
+      new_amount == amount ? self : Money.new(new_amount, currency)
     end
 
     # Returns a standard developer-oriented string inspection of the Money object.
@@ -48,8 +50,5 @@ module Mint
     # @param other [Object] the target object to compare
     # @return [Boolean] true if currencies match, false otherwise
     def same_currency?(other) = other.respond_to?(:currency) && other.currency == currency
-
-    # Returns default zero no currency money
-    def self.zero = @zero ||= new(0, Mint.currencies('XXX'))
   end
 end

data/lib/minting/money/parse.rb

@@ -32,7 +32,7 @@ module Mint
     # Extracts a numeric value from input that should only contain an amount.
     def self.parse_amount(input)
       # Remove any charater that is not a digit, comma or period
-      numeric = input.scan(/[\d.\-,]/).join
+      numeric = input.scan(/[\d.,-]/).join
       numeric = normalize_separators(numeric)
       Rational(numeric)
     end

data/lib/minting/version.rb

@@ -1,5 +1,5 @@
 # Root namespace for the Minting library.
 module Minting
   # Current version of the Minting gem.
-  VERSION = '1.1.2'.freeze
+  VERSION = '1.2.0'.freeze
 end

metadata

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