LEIAME.md

Maoli

Versão em inglês: README.md

Maoli é uma biblioteca de regras de negócio brasileiras comuns, compatível com .NET Framework 4.6+, .NET Core 1.0+ e .NET 5+.

Atualmente implementa:

• Validação de CEP
• Validação de CPF
• Validação de CNPJ

Para validação em cliente, consulte Maoli.js.

Documentação

Cep

Cep.Validate(string value) - valida se uma string é uma representação válida de CEP. Devolve true se o CEP é válido; caso contrário, false.

if (Cep.Validate("99999-999"))
{
  Console.WriteLine("CEP é válido");
}

Cpf

Cpf.Validate(string value) - valida se uma string é uma representação válida de CPF. Devolve true se o CPF é válido; caso contrário, false.

if (Cpf.Validate("999.999.99-99"))
{
  Console.WriteLine("CPF é válido");
}

Cpf.Complete(string value) - completa uma string de CPF parcial concatenando um dígito verificador válido. Devolve uma string de CPF com um dígito verificador válido.

// devolve "99999999999"
var cpf = Cpf.Complete("99999999")); 

Cnpj

Cnpj.Validate(string value) - valida se uma string é uma representação válida de CNPJ. Devolve true se o CNPJ é válido; caso contrário, false.

if (Cnpj.Validate("99.999.999/9999-99"))
{
  Console.WriteLine("CPNJ é válido");
}

Cnpj.Complete(string value) - completa uma string de CNPJ parcial concatenando um dígito verificador válido. Devolve uma string de CNPJ com um dígito verificador válido.

// devolve "99999999999999"
var cnpj = Cnpj.Complete("999999999999"));

Number Speller

NumberSpeller.Spell(int value) - retorna o número por extenso em português brasileiro. O valor máximo é int.MaxValue.

var speller = new NumberSpeller();

var number = speller.Spell(2022);

// imprime "dois mil duzentos e vinte e dois"
Console.WriteLine(number);

NumberSpeller.Spell(long value) - retorna o número por extenso em português brasileiro. O valor máximo é long.MaxValue.

var speller = new NumberSpeller();

var number = speller.Spell(2022L);

// imprime "dois mil duzentos e vinte e dois"
Console.WriteLine(number);

Pacote NuGet

Para instalar o Maoli usando o NuGet, execute o seguinte comando na linha de comando do console de Gerenciador de Pacotes:

Install-Package Maoli

Veja o website do NuGet.

.NET Fiddles

Os seguintes .NET Fiddles estão disponíveis para testar o Maoli:

• Validação de CPF: https://dotnetfiddle.net/7h7X00
• Validação de CNPJ: https://dotnetfiddle.net/IpEEmC

Código-fonte

O código-fonte está disponível em GitHub.

Licença

Este projeto está sob a licença MIT.

Autor

Adriano Ueda @adriueda