extenso_pt 0.6.0 → 0.6.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d1bdf0ca3275038eec98c0152caab67df72476569e5fcf1da8eef189d5fa1d0b
-  data.tar.gz: a7c217ea1f7f3bf22803c4b7934b932bc345b82a1659498badd727d7899c7954
+  metadata.gz: 8ddaa96b022c342baccbdc6c09fc9b4fdc5dbe0047f411610c0ca90a86959db1
+  data.tar.gz: 1fbbeb3c100c0f046789507d6aecd8a4f9277061d2fcec72f98c6c7cd74eb7c1
 SHA512:
-  metadata.gz: af9fddecbf22b45279b0c47aa89ee161dcd9cbd3ac0a0d23ca199e9ca000dc6c1c86c37ffd69d01763d7b86d2a230e3f1e8a529b3135076458fcd9e358c99465
-  data.tar.gz: b398d10b05e86044c0cc5a8ed2df5b72d77fe7ec2a10d3795c1e28624d133654a602d533caf10c183adba31849c17921d20a57578079dda6685aa0a9b43f0d03
+  metadata.gz: d37ed42e21fabe4a9503865c7c7cf1c5f9c0180dcbd36ceabe533de6871cc09d437d51205fa0eb2cd11ab9c41ad0e9127b5a1f0f09e62145519937b5e8276289
+  data.tar.gz: 142dc18b2d31100465851b4714bab65abf46f9038b61636ff206b7237d7f75a9278c5c70e40834d56e506cdfa9371cff62bf620a7462175088020c9de2950717

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    extenso_pt (0.6.0)
+    extenso_pt (0.6.1)
       bigdecimal (~> 1.4.4)
 
 GEM

data/README.md

@@ -1,6 +1,6 @@
 # ExtensoPt [![Build Status](https://travis-ci.org/hernanilr/extenso_pt.svg?branch=master)](https://travis-ci.org/hernanilr/extenso_pt)
 
-Converte valores monetários em extenso de portugês de portugal, brasil ou numeracao romana. 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) [wiki](https://pt.wikipedia.org/wiki/Escalas_curta_e_longa). Pode ainda converter os valores em numeracao romana e vice versa.
+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 em todos os países lusófonos) ou na escala curta (utilizada no Brasil) [wiki](https://pt.wikipedia.org/wiki/Escalas_curta_e_longa). Pode ainda produzir numeracao romana e vice versa.
 
 ## Installation
 
@@ -26,19 +26,19 @@ Or install it yourself as:
 "MCCXXXIV".romana                                  => 1234
 12000000.12.extenso                                => "DOZE MILHÕES DE EUROS E DOZE CÊNTIMOS"
 1.01.extenso(msingular:"DÓLAR")                    => "UM DÓLAR E UM CÊNTIMO"         
-10.1.extenso(mplural:"DÓLARES")                    => "DEZ DÓLARES E DEZ CÊNTIMOS"      # plural inferido <silgular> mais "S"
 14.01.extenso(mplural:"REAIS",fsingular:"CENTAVO") => "CATORZE REAIS E UM CENTAVO"
-14.10.extenso(mplural:"REAIS",fsingular:"CENTAVO") => "CATORZE REAIS E DEZ CENTAVOS"
 14.1.extenso(lc: :br)                              => "QUATORZE REAIS E DEZ CENTAVOS"
-1e10.extenso(lc: :pt,mplural:"REAIS")              => "DEZ MIL MILHÕES DE REAIS"        # portugal usa escala longa
+14.01.extenso(mplural:"REAIS",fplural:"CENTAVOS")  => "CATORZE REAIS E UM CENTAVO"      # singular inferido = <plural> menos "S"
+10.1.extenso(mplural:"DÓLARES")                    => "DEZ DÓLARES E DEZ CÊNTIMOS"      # plural   inferido = <silgular> mais "S"
+1e10.extenso(lc: :pt)                              => "DEZ MIL MILHÕES DE EUROS"        # portugal usa escala longa
 1e10.extenso(lc: :br)                              => "DEZ BILHÕES DE REAIS"            # brasil usa escala curta
-14.01.extenso(mplural:"REAIS",fplural:"CENTAVOS")  => "CATORZE REAIS E UM CENTAVO"      # singular inferido <plural> menos "S"
-["1", "2"].extenso                                 => ["UM EURO","DOIS EUROS"]          # extenso Array
-[0.1, 0.2].extenso                                 => ["DEZ CÊNTIMOS","VINTE CÊNTIMOS"] # extenso Array
-(1..2).extenso                                     => ["UM EURO","DOIS EUROS"]          # extenso Range
-{:a => 1,:b => 2}.extenso                          => {:a=>"UM EURO",:b=>"DOIS EUROS"}  # extenso Hash
-{:a => [3, 4],:b => 2}.extenso                     => {:a=>["TRÊS EUROS", "QUATRO EUROS"],:b=>"DOIS EUROS"} 
-
+[0.1, 0.2].extenso                                 => ["DEZ CÊNTIMOS","VINTE CÊNTIMOS"]
+[4, 5, 6, 7].romana                                => ["IV", "V", "VI", "VII"]
+(1..2).extenso                                     => ["UM EURO","DOIS EUROS"]
+(7..9).romana                                      => ["VII", "VIII", "IX"]
+{:a=>1, :b=>2}.extenso                             => {:a=>"UM EURO",:b=>"DOIS EUROS"}
+{:a=>[3, 4], :b=>2}.extenso                        => {:a=>["TRÊS EUROS", "QUATRO EUROS"],:b=>"DOIS EUROS"} 
+{:a=>["MCMLXVIII", "XIV"], :b=>4}.romana           => {:a=>[1968, 14], :b=>"IV"}
 ```
 
 ## Development

data/extenso_pt.gemspec

@@ -12,14 +12,14 @@ Gem::Specification.new do |spec|
   spec.homepage      = 'https://github.com/hernanilr/extenso_pt'
   spec.license       = 'MIT'
 
-  spec.summary = 'Converte valores monetários em extenso de 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 (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 ' \
-    'converter os valores em 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

data/lib/extenso_pt/constantes.rb

@@ -2,7 +2,7 @@
 
 # @author Hernani Rodrigues Vaz
 module ExtensoPt
-  # constantes para producao de extenso em portugues de portugal ou brasil
+  # constantes de extenso em portugues de portugal ou brasil
   EXTLC = %i[pt br].freeze
   A0020 = {
     pt: ['', 'UM', 'DOIS', 'TRÊS', 'QUATRO', 'CINCO', 'SEIS', 'SETE',
@@ -43,7 +43,7 @@ module ExtensoPt
             br: ['', ' MIL', ' MILHÕES', ' BILHÕES', ' TRILHÕES',
                  ' QUADRILHÕES', ' QUINTILHÕES', ' SEXTILHÕES'] }.freeze
 
-  # contantes para numeracao romana
+  # contantes de numeracao romana
   ROMAN = { M: 1000, CM: 900,
             D: 500,  CD: 400,
             C: 100,  XC: 90,
@@ -51,6 +51,5 @@ module ExtensoPt
             X: 10,   IX: 9,
             V: 5,    IV: 4,
             I: 1 }.freeze
-  # numeral romano
   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

@@ -2,35 +2,35 @@
 
 # @author Hernani Rodrigues Vaz
 module ExtensoPt
-  # Produz o extenso das centenas em portugues de portugal ou brasil
+  # Produz 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
+  # @return [String] extenso das centenas
   def self.e900(mil)
     A1000[@lc][(mil > 100 ? 1 : 0) + mil / 100] +
       (mil > 100 && (mil % 100).positive? ? ' E ' : '') # proposicao
   end
 
-  # Produz o extenso das dezenas em portugues de portugal ou brasil
+  # Produz extenso das dezenas em portugues de portugal ou brasil
   #
-  # @param [Integer] cem o valor dum grupo 3 digitos a converter
-  # @return [String] o extenso das dezenas
+  # @param [Integer] cem a centena dum grupo 3 digitos a converter
+  # @return [String] extenso das dezenas
   def self.e090(cem)
     A0100[@lc][cem / 10] +
       (cem > 20 && (cem % 10).positive? ? ' E ' : '') # proposicao
   end
 
-  # Produz o extenso das unidades em portugues de portugal ou brasil
+  # Produz extenso das unidades em portugues de portugal ou brasil
   #
-  # @param [Integer] cem o valor dum grupo 3 digitos a converter
-  # @return [String] o extenso das unidades
+  # @param [Integer] cem a centena dum grupo 3 digitos a converter
+  # @return [String] extenso das unidades
   def self.e009(cem)
     A0020[@lc][cem < 20 ? cem : cem % 10]
   end
 
-  # Produz extenso parte fracionaria em portugues de portugal ou brasil
+  # Produz extenso da parte fracionaria em portugues de portugal ou brasil
   #
-  # @return [String] o extenso da parte fracionaria dum valor monetario
+  # @return [String] extenso da parte fracionaria
   def self.ef99
     # parametrizacao por defeito
     @cs ||= 'CÊNTIMO'
@@ -45,7 +45,7 @@ module ExtensoPt
 
   # Produz final da moeda em portugues de portugal ou brasil
   #
-  # @return [String] o final da moeda
+  # @return [String] final da moeda
   def self.efim
     # parametrizacao por defeito
     @ms ||= 'EURO'
@@ -62,7 +62,7 @@ module ExtensoPt
 
   # Produz separador entre grupos 3 digitos
   #
-  # @param [Integer] pos posicao actual nos grupos 3 digitos do valor monetario
+  # @param [Integer] pos posicao actual nos grupos 3 digitos
   # @return [String] separador entre grupos 3 digitos
   def self.edgs(pos)
     if pos.positive? && @ai[pos - 1].positive?
@@ -74,34 +74,27 @@ module ExtensoPt
 
   # Produz qualificador grupo de 3 digitos em portugues de portugal ou brasil
   #
-  # @param [Integer] pos posicao actual nos grupos 3 digitos do valor monetario
+  # @param [Integer] pos posicao actual nos grupos 3 digitos
   # @return [String] qualificador grupo de 3 digitos
   def self.e124(pos)
     if @ai[pos].positive?
       @ai[pos] > 1 ? P1E24[@lc][pos] : S1E24[@lc][pos]
     else
       ''
-    end
+    end + edgs(pos)
   end
 
-  # Produz extenso grupo 3 digitos em portugues de portugal ou brasil
+  # Produz extenso de grupo 3 digitos em portugues de portugal ou brasil
   #
-  # @param [Integer] pos posicao actual nos grupos 3 digitos do valor monetario
+  # @param [Integer] pos posicao actual nos grupos 3 digitos
   # @return [String] extenso grupo 3 digitos
   def self.edg3(pos)
-    # parametrizacao por defeito
-    # the first mention of an @<variable> creates the
-    # instance variable in the current object ie: self = ExtensoPt
-    @lc ||= :pt
-
-    dg3 = if pos == 1 && @ai[pos] == 1
-            # caso especial MIL EUROS
-            ''
-          else
-            e900(@ai[pos]) + e090(@ai[pos] % 100) + e009(@ai[pos] % 100)
-          end
-    # qualificador grupo de 3 digitos
-    dg3 + e124(pos)
+    # caso especial MIL EUROS
+    if pos == 1 && @ai[pos] == 1
+      ''
+    else
+      e900(@ai[pos]) + e090(@ai[pos] % 100) + e009(@ai[pos] % 100)
+    end + e124(pos)
   end
 
   # Parametrizar controle singular/plural & proposicoes
@@ -112,11 +105,13 @@ module ExtensoPt
     @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
+    # parametrizar controle de proposicao E & singular/plural
+    @tt = @s6 + @m6
+    # parametrizar controle de proposicao DE
+    @de = @s6.zero? && @m6.positive?
   end
 
-  # Produz o extenso dum valor monetario em portugues de portugal ou brasil
+  # Produz extenso em portugues de portugal ou brasil
   #
   # @param [Integer] pos posicao actual nos grupos 3 digitos do valor monetario
   # @param [String] ext extenso em construcao
@@ -124,27 +119,32 @@ module ExtensoPt
   def self.etot(pos, ext)
     # testa fim do valor monetario
     if pos >= @ai.count
-      # parametrizar controle singular/plural & proposicoes
+      # parametrizar variaveis de controle
       epsp
 
       # caso especial zero
       (@tt + @nf).zero? ? 'ZERO ' + @mp : ext + efim
     else
-      # tratamento do proximo grupo 3 digitos
-      etot(pos + 1, edg3(pos) + edgs(pos) + ext)
+      # tratamento de grupo 3 digitos
+      etot(pos + 1, edg3(pos) + ext)
     end
   end
 
-  # Parametrizar parte inteira/fracionaria do valor monetario
+  # Parametrizar parte inteira/fracionaria da string digitos
   #
   # @param [String] digitos do valor monetario
   # @return [void]
   def self.epif(dig)
-    # parte inteira do valor monetario => array grupos 3 digitos
+    # parametrizacao por defeito
+    # the first mention of an @<variable> creates the
+    # instance variable in the current object ie: self = ExtensoPt
+    @lc ||= :pt
+
+    # converte parte inteira da string digitos em array com grupos de 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
+    # obtem parte fracionaria da string digitos
     #  ex: 123022.12 => 12
     # arredondada a 2 casas decimais (centimos/centavos)
     @nf = (dig[/\.\d*/].to_f * 100).round
@@ -159,26 +159,26 @@ module ExtensoPt
   #  array<extensos> se objecto for (Array, Range),
   #  hash<extensos> se objecto for (Hash)
   def self.eo2e(obj)
-    # converte os valores do Hash nos seus extensos - devolve um Hash
+    # converte os valores do Hash nos seus extensos
     if obj.is_a?(Hash) then obj.map { |k, v| [k, eo2e(v)] }.to_h
-    # converte o objecto num Array com os extensos dos valores
+    # converte objecto num Array com os valores convertidos em extensos
     elsif obj.respond_to?(:to_a) then obj.to_a.map { |a| eo2e(a) }
     else
       # converte objeto em string digitos utilizando bigdecimal para
       #  evitar problemas com aritmetica virgula flutuante em valores >1e12
-      # parametrizar parte inteira/fracionaria (@ai, @nf) do valor monetario
+      # parametrizar parte inteira/fracionaria (@ai, @nf) da string digitos
       epif(obj.to_d.to_s('F'))
 
-      # processar extenso - valores >1e24 nao sao tratados
+      # processar extenso - valores >1e24 sao ignorados
       @ai.count > 8 ? '' : etot(0, '')
     end
   end
 
   # Parametrizar moeda inferindo singular a partir do plural
   #
-  # @param [Hash] moeda as opcoes para parametrizar a moeda/fracao
+  # @param [Hash] moeda as opcoes para parametrizar moeda/fracao
   # @option moeda [Symbol] :lc locale do extenso -
-  #  portugues de portugal (:pt) ou brasil (:br)
+  #  portugues de portugal (:pt) portugues do brasil (:br)
   # @option moeda [String] :msingular moeda no singular -
   #  inferido do plural menos"S"
   # @option moeda [String] :fsingular fracao no singular -
@@ -195,9 +195,9 @@ module ExtensoPt
 
   # Parametrizar moeda inferindo plural a partir do singular
   #
-  # @param [Hash] moeda as opcoes para parametrizar a moeda/fracao
+  # @param [Hash] moeda as opcoes para parametrizar moeda/fracao
   # @option moeda [Symbol] :lc locale do extenso -
-  #  portugues de portugal (:pt) ou brasil (:br)
+  #  portugues de portugal (:pt) portugues do brasil (:br)
   # @option moeda [String] :msingular moeda no singular
   # @option moeda [String] :fsingular fracao no singular
   # @option moeda [String] :mplural moeda no plural -

data/lib/extenso_pt/romana.rb

@@ -2,20 +2,22 @@
 
 # @author Hernani Rodrigues Vaz
 module ExtensoPt
-  # Recursivamente produz numeral romano
+  # Produz numeral romano a partir de inteiro
   #
-  # @param [Integer] numero a converter em numeral romano
+  # @param [Integer] inteiro a converter
   # @return [String] numeral romano
-  def self.ri2r(numero)
-    return '' if numero <= 0
+  def self.ri2r(inteiro)
+    return '' if inteiro.zero?
 
-    ROMAN.each { |r, v| return r.to_s + ri2r(numero - v) if v <= numero }
+    # numeracao romana nao tem negativos
+    inteiro = inteiro.abs if inteiro.negative?
+    ROMAN.each { |r, v| return r.to_s + ri2r(inteiro - v) if v <= inteiro }
   end
 
-  # Recursivamente produz inteiro
+  # Produz inteiro a partir de numeral romano
   #
-  # @param [String] numeral romano em convercao
-  # @param [Integer] ultimo numeral convertido
+  # @param [String] numeral romano a converter
+  # @param [Integer] ultimo valor convertido
   # @return [Integer] inteiro do numeral romano
   def self.rr2i(numeral, ultimo)
     return 0 if numeral.empty?

data/lib/extenso_pt/version.rb

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

data/lib/extenso_pt.rb

@@ -10,11 +10,12 @@ require 'extenso_pt/romana'
 module ExtensoPt
   class Error < StandardError; end
 
-  # Produz extenso(s)) em portugues de portugal ou brasil
+  # Produz extenso em portugues de portugal ou brasil
+  # (valor numerico pode ser uma string digitos)
   #
-  # @param [Hash] moeda as opcoes para parametrizar a moeda/fracao
+  # @param [Hash] moeda as opcoes para parametrizar moeda/fracao
   # @option moeda [Symbol] :lc locale do extenso -
-  #  portugues de portugal (:pt) ou brasil (:br)
+  #  portugues de portugal (:pt) portugues do brasil (:br)
   # @option moeda [String] :msingular moeda no singular
   # @option moeda [String] :fsingular fracao no singular
   # @option moeda [String] :mplural moeda no plural
@@ -33,32 +34,32 @@ module ExtensoPt
     ExtensoPt.epsi(moeda)
     ExtensoPt.eppl(moeda)
 
-    # cria extenso(s) em portugues de portugal ou brasil
+    # cria extenso em portugues de portugal ou brasil
     ExtensoPt.eo2e(self)
   end
 
-  # Testa se string contem numeracao romana
+  # Testa se contem numeracao romana
   #
   # @return [true, false] sim ou nao numeracao romana
   def romana?
     is_a?(String) ? RO_RE.match?(upcase) : false
   end
 
-  # Produz numeracao romana a partir de numerico
-  # ou numerico a partir da numeracao romana
-  # (numerico pode ser uma string digitos)
+  # 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 inteiro
+  # @return [String, Integer] numeracao romana ou valor numerico
   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
-    elsif (inteiro = to_i).positive? then ExtensoPt.ri2r(inteiro)
-    else
-      # inteiro a partir da numeracao romana
-      RO_RE.match?(to_s) ? ExtensoPt.rr2i(upcase, 0) : ''
+    # (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) : ''
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: extenso_pt
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.6.1
 platform: ruby
 authors:
 - Hernâni Rodrigues Vaz
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2019-11-08 00:00:00.000000000 Z
+date: 2019-11-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -66,11 +66,11 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 1.4.4
-description: Converte valores monetários em extenso de portugês de portugal, brasil
-  ou numeracao romana. 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 converter os valores em numeracao romana e vice versa.
+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
+  em todos os países lusófonos) ou na escala curta (utilizada no Brasil). Pode ainda
+  produzir numeracao romana e vice versa.
 email:
 - hernanirvaz@gmail.com
 executables: []
@@ -117,6 +117,5 @@ requirements: []
 rubygems_version: 3.0.3
 signing_key: 
 specification_version: 4
-summary: Converte valores monetários em extenso de portugês de portugal, brasil ou
-  numeracao romana.
+summary: Produz extenso em portugês de portugal, brasil ou numeracao romana.
 test_files: []