Project

cnpj_utils

0.01
No commit activity in last 3 years
No release in over 3 years
cnpj_utilsjacksonpires/cnpj_utilsHomepageDocumentationSource CodeBug TrackerWiki
Uma suíte de funcionalidades para o CNPJ.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Popularity
Downloads
89,731
Stars
3
Forks
2
Watchers
1
 Releases
Current version
1.2.0
Total releases
3
First release
2014-03-27
Latest release
2018-03-13
 Development
Primary Language
Ruby
Licenses
MIT
Average date of last 50 commits
2014-10-17
Reverse Dependencies
1

 Dependencies

Development

bundler
~> 1.3
rake
>= 0
rspec
~> 2.14.1
 Project Readme

CnpjUtils

Gem Version Build Status Code Climate Coverage Status

CnpjUtils é uma suíte de funcionalidades para CNPJ. O CnpjUtils é capaz de gerar CNPJ para testes no formado tradicional ou apenas numérico, testa se determinado número de CNPJ é válido, gera dígitos verificadores para determinado número candidato a CNPJ, dentre outras coisas.

Compatibilidade

O CnpjUtils 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, 2.2.0, 2.3.0, 2.4.0, 2.5.0
  • JRuby 1.9.x

Instalação

Adicione essa linha na Gemfile da sua aplicação:

gem 'cnpj_utils'

E então execute:

$ bundle

Ou instale você mesmo, conforme abaixo:

$ gem install cnpj_utils

Uso

O CnpjUtils é muito fácil de usar, por exempo:

# Para gerar um número de CNPJ:
CnpjUtils.cnpj => # "61287395000140"

# Para gerar um CNPJ formatado:
CnpjUtils.cnpj_formatted => # "61.287.395/0001-40"

# Para verificar se um CNPJ é válido:
CnpjUtils.valid_cnpj?("61287395000140") => # true
CnpjUtils.valid_cnpj?(61287395000140) => # true
CnpjUtils.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"

Também é possível usar métodos em português:

# Para gerar um número de CNPJ:
CnpjUtils.cnpj => # "61287395000140"

# Para gerar um CNPJ formatado:
CnpjUtils.cnpj_formatado => # "61.287.395/0001-40"

# Para verificar se um CNPJ é válido:
CnpjUtils.cnpj_valido?("61287395000140") => # true
CnpjUtils.cnpj_valido?(61287395000140) => # true
CnpjUtils.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"

Recomende

Gostou dessa gem? Recomende-me no Linkedin!

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