DocsBRValidator 1.3.1

Prefix Reserved
There is a newer version of this package available.
See the version list below for details.
dotnet add package DocsBRValidator --version 1.3.1                
NuGet\Install-Package DocsBRValidator -Version 1.3.1                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="DocsBRValidator" Version="1.3.1" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add DocsBRValidator --version 1.3.1                
#r "nuget: DocsBRValidator, 1.3.1"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install DocsBRValidator as a Cake Addin
#addin nuget:?package=DocsBRValidator&version=1.3.1

// Install DocsBRValidator as a Cake Tool
#tool nuget:?package=DocsBRValidator&version=1.3.1                

DocsBRValidator

Primeiramente, obrigado pelo interesse em utilizar este pacote!

Caso queira consultar uma documentação mais completa, basta clicar aqui!.

Mas então, como usar o DocsBRValidator?

Após instalar o pacote em seu projeto, a utilização dele é bastante simples, vamos lá.

Validando um CPF

Para validar um número de CPF, por exemplo, basta importar o DocumentValidator na classe em que vai utilizar:

using DocumentValidator;

Após isso, utilizaremos o CpfValidation.Validate() informando o CPF a ser validado, como no singelo exemplo abaixo:

using System;
using DocumentValidator;

namespace ValidatorTest
{
    class Program
    {
        static void Main(string[] args)
        {
            if (CpfValidation.Validate("012.123.123-00"))
                Console.WriteLine("CPF Válido!");
            else
                Console.WriteLine("CPF Inválido!");
        }
    }
}

E em quais formatos posso enviar o CPF?

O CPF, assim como todos os demais documentos, podem ser enviados com ou sem máscara.

Não importa se o documento informado, como por exemplo o CPF, está no formato 012.123.123-00, 01212312300, 01.2123-12300, etc... a validação vai funcionar corretamente.

E para validar outros documentos?

A validação dos demais tipos de documentos suportados ocorre semelhante a do CPF.

Para validar um Titulo de Eleitor, por exemplo, utilizaremos TituloEleitorValidation.Validate(), passando o numero do título, com ou sem máscara como parâmetro. Ex: TituloEleitorValidation.Validate("038361610124").

IMPORTANTE! Existe apenas uma diferença na validação de Inscrição Estadual

Devido a cada estado ter autonomia para a criação de regras de validação, se faz necessário o envio da UF juntamente com o número da inscrição.

Para validar uma Inscrição Estadual, por exemplo, utilizaremos InscricaoEstadualValidation.Validate(), passando o numero da inscrição, com ou sem máscara, e o código da UF como parâmetros. Ex: InscricaoEstadualValidation.Validate("715.626.867.315", "SP").

(*)Para inscrições de produtor rural no estado de SP, é necessário adicionar ao início da inscrição, a letra 'R', como por exemplo: InscricaoEstadualValidation.Validate("R71562686731", "SP").

Retornos esperados

No momento, não existe possibilidade de retorno com mensagem de erro personalizável (mas terá!).

O retorno destas validações é do tipo boolean, retornando true quando o documento estiver correto e false, caso contrário.

Validações já inclusas

Até o momento, o DocsBrValidator conta com as seguintes validações:

Tipo de Validação Método
Validação de CPF CpfValidation.Validate()
Validação de CNPJ CnpjValidation.Validate()
Validação de CNH CnhValidation.Validate()
Validação de PIS/PASEP PisValidation.Validate()
Validação de RG RGValidation.Validate()
Validação de Titulo de Eleitor TituloEleitorValidation.Validate()
Validação de Inscrição Estadual(**) InscricaoEstadualValidation.Validate() (novo!)

(**) Para a validação de Inscrição estadual, devem ser enviados dois parâmetros do tipo string, um com a inscrição estadual e outro com o código da UF ("SP", "BA", "SC", etc...)

Todas as demais validações acima recebem uma string como parâmetro, contendo o documento com máscara ou não.

O que vem por aí?

As novas funcionalidades previstas incluem mas não se limitam a:

  • Validação de RNE;
  • Validação de CTPS;
  • Mensagens personalizáveis, de erro e de sucesso;
  • Entre outros...

Espero que disfrute deste pacote e lembre-se: Todo o feedback construtivo é válido!
Obrigado!
Product Compatible and additional computed target framework versions.
.NET net5.0 is compatible.  net5.0-windows was computed.  net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
.NET Core netcoreapp3.1 is compatible. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • .NETCoreApp 3.1

    • No dependencies.
  • net5.0

    • No dependencies.
  • net6.0

    • No dependencies.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on DocsBRValidator:

Package Downloads
SMCaetano.Extensions

Package Description

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.3.2 14,065 10/20/2023
1.3.1 65,205 8/10/2022
1.3.0 5,757 6/7/2022
1.2.1 1,735 1/20/2022
1.2.0 1,913 10/24/2021
1.1.1 367 9/29/2021
1.1.0 370 9/29/2021
1.0.1 367 9/24/2021
1.0.0 324 9/20/2021

Melhorias e ciração de Summarys