/fordev

Gere e valide dados randômicos com fordev 🎲

Primary LanguagePythonMIT LicenseMIT

Fordev - Gere e Valide Dados Randômicos

Metadata
PyPI - Version License MIT Total Downloads

Status
PyPI - Status Documentation Status Test Status

Index

O objetivo

O site 4Devs disponibiliza diversas funcionalidades muito úteis para um desenvolvedor utilizar em seus projetos que necessitam de dados randômicos válidos e outras peculiaridades, tais como: dados dos principais documentos pessoais do brasil (CPF, CNPJ, CNH etc), dados bancários, dados de cartões de crédito, dados completos de pessoas (nome, idade, documentos, endereço etc) e muitos outros geradores de dados. Porém, até o momento, não possui uma interface/API pública para utiliza-los diretamente no código da aplicação em desenvolvimento, assim, sendo necessário ir buscar tais dados diretamente no site.

Fordev foi construído para resolver esse problema, disponibilizando um módulo de fácil uso que mapeia todo o site 4Devs usando técnicas de scraping, de modo que seja possível obter todos recursos disponíveis no site em um módulo Python.

Instalação

Para instalar, certifique-se de que tenha Python e o gerenciador de pacotes pip instalados em seu ambiente.

Instale com pip:

$ pip install fordev

OBS: fordev precisa de acesso a internet para funcionar corretamente, certifique-se de que também a tenha

Demo

Socilitando dados randômicos de uma pessoa do sexo masculino, de 25 anos de idade e que mora em SP.

>>> from fordev.generators import people
>>> people(sex='M', age=25, uf_code='SP')
{
    'altura': '1,90',
    'bairro': 'Jardim Maria Amélia',
    'celular': '(12) 98401-5301',
    'cep': '12318-110',
    'cidade': 'Jacareí',
    'cor': 'laranja',
    'cpf': '061.632.758-70',
    'data_nasc': '06/12/1995',
    'email': 'bentoyagolorenzogoncalves-72@alcastro.com.br',
    'endereco': 'Rua José Benedito de Oliveira',
    'estado': 'SP',
    'idade': 25,
    'mae': 'Tereza Melissa Priscila',
    'nome': 'Bento Yago Lorenzo Gonçalves',
    'numero': 760,
    'pai': 'Sérgio Guilherme Erick Gonçalves',
    'peso': 88,
    'rg': '23.920.314-8',
    'senha': 'ErOKUUyoml',
    'sexo': 'Masculino',
    'signo': 'Sagitário',
    'telefone_fixo': '(12) 2844-9806',
    'tipo_sanguineo': 'AB+'
}

Confira a seção de funcionalidades para ver todas as funções atualmente disponíveis no módulo fordev.

Funcionalidades

Todas as funcionalidades disponíveis e que foram mapeadas no site 4Devs estão listados na tabela abaixo.

Função Tem gerador? Tem validador?
certificate
cnh
bank_account
pis_pasep
renavam
vehicle
vehicle_brand
vehicle_plate
cnpj
rg
state_registration
voter_title
credit_card
people
company
uf
city

Confira a Documentação Oficial para mais detalhes.

Contribuições

Toda contribuição é super bem-vinda!

Abaixo mostro com o que você pode contribuir:

  • Encontrou algum bug, quer propor uma nova funcionalidade ou conversar sobre o projeto? Abra uma Issue e descreve seu caso.

  • Existe uma issue aberta e você quer resolve-la, quer implementar uma nova funcionalidade ou melhorar a documentação? Faça suas adições e me envie um Pull Request

  • Gostou do projeto, mas não quer ou ainda não consegue contribuir com ele? Considere deixar uma estrela ⭐ para o Fordev

Obrigado pelo interesse em colaborar de alguma forma com o projeto 😄

Aviso Legal

Todo os dados são gerados de forma randômica, respeitando as regras de criação de cada tipo de dado.

Todo os dados gerados são para fins informativos e utilizados para auxiliar estudantes, programadores, analistas e testadores no desenvolvimento de softwares que necessitem de tais dados. Não devem ser considerados completos, atualizados, e não se destinam a ser utilizado no lugar de uma consulta jurídica, médica, financeira, ou de qualquer outro profissional. Todo e qualquer risco da utilização dos dados disponibilizados atráves do módulo Fordev é assumido pelo próprio usuário.

O aviso acima é uma adaptação para utilização no repositório, confira os termos de uso oficial do site 4Devs em: Termos de Uso

Licença

Fordev utiliza a licença MIT em todo seu código, confira suas condições em MIT License.