extenso_pt 0.5.3 → 0.5.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 10ea3b7fbc48b315312ba6ff3a297884a7eb715bbee0e5b0ff1332672fe66be8
-  data.tar.gz: 77f82a40052f904705bf3fa6e0ffc328006ef22c837fa11fe279317312783a9d
+  metadata.gz: 8d41d1cbf7468f74a1287b15d53fbe72624afeeb06bf4027bc51d5676e81fceb
+  data.tar.gz: ae4028347d25170b32a123bdab5cb260d0be01aadb32a266d9131adf8bd911c3
 SHA512:
-  metadata.gz: 7a1756b097562327fb5540533ec05a1bba78d1d2614106fc33690b276fc05274c899158c28c81169c165d0414dfd927423a3612421c72a769ccef9ee553c09ec
-  data.tar.gz: 6f9be8e11f8db30bbaedc8ff1e372e665e8d11fdcf160c0bff2563436b7a1963ecc44d5df2236401ad95b408862b65d7ad6736691780c1fd9ceaadba6a4ccaae
+  metadata.gz: 90362000feecf288a7318275fca0d59c27a07ed7fa50ba0b9d7e6d36b0ed8518ed690314d1da97df440f1da306683465f8effa88622743e149125315845314fe
+  data.tar.gz: 1cd11787676cf949a8f93edb2cc06c79d1b7a3a7b97b76e67f69488acd721a151aea87fb80ce26b5102a757ebb5bccadc52d008958cf2c7997d83626a873cae4

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    extenso_pt (0.5.3)
+    extenso_pt (0.5.4)
 
 GEM
   remote: https://rubygems.org/

data/extenso_pt.gemspec

@@ -9,23 +9,26 @@ Gem::Specification.new do |spec|
   spec.version       = ExtensoPt::VERSION
   spec.authors       = ['Hernâni Rodrigues Vaz']
   spec.email         = ['hernanirvaz@gmail.com']
-
-  spec.summary       = 'Produz valores monetários por extenso em portugês de portugal ou brasil.'
-  spec.description   = spec.summary + ' Os valores podem ser um numerico, uma string de digitos ou um conjunto destes (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 escolher a moeda e a fração da moeda.'
-
   spec.homepage      = 'https://github.com/hernanilr/extenso_pt'
   spec.license       = 'MIT'
 
+
+  spec.summary = 'Produz valores monetários por extenso\
+  em portugês de portugal ou brasil.'
+  spec.description = spec.summary + ' Os valores podem ser um numerico, uma\
+  string de digitos ou um conjunto destes (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 escolher\
+  a moeda e a fração da moeda.'
+
   spec.metadata['yard.run'] = 'yard' # use "yard" to build full HTML docs.
-  # spec.metadata["allowed_push_host"] = "TODO: Set to 'http://mygemserver.com'"
   spec.metadata['homepage_uri'] = spec.homepage
-  # spec.metadata["source_code_uri"] = "TODO: Put your gem's public repo URL here."
-  # spec.metadata["changelog_uri"] = "TODO: Put your gem's CHANGELOG.md URL here."
 
   # Specify which files should be added to the gem when it is released.
-  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  # 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) }

data/lib/extenso_pt.rb

@@ -3,195 +3,258 @@
 require 'extenso_pt/version'
 require 'bigdecimal/util'
 
-# @author Hernâni Rodrigues Vaz
+LC = %i[pt br].freeze
+A0020 = {
+  pt: ['', 'UM', 'DOIS', 'TRÊS', 'QUATRO', 'CINCO', 'SEIS', 'SETE',
+       'OITO', 'NOVE', 'DEZ', 'ONZE', 'DOZE', 'TREZE', 'CATORZE',
+       'QUINZE', 'DEZASSEIS', 'DEZASSETE', 'DEZOITO', 'DEZANOVE'],
+  br: ['', 'UM', 'DOIS', 'TRES', 'QUATRO', 'CINCO', 'SEIS', 'SETE',
+       'OITO', 'NOVE', 'DEZ', 'ONZE', 'DOZE', 'TREZE', 'QUATORZE',
+       'QUINZE', 'DEZESSEIS', 'DEZESSETE', 'DEZOITO', 'DEZENOVE']
+}.freeze
+A0100 = {
+  pt: ['', '', 'VINTE', 'TRINTA', 'QUARENTA', 'CINQUENTA', 'SESSENTA',
+       'SETENTA', 'OITENTA', 'NOVENTA'],
+  br: ['', '', 'VINTE', 'TRINTA', 'QUARENTA', 'CINQUENTA', 'SESSENTA',
+       'SETENTA', 'OITENTA', 'NOVENTA']
+}.freeze
+A1000 = {
+  pt: ['', 'CEM', 'CENTO', 'DUZENTOS', 'TREZENTOS', 'QUATROCENTOS',
+       'QUINHENTOS', 'SEISCENTOS', 'SETECENTOS', 'OITOCENTOS', 'NOVECENTOS'],
+  br: ['', 'CEM', 'CENTO', 'DUZENTOS', 'TREZENTOS', 'QUATROCENTOS',
+       'QUINHENTOS', 'SEISCENTOS', 'SETECENTOS', 'OITOCENTOS', 'NOVECENTOS']
+}.freeze
+A1E24 = {
+  pt: ['', 'MIL', ' MILHÃO', ' MIL MILHÃO', ' BILIÃO', ' MIL BILIÃO',
+       ' TRILIÃO', ' MIL TRILIÃO', '', ' MIL', ' MILHÕES', ' MIL MILHÕES',
+       ' BILIÕES', ' MIL BILIÕES', ' TRILIÕES', ' MIL TRILIÕES'],
+  br: ['', 'MIL', ' MILHÃO', ' BILHÃO', ' TRILHÃO', ' QUADRILHÃO',
+       ' QUINTILHÃO', ' SEXTILHÃO', '', ' MIL', ' MILHÕES', ' BILHÕES',
+       ' TRILHÕES', ' QUADRILHÕES', ' QUINTILHÕES', ' SEXTILHÕES']
+}.freeze
+
+# @author Hernani Rodrigues Vaz
 module ExtensoPt
   class Error < StandardError; end
 
-  LC = %i[pt br].freeze
-  A0020 = { pt: ['', 'UM', 'DOIS', 'TRÊS', 'QUATRO', 'CINCO', 'SEIS', 'SETE', 'OITO', 'NOVE', 'DEZ', 'ONZE', 'DOZE', 'TREZE', 'CATORZE', 'QUINZE', 'DEZASSEIS', 'DEZASSETE', 'DEZOITO', 'DEZANOVE'],
-            br: ['', 'UM', 'DOIS', 'TRES', 'QUATRO', 'CINCO', 'SEIS', 'SETE', 'OITO', 'NOVE', 'DEZ', 'ONZE', 'DOZE', 'TREZE', 'QUATORZE', 'QUINZE', 'DEZESSEIS', 'DEZESSETE', 'DEZOITO', 'DEZENOVE'] }.freeze
-  A0100 = { pt: ['', '', 'VINTE', 'TRINTA', 'QUARENTA', 'CINQUENTA', 'SESSENTA', 'SETENTA', 'OITENTA', 'NOVENTA'],
-            br: ['', '', 'VINTE', 'TRINTA', 'QUARENTA', 'CINQUENTA', 'SESSENTA', 'SETENTA', 'OITENTA', 'NOVENTA'] }.freeze
-  A1000 = { pt: ['', 'CEM', 'CENTO', 'DUZENTOS', 'TREZENTOS', 'QUATROCENTOS', 'QUINHENTOS', 'SEISCENTOS', 'SETECENTOS', 'OITOCENTOS', 'NOVECENTOS'],
-            br: ['', 'CEM', 'CENTO', 'DUZENTOS', 'TREZENTOS', 'QUATROCENTOS', 'QUINHENTOS', 'SEISCENTOS', 'SETECENTOS', 'OITOCENTOS', 'NOVECENTOS'] }.freeze
-  A1e24 = { pt: ['', 'MIL', ' MILHÃO', ' MIL MILHÃO', ' BILIÃO', ' MIL BILIÃO', ' TRILIÃO', ' MIL TRILIÃO', '', ' MIL', ' MILHÕES', ' MIL MILHÕES', ' BILIÕES', ' MIL BILIÕES', ' TRILIÕES', ' MIL TRILIÕES'],
-            br: ['', 'MIL', ' MILHÃO', ' BILHÃO', ' TRILHÃO', ' QUADRILHÃO', ' QUINTILHÃO', ' SEXTILHÃO', '', ' MIL', ' MILHÕES', ' BILHÕES', ' TRILHÕES', ' QUADRILHÕES', ' QUINTILHÕES', ' SEXTILHÕES'] }.freeze
-
-  # Produz o extenso das centenas em portugûes de portugal ou brasil.
+  # Produz o extenso das centenas em portugues de portugal ou brasil.
   #
   # @param [Integer] mil o valor dum grupo 3 digitos a converter
   # @return [String] o extenso das centenas
   def self.e900(mil)
-    A1000[@@lc][(mil > 100 ? 1 : 0) + mil / 100] + (mil > 100 && mil % 100 > 0 ? ' E ' : '')
+    A1000[@lc][(mil > 100 ? 1 : 0) + mil / 100] +
+      (mil > 100 && (mil % 100).positive? ? ' E ' : '')
   end
 
-  # Produz o extenso das dezenas em portugûes de portugal ou brasil.
+  # Produz o extenso das dezenas em portugues de portugal ou brasil.
   #
   # @param [Integer] mil o valor dum grupo 3 digitos a converter
   # @return [String] o extenso das dezenas
   def self.e90(mil)
-    A0100[@@lc][mil % 100 / 10] + (mil > 20 && mil % 10 > 0 ? ' E ' : '')
+    A0100[@lc][mil % 100 / 10] + (mil > 20 && (mil % 10).positive? ? ' E ' : '')
   end
 
-  # Produz o extenso das unidades em portugûes de portugal ou brasil.
+  # Produz o extenso das unidades em portugues de portugal ou brasil.
   #
-  # @param [Integer] mil o valor dum grupo 3 digitos a converter
+  # @param [Integer] cem o valor dum grupo 3 digitos a converter
   # @return [String] o extenso das unidades
   def self.e9(cem)
-    A0020[@@lc][(cem < 20 ? cem : cem % 10)]
+    A0020[@lc][(cem < 20 ? cem : cem % 10)]
   end
 
-  # Produz o qualificador grupo de 3 digitos em portugûes de portugal ou brasil.
+  # Produz extenso parte fracionaria em portugues de portugal ou brasil.
   #
-  # @param [Integer] pos posição actual nos grupos 3 digitos do valor monetário
-  # @return [String] o qualificador grupo de 3 digitos
-  def self.e1e24(pos)
-    A1e24[@@lc][@@ai[pos] > 0 ? @@ai[pos] > 1 ? 8 + pos : 0 + pos : 0]
-  end
-
-  # Produz o extenso da parte fracionária dum valor monetário em portugûes de portugal ou brasil.
-  #
-  # @return [String] o extenso da parte fracionária dum valor monetário
+  # @return [String] o extenso da parte fracionaria dum valor monetario
   def self.ef99
-    e90(@@nf) + e9(@@nf) + (@@nf == 1 ? ' ' + @@cs : @@nf > 1 ? ' ' + @@cp : '')
+    if @nf.positive?
+      e90(@nf) + e9(@nf) + (@nf > 1 ? ' ' + @cp : ' ' + @cs)
+    else
+      ''
+    end
   end
 
-  # Produz final da moeda em portugûes de portugal ou brasil.
+  # Produz final da moeda em portugues de portugal ou brasil.
   #
   # @return [String] o final da moeda
   def self.efim
-    # soma todos os grupos do valor monetário
-    sto = @@s6 + @@m6
-
-    (@@s6 == 0 && @@m6 > 0 ? ' DE' : '') +                  # proposição DE se zero nos primeiros 6 digitos e maiores que 1e6
-      (sto == 1 ? ' ' + @@ms : sto > 1 ? ' ' + @@mp : '') + # singular/plural da moeda
-      (sto > 0 && @@nf > 0 ? ' E ' : '') +                  # proposição E entre parte inteira e parte fracionária
-      ef99                                                  # extenso da parte fracionária dum valor monetário
+    # proposicao DE entre parte inteira e moeda
+    emo = @de ? ' DE' : ''
+    # moeda singular/plural
+    emo += @tt > 1 ? ' ' + @mp : ' ' + @ms if @tt.positive?
+    # proposicao E entre moeda e parte fracionaria
+    # extenso da parte fracionaria
+    emo + (@tt.positive? && @nf.positive? ? ' E ' : '') + ef99
   end
 
-  # Produz o extenso grupo 3 digitos em portugûes de portugal ou brasil.
+  # Produz separador entre grupos 3 digitos
   #
-  # @param [Integer] pos posição actual nos grupos 3 digitos do valor monetário
-  # @return [String] o extenso grupo 3 digitos
-  def self.edg3(pos)
-    # extenso do grupo actual 3 digitos
-    pos == 1 && @@ai[pos] == 1 ? e1e24(pos) : e900(@@ai[pos]) + e90(@@ai[pos]) + e9(@@ai[pos] % 100) + e1e24(pos)
-  end
-
-  # Produz separação entre grupos 3 digitos
-  #
-  # @param [Integer] pos posição actual nos grupos 3 digitos do valor monetário
-  # @return [String] separação entre grupos 3 digitos
+  # @param [Integer] pos posicao actual nos grupos 3 digitos do valor monetario
+  # @return [String] separador entre grupos 3 digitos
   def self.esep(pos)
-    pos > 0 ? @@ai[pos - 1] > 100 ? ' ' : @@ai[pos - 1] > 0 ? ' E ' : '' : ''
-  end
-
-  # Parametrizar grupos 3 digitos para controle de singular/plural
-  #
-  def self.pdg3
-    @@s6 = @@ai[0].to_i + @@ai[1].to_i * 2      # soma grupos 1,2 (primeiros 6 digitos)
-    @@m6 = @@ai[2..-1].to_a.inject(:+).to_i * 2 # soma grupos 3.. (digitos acima de 6)
+    if pos.positive? && @ai[pos - 1].positive?
+      @ai[pos - 1] > 100 ? ' ' : ' E '
+    else
+      ''
+    end
   end
 
-  # Parametrizar parte inteira/fracionária do valor monetário
+  # Produz qualificador grupo de 3 digitos em portugues de portugal ou brasil.
   #
-  # @param [String] dig string de digitos do valor monetário
-  def self.pintfra(dig)
-    # parte inteira do valor monetário => array grupos 3 digitos ex: 123022.12 => [22, 123]
-    @@ai = dig[/^\d+/].to_s.reverse.scan(/\d{1,3}/).map { |i| i.reverse.to_i }
-
-    # parte fracionária do valor monetário                       ex: 123022.12 => 12
-    # arredondada a 2 casas decimais (cêntimos/centavos)
-    @@nf = (dig[/\.\d*/].to_f * 100).round
+  # @param [Integer] pos posicao actual nos grupos 3 digitos do valor monetario
+  # @return [String] qualificador grupo de 3 digitos
+  def self.e1e24(pos)
+    if @ai[pos].positive?
+      A1E24[@lc][@ai[pos] > 1 ? 8 + pos : pos]
+    else
+      ''
+    end
   end
 
-  private_class_method :pintfra, :pdg3, :esep, :edg3, :e1e24, :e900, :e90, :e9, :ef99, :efim
-
-  # Parametrizar moeda inferindo singular a partir do plural
+  # Produz extenso grupo 3 digitos em portugues de portugal ou brasil.
   #
-  # @param [Hash] moeda as opcoes para parametrizar a moeda/fração
-  # @option moeda [Symbol] :lc locale do extenso - portugûes de portugal (:pt) ou brasil (:br)
-  # @option moeda [String] :msingular moeda no singular - pode ser inferido do plural menos "S"
-  # @option moeda [String] :fsingular fração no singular - pode ser inferido do plural menos "S"
-  # @option moeda [String] :mplural moeda no plural
-  # @option moeda [String] :fplural fração no plural
-  def self.isingular(moeda)
-    @@ms = moeda[:msingular] || (moeda[:mplural].to_s[-1] == 'S' ? moeda[:mplural][0..-2] : 'EURO')
-    @@cs = moeda[:fsingular] || (moeda[:fplural].to_s[-1] == 'S' ? moeda[:fplural][0..-2] : 'CÊNTIMO')
+  # @param [Integer] pos posicao actual nos grupos 3 digitos do valor monetario
+  # @return [String] extenso grupo 3 digitos
+  def self.edg3(pos)
+    dg3 = if pos == 1 && @ai[pos] == 1
+            # caso especial MIL EUROS
+            ''
+          else
+            e900(@ai[pos]) + e90(@ai[pos]) + e9(@ai[pos] % 100)
+          end
+    # qualificador grupo de 3 digitos
+    dg3 + e1e24(pos)
   end
 
-  # Parametrizar moeda inferindo plural a partir do singular
+  # Parametrizar controle singular/plural & proposicoes
   #
-  # @param [Hash] moeda as opcoes para parametrizar a moeda/fração
-  # @option moeda [Symbol] :lc locale do extenso - portugûes de portugal (:pt) ou brasil (:br)
-  # @option moeda [String] :msingular moeda no singular
-  # @option moeda [String] :fsingular fração no singular
-  # @option moeda [String] :mplural moeda no plural - pode ser inferido do singular mais "S"
-  # @option moeda [String] :fplural fração no plural - pode ser inferido do singular mais "S"
-  def self.iplural(moeda)
-    @@mp = moeda[:mplural] || @@ms + 'S'
-    @@cp = moeda[:fplural] || @@cs + 'S'
+  def self.pcontrolo
+    # soma grupos 1,2 (primeiros 6 digitos)
+    @s6 = @ai[0].to_i + @ai[1].to_i * 2
+    # soma grupos 3.. (digitos acima de 6)
+    @m6 = @ai[2..-1].to_a.inject(:+).to_i * 2
+    @tt = @s6 + @m6                  # proposicao E & singular/plural
+    @de = @s6.zero? && @m6.positive? # proposicao DE
   end
 
-  # Produz o extenso dum valor monetário em portugûes de portugal ou brasil.
+  # Produz o extenso dum valor monetario em portugues de portugal ou brasil.
   #
-  # @param [Integer] pos posição actual nos grupos 3 digitos do valor monetário
-  # @param [String] ext extenso actual em construção
-  # @return [String] o extenso dum valor monetário
+  # @param [Integer] pos posicao actual nos grupos 3 digitos do valor monetario
+  # @param [String] ext extenso  em construcao
+  # @return [String] o extenso dum valor monetario
   def self.enumerico(pos = 0, ext = '')
-    # testa fim do valor monetário
-    if pos >= @@ai.count
-      # parametrizar grupos 3 digitos (@@s6, @@m6) para controle de singular/plural
-      pdg3
+    # testa fim do valor monetario
+    if pos >= @ai.count
+      # parametrizar controle singular/plural & proposicoes
+      pcontrolo
 
       # caso especial zero
-      @@s6 == 0 && @@m6 == 0 && @@nf == 0 ? 'ZERO ' + @@mp : ext + efim
+      (@tt + @nf).zero? ? 'ZERO ' + @mp : ext + efim
     else
       # tratamento do proximo grupo 3 digitos
       enumerico(pos + 1, edg3(pos) + esep(pos) + ext)
     end
   end
 
-  # Converte um objeto criando extenso(s) em portugûes de portugal ou brasil.
+  # Parametrizar parte inteira/fracionaria do valor monetario
+  #
+  # @param [String] dig string de digitos rdo valor monetario
+  def self.pintfra(dig)
+    # parte inteira do valor monetario => array grupos 3 digitos
+    #  ex: 123022.12 => [22, 123]
+    @ai = dig[/^\d+/].to_s.reverse.scan(/\d{1,3}/).map { |i| i.reverse.to_i }
+
+    # parte fracionaria do valor monetario
+    #  ex: 123022.12 => 12
+    # arredondada a 2 casas decimais (centimos/centavos)
+    @nf = (dig[/\.\d*/].to_f * 100).round
+  end
+
+  private_class_method :pintfra, :pcontrolo, :esep, :edg3, :e1e24,
+                       :e900, :e90, :e9, :ef99, :efim
+
+  # Converte um objeto criando extenso(s) em portugues de portugal ou brasil.
   #
-  # @param [Object] objeto o objeto a converter pode ser (String, Float, Integer, Array, Range, Hash) ou uma mistura
-  # @return [String, Array<String>, Hash<String>] extenso se o objecto for (String, Float, Integer), Array dos extensos se o objecto for (Array, Range) ou Hash dos extensos se o objecto for (Hash)
+  # @param [Object] objeto objeto a converter
+  #  (String, Float, Integer, Array, Range, Hash)
+  # @return [String] extenso se objecto for (String, Float, Integer),
+  #  Array<extensos> se objecto for (Array, Range),
+  #  Hash<extensos> se objecto for (Hash)
   def self.pobjeto(obj)
     if obj.is_a?(Hash)
-      # converte os valores do Hash nos seus extensos mantendo as chaves - devolve um Hash
+      # converte os valores do Hash nos seus extensos - devolve um Hash
       obj.map { |k, v| [k, pobjeto(v)] }.to_h
-    elsif obj.respond_to? :to_a
-      # converte o objecto num Array e converte os valores do Array nos seus extensos - devolve um Array
+    elsif obj.respond_to?(:to_a)
+      # converte o objecto num Array com os extensos dos valores
       obj.to_a.map { |v| pobjeto(v) }
     else
       # converte objeto numa string de digitos
-      # usa bigdecimal/util para evitar aritmética binária (tem problemas com valores >1e12)
-      # qualquer valor não convertivel (ex: texto) resulta em "0.0"
+      # usa bigdecimal/util para evitar aritmetica binaria
+      #  (tem problemas com valores >1e12)
+      # qualquer valor nao convertivel (ex: texto) resulta em "0.0"
       sdigitos = obj.to_d.to_s('F')
 
-      # parametrizar parte inteira/fracionária (@@ai, @@nf) do valor monetário
+      # parametrizar parte inteira/fracionaria (@ai, @nf) do valor monetario
       pintfra(sdigitos)
 
-      # processar extenso  - valores superiores a 1e24 não são tratados
+      # processar extenso - valores superiores a 1e24 nao sao tratados
       sdigitos[/^\d+/].length <= 24 ? enumerico : ''
     end
   end
 
-  # Produz extenso(s) de objeto(s) em portugûes de portugal ou brasil.
+  # Parametrizar moeda inferindo singular a partir do plural
   #
-  # @param [Hash] moeda as opcoes para parametrizar a moeda/fração
-  # @option moeda [Symbol] :lc locale do extenso - portugûes de portugal (:pt) ou brasil (:br)
-  # @option moeda [String] :msingular moeda no singular
-  # @option moeda [String] :fsingular fração no singular
+  # @param [Hash] moeda as opcoes para parametrizar a moeda/fracao
+  # @option moeda [Symbol] :lc locale do extenso -
+  #  portugues de portugal (:pt) ou brasil (:br)
+  # @option moeda [String] :msingular moeda no singular -
+  #  inferido do plural menos "S"
+  # @option moeda [String] :fsingular fracao no singular -
+  #  inferido do plural menos "S"
   # @option moeda [String] :mplural moeda no plural
-  # @option moeda [String] :fplural fração no plural
-  # @return [String, Array<String>, Hash<String>] extenso se o objecto for (String, Float, Integer), Array dos extensos se o objecto for (Array, Range) ou Hash dos extensos se o objecto for (Hash)
-  def extenso(moeda = { lc: :pt, msingular: 'EURO', fsingular: 'CÊNTIMO' })
-    # parametrização por defeito para :br
-    moeda = { lc: :br, msingular: 'REAL', mplural: 'REAIS', fsingular: 'CENTAVO' } if moeda[:lc] == :br && !moeda[:msingular] && !moeda[:mplural]
+  # @option moeda [String] :fplural fracao no plural
+  def self.isingular(moeda)
+    @ms = moeda[:msingular] ||
+          (moeda[:mplural].to_s[-1] == 'S' ? moeda[:mplural][0..-2] : 'EURO')
+    @cs = moeda[:fsingular] ||
+          (moeda[:fplural].to_s[-1] == 'S' ? moeda[:fplural][0..-2] : 'CÊNTIMO')
+  end
 
+  # Parametrizar moeda inferindo plural a partir do singular
+  #
+  # @param [Hash] moeda as opcoes para parametrizar a moeda/fracao
+  # @option moeda [Symbol] :lc locale do extenso -
+  #  portugues de portugal (:pt) ou brasil (:br)
+  # @option moeda [String] :msingular moeda no singular
+  # @option moeda [String] :fsingular fracao no singular
+  # @option moeda [String] :mplural moeda no plural -
+  #  inferido do singular mais "S"
+  # @option moeda [String] :fplural fracao no plural -
+  #  inferido do singular mais "S"
+  def self.iplural(moeda)
     # somente [:pt, :br]
-    @@lc = LC.include?(moeda[:lc]) ? moeda[:lc] : :pt
+    @lc = LC.include?(moeda[:lc]) ? moeda[:lc] : :pt
+
+    @mp = moeda[:mplural] || @ms + 'S'
+    @cp = moeda[:fplural] || @cs + 'S'
+  end
+
+  # Produz extenso(s) de objeto(s) em portugues de portugal ou brasil.
+  #
+  # @param [Hash] moeda as opcoes para parametrizar a moeda/fracao
+  # @option moeda [Symbol] :lc locale do extenso -
+  #  portugues de portugal (:pt) ou brasil (:br)
+  # @option moeda [String] :msingular moeda no singular
+  # @option moeda [String] :fsingular fracao no singular
+  # @option moeda [String] :mplural moeda no plural
+  # @option moeda [String] :fplural fracao no plural
+  # @return [String] extenso se objecto for (String, Float, Integer),
+  #  Array<extensos> se objecto for (Array, Range),
+  #  Hash<extensos> se objecto for (Hash)
+  def extenso(moeda = { lc: :pt, msingular: 'EURO', fsingular: 'CÊNTIMO' })
+    # parametrizacao por defeito para :br
+    if moeda[:lc] == :br && !moeda[:msingular] && !moeda[:mplural]
+      moeda.merge!(msingular: 'REAL', mplural: 'REAIS', fsingular: 'CENTAVO')
+    end
 
     # parametrizar moeda
     ExtensoPt.isingular(moeda)
@@ -201,9 +264,33 @@ module ExtensoPt
     ExtensoPt.pobjeto(self)
   end
 end
-class Hash;   include ExtensoPt; end
-class Array;  include ExtensoPt; end
-class Range;  include ExtensoPt; end
-class Float;  include ExtensoPt; end
-class Integer; include ExtensoPt; end
-class String; include ExtensoPt; end
+
+# permite obter um Hash com valores numericos convertidos nos seus extensos
+class Hash
+  include ExtensoPt
+end
+
+# permite obter um Array com valores numericos convertidos nos seus extensos
+class Array
+  include ExtensoPt
+end
+
+# permite obter um Array com valores numericos convertidos nos seus extensos
+class Range
+  include ExtensoPt
+end
+
+# permite obter o extenso dum Float
+class Float
+  include ExtensoPt
+end
+
+# permite obter o extenso dum Integer
+class Integer
+  include ExtensoPt
+end
+
+# permite obter o extenso duma String de digitos
+class String
+  include ExtensoPt
+end

data/lib/extenso_pt/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: extenso_pt
 version: !ruby/object:Gem::Version
-  version: 0.5.3
+  version: 0.5.4
 platform: ruby
 authors:
 - Hernâni Rodrigues Vaz
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2019-09-27 00:00:00.000000000 Z
+date: 2019-09-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bigdecimal
@@ -66,11 +66,12 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '10.0'
-description: Produz valores monetários por extenso em portugês de portugal ou brasil.
-  Os valores podem ser um numerico, uma string de digitos ou um conjunto destes (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 escolher
-  a moeda e a fração da moeda.
+description: |-
+  Produz valores monetários por extenso\ em portugês de portugal ou brasil. Os valores podem ser um numerico, uma\
+    string de digitos ou um conjunto destes (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 escolher\
+    a moeda e a fração da moeda.
 email:
 - hernanirvaz@gmail.com
 executables: []
@@ -79,8 +80,6 @@ extra_rdoc_files: []
 files:
 - ".gitignore"
 - ".project_alt.json"
-- ".rubocop.yml"
-- ".rubocop_todo.yml"
 - ".travis.yml"
 - Gemfile
 - Gemfile.lock
@@ -116,5 +115,5 @@ requirements: []
 rubygems_version: 3.0.3
 signing_key: 
 specification_version: 4
-summary: Produz valores monetários por extenso em portugês de portugal ou brasil.
+summary: Produz valores monetários por extenso\ em portugês de portugal ou brasil.
 test_files: []

data/.rubocop.yml

@@ -1 +0,0 @@
-inherit_from: .rubocop_todo.yml

data/.rubocop_todo.yml

@@ -1,74 +0,0 @@
-# This configuration was generated by
-# `rubocop --auto-gen-config`
-# on 2019-09-25 11:13:11 +0100 using RuboCop version 0.74.0.
-# The point is for the user to remove these configuration records
-# one by one as the offenses are removed from the code base.
-# Note that changes in the inspected code, or installation of new
-# versions of RuboCop, may require this file to be generated again.
-
-# Offense count: 1
-#Lint/RequireParentheses:
-#  Exclude:
-#    - 'lib/extenso_pt.rb'
-
-# Offense count: 4
-#Metrics/AbcSize:
-#  Max: 58
-
-# Offense count: 3
-Metrics/CyclomaticComplexity:
-  Max: 17
-
-# Offense count: 3
-# Configuration parameters: CountComments, ExcludedMethods.
-Metrics/MethodLength:
-  Max: 24
-
-# Offense count: 3
-Metrics/PerceivedComplexity:
-  Max: 19
-
-# Offense count: 1
-Naming/ConstantName:
-  Exclude:
-    - 'lib/extenso_pt.rb'
-
-# Offense count: 39
-# Configuration parameters: AllowedChars.
-Style/AsciiComments:
-  Exclude:
-    - 'lib/extenso_pt.rb'
-    - 'test/extenso_pt_test.rb'
-
-# Offense count: 7
-Style/ClassVars:
-  Exclude:
-    - 'lib/extenso_pt.rb'
-
-# Offense count: 6
-Style/Documentation:
-  Exclude:
-    - 'spec/**/*'
-    - 'test/**/*'
-    - 'lib/extenso_pt.rb'
-
-# Offense count: 2
-Style/NestedTernaryOperator:
-  Exclude:
-    - 'lib/extenso_pt.rb'
-
-# Offense count: 10
-# Cop supports --auto-correct.
-# Configuration parameters: AutoCorrect, EnforcedStyle, IgnoredMethods.
-# SupportedStyles: predicate, comparison
-Style/NumericPredicate:
-  Exclude:
-    - 'spec/**/*'
-    - 'lib/extenso_pt.rb'
-
-# Offense count: 53
-# Cop supports --auto-correct.
-# Configuration parameters: AutoCorrect, AllowHeredoc, AllowURI, URISchemes, IgnoreCopDirectives, IgnoredPatterns.
-# URISchemes: http, https
-Metrics/LineLength:
-  Max: 317