extensobr 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 5e99b58efe83a3f99bb83bb9be0848571a809e4d
+  data.tar.gz: fe0ccbb85bbf842a10c77120e9e6e41a5e661113
+SHA512:
+  metadata.gz: f0b80a3ea762824614f683473463b6943794e10701d5a2c2e0eec51a6f5b75083dfcded2e0d659e38d31b1061f3743d2d36b819d936fe3ee64b41aabdc31c2dc
+  data.tar.gz: 45907740fd1c97467723502ba54705e5b0937bcaa560517cfbb8deaefca136d72a9d71be1d0add7ec9e905c63f7ea37fcf29b0a68d9f6dadf88b8a304b428ad8

data/.gitignore

@@ -0,0 +1,9 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,74 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as
+contributors and maintainers pledge to making participation in our project and
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, gender identity and expression, level of experience,
+nationality, personal appearance, race, religion, or sexual identity and
+orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment
+include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or
+advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic
+  address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community. Examples of
+representing a project or community include using an official project e-mail
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event. Representation of a project may be
+further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project team at rickmaxg3@hotmail.com. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. The project team is
+obligated to maintain confidentiality with regard to the reporter of an incident.
+Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
+available at [http://contributor-covenant.org/version/1/4][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/4/

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in extensobr.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 MacBook Pro
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,56 @@
+# Extensobr
+
+Esta gem foi desenvolvida para auxiliar no desenvolvimento de aplicações onde é necessário escrever ou imprimir números ou moedas por extenso como por exemplo em recibos, contratos entre outros.
+
+
+## Instalação
+
+Adicionando em sua Gemfile:
+
+```ruby
+gem 'extensobr'
+```
+
+Ou instale você mesmo:
+
+    $ gem install extensobr
+
+## Exemplos de uso
+
+Para obter o extenso de um número, utilize GExtenso.numero.
+
+    irb
+
+require 'Extensobr.rb'
+ 
+    puts Extenso.numero(832); # oitocentos e trinta e dois
+    puts Extenso.numero(832, Extenso::GENERO_FEM) # oitocentas e trinta e duas
+
+Para obter o extenso de um valor monetário, utilize GExtenso.moeda.
+
+    require 'Extenso.rb'
+ 
+## IMPORTANTE: este método recebe um valor inteiro(int), para a contagem das casas decimais!
+    
+    puts Extenso.moeda(15402) # cento e cinquenta e quatro reais e dois centavos
+    puts Extenso.moeda(47)   # quarenta e sete centavos
+    puts Extenso.moeda(357082, 2, ['peseta', 'pesetas', Extenso::GENERO_FEM], ['cêntimo', 'cêntimos', Extenso::GENERO_MASC])
+
+## três mil, quinhentas e setenta pesetas e oitenta e dois cêntimos
+
+# Developers
+
+[Henrique Max](https://github.com/rickmax),
+[Fausto G. Cintra](https://github.com/goncin)
+
+## Como contribuir?
+
+1. Fazer um fork do projeto
+1. Fazer os devidos ajustes com os respectivos testes
+1. Fazer pull request
+
+
+## Licença
+
+Está Gem esta disponível sob ostermos de licença [MIT License](http://opensource.org/licenses/MIT).
+

data/Rakefile

@@ -0,0 +1,2 @@
+require "bundler/gem_tasks"
+task :default => :spec

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "extensobr"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/extensobr.gemspec

@@ -0,0 +1,29 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'extensobr/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "extensobr"
+  spec.version       = Extensobr::VERSION
+  spec.authors       = ["Henrique Max"]
+  spec.email         = ["rickmaxg3@hotmail.com"]
+
+  spec.summary       = %q{ExtendoBr escreve números e moeda por extenso.}
+  spec.description   = %q{ExtensoBr é uma gem que foi desenvolvida para auxiliar na impressão de números e moedas por extenso em portugês do Brasil.}
+  spec.homepage      = "https://github.com/rickmax/extensobr"
+  spec.license       = "MIT"
+
+  # Prevent pushing this gem to RubyGems.org. To allow pushes either set the 'allowed_push_host'
+  # to allow pushing to a single host or delete this section to allow pushing to any host.
+
+  spec.files         = `git ls-files -z`.split("\x0").reject do |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.13"
+  spec.add_development_dependency "rake", "~> 10.0"
+end

data/lib/extensobr/version.rb

@@ -0,0 +1,3 @@
+module Extensobr
+  VERSION = "0.1.0"
+end

data/lib/extensobr.rb

@@ -0,0 +1,451 @@
+require "extensobr/version"
+class Extenso
+# Extenso class file
+
+# Extenso é uma classe que gera a representação por extenso de um número ou valor monetário.
+#
+# ATENÇÃO: A PÁGINA DE CÓDIGO DESTE ARQUIVO É UTF-8 (Unicode)!
+# 
+# Sua implementação foi feita como prova de conceito, utilizando:
+# * Métodos estáticos, implementando o padrão de projeto ("design pattern") SINGLETON;
+# * Chamadas recursivas a métodos, minimizando repetições e mantendo o código enxuto; e
+# * Tratamento de erros por intermédio de exceções.
+#
+# = EXEMPLOS DE USO =
+#
+# Para obter o extenso de um número, utilize Extenso.numero.
+# 
+# puts Extenso.numero(832); # oitocentos e trinta e dois
+# puts Extenso.numero(832, Extenso::GENERO_FEM) # oitocentas e trinta e duas
+# 
+#
+# Para obter o extenso de um valor monetário, utilize Extenso.moeda.
+# 
+# # IMPORTANTE: veja nota sobre o parâmetro 'valor' na documentação do método!
+#
+# puts Extenso.moeda(15402) # cento e cinquenta e quatro reais e dois centavos
+#
+# puts Extenso.moeda(47)   # quarenta e sete centavos
+#
+# puts Extenso.moeda(357082, 2,
+#   ['peseta', 'pesetas', Extenso::GENERO_FEM],
+#   ['cêntimo', 'cêntimos', Extenso::GENERO_MASC])
+#   # três mil, quinhentas e setenta pesetas e oitenta e dois cêntimos
+#
+  
+  NUM_SING = 0
+  NUM_PLURAL = 1
+  POS_GENERO = 2
+  GENERO_MASC = 0
+  GENERO_FEM = 1
+  
+  VALOR_MAXIMO = 999999999
+  
+  # As unidades 1 e 2 variam em gênero, pelo que precisamos de dois conjuntos de strings (masculinas e femininas) para as unidades
+  UNIDADES = {
+    GENERO_MASC => {
+      1 => 'Um',
+      2 => 'Dois',
+      3 => 'Três',
+      4 => 'Quatro',
+      5 => 'Cinco',
+      6 => 'Seis',
+      7 => 'Sete',
+      8 => 'Oito',
+      9 => 'Nove'
+    },
+    GENERO_FEM => {
+      1 => 'Uma',
+      2 => 'Duas',
+      3 => 'Três',
+      4 => 'Quatro',
+      5 => 'Cinco',
+      6 => 'Seis',
+      7 => 'Sete',
+      8 => 'Oito',
+      9 => 'Nove'
+    }
+  }
+  
+  DE11A19 = {
+    11 => 'Onze',
+    12 => 'Doze',
+    13 => 'Treze',
+    14 => 'Quatorze',
+    15 => 'Quinze',
+    16 => 'Dezesseis',
+    17 => 'Dezessete',
+    18 => 'Dezoito',
+    19 => 'Dezenove'
+  }
+  
+  DEZENAS = {
+    10 => 'Dez',
+    20 => 'Vinte',
+    30 => 'Trinta',
+    40 => 'Quarenta',
+    50 => 'Cinquenta',
+    60 => 'Sessenta',
+    70 => 'Setenta',
+    80 => 'Oitenta',
+    90 => 'Noventa'
+  }
+  
+  CENTENA_EXATA = 'Cem'
+  
+  # As centenas, com exceção de 'cento', também variam em gênero. Aqui também se faz
+  # necessário dois conjuntos de strings (masculinas e femininas).
+   
+  CENTENAS = {
+    GENERO_MASC => {
+      100 => 'Cento',
+      200 => 'Duzentos',
+      300 => 'Trezentos',
+      400 => 'Quatrocentos',
+      500 => 'Quinhentos',
+      600 => 'Seiscentos',
+      700 => 'Setecentos',
+      800 => 'Oitocentos',
+      900 => 'Novecentos'
+    },
+    GENERO_FEM => {
+      100 => 'Cento',
+      200 => 'Duzentas',
+      300 => 'Trezentas',
+      400 => 'Quatrocentas',
+      500 => 'Quinhentas',
+      600 => 'Seiscentas',
+      700 => 'Setecentas',
+      800 => 'Oitocentas',
+      900 => 'Novecentas'
+    }
+  }
+  
+  #'Mil' é invariável, seja em gênero, seja em número
+  MILHAR = 'mil'
+
+  MILHOES = {
+    NUM_SING => 'Milhão',
+    NUM_PLURAL => 'Milhões'
+  }
+
+   UNIDADES_ORDINAL = {
+    GENERO_MASC => {
+      1 => 'Primeiro',
+      2 => 'Segundo',
+      3 => 'Terceiro',
+      4 => 'Quarto',
+      5 => 'Quinto',
+      6 => 'Sexto',
+      7 => 'Sétimo',
+      8 => 'Oitavo',
+      9 => 'Nono'},
+    GENERO_FEM => {
+      1 => 'Primeira',
+      2 => 'Segunda',
+      3 => 'Terceira',
+      4 => 'Quarta',
+      5 => 'Quinta',
+      6 => 'Sexta',
+      7 => 'Sétima',
+      8 => 'Oitava',
+      9 => 'Nona'}}
+
+  DEZENAS_ORDINAL = {
+    GENERO_MASC => {
+      10 => 'Décimo',
+      20 => 'Vigésimo',
+      30 => 'Trigésimo',
+      40 => 'Quadragésimo',
+      50 => 'Quinquagésimo',
+      60 => 'Sexagésimo',
+      70 => 'Septuagésimo',
+      80 => 'Octogésimo',
+      90 => 'Nonagésimo'},
+    GENERO_FEM => {
+      10 => 'Décima',
+      20 => 'Vigésima',
+      30 => 'Trigésima',
+      40 => 'Quadragésima',
+      50 => 'Quinquagésima',
+      60 => 'Sexagésima',
+      70 => 'Septuagésima',
+      80 => 'Octogésima',
+      90 => 'Nonagésima'}}
+   
+  CENTENAS_ORDINAL = {
+    GENERO_MASC => {
+      100 => 'Centésimo',
+      200 => 'Ducentésimo',
+      300 => 'Trecentésimo',
+      400 => 'Quadringentésimo',
+      500 => 'Quingentésimo',
+      600 => 'Seiscentésimo',
+      700 => 'Septingentésimo',
+      800 => 'Octingentésimo',
+      900 => 'Noningentésimo'},
+    GENERO_FEM => {
+      100 => 'Centésima',
+      200 => 'Ducentésima',
+      300 => 'Trecentésima',
+      400 => 'Quadringentésima',
+      500 => 'Quingentésima',
+      600 => 'Seiscentésima',
+      700 => 'Septingentésima',
+      800 => 'Octingentésima',
+      900 => 'Noningentésima'}}
+    
+  
+    MILHAR_ORDINAL = {
+      GENERO_MASC => {
+        1000 => 'Milésimo'},
+      GENERO_FEM =>{
+        1000 => 'Milésima'}}
+  
+  def self.is_int(s)
+    Integer(s) != nil rescue false
+  end
+  
+  #######################################################################################################################################
+  
+  def self.numero (valor, genero = GENERO_MASC)
+
+    # Gera a representação por extenso de um número inteiro, maior que zero e menor ou igual a VALOR_MAXIMO.
+    #
+    # PARÂMETROS:
+    # valor (Integer) O valor numérico cujo extenso se deseja gerar
+    #
+    # genero (Integer) [Opcional; valor padrão: Extenso::GENERO_MASC] O gênero gramatical (Extenso::GENERO_MASC ou Extenso::GENERO_FEM)
+    # do extenso a ser gerado. Isso possibilita distinguir, por exemplo, entre 'duzentos e dois homens' e 'duzentas e duas mulheres'.
+    #
+    # VALOR DE RETORNO:
+    # (String) O número por extenso
+    
+    # ----- VALIDAÇÃO DOS PARÂMETROS DE ENTRADA ---- 
+    
+    if !is_int(valor)
+      raise "[Exceção em Extenso.numero] Parâmetro 'valor' não é numérico (recebido: '#{valor}')"
+    elsif valor <= 0
+      raise "[Exceção em Extenso.numero] Parâmetro 'valor' igual a ou menor que zero (recebido: '#{valor}')"
+    elsif valor > VALOR_MAXIMO
+      raise '[Exceção em Extenso::numero] Parâmetro ''valor'' deve ser um inteiro entre 1 e ' + VALOR_MAXIMO.to_s + " (recebido: '#{valor}')"
+    elsif genero != GENERO_MASC && genero != GENERO_FEM
+      raise "Exceção em Extenso: valor incorreto para o parâmetro 'genero' (recebido: '#{genero}')"
+
+  # ------------------------------------------------
+
+    elsif valor >= 1 && valor <= 9
+      UNIDADES[genero][valor]
+    
+    elsif valor == 10
+      DEZENAS[valor]
+
+    elsif valor >= 11 && valor <= 19
+      DE11A19[valor]
+    
+    elsif valor >= 20 && valor <= 99
+      dezena = valor - (valor % 10)
+      ret = DEZENAS[dezena]
+      # Chamada recursiva à função para processar resto se este for maior que zero.
+      # O conectivo 'e' é utilizado entre dezenas e unidades.
+      resto = valor - dezena
+      if resto > 0
+        ret += ' e ' + self.numero(resto, genero)
+      end
+      ret
+
+    elsif valor == 100 
+      CENTENA_EXATA
+
+    elsif valor >= 101 && valor <= 999
+      centena = valor - (valor % 100)
+      ret = CENTENAS[genero][centena] # As centenas (exceto 'cento') variam em gênero
+      # Chamada recursiva à função para processar resto se este for maior que zero.
+      # O conectivo 'e' é utilizado entre centenas e dezenas.
+      resto = valor - centena 
+      if resto > 0
+        ret += ' e ' + self.numero(resto, genero)
+      end
+      ret
+
+    elsif valor >= 1000 && valor <= 999999
+      # A função 'floor' é utilizada para encontrar o inteiro da divisão de valor por 1000,
+      # assim determinando a quantidade de milhares. O resultado é enviado a uma chamada recursiva
+      # da função. A palavra 'mil' não se flexiona.
+      milhar = (valor / 1000).floor
+      ret = self.numero(milhar, GENERO_MASC) + ' ' + MILHAR # 'Mil' é do gênero masculino
+      resto = valor % 1000
+      # Chamada recursiva à função para processar resto se este for maior que zero.
+      # O conectivo 'e' é utilizado entre milhares e números entre 1 e 99, bem como antes de centenas exatas.
+      if resto > 0 && ((resto >= 1 && resto <= 99) || resto % 100 == 0)
+        ret += ' e ' + self.numero(resto, genero)
+      # Nos demais casos, após o milhar é utilizada a vírgula.
+      elsif (resto > 0)
+        ret += ', ' + self.numero(resto, genero)
+      end
+      ret
+
+    elsif valor >= 100000 && valor <= VALOR_MAXIMO
+      # A função 'floor' é utilizada para encontrar o inteiro da divisão de valor por 1000000,
+      # assim determinando a quantidade de milhões. O resultado é enviado a uma chamada recursiva
+      # da função. A palavra 'milhão' flexiona-se no plural.
+      milhoes = (valor / 1000000).floor
+      ret = self.numero(milhoes, GENERO_MASC) + ' ' # Milhão e milhões são do gênero masculino
+      
+      # Se a o número de milhões for maior que 1, deve-se utilizar a forma flexionada no plural
+      ret += milhoes == 1 ? MILHOES[NUM_SING] : MILHOES[NUM_PLURAL]
+
+      resto = valor % 1000000
+
+      # Chamada recursiva à função para processar resto se este for maior que zero.
+      # O conectivo 'e' é utilizado entre milhões e números entre 1 e 99, bem como antes de centenas exatas.
+      if resto && ((resto >= 1 && resto <= 99) || resto % 100 == 0)
+        ret += ' e ' + ret.numero(resto, genero)
+      # Nos demais casos, após o milhão é utilizada a vírgula.
+      elsif resto > 0
+        ret += ', ' + self.numero(resto, genero)
+      end
+      ret
+
+    end
+  
+  end
+  
+  #######################################################################################################################################
+  
+  def self.moeda(
+    valor,
+    casas_decimais = 2,
+    info_unidade = ['Real', 'Reais', GENERO_MASC],
+    info_fracao = ['Centavo', 'Centavos', GENERO_MASC]
+  ) 
+  
+   # Gera a representação por extenso de um valor monetário, maior que zero e menor ou igual a Extenso::VALOR_MAXIMO.
+   #
+   #
+   # PARÂMETROS:
+   # valor (Integer) O valor monetário cujo extenso se deseja gerar.
+   #   ATENÇÃO: PARA EVITAR OS CONHECIDOS PROBLEMAS DE ARREDONDAMENTO COM NÚMEROS DE PONTO FLUTUANTE, O VALOR DEVE SER PASSADO
+   #   JÁ DEVIDAMENTE MULTIPLICADO POR 10 ELEVADO A $casasDecimais (o que equivale, normalmente, a passar o valor com centavos
+   #   multiplicado por 100)
+   #
+   # casas_decimais (Integer) [Opcional; valor padrão: 2] Número de casas decimais a serem consideradas como parte fracionária (centavos)
+   #
+   # info_unidade (Array) [Opcional; valor padrão: ['real', 'reais', Extenso::GENERO_MASC]] Fornece informações sobre a moeda a ser
+   #   utilizada. O primeiro valor da matriz corresponde ao nome da moeda no singular, o segundo ao nome da moeda no plural e o terceiro
+   #   ao gênero gramatical do nome da moeda (Extenso::GENERO_MASC ou Extenso::GENERO_FEM)
+   #
+   # info_fracao (Array) [Opcional; valor padrão: ['centavo', 'centavos', Extenso::GENERO_MASC]] Provê informações sobre a parte fracionária
+   #   da moeda. O primeiro valor da matriz corresponde ao nome da parte fracionária no singular, o segundo ao nome da parte fracionária no plural
+   #   e o terceiro ao gênero gramatical da parte fracionária (Extenso::GENERO_MASC ou Extenso::GENERO_FEM)
+   #
+   # VALOR DE RETORNO:
+   # (String) O valor monetário por extenso
+   
+    # ----- VALIDAÇÃO DOS PARÂMETROS DE ENTRADA ----
+
+    if ! self.is_int(valor)
+      raise "[Exceção em Extenso.moeda] Parâmetro 'valor' não é numérico (recebido: '#{valor}')"
+
+    elsif valor <= 0
+      raise "[Exceção em Extenso.moeda] Parâmetro valor igual a ou menor que zero (recebido: '#{valor}')"
+
+    elsif ! self.is_int(casas_decimais) || casas_decimais < 0
+      raise "[Exceção em Extenso.moeda] Parâmetro 'casas_decimais' não é numérico ou é menor que zero (recebido: '#{casas_decimais}')"
+
+    elsif info_unidade.class != Array || info_unidade.length < 3
+      temp = info_unidade.class == Array ? '[' + info_unidade.join(', ') + ']' : "'#{info_unidade}'"
+      raise "[Exceção em Extenso.moeda] Parâmetro 'info_unidade' não é uma matriz com 3 (três) elementos (recebido: #{temp})"
+    
+    elsif info_unidade[POS_GENERO] != GENERO_MASC && info_unidade[POS_GENERO] != GENERO_FEM
+      raise "Exceção em Extenso: valor incorreto para o parâmetro 'info_unidade[POS_GENERO]' (recebido: '#{info_unidade[POS_GENERO]}')"
+
+    elsif info_fracao.class != Array || info_fracao.length < 3
+      temp = info_fracao.class == Array ? '[' + info_fracao.join(', ') + ']' : "'#{info_fracao}'"
+      raise "[Exceção em Extenso.moeda] Parâmetro 'info_fracao' não é uma matriz com 3 (três) elementos (recebido: #{temp})"
+    
+    elsif info_fracao[POS_GENERO] != GENERO_MASC && info_fracao[POS_GENERO] != GENERO_FEM
+      raise "[Exceção em Extenso.moeda] valor incorreto para o parâmetro 'info_fracao[POS_GENERO]' (recebido: '#{info_fracao[POS_GENERO]}')."
+    
+    end
+
+    # -----------------------------------------------
+
+    ret = ''
+
+    # A parte inteira do valor monetário corresponde ao valor passado dividido por 10 elevado a casas_decimais, desprezado o resto.
+    # Assim, com o padrão de 2 casas_decimais, o valor será dividido por 100 (10^2), e o resto é descartado utilizando-se floor().
+    parte_inteira = valor.floor / (10**casas_decimais)
+
+    # A parte fracionária ('centavos'), por seu turno, corresponderá ao resto da divisão do valor por 10 elevado a casas_decimais.
+    # No cenário comum em que trabalhamos com 2 casas_decimais, será o resto da divisão do valor por 100 (10^2).
+    fracao = valor % (10**casas_decimais)
+
+    # O extenso para a parte_inteira somente será gerado se esta for maior que zero. Para tanto, utilizamos
+    # os préstimos do método Extenso::numero().
+    if parte_inteira > 0
+      ret = self.numero(parte_inteira, info_unidade[POS_GENERO]) + ' '
+      ret += parte_inteira == 1 ? info_unidade[NUM_SING] : info_unidade[NUM_PLURAL]
+    end
+
+    # De forma semelhante, o extenso da fracao somente será gerado se esta for maior que zero. */
+    if fracao > 0
+      # Se a parte_inteira for maior que zero, o extenso para ela já terá sido gerado. Antes de juntar os
+      # centavos, precisamos colocar o conectivo 'e'.
+      if parte_inteira > 0
+        ret += ' e '
+      end
+      ret += self.numero(fracao, info_fracao[POS_GENERO]) + ' '
+      ret += parte_inteira == 1 ? info_fracao[NUM_SING] : info_fracao[NUM_PLURAL]
+    end
+
+    ret
+
+  end
+
+  ######################################################################################################################################################
+  def self.ordinal (valor, genero = GENERO_MASC)
+
+    # Gera a representação ordinal de um número inteiro de 1 à 1000
+
+    # PARÂMETROS:
+    # valor (Integer) O valor numérico cujo extenso se deseja gerar
+    #
+    # genero (Integer) [Opcional; valor padrão: Extenso::GENERO_MASC] O gênero gramatical (Extenso::GENERO_MASC ou Extenso::GENERO_FEM)
+    # do extenso a ser gerado. Isso possibilita distinguir, por exemplo, entre 'duzentos e dois homens' e 'duzentas e duas mulheres'.
+    #
+    # VALOR DE RETORNO:
+    # (String) O número por extenso
+    
+    # ----- VALIDAÇÃO DOS PARÂMETROS DE ENTRADA ---- 
+    
+    if !is_int(valor)
+      raise "[Exceção em Extenso.numero] Parâmetro 'valor' não é numérico (recebido: '#{valor}')"
+    elsif valor <= 0
+      raise "[Exceção em Extenso.numero] Parâmetro 'valor' igual a ou menor que zero (recebido: '#{valor}')"
+    elsif valor > VALOR_MAXIMO
+      raise '[Exceção em Extenso::numero] Parâmetro ''valor'' deve ser um inteiro entre 1 e ' + VALOR_MAXIMO.to_s + " (recebido: '#{valor}')"
+    elsif genero != GENERO_MASC && genero != GENERO_FEM
+      raise "Exceção em Extenso: valor incorreto para o parâmetro 'genero' (recebido: '#{genero}')"
+  # ------------------------------------------------
+    elsif valor >= 1 && valor <= 9
+      return UNIDADES_ORDINAL[genero][valor]
+    elsif valor >= 10 && valor <= 99
+      dezena = valor - (valor % 10)
+      resto = valor - dezena
+      ret = DEZENAS_ORDINAL[genero][dezena]+" "
+      if resto > 0 then ret+= self.ordinal(resto,genero); end
+      return ret
+    elsif valor >= 100 && valor <= 999
+      centena = valor - (valor % 100)
+      resto = valor - centena 
+      ret = CENTENAS_ORDINAL[genero][centena]+" "
+      if resto > 0 then ret += self.ordinal(resto, genero); end
+      return ret
+    elsif valor == 1000
+      return MILHAR_ORDINAL[genero][valor]+" "
+    end
+  end
+
+  
+end

metadata

@@ -0,0 +1,84 @@
+--- !ruby/object:Gem::Specification
+name: extensobr
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Henrique Max
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2016-11-30 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.13'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.13'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+description: ExtensoBr é uma gem que foi desenvolvida para auxiliar na impressão de
+  números e moedas por extenso em portugês do Brasil.
+email:
+- rickmaxg3@hotmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- CODE_OF_CONDUCT.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- extensobr.gemspec
+- lib/extensobr.rb
+- lib/extensobr/version.rb
+homepage: https://github.com/rickmax/extensobr
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.5.1
+signing_key: 
+specification_version: 4
+summary: ExtendoBr escreve números e moeda por extenso.
+test_files: []