EdaCPFbr

Esta gema valida CPFs, verificando se os dígitos verificadores estão corretos.

Badges

Build Status Code Climate

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.