fordev.generators

Este módulo coleta dados aleatórios gerados pelo site 4Devs e disponíbiliza uma API simples para uso.

Use a função help() para mais informações:

>>> from fordev import generators
>>> help(generators)
Help on module fordev.generators in fordev:

NAME
    fordev.generators

DESCRIPTION
(...)

Parâmetros Comuns

Muitas funções do módulo fordev.generators contém parâmetros em comum, são eles:

uf_code: str

Recebe o Código da Unidade Federativa para geração do dado.

Caso não saiba o que é ou não conheça o do estado que necessita, obtenha mais informações em: https://pt.wikipedia.org/wiki/Subdivis%C3%B5es_do_Brasil

formatting: bool

Se receber o valor True, retorna os dados formatados. Se receber o valor False, retorna os dados sem formatação.

data_only: bool

Se receber o valor True, retorna somente os dados em texto puro. Se receber o valor False, retorna um dicionário contendo uma chave msg e data ou error contendo valores correspondentes à nomenclatura de suas chaves.

Sendo assim, sempre que os encontrar, utilize conforme o descrito acima.

Docs de todas funções

fordev.generators.certificate(type_: str = 'I', formatting: bool = True, data_only: bool = True) → str | dict

Gere o código de certidões (birth, wedding, religious wedding and death) aleatórias.

Parâmetros:

type –

O tipo da certidão para geração do código.

Consulte a doc para verificar as opções suportadas: https://fordev.rtfd.io/pt_BR/latest/fordev/generators.html

Certidões suportadas:

I = Indifferent (Indiferente) <Padrão>

B = Birth (Nascimento)

W = Wedding (Casamento)

R = Religious Wedding (Casamento Religioso)

D = Death (Morte)

Nota

Os tipos de certidões devem ser passados para o parâmetro type_.

Exemplo:

>>> from fordev.generators import certificate
>>> certificate(type_='B')

fordev.generators.cnh(data_only: bool = True) → str | dict: Geração aleatória de CNH (Carteira Nacional de Habilitação).

fordev.generators.bank_account(bank: int = 0, uf_code: str = '', data_only: bool = True) → dict

Gere dados de conta bancária.

Parâmetros:

bank –

Recebe um valor númerico de 0 a 5 que representa a bandeira do banco da conta bancária a ser gerada.

Consulte a doc para verificar as opções suportadas: https://fordev.rtfd.io/pt_BR/latest/fordev/generators.html

Bandeiras suportadas:

0 = Aleatório <Padrão>

1 = Banco do Brasil

2 = Bradesco

3 = Citibank

4 = Itaú

5 = Santander

Nota

O valor númerico que representa a bandeira do banco deve ser passada para o parâmetro bank.

Exemplo:

>>> from fordev.generators import bank_account
>>> bank_account(bank=2)  # Banco Bradesco

fordev.generators.cpf(uf_code: str = '', formatting: bool = True, data_only: bool = True) → str | dict: Gere o código de um CPF(Cadastro de Pessoas Físicas) aleatório.

fordev.generators.pis_pasep(formatting: bool = True, data_only: bool = True) → str | dict: Gere o código do PIS/PASEP aleatório.

fordev.generators.renavam(data_only: bool = True) → str | dict: Gere o código do RENAVAM(Registro Nacional de Veículos Automotores) aleatório.

fordev.generators.vehicle(brand_code: int = 0, uf_code: str = '', formatting: bool = True, data_only: bool = True) → dict

Gere dados de veículo aleatório.

Parâmetros:

brand –

Recebe um valor númerico de 0 a 87 que representa a marca do carro para geração dos dados aleatórios.

Consulte a doc para verificar as opções suportadas: https://fordev.rtfd.io/pt_BR/latest/fordev/generators.html

Marcas suportadas:

0 = Aleatório <Padrão>

1 = Acura

2 = Agrale

3 = Alfa Romeo

4 = AM Gen

5 = Asia Motors

6 = ASTON MARTIN

7 = Audi

8 = BMW

9 = BRM

10 = Buggy

11 = Bugre

12 = Cadillac

13 = CBT Jipe

14 = CHANA

15 = CHANGAN

16 = CHERY

17 = Chrysler

18 = Citroen

19 = Cross Lander

20 = Daewoo

21 = Daihatsu

22 = Dodge

23 = EFFA

24 = Engesa

25 = Envemo

26 = Ferrari

27 = Fiat

28 = Fibravan

29 = Ford

30 = FOTON

31 = Fyber

32 = GEELY

33 = GM - Chevrolet

34 = GREAT WALL

35 = Gurgel

36 = HAFEI

37 = Honda

38 = Hyundai

39 = Isuzu

40 = JAC

41 = Jaguar

42 = Jeep

43 = JINBEI

44 = JPX

45 = Kia Motors

46 = Lada

47 = LAMBORGHINI

48 = Land Rover

49 = Lexus

50 = LIFAN

51 = LOBINI

52 = Lotus

53 = Mahindra

54 = Maserati

55 = Matra

56 = Mazda

57 = Mercedes-Benz

58 = Mercury

59 = MG

60 = MINI

61 = Mitsubishi

62 = Miura

63 = Nissan

64 = Peugeot

65 = Plymouth

66 = Pontiac

67 = Porsche

68 = RAM

69 = RELY

70 = Renault

71 = Rolls-Royce

72 = Rover

73 = Saab

74 = Saturn

75 = Seat

76 = SHINERAY

77 = smart

78 = SSANGYONG

79 = Subaru

80 = Suzuki

81 = TAC

82 = Toyota

83 = Troller

84 = Volvo

85 = VW - VolksWagen

86 = Wake

87 = Walk

Nota

O valor númerico que representa a marca do veículo deve ser passada para o parâmetro brand_code.

Exemplo:

>>> from fordev.generators import vehicle
>>> vehicle(brand_code=26)  # Ferrari

fordev.generators.vehicle_brand(n: int = 1, data_only: bool = True) → list | dict

Obtenha o nome de marca(s) de veículo(s).

Parâmetros:: n – Recebe o número de marcas de veículos a ser gerado. O valor mínimo é 1 e o máximo é 87.

fordev.generators.vehicle_plate(uf_code: str = '', formatting: bool = True, data_only: bool = True) → str | dict: Gere o código da placa de veículo aleatório.

fordev.generators.cnpj(formatting: bool = True, data_only: bool = True) → str | dict: Gere o código do CNPJ(Cadastro Nacional da Pessoa Jurídica) aleatório.

fordev.generators.rg(formatting: bool = True, data_only: bool = True) → str | dict: Gere o código do RG(Registro Geral) aleatório, emitido por SSP-SP.

fordev.generators.state_registration(uf_code: str = 'SP', formatting: bool = True, data_only: bool = True) → str | dict: Gere o código de registro de estado aleatório.

fordev.generators.voter_title(uf_code: str, data_only: bool = True) → str | dict: Gere o código do título de eleitor aleatório, conforme o UF especificado.

fordev.generators.credit_card(bank: int = 0, formatting: bool = True, data_only: bool = True) → dict

Gere dados de cartão de crédito aleatório.

Parâmetros:

bank –

Recebe um valor númerico de 0 a 10 representando a bandeira do cartão de crédito a ser gerado.

Consulte a doc para verificar as opções suportadas: https://fordev.rtfd.io/pt_BR/latest/fordev/generators.html

Bandeiras suportadas:

0 = Aleatório <Padrão>

1 = MasterCard

2 = Visa 16 Dígitos

3 = American Express

4 = Diners Club

5 = Discover

6 = enRoute

7 = JCB

8 = Voyager

9 = HiperCard

10 = Aura

Nota

O valor númerico que representa a bandeira do cartão de crédito deve ser passada para o parâmetro bank.

Exemplo:

>>> from fordev.generators import credit_card
>>> credit_card(bank=3)  # American Express

fordev.generators.people(n: int = 1, sex: str = 'R', age: int = 0, uf_code: str = '', formatting: bool = True, data_only: bool = True) → str | dict

Gere dados de pessoa(s) aleatório(s)

Parâmetros:

n – O número de pessoas a ter dados gerados. O mínimo é 1 e o máximo é 30.
sex –
Uma string representando o sexo da pessoa para geração dos dados.

Consulte a doc para verificar as opções suportadas: https://fordev.rtfd.io/pt_BR/latest/fordev/generators.html
age – A idade da pessoa para geração dos dados. A idade mínima é 18 e a máxima é 80.

Opções de sexo:

R = Random <Padrão>

M = Male

F = Feminine

Nota

A opção de sexo deve ser passada para o parâmetro sex.

Exemplo:

>>> from fordev.generators import people
>>> people(sex='M')  # Male (Masculino)

fordev.generators.company(uf_code: str = 'SP', age: int = 1, formatting: bool = True, data_only: bool = True) → dict

Gere dados de companhia (empresa/organização) aleatório.

Parâmetros:: age – Representa o tempo de existência da companhia (a idade da companhia).

fordev.generators.uf(n: int = 1, data_only: bool = True) → list | dict

Gere o código da UF(Unidade Federativa) aleatório.

Parâmetros:: n – O número de UF’s para geração do dado. O mínimo é 1 e o máximo é 27.

fordev.generators.city(uf_code: str = 'SP', data_only: bool = True) → list | dict: Obtenha as cidades do UF especificado.