extenso_pt 0.6.12 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2edd9a523eac9facf5a8860a49d7331d8a0ff75c34f8ff50ddd587908e10555b
-  data.tar.gz: 3dec90e595971ebf76d07df1fbb0c38de5f2e217aae22f4c6ee44d161998e5c3
+  metadata.gz: 585d41335b5503f750798310e043e7a90a55b37a616eb2fc34e8399cc7bde3df
+  data.tar.gz: 86f6231beffdac04d18c5a32a452e48fa090e70d24a12912d0fecdb88dfbbe57
 SHA512:
-  metadata.gz: c078f5c9f5b7aeb079391ef13c2c452838ef01ff72742dc73a6c89a98bd736a7286331e3002cb084bfe4e0b56fc61f39226d866fe89c24afbbd5d3cf3876f096
-  data.tar.gz: ca1514d646ad8b2b596dcd7b9e62094b586a19df9fb302bc921957e2edca10f99b82e08d9ca3e57a1816a577a6c9bf9d76754aa294b381aa7aec1fac2b34644b
+  metadata.gz: 8a3741e89853e408a92e655c5333cd1e718f1b5d308f9b09ba5c50302f77de1560d272da2f9aff18c956e952f870b3964425222d4faff673fe491581b2e40bd7
+  data.tar.gz: 113ac582f6ac5f4554b83dd64ca4e842b45b2f470c6fbfb4c1154633090fa6a8157aaf027aaecb7502623ead61b361524d7e13c9e2a72d624c9f62e976796d19

data/Gemfile.lock

@@ -1,24 +1,24 @@
 PATH
   remote: .
   specs:
-    extenso_pt (0.6.12)
-      bigdecimal (~> 1.4)
+    extenso_pt (0.7.0)
+      bigdecimal
 
 GEM
   remote: https://rubygems.org/
   specs:
-    bigdecimal (1.4.4)
-    minitest (5.14.0)
+    bigdecimal (2.0.0)
+    minitest (5.14.1)
     rake (13.0.1)
 
 PLATFORMS
   ruby
 
 DEPENDENCIES
-  bundler (~> 1.17)
+  bundler
   extenso_pt!
-  minitest (~> 5.0)
+  minitest
   rake
 
 BUNDLED WITH
-   1.17.2
+   2.1.2

data/extenso_pt.gemspec

@@ -12,14 +12,11 @@ Gem::Specification.new do |spec|
   spec.homepage      = 'https://github.com/hernanilr/extenso_pt'
   spec.license       = 'MIT'
 
-  spec.summary = 'Produz extenso em portugês de portugal, brasil '\
-    'ou numeracao romana.'
+  spec.summary = 'Produz extenso em portugês de portugal, brasil ou numeracao romana.'
   spec.description = spec.summary
-  spec.description += ' Os valores podem ser um numerico, uma string de '\
-    'digitos ou um conjunto destes agrupados em (array, range, hash). '\
-    'O extenso pode ser produzido na escala longa (utilizada em todos os '\
-    'países lusófonos) ou na escala curta (utilizada no Brasil). Pode ainda '\
-    'produzir numeracao romana e vice versa.'
+  spec.description += ' Os valores podem ser um numerico, uma string de digitos ou um conjunto destes agrupados em '\
+    '(array, range, hash). O extenso pode ser produzido na escala longa (utilizada em todos os países lusófonos) ou '\
+    'na escala curta (utilizada no Brasil). Pode ainda produzir numeracao romana e vice versa.'
 
   spec.metadata['yard.run'] = 'yard' # use "yard" to build full HTML docs.
   spec.metadata['homepage_uri'] = spec.homepage
@@ -27,16 +24,15 @@ Gem::Specification.new do |spec|
   # Specify which files should be added to the gem when it is released.
   # loads the files in the RubyGem that have been added into git.
   spec.files = Dir.chdir(File.expand_path(__dir__)) do
-    `git ls-files -z`.split("\x0").reject \
-      { |f| f.match(%r{^(test|spec|features)/}) }
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
   end
   spec.bindir        = 'exe'
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ['lib']
 
-  spec.add_development_dependency 'bundler', '~> 1.17'
-  spec.add_development_dependency 'minitest', '~> 5.0'
+  spec.add_development_dependency 'bundler'
+  spec.add_development_dependency 'minitest'
   spec.add_development_dependency 'rake'
 
-  spec.add_dependency 'bigdecimal', '~> 1.4'
+  spec.add_dependency 'bigdecimal'
 end

data/lib/extenso_pt.rb

@@ -10,12 +10,11 @@ require 'extenso_pt/version'
 # @author Hernani Rodrigues Vaz
 module ExtensoPt
   class Error < StandardError; end
-  # Produz extenso em portugues de portugal ou brasil
-  # (valor numerico pode ser uma string digitos)
+  # Produz extenso em portugues de portugal ou brasil a partir de valor numerico
   #
+  # @note valor numerico pode ser uma string digitos
   # @param [Hash<String, Symbol>] moeda opcoes parametrizar moeda/fracao
-  # @option moeda [Symbol] :lc locale do extenso -
-  #  portugues de portugal (:pt) portugues do brasil (:br)
+  # @option moeda [Symbol] :lc locale do extenso - portugues de portugal (:pt) portugues do brasil (:br)
   # @option moeda [String] :moeda_singular moeda no singular
   # @option moeda [String] :fracao_singular fracao no singular
   # @option moeda [String] :moeda_plural moeda no plural
@@ -33,10 +32,7 @@ module ExtensoPt
 
   # Processa objeto criando extenso(s) em portugues de portugal ou brasil
   #
-  # @return [String, Array<String>, Hash<String>]
-  #  String<extenso> se objecto for (String, Float, Integer),
-  #  Array<extensos> se objecto for (Array, Range),
-  #  Hash<extensos>  se objecto for (Hash)
+  # @return (see #extenso)
   def processa
     # converte valores do Hash nos seus extensos
     if is_a?(Hash) then map { |k, v| [k, v.processa] }.to_h
@@ -53,52 +49,40 @@ module ExtensoPt
     end
   end
 
-  # Parametrizacao por defeito para :br
-  #
-  # @return [Hash<String, Symbol>] parametrizacao moeda
+  # @return [Hash<String, Symbol>] parametrizacao moeda por defeito para :br & inferencias & errados
   def parametrizar
-    if value?(:br) &&
-       %i[moeda_singular moeda_plural].all? { |e| !keys.include?(e) }
-      { lc: :br, moeda_singular: 'REAL', moeda_plural: 'REAIS',
-        fracao_singular: 'CENTAVO', fracao_plural: 'CENTAVOS' }
+    if value?(:br) && %i[moeda_singular moeda_plural].all? { |e| !keys.include?(e) }
+      { lc: :br, moeda_singular: 'REAL', moeda_plural: 'REAIS', fracao_singular: 'CENTAVO', fracao_plural: 'CENTAVOS' }
     else
-      inferir_singular
+      inferir_singular.eliminar_errados
     end
   end
 
-  # Parametrizacao singular inferindo do plural
-  #
-  # @return [Hash<String, Symbol>] parametrizacao moeda
+  # @return [Hash<String, Symbol>] parametrizacao moeda singular inferindo do plural
   def inferir_singular
-    self[:moeda_singular] ||= if fetch(:moeda_plural, '')[-1] == 'S'
-                                fetch(:moeda_plural, '')[0..-2]
-                              end
-    self[:fracao_singular] ||= if fetch(:fracao_plural, '')[-1] == 'S'
-                                 fetch(:fracao_plural, '')[0..-2]
-                               end
-    # eliminar parametros errados
+    self[:moeda_singular]  ||= (fetch(:moeda_plural,  '')[0..-2] if fetch(:moeda_plural,  '')[-1] == 'S')
+    self[:fracao_singular] ||= (fetch(:fracao_plural, '')[0..-2] if fetch(:fracao_plural, '')[-1] == 'S')
+    self
+  end
+
+  # @return [Hash<String, Symbol>] parametrizacao moeda eliminar parametros errados
+  def eliminar_errados
     keep_if { |k, v| MOEDA.include?(k) && (k != :lc || EXTLC.include?(v)) }
   end
 
-  # Testa se contem numeracao romana
-  #
-  # @return [true, false] sim ou nao numeracao romana
+  # @return [true, false] testa se contem numeracao romana
   def romana?
     is_a?(String) ? RO_RE.match?(upcase) : false
   end
 
-  # Produz numeracao romana a partir de valor numerico
-  # ou valor numerico a partir da numeracao romana
-  # (valor numerico pode ser uma string digitos)
-  #
-  # @return [String, Integer] numeracao romana ou valor numerico
+  # @note valor numerico pode ser uma string digitos
+  # @return [String, Integer] numeracao romana a partir de numerico ou inteiro a partir da numeracao romana
   def romana
     # converte os valores do Hash
     if is_a?(Hash) then map { |k, v| [k, v.romana] }.to_h
     # converte objecto num Array com os valores convertidos
     elsif respond_to?(:to_a) then to_a.map(&:romana)
-    # numeracao romana a partir de inteiro ou string digitos
-    # (ignora parte fracionaria)
+    # numeracao romana a partir de inteiro ou string digitos (ignora parte fracionaria)
     elsif (inteiro = to_i) != 0 then ExtensoPt.ri2r(inteiro)
     # inteiro a partir da numeracao romana
     else RO_RE.match?(to_s) ? ExtensoPt.rr2i(upcase, 0) : ''

data/lib/extenso_pt/constantes.rb

@@ -3,35 +3,33 @@
 # @author Hernani Rodrigues Vaz
 module ExtensoPt
   # chaves parametrizacao moeda permitidas
-  MOEDA = %i[moeda_singular fracao_singular
-             moeda_plural fracao_plural lc].freeze
-  # somente portugues de portugal ou brasil permitidos
-  # qualquer outro locale equivale usar :pt
+  MOEDA = %i[moeda_singular fracao_singular moeda_plural fracao_plural lc].freeze
+
+  # somente portugues de portugal ou brasil permitidos, qualquer outro locale equivale usar :pt
   EXTLC = %i[pt br].freeze
-  E13 = %w[UM DOIS TRÊS QUATRO CINCO SEIS SETE
-           OITO NOVE DEZ ONZE DOZE TREZE].freeze
+
+  E13 = %w[UM DOIS TRÊS QUATRO CINCO SEIS SETE OITO NOVE DEZ ONZE DOZE TREZE].freeze
+
   # extensos 1 ate 19
   A0020 = {
     pt: [''] + E13 + %w[CATORZE QUINZE DEZASSEIS DEZASSETE DEZOITO DEZANOVE],
     br: [''] + E13 + %w[QUATORZE QUINZE DEZESSEIS DEZESSETE DEZOITO DEZENOVE]
   }.freeze
+
   # extensos 20 ate 90
   A0100 = {
-    pt: ['', ''] +
-        %w[VINTE TRINTA QUARENTA CINQUENTA SESSENTA SETENTA OITENTA NOVENTA],
-    br: ['', ''] +
-        %w[VINTE TRINTA QUARENTA CINQUENTA SESSENTA SETENTA OITENTA NOVENTA]
+    pt: ['', ''] + %w[VINTE TRINTA QUARENTA CINQUENTA SESSENTA SETENTA OITENTA NOVENTA],
+    br: ['', ''] + %w[VINTE TRINTA QUARENTA CINQUENTA SESSENTA SETENTA OITENTA NOVENTA]
   }.freeze
+
   # extensos 100 ate 900
   A1000 = {
-    pt: [''] + %w[CEM CENTO DUZENTOS TREZENTOS QUATROCENTOS QUINHENTOS
-                  SEISCENTOS SETECENTOS OITOCENTOS NOVECENTOS],
-    br: [''] + %w[CEM CENTO DUZENTOS TREZENTOS QUATROCENTOS QUINHENTOS
-                  SEISCENTOS SETECENTOS OITOCENTOS NOVECENTOS]
+    pt: [''] + %w[CEM CENTO DUZENTOS TREZENTOS QUATROCENTOS QUINHENTOS SEISCENTOS SETECENTOS OITOCENTOS NOVECENTOS],
+    br: [''] + %w[CEM CENTO DUZENTOS TREZENTOS QUATROCENTOS QUINHENTOS SEISCENTOS SETECENTOS OITOCENTOS NOVECENTOS]
   }.freeze
 
   # singular extensos 1e3 ate 1e24
-  #   escala segundo convencao entre varios paises,
+  # @note escala segundo convencao entre varios paises,
   #   na 9a Conferencia Geral de Pesos e Medidas (12-21 de Outubro de 1948),
   #   organizada pelo Bureau International des Poids et Mesures
   # @example
@@ -41,24 +39,25 @@ module ExtensoPt
   #   1 000 000 000 000 000 000 000 000 = quadriliao
   #   1 000 000 000 000 000 000 000 000 000 000 = quintiliao
   #   1 000 000 000 000 000 000 000 000 000 000 000 000 = sextiliao
-  S1E24 = { pt: ['', 'MIL', ' MILHÃO', ' MIL MILHÃO', ' BILIÃO',
-                 ' MIL BILIÃO', ' TRILIÃO', ' MIL TRILIÃO'],
-            br: ['', 'MIL', ' MILHÃO', ' BILHÃO', ' TRILHÃO',
-                 ' QUADRILHÃO', ' QUINTILHÃO', ' SEXTILHÃO'] }.freeze
+  S1E24 = {
+    pt: ['', 'MIL', ' MILHÃO', ' MIL MILHÃO', ' BILIÃO', ' MIL BILIÃO', ' TRILIÃO', ' MIL TRILIÃO'],
+    br: ['', 'MIL', ' MILHÃO', ' BILHÃO', ' TRILHÃO', ' QUADRILHÃO', ' QUINTILHÃO', ' SEXTILHÃO']
+  }.freeze
+
   # plural extensos 1e3 ate 1e24
-  P1E24 = { pt: ['', ' MIL', ' MILHÕES', ' MIL MILHÕES', ' BILIÕES',
-                 ' MIL BILIÕES', ' TRILIÕES', ' MIL TRILIÕES'],
-            br: ['', ' MIL', ' MILHÕES', ' BILHÕES', ' TRILHÕES',
-                 ' QUADRILHÕES', ' QUINTILHÕES', ' SEXTILHÕES'] }.freeze
+  # @note escala segundo convencao entre varios paises,
+  #   na 9a Conferencia Geral de Pesos e Medidas (12-21 de Outubro de 1948),
+  #   organizada pelo Bureau International des Poids et Mesures
+  P1E24 = {
+    pt: ['', ' MIL', ' MILHÕES', ' MIL MILHÕES', ' BILIÕES', ' MIL BILIÕES', ' TRILIÕES', ' MIL TRILIÕES'],
+    br: ['', ' MIL', ' MILHÕES', ' BILHÕES', ' TRILHÕES', ' QUADRILHÕES', ' QUINTILHÕES', ' SEXTILHÕES']
+  }.freeze
 
   # numeracao romana
-  ROMAN = { M: 1000, CM: 900,
-            D: 500,  CD: 400,
-            C: 100,  XC: 90,
-            L: 50,   XL: 40,
-            X: 10,   IX: 9,
-            V: 5,    IV: 4,
-            I: 1 }.freeze
-  # exprecao regular da numeracao romana
+  ROMAN = {
+    M: 1000, CM: 900, D: 500, CD: 400, C: 100, XC: 90, L: 50, XL: 40, X: 10, IX: 9, V: 5, IV: 4, I: 1
+  }.freeze
+
+  # expressao regular da numeracao romana
   RO_RE = /^M*(D?C{0,3}|C[DM])(L?X{0,3}|X[LC])(V?I{0,3}|I[VX])$/i.freeze
 end

data/lib/extenso_pt/extenso.rb

@@ -28,9 +28,7 @@ module ExtensoPt
     A0020[@lc][cem < 20 ? cem : cem % 10]
   end
 
-  # Produz extenso da parte fracionaria em portugues de portugal ou brasil
-  #
-  # @return [String] extenso da parte fracionaria
+  # @return [String] extenso da parte fracionaria em portugues de portugal ou brasil
   def self.ef99
     if cnf?
       e090(@nf) + e009(@nf) + ' ' + (@nf > 1 ? @fp : @fs)
@@ -39,25 +37,21 @@ module ExtensoPt
     end
   end
 
-  # Produz final da moeda em portugues de portugal ou brasil
-  #
-  # @return [String] final da moeda
+  # @return [String] final da moeda em portugues de portugal ou brasil
   def self.efim
     t = c124
     if t.positive?
-      # proposicao DE entre parte inteira e moeda
-      # moeda singular/plural
-      # proposicao E entre moeda e parte fracionaria
+      # proposicao DE entre parte inteira e moeda & moeda singular/plural & proposicao E entre moeda e parte fracionaria
       (cde? ? ' DE ' : ' ') + (t > 1 ? @mp : @ms) + (cnf? ? ' E ' : '')
     else
       ''
     end + ef99
   end
 
-  # Produz separador entre grupos 3 digitos
+  # Produz proposicao E entre grupos 3 digitos
   #
   # @param [Integer] pos posicao actual nos grupos 3 digitos
-  # @return [String] separador entre grupos 3 digitos
+  # @return [String] proposicao E entre grupos 3 digitos
   def self.edgs(pos)
     if pos.positive? && @ai[pos - 1].positive?
       @ai[pos - 1] > 100 ? ' ' : ' E '
@@ -87,6 +81,7 @@ module ExtensoPt
     if pos == 1 && @ai[pos] == 1
       ''
     else
+      # extenso das centenas + extenso das dezenas + extenso das unidades
       e900(@ai[pos]) + e090(@ai[pos] % 100) + e009(@ai[pos] % 100)
     end + e124(pos)
   end
@@ -102,8 +97,7 @@ module ExtensoPt
       # caso especial de zero
       (c124 + @nf).zero? ? 'ZERO ' + @mp : ext + efim
     else
-      # converte grupo 3 digitos na posicao corrente
-      # envoca proxima posicao
+      # converte grupo 3 digitos na posicao corrente & envoca proxima posicao
       ejun(pos + 1, edg3(pos) + ext)
     end
   end

data/lib/extenso_pt/romana.rb

@@ -23,6 +23,6 @@ module ExtensoPt
     return 0 if numeral.empty?
 
     v = ROMAN[numeral[-1].to_sym]
-    v < ultimo ? (rr2i(numeral.chop, v) - v) : (rr2i(numeral.chop, v) + v)
+    rr2i(numeral.chop, v) + (v < ultimo ? -v : v)
   end
 end

data/lib/extenso_pt/variaveis.rb

@@ -2,19 +2,17 @@
 
 # @author Hernani Rodrigues Vaz
 module ExtensoPt
-  # Parametrizar moeda
+  # Parametrizar variaveis da moeda
   #
   # @param [Hash<String, Symbol>] moeda opcoes parametrizar moeda/fracao
-  # @option moeda [Symbol] :lc locale do extenso -
-  #  portugues de portugal (:pt) portugues do brasil (:br)
+  # @option moeda [Symbol] :lc locale do extenso - portugues de portugal (:pt) portugues do brasil (:br)
   # @option moeda [String] :moeda_singular moeda no singular
   # @option moeda [String] :fracao_singular fracao no singular
   # @option moeda [String] :moeda_plural moeda no plural
   # @option moeda [String] :fracao_plural fracao no plural
   def self.prmo(moeda)
     # parametrizacao por defeito
-    #  the first mention of a @<variable> creates that instance variable
-    #  in the current object ie: self = ExtensoPt
+    # the first mention of a @<variable> creates that instance variable in the current object ie: self = ExtensoPt
     @lc = moeda[:lc] || :pt
     @ms = moeda[:moeda_singular] || 'EURO'
     @fs = moeda[:fracao_singular] || 'CÊNTIMO'
@@ -22,18 +20,14 @@ module ExtensoPt
     @fp = moeda[:fracao_plural] || @fs + 'S'
   end
 
-  # Parametrizar parte inteira e fracionaria
+  # Parametrizar variaveis parte inteira e fracionaria
   #
   # @param [String] digitos do valor monetario a converter
   def self.prif(digitos)
-    # cria array de grupos 3 digitos da parte inteira
-    #  ex: 123022.12 => [22, 123]
-    @ai = digitos[/^\d+/].to_s.reverse.scan(/\d{1,3}/)
-                         .map { |i| i.reverse.to_i }
+    # cria array de grupos 3 digitos da parte inteira ex: 123022.12 => [22, 123]
+    @ai = digitos[/^\d+/].to_s.reverse.scan(/\d{1,3}/).map { |i| i.reverse.to_i }
 
-    # obtem parte fracionaria da string digitos
-    #  ex: 123022.12 => 12
-    # arredondada a 2 casas decimais (centimos/centavos)
+    # obtem parte fracionaria da string digitos arredondada a 2 casas decimais ex: 123022.12 => 12
     @nf = (digitos[/\.\d*/].to_f * 100).round
   end
 
@@ -49,8 +43,7 @@ module ExtensoPt
 
   # @return [true, false] sim ou nao para controle proposicao DE
   def self.cde?
-    @ai[0..1].to_a.inject(:+).to_i.zero? &&
-      @ai[2..-1].to_a.inject(:+).to_i.positive?
+    @ai[0..1].to_a.inject(:+).to_i.zero? && @ai[2..-1].to_a.inject(:+).to_i.positive?
   end
 
   # @return [true, false] sim ou nao para controle proposicao E

data/lib/extenso_pt/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ExtensoPt
-  VERSION = '0.6.12'
+  VERSION = '0.7.0'
 end

metadata

@@ -1,43 +1,43 @@
 --- !ruby/object:Gem::Specification
 name: extenso_pt
 version: !ruby/object:Gem::Version
-  version: 0.6.12
+  version: 0.7.0
 platform: ruby
 authors:
 - Hernâni Rodrigues Vaz
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-03-09 00:00:00.000000000 Z
+date: 2020-08-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.17'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.17'
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '5.0'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '5.0'
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -56,16 +56,16 @@ dependencies:
   name: bigdecimal
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.4'
+        version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.4'
+        version: '0'
 description: Produz extenso em portugês de portugal, brasil ou numeracao romana. Os
   valores podem ser um numerico, uma string de digitos ou um conjunto destes agrupados
   em (array, range, hash). O extenso pode ser produzido na escala longa (utilizada
@@ -115,7 +115,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
+rubygems_version: 3.1.2
 signing_key: 
 specification_version: 4
 summary: Produz extenso em portugês de portugal, brasil ou numeracao romana.