minting 1.0.1 → 1.1.1

data/lib/minting/money/parse.rb

@@ -0,0 +1,82 @@
+module Mint
+  # nodoc
+  class Money
+    # Parses a human-readable money string into a {Money} object.
+    #
+    # @param input [String] Amount input, optionally including a currency symbol or code
+    # @param currency [String, Symbol, Currency, nil] ISO code when not present in +input+
+    # @return [Money]
+    # @raise [ArgumentError] when +input+ is invalid or currency cannot be determined
+    #
+    # @example With explicit currency
+    #   Money.parse('19.99', 'USD')    #=> [USD 19.99]
+    #   Money.parse('1.234,56', 'EUR') #=> [EUR 1234.56]
+    #
+    # @example With symbol or code in the string
+    #   Money.parse('$19.99')            #=> [USD 19.99]
+    #   Money.parse('19,99 €')         #=> [EUR 19.99]
+    #   Money.parse('USD 1,234.56')    #=> [USD 1234.56]
+    def self.parse(input, currency = nil)
+      raise ArgumentError, 'input must be a String' unless input.is_a?(String)
+
+      input = input.strip
+      raise ArgumentError, 'input cannot be empty' if input.empty?
+
+      currency = currency ? Mint.currency(currency) : parse_currency(input)
+      raise ArgumentError, "Currency [#{currency}] not registered" unless currency
+
+      amount = parse_amount(input)
+      new(amount, currency)
+    end
+
+    # 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 = normalize_separators(numeric)
+      Rational(numeric)
+    end
+
+    # Converts locale-specific decimal/thousand separators into a plain decimal string.
+    def self.normalize_separators(numeric)
+      case [numeric.count(','), numeric.count('.')]
+      in [0, 0] | [0, 1] # Nothing to normalize (e.g. "1500" or "34.21").
+        numeric
+      in [1, 0] # Only one comma: decimal (e.g. 19,99 or 1,234).
+        numeric.tr(',', '.')
+      in [c, p] if c > 1 && p > 1 # Both separators appear multiple times
+        raise ArgumentError, "could not distinguish decimal and thousand separators in '#{numeric}'"
+      in [c, p] if c > 0 && p > 0 # Commas and dots: the rightmost one is the decimal separator.
+        if numeric.rindex(',') > numeric.rindex('.')
+          numeric.delete('.').tr(',', '.')
+        else
+          numeric.delete(',')
+        end
+      else # Multiple of the same separator only (e.g. 1,234,567) — all are thousands.
+        numeric.delete(',.')
+      end
+    end
+
+    def self.parse_currency(input)
+      # Prefer an explicit ISO 4217 code (e.g. "USD 1,234.56") over symbol matching.
+      code = input[/\b([A-Z]{3})\b/, 1]
+      if code
+        currency = Mint.currency(code)
+        return currency if currency
+      end
+
+      # Fall back to registered symbols, longest first (HK$ before $).
+      Mint.currency_symbols.each do |symbol, currency|
+        next if symbol.empty?
+
+        return currency if input.include?(symbol)
+      end
+
+      raise ArgumentError,
+            'currency could not be detected; pass a currency code as the second argument'
+    end
+
+    private_class_method :parse_amount, :normalize_separators,
+                         :parse_currency
+  end
+end

data/lib/minting/money.rb

@@ -1,3 +1,4 @@
+require 'minting/money/parse'
 require 'minting/money/allocation'
 require 'minting/money/arithmetics'
 require 'minting/money/coercion'

data/lib/minting/version.rb

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

data/minting.gemspec

@@ -29,7 +29,7 @@ Gem::Specification.new do |s|
   s.required_ruby_version = '>= 3.2.0'
 
   s.files = Dir.glob('{bin,doc,lib}/**/*')
-  s.files += %w[minting.gemspec Rakefile README.md]
+  s.files += %w[minting.gemspec Rakefile README.md LICENSE]
 
   s.bindir        = 'bin'
   s.require_paths = ['lib']

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: minting
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 1.1.1
 platform: ruby
 authors:
 - Gilson Ferraz
@@ -15,11 +15,13 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- LICENSE
 - README.md
 - Rakefile
 - bin/console
 - bin/setup
 - lib/minting.rb
+- lib/minting/data/currencies.yaml
 - lib/minting/mint.rb
 - lib/minting/mint/currency.rb
 - lib/minting/mint/refinements.rb
@@ -32,6 +34,7 @@ files:
 - lib/minting/money/conversion.rb
 - lib/minting/money/formatting.rb
 - lib/minting/money/money.rb
+- lib/minting/money/parse.rb
 - lib/minting/version.rb
 - minting.gemspec
 homepage: https://github.com/gferraz/minting
@@ -58,7 +61,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.7.1
+rubygems_version: 4.0.9
 specification_version: 4
 summary: Library to manipulate currency values
 test_files: []