Skip to content

Biblioteca de funções (JS) para validar dados sociais como números de telefone, CC, NIF, Cod-Postal e muito mais. (Países de Língua Portuguesa)

License

Notifications You must be signed in to change notification settings

EmanuelGF/validatuga

Repository files navigation

validatuga Testes Actions Status

Biblioteca em Javascript de funções de validação de dados sociais de Paises de Lingua Portuguesa como números de telefones, Cartão de cidadão, cod-postal etc...

Objetivo:

  • Criar uma extensa biblioteca de validações de dados sociais especificos a cada país de lingua Portuguesa.

Casos de uso:

  • Útil para validar dados vindos de formulários.
  • Websites
  • softwares empresariais

Instalação

npm install

Correr testes

npm test

Estrutura

.
+-- __tests__
|   +-- testes.test.js
+-- validatuga.js
+-- data.js
+-- testData.js
+-- util.js

Validatuga (Objeto)

  • Comuns (funções de validação comuns como email, soLetras etc...)
  • BR (funções de validação para dados sociais de Brazil)
  • PT (funções de validação para dados sociais de Portugal)
  • ANG (funções de validação para dados sociais de Angola)
  • ...

NOTAS IMPORTANTES:

  • data.js contém os recursos para as validações.
  • validatuga.js é o ficheiro que contem todas as funções para as validações.
  • Jest é a framework usada para testar as funções. É encorajada uma abordagem TDD na construção da biblioteca.
  • util.js contém funções de utilitárias de validatuga.js.

Usar nos vossos projetos

  • Basta copiar os ficheiros (validatuga.js, data.js e util.js) para o mesmo sítio no vosso projeto e depois importar:
  • Importar a biblioteca: ex. const vt = require('./validatuga.js')

Contribuir

  1. Fork do projeto
  2. Clonar para a vossa máquina local
  3. npm install
  4. Criar o código para as funçoes no ficheiro validatuga.js correr e passar nos testes correndo npm test

Leia o guia de contribuições no ficheiro CONTRIBUTING.md

Pff crie um issue para novas funções e testes que ñ estejam presentes.

Se esta é a sua primeira vez a contribuir estou disponivél para qualquer explicação. Iniciantes bem vindos!! 🎉👋

About

Biblioteca de funções (JS) para validar dados sociais como números de telefone, CC, NIF, Cod-Postal e muito mais. (Países de Língua Portuguesa)

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published