Skip to content

LeoColman/SimpleCpfValidator

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

99 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Simple Cpf Validator

Build GitHub Maven Central Awesome Kotlin Badge Zero Dependencies Badge

O conceito de validação de CPF existe desde a criação do próprio documento. No entanto, observa-se que a validação deste documento é replicada em várias aplicações, em classes idênticas, copiadas e coladas.

Com o objetivo de simplificar esse tipo de validação (seja em casos de teste ou em cenários de verificação de cadastro), a biblioteca Simple CPF Validator traz essa funcionalidade de uma vez, evitando assim boilerplate e possibilidade de erros no reuso de classe.

Utilizando

Para utilizar é bem simples. Primeiro importe no seu Gradle:

implementation("br.com.colman.simplecpfvalidator:simple-cpf-validator:{version}")

E utilize a função em qualquer String de seu código:

"12345678911".isCpf()

Por padrão, os caracteres . e - são retirados da String (permitindo o formato 123.456.789-11, por exemplo), mas isso pode ser modificado através do parâmetro charactersToIgnore:

"123.456.789/11".isCpf(charactersToIgnore = listOf('.', '/'))

CPFs inválidos

Por definição, os CPFs 111.111.111-11, 222.222.222-22, ..., 999.999.999-99 são inválidos, e seu retorno será falso.

O CPF 000.000.001-91 em teoria representa apenas pessoas sem CPF, no entanto este validador considerará que o CPF é válido.

Contribuindo

Sinta-se livre para abrir um pull request ou uma issue para contribuir com este projeto.