Python · SDK · todas UFs

Gerador de Endereço em Python

SDK fakeforge-br gera endereço brasileiro completo — rua, número, bairro, cidade, UF, CEP válido. Cobre todas as 27 UFs.

pip install fakeforge-br

from fakeforge import FakeForge
enderecos = FakeForge().address(100)

SDK oficial

from fakeforge import FakeForge

ff = FakeForge()

# 100 endereços aleatórios (mix de UFs)
enderecos = ff.address(100)
for e in enderecos[:3]:
    print(e)
    # {
    #   "cep": "01310-100",
    #   "logradouro": "Av. Paulista, 1500",
    #   "bairro": "Bela Vista",
    #   "cidade": "São Paulo",
    #   "estado": "SP",
    #   "estadoNome": "São Paulo"
    # }

# Preset customer com endereço correlacionado (email deriva do nome, DDD bate com UF)
pessoas = ff.preset("customer", 10)
for p in pessoas:
    e = p["endereco"]
    print(f"{p['nome']}: {e['cidade']}/{e['estado']}")

Django seed com endereços por região

# myapp/management/commands/seed_users_regionalizados.py
from django.core.management.base import BaseCommand
from fakeforge import FakeForge
from myapp.models import User, Endereco

class Command(BaseCommand):
    def handle(self, *args, **options):
        ff = FakeForge()
        pessoas = ff.preset("customer", 1000)

        for p in pessoas:
            u = User.objects.create(nome=p["nome"], cpf=p["cpf"], email=p["email"])
            Endereco.objects.create(
                user=u,
                cep=p["endereco"]["cep"],
                logradouro=p["endereco"]["logradouro"],
                bairro=p["endereco"]["bairro"],
                cidade=p["endereco"]["cidade"],
                uf=p["endereco"]["estado"],
            )

pytest com fixture

# tests/conftest.py
import pytest
from fakeforge import FakeForge

@pytest.fixture(scope="session")
def enderecos(ff):
    return ff.address(50)

@pytest.fixture
def endereco_sp(ff):
    """1 endereço garantido de SP pra testar regra específica."""
    for _ in range(20):
        e = ff.address(1)[0]
        if e["estado"] == "SP":
            return e
    raise AssertionError("Não gerou endereço SP em 20 tentativas")

# tests/test_frete.py
def test_frete_regionalizado(endereco_sp):
    from myapp.frete import CalculadoraFrete
    valor = CalculadoraFrete.calcular(cep=endereco_sp["cep"], peso_kg=2)
    assert valor > 0
Testar APIEndereço básicoNode.js