RubyGems - extenso_pt - Versions diffs - 0.5.3 → 0.5.4 - Mend

extenso_pt 0.5.3 → 0.5.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

checksums.yaml CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

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

metadata CHANGED Viewed

@@ -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 DELETED Viewed

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

data/.rubocop_todo.yml DELETED Viewed

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