documentos_br 1.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 6e5a5e28315e2f98cc7170023ed77b943a81e45f
+  data.tar.gz: 49eda89c30c687af63f4dec81051897a79d458c6
+SHA512:
+  metadata.gz: 59a84d2abaf7308b1435130bbd29bd88fd2c213929d4581e49e0ec53428efaae63030e13503ea1fe7681619131fb8d707376efef2c5824fe2b2e362cf094b324
+  data.tar.gz: 0ad9bdde3699cbb41bccbd8ddd0ae8a9776da1d46477c6a47f03420288e2d879254b9ee7d3dafbf435bd5747fcd29135298fd3361f805cd129d83e3c6c7fda30

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/.rspec

@@ -0,0 +1,2 @@
+--format nested
+--color

data/.travis.yml

@@ -0,0 +1,10 @@
+rvm:
+  - 1.9.2
+  - 1.9.3
+  - 2.0.0
+  - 2.1.0
+  - jruby-19mode
+script: "bundle exec rspec spec"
+addons:
+  code_climate:
+    repo_token: 0e2046416b36edbde0bc1d871520755acd72dabbdf3d8b52e5ff98176ba15fb4

data/Gemfile

@@ -0,0 +1,14 @@
+source 'https://rubygems.org'
+
+# Code Climate Test Reporter
+gem "codeclimate-test-reporter", group: :test, require: nil
+
+# Code coverage for Ruby 1.9+ with a powerful configuration library and
+# automatic merging of coverage across test suites
+gem 'simplecov', '~> 0.7.1', group: :test, require: nil
+
+# A Ruby implementation of the Coveralls API.
+gem 'coveralls', require: false
+
+# Specify your gem's dependencies in cpf_utils.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Jackson Pires
+
+MIT License
+
+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,255 @@
+# DocumentosBr
+[![Gem Version](https://badge.fury.io/rb/documentos_br.png)](http://badge.fury.io/rb/documentos_br)
+[![Build Status](https://travis-ci.org/jacksonpires/documentos_br.svg?branch=master)](https://travis-ci.org/jacksonpires/documentos_br)
+[![Code Climate](https://codeclimate.com/github/jacksonpires/documentos_br.png)](https://codeclimate.com/github/jacksonpires/documentos_br)
+[![Coverage Status](https://coveralls.io/repos/jacksonpires/documentos_br/badge.png?branch=master)](https://coveralls.io/r/jacksonpires/documentos_br?branch=master)
+
+DocumentosBr é um 'wrapper' para a suíte de funcionalidades das Gems 'CpfUtils', 'CnpjUtils' e 'TituloEleitorUtils'.
+O DocumentosBr é capaz de gerar CPF, CNPJ e Título de Eleitor para testes no formado tradicional ou apenas numérico, testa se determinado número de CPF, CNPJ ou Título de Eleitor é válido, gera dígitos verificadores para determinado número candidato a CPF, CNPJ ou Título de Eleitor, dentre outras coisas.
+
+*PS: Devido à inconsistência entre as formatações/máscaras usadas para o Título de Eleitor em todo território nacional, optamos por usar uma formatação/máscara próxima à que Justiça Eleitoral usa nos comprovantes de votação. Nossa formatação/máscara será ####.####.####, visto que o título eleitoral é formado por 12 dígitos.*
+
+## Compatibilidade
+
+O DocumentosBr usa o Travis-CI para efetuar testes em diferentes versões do Ruby. As versões testadas e aprovadas, por enquanto, são:
+
+* MRI 1.9.2, 1.9.3, 2.0.0, 2.1.0
+* JRuby 1.9.x
+
+## Instalação
+
+Adicione essa linha na Gemfile da sua aplicação:
+
+```ruby
+gem 'documentos_br'
+```
+
+E então execute:
+
+```ruby
+$ bundle
+```
+
+Ou instale você mesmo, conforme abaixo:
+
+```ruby
+$ gem install documentos_br
+```
+
+## Uso
+
+O DocumentosBr é muito fácil de usar. Veja os exemplos abaixo:
+
+###### CPF
+
+```ruby
+# Para gerar um número de CPF:
+DocumentosBr.cpf => # "45698394823"
+
+# Para gerar um CPF formatado:
+DocumentosBr.cpf_formatted => # "456.983.948-23"
+
+# Para verificar se um CPF é válido:
+DocumentosBr.valid_cpf?("47238051923") => # true
+DocumentosBr.valid_cpf?(47238051923) => # true
+DocumentosBr.valid_cpf?("472.380.519-23") => # true
+
+# Outra forma de verificar se um CPF é válido:
+"45698394823".valid_cpf? => # true
+"456.983.948-23".valid_cpf? => # true
+
+# Para verificar se uma máscara de CPF é válida:
+"456.983.948-23".valid_cpf_mask? => # true
+"456.983..948-23".valid_cpf_mask? => # false
+
+# Para formatar um número válido de CPF:
+"45698394823".to_cpf_format => # "456.983.948-23"
+
+# Para gerar um número de CPF a partir de um número candidato de 9 dígitos:
+"456983948".generate_cpf => # "45698394823"
+
+# Para gerar um número de CPF formatado a partir de um número candidato de 9 dígitos:
+"456983948".generate_cpf_formatted => # "456.983.948-23"
+```
+
+###### CNPJ
+
+```ruby
+# Para gerar um número de CNPJ:
+DocumentosBr.cnpj => # "61287395000140"
+
+# Para gerar um CNPJ formatado:
+DocumentosBr.cnpj_formatted => # "61.287.395/0001-40"
+
+# Para verificar se um CNPJ é válido:
+DocumentosBr.valid_cnpj?("61287395000140") => # true
+DocumentosBr.valid_cnpj?(61287395000140) => # true
+DocumentosBr.valid_cnpj?("61.287.395/0001-40") => # true
+
+# Outra forma de verificar se um CNPJ é válido:
+"61287395000140".valid_cnpj? => # true
+"61.287.395/0001-40".valid_cnpj? => # true
+
+# Para verificar se uma máscara de CNPJ é válida:
+"61.287.395/0001-40".valid_cnpj_mask? => # true
+"61.287..395/0001-40".valid_cnpj_mask? => # false
+
+# Para formatar um número válido de CNPJ:
+"61287395000140".to_cnpj_format => # "61.287.395/0001-40"
+
+# Para gerar um número de CNPJ a partir de um número candidato de 12 dígitos:
+"612873950001".generate_cnpj => # "61287395000140"
+
+# Para gerar um número de CNPJ formatado a partir de um número candidato de 12 dígitos:
+"612873950001".generate_cnpj_formatted => # "61.287.395/0001-40"
+```
+
+###### Título de Eleitor
+
+```ruby
+# Para gerar um número de Título de Eleitor:
+DocumentosBr.titulo_eleitor => # "023434561340"
+
+# Para gerar um Título de Eleitor formatado:
+DocumentosBr.titulo_eleitor_formatted => # "0234.3456.1340"
+
+# Para verificar se um Título de Eleitor é válido:
+DocumentosBr.valid_titulo_eleitor?("023434561340") => # true
+DocumentosBr.valid_titulo_eleitor?(023434561340) => # true
+DocumentosBr.valid_titulo_eleitor?("0234.3456.1340") => # true
+
+# Outra forma de verificar se um Título de Eleitor é válido:
+"023434561340".valid_titulo_eleitor? => # true
+"0234.3456.1340".valid_titulo_eleitor? => # true
+
+# Para verificar se uma máscara de Título de Eleitor é válida:
+"0234.3456.1340".valid_titulo_eleitor_mask? => # true
+"0234.3456..1340".valid_titulo_eleitor_mask? => # false
+
+# Para formatar um número válido de Título de Eleitor:
+"023434561340".to_titulo_eleitor_format => # "0234.3456.1340"
+
+# Para gerar um número de Título de Eleitor a partir de um número candidato de 10 dígitos:
+"612873950001".generate_titulo_eleitor => # "023434561340"
+
+# Para gerar um número de Título de Eleitor formatado a partir de um número candidato de 10 dígitos:
+"612873950001".generate_titulo_eleitor_formatted => # "0234.3456.1340"
+
+# Para saber a qual unidade federativa o Título de Eleitor pertence:
+DocumentosBr.titulo_eleitor_province("759026311727") => # "TO"
+"759026311727".titulo_eleitor_province => # "TO"
+```
+
+Também é possível usar métodos em português:
+
+###### CPF - Em português
+
+```ruby
+# Para gerar um número de CPF:
+DocumentosBr.cpf => # "45698394823"
+
+# Para gerar um CPF formatado:
+DocumentosBr.cpf_formatado => # "456.983.948-23"
+
+# Para verificar se um CPF é válido:
+DocumentosBr.cpf_valido?("47238051923") => # true
+DocumentosBr.cpf_valido?(47238051923) => # true
+DocumentosBr.cpf_valido?("472.380.519-23") => # true
+
+# Outra forma de verificar se um CPF é válido:
+"45698394823".cpf_valido? => # true
+"456.983.948-23".cpf_valido? => # true
+
+# Para verificar se uma máscara de CPF é válida:
+"456.983.948-23".mascara_de_cpf_valida? => # true
+"456.983..948-23".mascara_de_cpf_valida? => # false
+
+# Para formatar um número válido de CPF:
+"45698394823".para_formato_cpf => # "456.983.948-23"
+
+# Para gerar um número de CPF a partir de um número candidato de 9 dígitos:
+"456983948".gerar_cpf => # "45698394823"
+
+# Para gerar um número de CPF formatado a partir de um número candidato de 9 dígitos:
+"456983948".gerar_cpf_formatado => # "456.983.948-23"
+```
+
+###### CNPJ - Em português
+
+```ruby
+# Para gerar um número de CNPJ:
+DocumentosBr.cnpj => # "61287395000140"
+
+# Para gerar um CNPJ formatado:
+DocumentosBr.cnpj_formatado => # "61.287.395/0001-40"
+
+# Para verificar se um CNPJ é válido:
+DocumentosBr.cnpj_valido?("61287395000140") => # true
+DocumentosBr.cnpj_valido?(61287395000140) => # true
+DocumentosBr.cnpj_valido?("61.287.395/0001-40") => # true
+
+# Outra forma de verificar se um CNPJ é válido:
+"61287395000140".cnpj_valido? => # true
+"61.287.395/0001-40".cnpj_valido? => # true
+
+# Para verificar se uma máscara de CNPJ é válida:
+"61.287.395/0001-40".mascara_de_cnpj_valida? => # true
+"61.287..395/0001-40".mascara_de_cnpj_valida? => # false
+
+# Para formatar um número válido de CNPJ:
+"61287395000140".para_formato_cnpj => # "61.287.395/0001-40"
+
+# Para gerar um número de CNPJ a partir de um número candidato de 12 dígitos:
+"612873950001".gerar_cnpj => # "61287395000140"
+
+# Para gerar um número de CNPJ formatado a partir de um número candidato de 12 dígitos:
+"612873950001".gerar_cnpj_formatado => # "61.287.395/0001-40"
+```
+
+###### Título de Eleitor - Em português
+
+```ruby
+# Para gerar um número de Título de Eleitor:
+DocumentosBr.titulo_eleitor => # "023434561340"
+
+# Para gerar um Título de Eleitor formatado:
+DocumentosBr.titulo_eleitor_formatado => # "0234.3456.1340"
+
+# Para verificar se um Título de Eleitor é válido:
+DocumentosBr.titulo_eleitor_valido?("023434561340") => # true
+DocumentosBr.titulo_eleitor_valido?(023434561340) => # true
+DocumentosBr.titulo_eleitor_valido?("0234.3456.1340") => # true
+
+# Outra forma de verificar se um Título de Eleitor é válido:
+"023434561340".titulo_eleitor_valido? => # true
+"0234.3456.1340".titulo_eleitor_valido? => # true
+
+# Para verificar se uma máscara de Título de Eleitor é válida:
+"0234.3456.1340".mascara_de_titulo_eleitor_valida? => # true
+"0234.3456..1340".mascara_de_titulo_eleitor_valida? => # false
+
+# Para formatar um número válido de Título de Eleitor:
+"023434561340".para_formato_titulo_eleitor => # "0234.3456.1340"
+
+# Para gerar um número de Título de Eleitor a partir de um número candidato de 10 dígitos:
+"612873950001".gerar_titulo_eleitor => # "023434561340"
+
+# Para gerar um número de Título de Eleitor formatado a partir de um número candidato de 10 dígitos:
+"612873950001".gerar_titulo_eleitor_formatado => # "0234.3456.1340"
+
+# Para saber a qual unidade federativa o Título de Eleitor pertence:
+DocumentosBr.uf_do_titulo_eleitor("759026311727") => # "TO"
+"759026311727".uf_do_titulo_eleitor => # "TO"
+```
+
+## Recomende
+
+Gostou dessa gem? Recomende-me no [Working With Rails](http://www.workingwithrails.com/people/148426)!
+
+## Contribuindo
+
+1. Faça um Fork
+2. Crie um branch para a nova funcionalidade (`git checkout -b minha-nova-funcionalidade`)
+3. Faça o commit de suas alterações  (`git commit -am 'Adicionada nova funcionalidade'`)
+4. Faça um push da sua nova funconalidade (`git push origin minha-nova-funcionalidade`)
+5. Submeta uma nova Pull Request

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/documentos_br.gemspec

@@ -0,0 +1,30 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'documentos_br/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "documentos_br"
+  spec.version       = DocumentosBr::VERSION
+  spec.authors       = ["Jackson Pires"]
+  spec.email         = ["jackson.pires@gmail.com"]
+  spec.description   = %q{Uma 'wrapper' para as Gems 'CpfUtils', 'CnpjUtils' e
+                          'TituloEleitorUtils'.}
+  spec.summary       = %q{DocumentosBr é um 'wrapper' para a suíte de
+                          funcionalidades das Gems 'CpfUtils', 'CnpjUtils' e
+                          'TituloEleitorUtils'.}
+  spec.homepage      = "https://github.com/jacksonpires/documentos_br"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "rspec", "~> 2.14.1"
+  spec.add_development_dependency "cpf_utils", "~> 1.1.0"
+  spec.add_development_dependency "cnpj_utils", "~> 1.0.0"
+  spec.add_development_dependency "titulo_eleitor_utils", "~> 1.0.0"
+end

data/lib/documentos_br/version.rb

@@ -0,0 +1,3 @@
+module DocumentosBr
+  VERSION = "1.0.1"
+end

data/lib/documentos_br.rb

@@ -0,0 +1,154 @@
+require "documentos_br/version"
+require "cpf_utils"
+require "cnpj_utils"
+require "titulo_eleitor_utils"
+
+module DocumentosBr
+  # Gera um número de CPF.
+  #
+  # Exemplo:
+  # DocumentosBr.cpf => # "45698394823"
+  def self.cpf
+    CpfUtils.cpf
+  end
+
+  # Gera um número de CPF formatado.
+  #
+  # Exemplo:
+  # DocumentosBr.cpf_formatted => # "456.983.948-23"
+  def self.cpf_formatted
+    CpfUtils.cpf_formatted
+  end
+
+  # Gera um número de CPF formatado.
+  #
+  # Exemplo:
+  # DocumentosBr.cpf_formatado => # "456.983.948-23"
+  def self.cpf_formatado
+    self.cpf_formatted
+  end
+
+  # Verifica se um CPF é válido.
+  #
+  # Exemplo:
+  # DocumentosBr.valid_cpf?(45698394823) => # true
+  # DocumentosBr.valid_cpf?("45698394823") => # true
+  # DocumentosBr.valid_cpf?("456.983.948-23") => # true
+  def self.valid_cpf?(cpf_number)
+    cpf_number.to_s.valid_cpf?
+  end
+
+  # Verifica se um CPF é válido.
+  #
+  # Exemplo:
+  # DocumentosBr.cpf_valido?(45698394823) => # true
+  # DocumentosBr.cpf_valido?("45698394823") => # true
+  # DocumentosBr.cpf_valido?("456.983.948-23") => # true
+  def self.cpf_valido?(cpf_number)
+    self.valid_cpf?(cpf_number)
+  end
+
+  # Gera um número de CNPJ.
+  #
+  # Exemplo:
+  # DocumentosBr.cnpj => # "61287395000140"
+  def self.cnpj
+    CnpjUtils.cnpj
+  end
+
+  # Gera um número de Cnpj formatado.
+  #
+  # Exemplo:
+  # DocumentosBr.cnpj_formatted => # "61.287.395/0001-40"
+  def self.cnpj_formatted
+    CnpjUtils.cnpj_formatted
+  end
+
+  # Gera um número de Cnpj formatado.
+  #
+  # Exemplo:
+  # DocumentosBr.cnpj_formatado => # "61.287.395/0001-40"
+  def self.cnpj_formatado
+    self.cnpj_formatted
+  end
+
+  # Verifica se um Cnpj é válido.
+  #
+  # Exemplo:
+  # DocumentosBr.valid_cnpj?(61287395000140) => # true
+  # DocumentosBr.valid_cnpj?("61287395000140") => # true
+  # DocumentosBr.valid_cnpj?("61.287.395/0001-40") => # true
+  def self.valid_cnpj?(cnpj_number)
+    cnpj_number.to_s.valid_cnpj?
+  end
+
+  # Verifica se um Cnpj é válido.
+  #
+  # Exemplo:
+  # DocumentosBr.cnpj_valido?(61287395000140) => # true
+  # DocumentosBr.cnpj_valido?("61287395000140") => # true
+  # DocumentosBr.cnpj_valido?("61.287.395/0001-40") => # true
+  def self.cnpj_valido?(cnpj_number)
+    self.valid_cnpj?(cnpj_number)
+  end
+
+  # Gera um número de Título de Eleitor.
+  #
+  # Exemplo:
+  # DocumentosBr.titulo_eleitor => # "023434561340"
+  def self.titulo_eleitor
+    TituloEleitorUtils.titulo_eleitor
+  end
+
+  # Gera um número de Título de Eleitor formatado.
+  #
+  # Exemplo:
+  # DocumentosBr.titulo_eleitor_formatted => # "0234.3456.1340"
+  def self.titulo_eleitor_formatted
+    TituloEleitorUtils.titulo_eleitor_formatted
+  end
+
+  # Gera um número de Título de Eleitor formatado.
+  #
+  # Exemplo:
+  # DocumentosBr.titulo_eleitor_formatado => # "0234.3456.1340"
+  def self.titulo_eleitor_formatado
+    self.titulo_eleitor_formatted
+  end
+
+  # Verifica se um Título de Eleitor é válido.
+  #
+  # Exemplo:
+  # DocumentosBr.valid_titulo_eleitor?(023434561340) => # true
+  # DocumentosBr.valid_titulo_eleitor?("023434561340") => # true
+  # DocumentosBr.valid_titulo_eleitor?("0234.3456.1340") => # true
+  def self.valid_titulo_eleitor?(titulo_eleitor_number)
+    titulo_eleitor_number.valid_titulo_eleitor?
+  end
+
+  # Verifica se um Título de Eleitor é válido.
+  #
+  # Exemplo:
+  # DocumentosBr.titulo_eleitor_valido?(023434561340) => # true
+  # DocumentosBr.titulo_eleitor_valido?("023434561340") => # true
+  # DocumentosBr.titulo_eleitor_valido?("0234.3456.1340") => # true
+  def self.titulo_eleitor_valido?(titulo_eleitor_number)
+    self.valid_titulo_eleitor?(titulo_eleitor_number)
+  end
+
+  # Para saber a qual unidade federativa o Título de Eleitor pertence:
+  #
+  # Exemplo:
+  # DocumentosBr.titulo_eleitor_province("759026311727") => # "TO"
+  def self.titulo_eleitor_province(titulo_eleitor_number)
+    TituloEleitorUtils.titulo_eleitor_province(titulo_eleitor_number)
+  end
+
+  # Para saber a qual unidade federativa o Título de Eleitor pertence:
+  #
+  # Exemplo:
+  # DocumentosBr.uf_do_titulo_eleitor("759026311727") => # "TO"
+  def self.uf_do_titulo_eleitor(titulo_eleitor_number)
+    self.titulo_eleitor_province(titulo_eleitor_number)
+  end
+end

data/spec/documentos_br_spec.rb

@@ -0,0 +1,114 @@
+require "spec_helper"
+
+describe "DocumentosBr" do
+  context 'CPFUtils' do
+    it ".cpf" do
+      valid_cpf = DocumentosBr.cpf
+      expect(valid_cpf).to be_a_kind_of(String)
+      expect(valid_cpf.length).to eql(11)
+    end
+
+    it ".cpf_formatted" do
+      valid_cpf = DocumentosBr.cpf_formatted
+      expect(valid_cpf).to match(/^[+-]?[0-9]{3}\.[0-9]{3}\.[0-9]{3}-[0-9]{2}+$/)
+    end
+
+    it ".cpf_formatado" do
+      valid_cpf = DocumentosBr.cpf_formatado
+      expect(valid_cpf).to match(/^[+-]?[0-9]{3}\.[0-9]{3}\.[0-9]{3}-[0-9]{2}+$/)
+    end
+
+    it ".valid_cpf?" do
+      valid_cpf = DocumentosBr.cpf
+      expect(DocumentosBr.valid_cpf? valid_cpf).to be_true
+    end
+
+    it ".cpf_valido?" do
+      cpf_valido = DocumentosBr.cpf
+      expect(DocumentosBr.cpf_valido? cpf_valido).to be_true
+    end
+
+    it ".valid_cpf? - be false" do
+      invalid_cpf = "123.456.789-12"
+      expect(DocumentosBr.valid_cpf? invalid_cpf).to be_false
+    end
+  end
+
+  context 'CnpjUtils' do
+    it ".cnpj" do
+      valid_cnpj = DocumentosBr.cnpj
+      expect(valid_cnpj).to be_a_kind_of(String)
+      expect(valid_cnpj.length).to eql(14)
+    end
+
+    it ".cnpj_formatted" do
+      valid_cnpj = DocumentosBr.cnpj_formatted
+      expect(valid_cnpj).to match(/^[+-]?[0-9]{2}\.[0-9]{3}\.[0-9]{3}\/[0-9]{4}-[0-9]{2}+$/)
+    end
+
+    it ".cnpj_formatado" do
+      valid_cnpj = DocumentosBr.cnpj_formatado
+      expect(valid_cnpj).to match(/^[+-]?[0-9]{2}\.[0-9]{3}\.[0-9]{3}\/[0-9]{4}-[0-9]{2}+$/)
+    end
+
+    it ".valid_cnpj?" do
+      valid_cnpj = DocumentosBr.cnpj
+      expect(DocumentosBr.valid_cnpj? valid_cnpj).to be_true
+    end
+
+    it ".cnpj_valido?" do
+      cnpj_valido = DocumentosBr.cnpj
+      expect(DocumentosBr.cnpj_valido? cnpj_valido).to be_true
+    end
+
+    it ".valid_cnpj? - be false" do
+      invalid_cnpj = "12.345.678/0001-12"
+      expect(DocumentosBr.valid_cnpj? invalid_cnpj).to be_false
+    end
+  end
+
+  context 'TituloEleitorUtils' do
+    it ".titulo_eleitor" do
+      valid_titulo_eleitor = DocumentosBr.titulo_eleitor
+      expect(valid_titulo_eleitor).to be_a_kind_of(String)
+      expect(valid_titulo_eleitor[8,2].to_i).to be >= 1
+      expect(valid_titulo_eleitor[8,2].to_i).to be <= 28
+      expect(valid_titulo_eleitor.length).to eql(12)
+    end
+
+    it ".titulo_eleitor_formatted" do
+      valid_titulo_eleitor = DocumentosBr.titulo_eleitor_formatted
+      expect(valid_titulo_eleitor).to match(/^[0-9]{4}\.[0-9]{4}\.[0-9]{4}+$/)
+    end
+
+    it ".titulo_eleitor_formatado" do
+      valid_titulo_eleitor = DocumentosBr.titulo_eleitor_formatado
+      expect(valid_titulo_eleitor).to match(/^[0-9]{4}\.[0-9]{4}\.[0-9]{4}+$/)
+    end
+
+    it ".valid_titulo_eleitor?" do
+      valid_titulo_eleitor = DocumentosBr.titulo_eleitor
+      expect(DocumentosBr.valid_titulo_eleitor? valid_titulo_eleitor).to be_true
+    end
+
+    it ".titulo_eleitor_valido?" do
+      titulo_eleitor_valido = DocumentosBr.titulo_eleitor
+      expect(DocumentosBr.titulo_eleitor_valido? titulo_eleitor_valido).to be_true
+    end
+
+    it ".valid_titulo_eleitor? - be false" do
+      invalid_titulo_eleitor = "1234.5678.9101"
+      expect(DocumentosBr.valid_titulo_eleitor? invalid_titulo_eleitor).to be_false
+    end
+
+    it ".titulo_eleitor_province" do
+      state = DocumentosBr.titulo_eleitor_province("759026311727")
+      expect(state).to eql("TO")
+    end
+
+    it ".uf_do_titulo_eleitor" do
+      state = DocumentosBr.uf_do_titulo_eleitor("759026311727")
+      expect(state).to eql("TO")
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,14 @@
+# Require Code Climate Test Reporter
+require "codeclimate-test-reporter"
+
+# Starts Code Climate Test Reporter
+CodeClimate::TestReporter.start
+
+# Require Coveralls for Test cover
+require 'coveralls'
+
+# Starts Coderalls
+Coveralls.wear!
+
+# Require other files of project
+require "documentos_br"

data/spec/string_spec.rb

@@ -0,0 +1,235 @@
+require "spec_helper"
+
+describe String do
+  context 'CpfUtils' do
+   it "#valid_cpf_mask?" do
+      expect("123.456.789-12".valid_cpf_mask?).to be_true
+      expect("12345678912".valid_cpf_mask?).to be_true
+    end
+
+    it "#mascara_de_cpf_valida?" do
+      expect("123.456.789-12".mascara_de_cpf_valida?).to be_true
+      expect("12345678912".mascara_de_cpf_valida?).to be_true
+    end
+
+    it "#valid_cpf_mask? - be false" do
+      expect("123..456.789-12".valid_cpf_mask?).to be_false
+      expect("123.456.789--12".valid_cpf_mask?).to be_false
+      expect("123.456.789-1E".valid_cpf_mask?).to be_false
+    end
+
+    it "#mascara_de_cpf_valida? - be false" do
+      expect("123..456.789-12".mascara_de_cpf_valida?).to be_false
+      expect("123.456.789--12".mascara_de_cpf_valida?).to be_false
+      expect("123.456.789-1E".mascara_de_cpf_valida?).to be_false
+    end
+
+    it "#valid_cpf?" do
+      cpf = DocumentosBr.cpf
+      expect(cpf.valid_cpf?).to be_true
+    end
+
+    it "#cpf_valido?" do
+      cpf = DocumentosBr.cpf
+      expect(cpf.cpf_valido?).to be_true
+    end
+
+    it "#to_cpf_format?" do
+      cpf = DocumentosBr.cpf
+      expect(cpf.to_cpf_format).to match(/^[+-]?[0-9]{3}\.[0-9]{3}\.[0-9]{3}-[0-9]{2}+$/)
+    end
+
+    it "#para_formato_cpf?" do
+      cpf = DocumentosBr.cpf
+      expect(cpf.para_formato_cpf).to match(/^[+-]?[0-9]{3}\.[0-9]{3}\.[0-9]{3}-[0-9]{2}+$/)
+    end
+
+    it "#generate_cpf" do
+      valid_cpf = DocumentosBr.cpf
+      final_cpf = valid_cpf[0..8].generate_cpf
+
+      expect(final_cpf).to be_a_kind_of(String)
+      expect(final_cpf.length).to eql(11)
+    end
+
+    it "#gerar_cpf" do
+      valid_cpf = DocumentosBr.cpf
+      final_cpf = valid_cpf[0..8].gerar_cpf
+
+      expect(final_cpf).to be_a_kind_of(String)
+      expect(final_cpf.length).to eql(11)
+    end
+
+    it "#gerar_cpf_formatado" do
+      valid_cpf = DocumentosBr.cpf
+      final_cpf = valid_cpf[0..8].gerar_cpf_formatado
+
+      expect(final_cpf).to match(/^[+-]?[0-9]{3}\.[0-9]{3}\.[0-9]{3}-[0-9]{2}+$/)
+    end
+
+    it "#generate_cpf_formatted" do
+      valid_cpf = DocumentosBr.cpf
+      final_cpf = valid_cpf[0..8].generate_cpf_formatted
+
+      expect(final_cpf).to match(/^[+-]?[0-9]{3}\.[0-9]{3}\.[0-9]{3}-[0-9]{2}+$/)
+    end
+  end
+
+  context 'CnpjUtils' do
+    it "#valid_cnpj_mask?" do
+      expect("61.287.395/0001-40".valid_cnpj_mask?).to be_true
+      expect("61287395000140".valid_cnpj_mask?).to be_true
+    end
+
+    it "#mascara_de_cnpj_valida?" do
+      expect("61.287.395/0001-40".mascara_de_cnpj_valida?).to be_true
+      expect("61287395000140".mascara_de_cnpj_valida?).to be_true
+    end
+
+    it "#valid_cnpj_mask? - be false" do
+      expect("45.698.394//0001-54".valid_cnpj_mask?).to be_false
+      expect("45.698..394/0001-54".valid_cnpj_mask?).to be_false
+      expect("45.698.394/00O1-54".valid_cnpj_mask?).to be_false
+    end
+
+    it "#mascara_de_cnpj_valida? - be false" do
+      expect("45.698.394//0001-54".mascara_de_cnpj_valida?).to be_false
+      expect("45.698..394/0001-54".mascara_de_cnpj_valida?).to be_false
+      expect("45.698.394/00O1-54".mascara_de_cnpj_valida?).to be_false
+    end
+
+    it "#valid_cnpj?" do
+      cnpj = CnpjUtils.cnpj
+      expect(cnpj.valid_cnpj?).to be_true
+    end
+
+    it "#cnpj_valido?" do
+      cnpj = CnpjUtils.cnpj
+      expect(cnpj.cnpj_valido?).to be_true
+    end
+
+    it "#to_cnpj_format?" do
+      cnpj = CnpjUtils.cnpj
+      expect(cnpj.to_cnpj_format).to match(/^[+-]?[0-9]{2}\.[0-9]{3}\.[0-9]{3}\/[0-9]{4}-[0-9]{2}+$/)
+    end
+
+    it "#para_formato_cnpj?" do
+      cnpj = CnpjUtils.cnpj
+      expect(cnpj.para_formato_cnpj).to match(/^[+-]?[0-9]{2}\.[0-9]{3}\.[0-9]{3}\/[0-9]{4}-[0-9]{2}+$/)
+    end
+
+    it "#generate_cnpj" do
+      valid_cnpj = CnpjUtils.cnpj
+      final_cnpj = valid_cnpj[0..11].generate_cnpj
+
+      expect(final_cnpj).to be_a_kind_of(String)
+      expect(final_cnpj.length).to eql(14)
+    end
+
+    it "#gerar_cnpj" do
+      valid_cnpj = CnpjUtils.cnpj
+      final_cnpj = valid_cnpj[0..11].gerar_cnpj
+
+      expect(final_cnpj).to be_a_kind_of(String)
+      expect(final_cnpj.length).to eql(14)
+    end
+
+    it "#gerar_cnpj_formatado" do
+      valid_cnpj = CnpjUtils.cnpj
+      final_cnpj = valid_cnpj[0..11].gerar_cnpj_formatado
+
+      expect(final_cnpj).to match(/^[+-]?[0-9]{2}\.[0-9]{3}\.[0-9]{3}\/[0-9]{4}-[0-9]{2}+$/)
+    end
+
+    it "#generate_cnpj_formatted" do
+      valid_cnpj = CnpjUtils.cnpj
+      final_cnpj = valid_cnpj[0..11].generate_cnpj_formatted
+
+      expect(final_cnpj).to match(/^[+-]?[0-9]{2}\.[0-9]{3}\.[0-9]{3}\/[0-9]{4}-[0-9]{2}+$/)
+    end
+  end
+
+  context 'TituloEleitorUtils' do
+    it "#valid_titulo_eleitor_mask?" do
+      expect("7590.2631.1727".valid_titulo_eleitor_mask?).to be_true
+      expect("759026311727".valid_titulo_eleitor_mask?).to be_true
+    end
+
+    it "#mascara_de_titulo_eleitor_valida?" do
+      expect("7590.2631.1727".mascara_de_titulo_eleitor_valida?).to be_true
+      expect("759026311727".mascara_de_titulo_eleitor_valida?).to be_true
+    end
+
+    it "#valid_titulo_eleitor_mask? - be false" do
+      expect("7590.26E1.1727".valid_titulo_eleitor_mask?).to be_false
+      expect("7590..2631.1727".valid_titulo_eleitor_mask?).to be_false
+      expect("7590.26311727".valid_titulo_eleitor_mask?).to be_false
+    end
+
+    it "#mascara_de_titulo_eleitor_valida? - be false" do
+      expect("7590.26E1.1727".mascara_de_titulo_eleitor_valida?).to be_false
+      expect("7590..2631.1727".mascara_de_titulo_eleitor_valida?).to be_false
+      expect("7590.2631..1727".mascara_de_titulo_eleitor_valida?).to be_false
+    end
+
+    it "#valid_titulo_eleitor?" do
+      titulo_eleitor = DocumentosBr.titulo_eleitor
+      expect(titulo_eleitor.valid_titulo_eleitor?).to be_true
+    end
+
+    it "#titulo_eleitor_valido?" do
+      titulo_eleitor = DocumentosBr.titulo_eleitor
+      expect(titulo_eleitor.titulo_eleitor_valido?).to be_true
+    end
+
+    it "#to_titulo_eleitor_format?" do
+      titulo_eleitor = DocumentosBr.titulo_eleitor
+      expect(titulo_eleitor.to_titulo_eleitor_format).to match(/^[0-9]{4}\.[0-9]{4}\.[0-9]{4}+$/)
+    end
+
+    it "#para_formato_titulo_eleitor?" do
+      titulo_eleitor = DocumentosBr.titulo_eleitor
+      expect(titulo_eleitor.para_formato_titulo_eleitor).to match(/^[0-9]{4}\.[0-9]{4}\.[0-9]{4}+$/)
+    end
+
+    it "#generate_titulo_eleitor" do
+      valid_titulo_eleitor = DocumentosBr.titulo_eleitor
+      final_titulo_eleitor = valid_titulo_eleitor[0..9].generate_titulo_eleitor
+
+      expect(final_titulo_eleitor).to be_a_kind_of(String)
+      expect(final_titulo_eleitor.size).to eql(12)
+    end
+
+    it "#gerar_titulo_eleitor" do
+      valid_titulo_eleitor = DocumentosBr.titulo_eleitor
+      final_titulo_eleitor = valid_titulo_eleitor[0..9].gerar_titulo_eleitor
+
+      expect(final_titulo_eleitor).to be_a_kind_of(String)
+      expect(final_titulo_eleitor.size).to eql(12)
+    end
+
+    it "#gerar_titulo_eleitor_formatado" do
+      valid_titulo_eleitor = DocumentosBr.titulo_eleitor
+      final_titulo_eleitor = valid_titulo_eleitor[0..9].gerar_titulo_eleitor_formatado
+
+      expect(final_titulo_eleitor).to match(/^[0-9]{4}\.[0-9]{4}\.[0-9]{4}+$/)
+    end
+
+    it "#generate_titulo_eleitor_formatted" do
+      valid_titulo_eleitor = DocumentosBr.titulo_eleitor
+      final_titulo_eleitor = valid_titulo_eleitor[0..9].generate_titulo_eleitor_formatted
+
+      expect(final_titulo_eleitor).to match(/^[0-9]{4}\.[0-9]{4}\.[0-9]{4}+$/)
+    end
+
+    it "#titulo_eleitor_province" do
+      state = "759026311727".titulo_eleitor_province
+      expect(state).to eql("TO")
+    end
+
+    it "#uf_do_titulo_eleitor" do
+      state = "759026311727".uf_do_titulo_eleitor
+      expect(state).to eql("TO")
+    end
+  end
+end

metadata

@@ -0,0 +1,147 @@
+--- !ruby/object:Gem::Specification
+name: documentos_br
+version: !ruby/object:Gem::Version
+  version: 1.0.1
+platform: ruby
+authors:
+- Jackson Pires
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-04-12 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.14.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.14.1
+- !ruby/object:Gem::Dependency
+  name: cpf_utils
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.1.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.1.0
+- !ruby/object:Gem::Dependency
+  name: cnpj_utils
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+- !ruby/object:Gem::Dependency
+  name: titulo_eleitor_utils
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+description: |-
+  Uma 'wrapper' para as Gems 'CpfUtils', 'CnpjUtils' e
+                            'TituloEleitorUtils'.
+email:
+- jackson.pires@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- .travis.yml
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- documentos_br.gemspec
+- lib/documentos_br.rb
+- lib/documentos_br/version.rb
+- spec/documentos_br_spec.rb
+- spec/spec_helper.rb
+- spec/string_spec.rb
+homepage: https://github.com/jacksonpires/documentos_br
+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.0.3
+signing_key: 
+specification_version: 4
+summary: DocumentosBr é um 'wrapper' para a suíte de funcionalidades das Gems 'CpfUtils',
+  'CnpjUtils' e 'TituloEleitorUtils'.
+test_files:
+- spec/documentos_br_spec.rb
+- spec/spec_helper.rb
+- spec/string_spec.rb