EdaCPFbr
Esta gema valida CPFs, verificando se os dígitos verificadores estão corretos.
Badges
Requisitos
Ruby >= 1.9.2
Instalação
Adicione a seguinte linha ao seu Gemfile:
gem 'edacpfbr'
E execute:
$ bundle
Ou instale você, digitando:
$ gem install edacpfbr
Uso
Você pode invocar
EdaCPFbr.validar(cpf)
onde cpf
é uma string contendo um CPF completo. O resultado será true
se o CPF estiver correto, ou seja, se os dois dígitos verificadores estiverem simultaneamente corretos, ou false
caso contrário.
É possível também validar uma lista de CPFs, passada como uma array, com
EdaCPFbr.validar_lote(lista)
Nesse caso a saía será um Hash, com as chaves sendo os CPFs passados e os valores sendo true
ou false
, conforme cada CPF seja correto ou não.
Finalmente, é possível requisitar uma lista de n
CPFs válidos com
EdaCPFbr.gerar_lote_valido(n)
ou inválidos com
EdaCPFbr.gerar_lote_invalido(n)
Desenvolvimento
Depois de fazer o checkout do repositório, execure bin/setup
para instalar as dependências. Então execure rake spec
para rodar todos os testes. Você pode também executar bin/console
para obter um console iterativo que permitirá fazer experiências com a gema.
Para instalar esta gema em sua máquina local, execute bundle exec rake install
.
Para submeter sua contribuição, faça o push do seu branch com git pull origin <branch>
e gere o pull request, que será avaliado, sendo o merge resultado da avaliação positiva do código submetido.
Bugs e pull requests são bemvindos no GitHub em https://github.com/EdDeAlmeidaJr/edacpfbr.
Esta gema está disponível nos termos da MIT License. Isto significa, em resumo, que você pode copiar, modificar e distribuir livremente o código, desde que informe quem é o autor.