Skip to content

RafaelEstevamReis/Simple.Brazilian

Repository files navigation

.NET NuGet

Brazilian text Tools

This library is (will be) a tool for developers of brazilian-portuguese software

To be as inclusive as possible this readme will be in Portuguese

Repositório de Ferramentas Textuais

Esta biblioteca será uma ferramenta para todos que escrevem software em português e precisam lidar com textos, datas, e valores monetários em diferentes ambientes.

Para manter o projeto acessível, este readme e toda a documentação será em português

O que somos ?

Toda software-house sempre escreve seus próprios métodos para remover acentos, escrever números por extenso, etc.

Existem repositórios em várias linguagens porém é raro que:

  • Sejam em C#
  • Sejam enxutos
  • Sejam altamente compatíveis
  • Poucas ou nenhuma dependência externa
  • Licença permissiva para uso comercial irrestrito

Quais são os pilares desta biblioteca ?

  • Conformidade com a ABNT
  • Segurança e previsibilidade
    • 100% coberto por testes unitários
    • Verificação a cada commit/merge
      .NET
  • Inclusivo, código escrito e documentado em português
  • Altíssima compatibilidade permitindo o uso em qualquer versão de .Net
    • Net 8.0
    • Net 6.0
    • Net Core 3.1
    • Net Framework 2.0
    • Net Standard 2.0+
      • Mono 5.4+
      • Xamarin.iOS 10.14, 12.16+
      • Xamarin.Mac 3.8, 5.16+
      • Xamarin.Android 8.0+
      • UWP 10.0.16299+
      • Unity 2018.1+

O que já temos ou ainda queremos ter ?

Validadores:

  • Validação de Documentos: CEP, CNPJ, CPF, IE e PIS
  • Validação de Documentos: RG
  • Validação de Chaves PIX
  • Validação de Dados Bancários (sem calcular DV)
  • Validação de Dados Bancários (com cálculo DV)
  • Valida Dia Útil com possibilidade de verificar feriados nacionais
  • Calculador de dias úteis (ex.: Quando será daqui X dias úteis)

Formatadores:

  • Máscaras para documentos: CNPJ, CPF, PIS e IE
  • Máscaras para documentos: RG
  • Máscaras em geral: CEP e Telefone
  • Remoção de máscaras
  • Remoção de acentos (torna o texto compatível com ASCII7)
  • Remoção de caracteres especiais (configurável)
  • Remoção de espaços desnecessários
  • Conversão de textos em números
  • Conversão de números em texto com arredondamento ABNT
  • Conversão de valor em reais para texto com sinal monetário e arredondamento ABNT
  • Funções para escrita de valores por extenso
  • Conversão de palavras em singular para plural
  • Filtragem de textos para remoção de caracteres por categorias

Dados:

  • Montagem de BRCode para PIX Estático
  • Feriados Nacionais (pelas leis 10.607/2002 e 6.802/1980)
  • Feriados Estaduais
  • Dias úteis (pelas leis 10.607/2002 e 6.802/1980)
  • Nomes de meses e dias da semana com e sem acentos, em maiúsculo e minúsculo
  • Enum de UFs relacionado com o Código IBGE
  • Arrays com as UFs, os nomes dos estados, seus códigos no IBGE e suas capitais
  • Lista de Cidades com os Códigos IBGE

About

A simple formatter for brazilian software in portuguese

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •  

Languages