cidadaobr

Gerador de dados aleatórios de um cidadão brasileiro.


Keywords
gerador, brasil, cpf, rg, endereço, cep, logradouro, rua, ddd, telefone, celular, nome, idade, bairro, cidade, estado
License
MIT
Install
pip install cidadaobr==1.02

Documentation

cidadaobr

Gerador de dados aleatórios de um cidadão brasileiro. Ideal para desenvolvedores, mas sua utilidade depende de quem o usar

Começando

Essas instruções vão te garantir uma cópia do projeto rodando em sua máquina local para desenvolvimento e testes, apenas.

Pré-requisitos

Instalação

Pelo pip (recomendado):

pip install cidadaobr

Pelo git:

git clone https://github.com/yanorestes/cidadaobr.git

Como usar

Instância da classe CidadaoBrasileiro

  • Construtor:
    • nome (str - opcional)
    • data_nascimento (str -- AAAA/MM/DD obrigatoriamente - opcional)
    • estado (str ex. SP/RJ/MG... - opcional)
  • Atributos:
    • nome (str)
    • data_nascimento (datetime.date)
    • idade (int)
    • cpf (str)
    • rg (str -- Por enquanto apenas para cidadãos paulistas)
    • endereco (Endereco)
      • estado (str)
      • cidade (str)
      • bairro (str)
      • logradouro (str)
      • numero (int)
      • ibge (str)
      • ddd (str)
    • telefone_fixo (str)
    • celular (str)
  • Métodos:
    • __repr__ (retorna uma string contendo todos os dados formatados)
    • json (retorna um dicionário contendo todos os dados)
    • __getitem__ (param: index -- retorna o dado buscado no dicionário json com o index do parâmetro)

Exemplo de código

Exemplo 1:

from cidadaobr import CidadaoBrasileiro

cidadao = CidadaoBrasileiro()
print(cidadao)

Resultado (Ex.):

Nome: Rosana Cerveira
Data de Nascimento: 1979-02-14
Idade: 38
CPF: 63563459428
RG: None
Endereço:
	Brasil - ES - Cariacica
	Campina Grande
	Rua Cabo Frio, 332
	IBGE: 3201308
Telefone Fixo: +55 27 85798533
Telefone Celular: +55 27 944737310

Exemplo 2:

from cidadaobr import CidadaoBrasileiro

cidadao = CidadaoBrasileiro(nome='Yan Orestes', data_nascimento='23/10/2000', estado='SP')
print(c.json())
print('\n' + cidadao['nome'])

Resultado (Ex.):

{'nome': 'Yan Orestes', 'nascimento': '23/10/2000', 'idade': 17, 'cpf': '94275784243', 'pais': 'Brasil', 'estado': 'SP', 'cidade': 'Itapira', 'rg': '839280120', 'bairro': 'Centro', 'logradouro': 'Rua Doutor Mário da Fonseca', 'endereco_numero': 767, 'endereco_ibge': '3522604', 'fixo': '+55 19 83968836', 'celular': '+55 19 997928407'}

Yan Orestes

Controle de Versão

Utilizamos o git para controle de versão. Cheque as tags nesse repositório para ver as versões disponíveis.

Autores

  • Yan Orestes - nbdy

Licença

Este projeto está licenciado sob a Licença MIT - veja LICENSE.txt