nini-datagen 0.2.0__py3-none-win_amd64.whl

nini_datagen/__init__.py

@@ -0,0 +1,230 @@
+"""nini-datagen: dados sintéticos realistas do Brasil em escala, gerados por kernels C++ direto em Polars.
+
+>>> import nini_datagen as dg
+>>> dg.first_name(5, seed=42)                     # doctest: +SKIP
+>>> g = dg.DataGen(seed=42)
+>>> g.integer(1_000_000, low=1, high=6)           # doctest: +SKIP
+>>> g.choice(10, ["a", "b", "c"], weights=[5, 3, 2])  # doctest: +SKIP
+
+Toda configuração é um modelo Pydantic (``dg.IntegerConfig(low=1, high=6)``); dicts e kwargs são convertidos para ele,
+então um parâmetro com nome errado vira erro em vez de ser ignorado.
+"""
+
+from __future__ import annotations
+
+from importlib import metadata
+
+from . import datasets, validators
+from .api import (
+    address,
+    age,
+    birthdate,
+    boolean,
+    cep,
+    choice,
+    choice_by,
+    city,
+    cnh,
+    cnpj,
+    company,
+    correlated,
+    cpf,
+    credit_card,
+    date,
+    datetime,
+    ean13,
+    email,
+    first_name,
+    full_name,
+    generate,
+    iban,
+    integer,
+    ipv4,
+    ipv6,
+    last_name,
+    license_plate,
+    lognormal,
+    mac,
+    normal,
+    occupation,
+    paragraph,
+    phone,
+    pis,
+    rg,
+    scan,
+    sentence,
+    sex,
+    state,
+    table,
+    uniform,
+    url,
+    username,
+    uuid,
+    vehicle,
+    voter_id,
+    write_parquet_dataset,
+)
+from .config import (
+    AddressConfig,
+    AgeConfig,
+    BaseConfig,
+    BirthdateConfig,
+    BooleanConfig,
+    CepConfig,
+    ChoiceByConfig,
+    ChoiceConfig,
+    CityConfig,
+    CNHConfig,
+    CNPJConfig,
+    CompanyConfig,
+    CorrelatedConfig,
+    CPFConfig,
+    CreditCardConfig,
+    DateConfig,
+    DatetimeConfig,
+    EAN13Config,
+    EmailConfig,
+    FirstNameConfig,
+    FullNameConfig,
+    IBANConfig,
+    IntegerConfig,
+    IPv4Config,
+    IPv6Config,
+    LastNameConfig,
+    LicensePlateConfig,
+    LognormalConfig,
+    MACConfig,
+    NormalConfig,
+    OccupationConfig,
+    ParagraphConfig,
+    PhoneConfig,
+    PISConfig,
+    RGConfig,
+    SentenceConfig,
+    SexConfig,
+    StateConfig,
+    UniformConfig,
+    URLConfig,
+    UsernameConfig,
+    UUIDConfig,
+    VehicleConfig,
+    VoterIDConfig,
+)
+from .config.dirty import DirtyConfig
+from .errors import DatagenError, NativeLibraryError
+from .generator import DataGen
+from .registry import registry
+from .schema import Schema, column, ref
+from .transforms import add_duplicates, dirty
+
+try:
+    __version__ = metadata.version("nini-datagen")
+except metadata.PackageNotFoundError:  # rodando de uma cópia sem instalar
+    __version__ = "0.0.0"
+
+__all__ = [
+    "AddressConfig",
+    "AgeConfig",
+    "BaseConfig",
+    "BirthdateConfig",
+    "BooleanConfig",
+    "CNHConfig",
+    "CNPJConfig",
+    "CPFConfig",
+    "CepConfig",
+    "ChoiceByConfig",
+    "ChoiceConfig",
+    "CityConfig",
+    "CompanyConfig",
+    "CorrelatedConfig",
+    "CreditCardConfig",
+    "DataGen",
+    "DatagenError",
+    "DateConfig",
+    "DatetimeConfig",
+    "DirtyConfig",
+    "EAN13Config",
+    "EmailConfig",
+    "FirstNameConfig",
+    "FullNameConfig",
+    "IBANConfig",
+    "IPv4Config",
+    "IPv6Config",
+    "IntegerConfig",
+    "LastNameConfig",
+    "LicensePlateConfig",
+    "LognormalConfig",
+    "MACConfig",
+    "NativeLibraryError",
+    "NormalConfig",
+    "OccupationConfig",
+    "PISConfig",
+    "ParagraphConfig",
+    "PhoneConfig",
+    "RGConfig",
+    "Schema",
+    "SentenceConfig",
+    "SexConfig",
+    "StateConfig",
+    "URLConfig",
+    "UUIDConfig",
+    "UniformConfig",
+    "UsernameConfig",
+    "VehicleConfig",
+    "VoterIDConfig",
+    "__version__",
+    "add_duplicates",
+    "address",
+    "age",
+    "birthdate",
+    "boolean",
+    "cep",
+    "choice",
+    "choice_by",
+    "city",
+    "cnh",
+    "cnpj",
+    "column",
+    "company",
+    "correlated",
+    "cpf",
+    "credit_card",
+    "datasets",
+    "date",
+    "datetime",
+    "dirty",
+    "ean13",
+    "email",
+    "first_name",
+    "full_name",
+    "generate",
+    "iban",
+    "integer",
+    "ipv4",
+    "ipv6",
+    "last_name",
+    "license_plate",
+    "lognormal",
+    "mac",
+    "normal",
+    "occupation",
+    "paragraph",
+    "phone",
+    "pis",
+    "ref",
+    "registry",
+    "rg",
+    "scan",
+    "sentence",
+    "sex",
+    "state",
+    "table",
+    "uniform",
+    "url",
+    "username",
+    "uuid",
+    "validators",
+    "vehicle",
+    "voter_id",
+    "write_parquet_dataset",
+]

nini_datagen/_native.py

@@ -0,0 +1,122 @@
+"""Carrega a biblioteca C++ (libdatagen) via ctypes e aplica as assinaturas de `_signatures.py`.
+
+Ordem de busca:
+1. variável de ambiente ``NINI_DATAGEN_LIB`` (caminho do arquivo; útil para testar um build manual);
+2. a pasta do pacote (instalação normal por wheel);
+3. os arquivos registrados na instalação (instalação editável do ``uv sync``, em que o pacote aponta para ``src/`` e a
+   biblioteca compilada fica no site-packages).
+
+O ctypes solta o GIL durante cada chamada, então os blocos rodam em paralelo de verdade numa ThreadPool.
+"""
+
+from __future__ import annotations
+
+import ctypes
+import os
+import sys
+import threading
+from importlib import metadata
+from pathlib import Path
+
+import numpy as np
+
+from ._signatures import ABI_VERSION, SIGNATURES
+from .errors import NativeLibraryError
+
+__all__ = ["ENV_VAR", "LIB_NAMES", "lib", "library_path", "ptr"]
+
+ENV_VAR = "NINI_DATAGEN_LIB"
+if sys.platform == "win32":
+    LIB_NAMES: tuple[str, ...] = ("datagen.dll",)
+elif sys.platform == "darwin":
+    LIB_NAMES = ("libdatagen.dylib", "libdatagen.so")
+else:
+    LIB_NAMES = ("libdatagen.so",)
+
+_lock = threading.Lock()
+_lib: ctypes.CDLL | None = None
+_path: Path | None = None
+
+
+def _candidates() -> list[Path]:
+    env = os.environ.get(ENV_VAR)
+    if env:
+        return [Path(env)]  # pedido explícito: não procura em outro lugar
+    here = Path(__file__).resolve().parent
+    found = [here / name for name in LIB_NAMES]
+    try:
+        files = metadata.files("nini-datagen") or []
+    except metadata.PackageNotFoundError:
+        files = []
+    found += [Path(str(f.locate())) for f in files if f.name in LIB_NAMES]
+    return found
+
+
+def _load(path: Path) -> ctypes.CDLL:
+    try:
+        handle = ctypes.CDLL(str(path))
+    except OSError as e:
+        raise NativeLibraryError(f"não consegui carregar {path}: {e}") from e
+    try:
+        version = handle.dg_abi_version()
+    except AttributeError as e:
+        raise NativeLibraryError(f"{path} não é a biblioteca do nini-datagen (falta dg_abi_version)") from e
+    if version != ABI_VERSION:
+        raise NativeLibraryError(
+            f"{path} tem ABI {version}, mas o pacote Python espera {ABI_VERSION}: recompile"
+            " (uv sync --reinstall-package nini-datagen) ou reinstale o pacote"
+        )
+    missing = [name for name in SIGNATURES if not hasattr(handle, name)]
+    if missing:
+        raise NativeLibraryError(f"{path} não exporta {missing}")
+    for name, (restype, argtypes) in SIGNATURES.items():
+        fn = getattr(handle, name)
+        fn.restype = restype
+        fn.argtypes = argtypes
+    # inicializa todas as tabelas antes de qualquer thread (veja dg_init em cpp/tables.cpp)
+    handle.dg_init()
+    return handle
+
+
+def lib() -> ctypes.CDLL:
+    """A biblioteca carregada (carrega na primeira chamada; seguro entre threads)."""
+    global _lib, _path
+    if _lib is not None:
+        return _lib
+    with _lock:
+        if _lib is None:
+            tried = []
+            for path in _candidates():
+                if path.is_file():
+                    _lib, _path = _load(path), path
+                    break
+                tried.append(str(path))
+            else:
+                raise NativeLibraryError(
+                    "biblioteca C++ do nini-datagen não encontrada (procurei em: "
+                    + ", ".join(tried)
+                    + "). Numa cópia do repositório, rode `uv sync`; para um build manual, aponte "
+                    + f"{ENV_VAR} para o arquivo."
+                )
+    return _lib
+
+
+def library_path() -> Path:
+    """Caminho do arquivo da biblioteca carregada."""
+    lib()
+    assert _path is not None
+    return _path
+
+
+def _reset() -> None:
+    """Só para testes: esquece a biblioteca carregada (a próxima chamada a `lib()` procura de novo)."""
+    global _lib, _path
+    with _lock:
+        _lib, _path = None, None
+
+
+def ptr(a: np.ndarray) -> int:
+    """Endereço do primeiro elemento de um array contíguo (o C++ escreve/lê nele como um vetor plano)."""
+    if not a.flags.c_contiguous:
+        raise ValueError("o array precisa ser contíguo (C order) para ir ao C++")
+    return a.ctypes.data

nini_datagen/_signatures.py

@@ -0,0 +1,58 @@
+"""Tipos dos argumentos de cada função da biblioteca C++ (GERADO por tools/gen_bindings.py; não edite)."""
+from __future__ import annotations
+
+from ctypes import c_double, c_float, c_int, c_int64, c_uint8, c_uint16, c_uint32, c_uint64, c_void_p
+
+ABI_VERSION = 10
+
+# nome: (tipo de retorno, [tipos dos argumentos])
+SIGNATURES = {
+    "dg_cep_views": (None, [c_void_p, c_uint32, c_void_p, c_int, c_int64, c_void_p]),
+    "dg_cep_views_uf": (None, [c_void_p, c_void_p, c_void_p, c_void_p, c_void_p, c_int, c_int64, c_void_p]),
+    "dg_empresa_views": (None, [c_void_p, c_uint32, c_void_p, c_void_p, c_void_p, c_uint32, c_void_p, c_void_p, c_void_p, c_uint32, c_void_p, c_void_p, c_void_p, c_uint32, c_void_p, c_void_p, c_void_p, c_int64, c_void_p, c_void_p]),
+    "dg_veiculo_idx": (None, [c_void_p, c_uint32, c_void_p, c_void_p, c_void_p, c_void_p, c_uint32, c_void_p, c_int64, c_void_p, c_void_p, c_void_p]),
+    "dg_cep_pick": (None, [c_void_p, c_uint32, c_void_p, c_void_p, c_int, c_int64, c_void_p]),
+    "dg_address_core": (None, [c_void_p, c_uint32, c_void_p, c_void_p, c_void_p, c_void_p, c_void_p, c_void_p, c_int64, c_void_p, c_void_p, c_void_p, c_void_p, c_void_p, c_void_p, c_void_p]),
+    "dg_house_number": (None, [c_void_p, c_void_p, c_int64, c_void_p]),
+    "dg_pick_in_group": (None, [c_void_p, c_void_p, c_int, c_void_p, c_void_p, c_void_p, c_int64, c_void_p]),
+    "dg_int_views": (None, [c_void_p, c_int64, c_void_p]),
+    "dg_concat_size": (c_int64, [c_int64, c_int, c_void_p, c_void_p]),
+    "dg_concat_views": (None, [c_int64, c_int, c_void_p, c_void_p, c_void_p, c_void_p, c_void_p, c_void_p]),
+    "dg_cpf_from_base": (None, [c_void_p, c_int64, c_int, c_void_p, c_void_p]),
+    "dg_cpf_perm": (None, [c_uint64, c_uint64, c_int64, c_int, c_void_p, c_void_p]),
+    "dg_cpf_random": (None, [c_void_p, c_int64, c_int, c_void_p, c_void_p]),
+    "dg_cnpj_gen": (None, [c_void_p, c_int, c_uint32, c_uint32, c_int, c_int, c_uint64, c_uint64, c_int64, c_void_p, c_void_p]),
+    "dg_id_views": (None, [c_void_p, c_int, c_int, c_int64, c_void_p, c_void_p, c_int]),
+    "dg_uuid_views": (None, [c_void_p, c_int64, c_void_p, c_void_p]),
+    "dg_ipv4_views": (None, [c_void_p, c_int, c_int64, c_void_p, c_void_p]),
+    "dg_url_views": (None, [c_void_p, c_uint32, c_void_p, c_void_p, c_uint32, c_void_p, c_void_p, c_void_p, c_int64, c_void_p, c_void_p]),
+    "dg_alias_build": (None, [c_void_p, c_uint32, c_void_p]),
+    "dg_bool_bits": (None, [c_void_p, c_uint64, c_int64, c_void_p]),
+    "dg_rand_i64": (None, [c_void_p, c_int64, c_uint64, c_int64, c_void_p]),
+    "dg_rand_i32": (None, [c_void_p, c_int, c_uint32, c_int64, c_void_p]),
+    "dg_rand_f64": (None, [c_void_p, c_double, c_double, c_int64, c_void_p]),
+    "dg_rand_f32": (None, [c_void_p, c_float, c_float, c_int64, c_void_p]),
+    "dg_rand_normal": (None, [c_void_p, c_double, c_double, c_int, c_int64, c_void_p]),
+    "dg_correlated": (None, [c_void_p, c_void_p, c_double, c_double, c_double, c_double, c_double, c_int, c_int64, c_void_p]),
+    "dg_birthdate": (None, [c_void_p, c_void_p, c_void_p, c_void_p, c_int64, c_void_p]),
+    "dg_det_exp": (c_double, [c_double]),
+    "dg_alias_idx": (None, [c_uint32, c_void_p, c_void_p, c_int64, c_void_p]),
+    "dg_choice_views": (None, [c_void_p, c_uint32, c_void_p, c_int64, c_void_p]),
+    "dg_choice_alias_views": (None, [c_void_p, c_uint32, c_void_p, c_void_p, c_int64, c_void_p]),
+    "dg_choice_alias_views_by": (None, [c_void_p, c_uint32, c_uint32, c_void_p, c_void_p, c_void_p, c_int64, c_void_p]),
+    "dg_phone_views": (None, [c_void_p, c_uint32, c_void_p, c_void_p, c_uint64, c_int, c_int64, c_void_p, c_void_p, c_void_p]),
+    "dg_email_views": (None, [c_void_p, c_uint32, c_void_p, c_void_p, c_uint32, c_void_p, c_void_p, c_void_p, c_void_p, c_int, c_uint32, c_void_p, c_void_p, c_void_p, c_int64, c_void_p, c_void_p, c_void_p, c_void_p, c_void_p]),
+    "dg_gather_views": (None, [c_void_p, c_void_p, c_int64, c_void_p]),
+    "dg_alias_idx_by": (None, [c_uint32, c_uint32, c_void_p, c_void_p, c_void_p, c_int64, c_void_p]),
+    "dg_join_size": (c_int64, [c_int64, c_int, c_void_p, c_void_p, c_uint32]),
+    "dg_join_views": (None, [c_int64, c_int, c_void_p, c_void_p, c_void_p, c_void_p, c_uint32, c_uint32, c_void_p, c_void_p]),
+    "dg_sex_mask": (c_int64, [c_void_p, c_void_p, c_int64, c_int64, c_void_p]),
+    "dg_xoshiro_streams": (None, [c_void_p, c_int64, c_int64, c_void_p]),
+    "dg_views_used": (c_int64, [c_void_p, c_int64, c_int]),
+    "dg_init": (c_int, []),
+    "dg_abi_version": (c_int, []),
+    "dg_text_views": (None, [c_void_p, c_uint32, c_void_p, c_void_p, c_void_p, c_uint32, c_uint32, c_uint32, c_uint32, c_int64, c_void_p, c_void_p]),
+    "dg_template_views": (c_int64, [c_void_p, c_void_p, c_void_p, c_void_p, c_void_p, c_void_p, c_void_p, c_void_p, c_uint32, c_uint32, c_int, c_int64, c_int64, c_int64, c_void_p, c_void_p]),
+}
+
+__all__ = ['ABI_VERSION', 'SIGNATURES', 'c_double', 'c_float', 'c_int', 'c_int64', 'c_uint8', 'c_uint16', 'c_uint32', 'c_uint64', 'c_void_p']

nini_datagen/api.py

@@ -0,0 +1,187 @@
+"""Funções soltas: ``nini_datagen.integer(n, ...)`` é um atalho para ``DataGen(seed, ...).integer(n, ...)``.
+
+Sem ``seed``, cada chamada sorteia uma semente nova (valores diferentes a cada vez). Com ``seed``, o resultado é sempre
+o mesmo.
+"""
+
+from __future__ import annotations
+
+from collections.abc import Mapping
+from pathlib import Path
+from typing import Any
+
+import polars as pl
+
+from .generator import DataGen
+from .locales import Locale
+from .schema import Schema
+
+__all__ = [
+    "address",
+    "age",
+    "birthdate",
+    "boolean",
+    "cep",
+    "choice",
+    "choice_by",
+    "city",
+    "cnh",
+    "cnpj",
+    "company",
+    "correlated",
+    "cpf",
+    "credit_card",
+    "date",
+    "datetime",
+    "ean13",
+    "email",
+    "first_name",
+    "full_name",
+    "generate",
+    "iban",
+    "integer",
+    "ipv4",
+    "ipv6",
+    "last_name",
+    "license_plate",
+    "lognormal",
+    "mac",
+    "normal",
+    "occupation",
+    "paragraph",
+    "phone",
+    "pis",
+    "rg",
+    "scan",
+    "sentence",
+    "sex",
+    "state",
+    "table",
+    "uniform",
+    "url",
+    "username",
+    "uuid",
+    "vehicle",
+    "voter_id",
+    "write_parquet_dataset",
+]
+
+
+def generate(
+    kind: str,
+    n: int,
+    config: Any = None,
+    /,
+    *,
+    seed: int | None = None,
+    locale: str | Locale = "pt_BR",
+    threads: int | None = None,
+    **kwargs: Any,
+) -> pl.Series:
+    """Gera ``n`` valores do tipo ``kind``; veja `DataGen.generate`."""
+    return DataGen(seed, locale=locale, threads=threads).generate(kind, n, config, **kwargs)
+
+
+def table(
+    n: int,
+    schema: Schema | Mapping[str, Any],
+    *,
+    seed: int | None = None,
+    locale: str | Locale = "pt_BR",
+    threads: int | None = None,
+) -> pl.DataFrame:
+    """Tabela de ``n`` linhas; veja `DataGen.table`."""
+    return DataGen(seed, locale=locale, threads=threads).table(n, schema)
+
+
+def scan(
+    n: int,
+    schema: Schema | Mapping[str, Any],
+    *,
+    seed: int | None = None,
+    locale: str | Locale = "pt_BR",
+    threads: int | None = None,
+    batch_size: int | None = None,
+) -> pl.LazyFrame:
+    """Tabela como ``pl.LazyFrame``, gerada sob demanda; veja `DataGen.scan`.
+
+    Sem ``seed``, a semente é sorteada uma vez aqui: coletar o mesmo LazyFrame duas vezes dá a mesma tabela.
+    """
+    return DataGen(seed, locale=locale, threads=threads).scan(n, schema, batch_size=batch_size)
+
+
+def write_parquet_dataset(
+    path: str | Path,
+    n: int,
+    schema: Schema | Mapping[str, Any],
+    *,
+    seed: int | None = None,
+    locale: str | Locale = "pt_BR",
+    threads: int | None = None,
+    **options: Any,
+) -> list[Path]:
+    """Grava ``n`` linhas em Parquet, em lotes; veja `DataGen.write_parquet_dataset` (as opções são as mesmas)."""
+    return DataGen(seed, locale=locale, threads=threads).write_parquet_dataset(path, n, schema, **options)
+
+
+def _shortcut(kind: str, doc: str) -> Any:
+    def fn(
+        n: int,
+        config: Any = None,
+        /,
+        *,
+        seed: int | None = None,
+        locale: str | Locale = "pt_BR",
+        threads: int | None = None,
+        **kwargs: Any,
+    ) -> pl.Series:
+        return generate(kind, n, config, seed=seed, locale=locale, threads=threads, **kwargs)
+
+    fn.__name__ = fn.__qualname__ = kind
+    fn.__doc__ = doc + "\n\n``seed``, ``locale`` e ``threads`` como em `DataGen`; o resto vai para a configuração."
+    return fn
+
+
+integer = _shortcut("integer", DataGen.integer.__doc__ or "")
+uniform = _shortcut("uniform", DataGen.uniform.__doc__ or "")
+normal = _shortcut("normal", DataGen.normal.__doc__ or "")
+lognormal = _shortcut("lognormal", DataGen.lognormal.__doc__ or "")
+boolean = _shortcut("boolean", DataGen.boolean.__doc__ or "")
+date = _shortcut("date", DataGen.date.__doc__ or "")
+datetime = _shortcut("datetime", DataGen.datetime.__doc__ or "")
+choice = _shortcut("choice", DataGen.choice.__doc__ or "")
+sex = _shortcut("sex", DataGen.sex.__doc__ or "")
+age = _shortcut("age", DataGen.age.__doc__ or "")
+first_name = _shortcut("first_name", DataGen.first_name.__doc__ or "")
+last_name = _shortcut("last_name", DataGen.last_name.__doc__ or "")
+full_name = _shortcut("full_name", DataGen.full_name.__doc__ or "")
+cpf = _shortcut("cpf", DataGen.cpf.__doc__ or "")
+cnpj = _shortcut("cnpj", DataGen.cnpj.__doc__ or "")
+pis = _shortcut("pis", DataGen.pis.__doc__ or "")
+voter_id = _shortcut("voter_id", DataGen.voter_id.__doc__ or "")
+cnh = _shortcut("cnh", DataGen.cnh.__doc__ or "")
+rg = _shortcut("rg", DataGen.rg.__doc__ or "")
+license_plate = _shortcut("license_plate", DataGen.license_plate.__doc__ or "")
+credit_card = _shortcut("credit_card", DataGen.credit_card.__doc__ or "")
+iban = _shortcut("iban", DataGen.iban.__doc__ or "")
+ean13 = _shortcut("ean13", DataGen.ean13.__doc__ or "")
+uuid = _shortcut("uuid", DataGen.uuid.__doc__ or "")
+ipv4 = _shortcut("ipv4", DataGen.ipv4.__doc__ or "")
+ipv6 = _shortcut("ipv6", DataGen.ipv6.__doc__ or "")
+mac = _shortcut("mac", DataGen.mac.__doc__ or "")
+url = _shortcut("url", DataGen.url.__doc__ or "")
+phone = _shortcut("phone", DataGen.phone.__doc__ or "")
+email = _shortcut("email", DataGen.email.__doc__ or "")
+username = _shortcut("username", DataGen.username.__doc__ or "")
+company = _shortcut("company", DataGen.company.__doc__ or "")
+vehicle = _shortcut("vehicle", DataGen.vehicle.__doc__ or "")
+occupation = _shortcut("occupation", DataGen.occupation.__doc__ or "")
+sentence = _shortcut("sentence", DataGen.sentence.__doc__ or "")
+paragraph = _shortcut("paragraph", DataGen.paragraph.__doc__ or "")
+cep = _shortcut("cep", DataGen.cep.__doc__ or "")
+address = _shortcut("address", DataGen.address.__doc__ or "")
+city = _shortcut("city", DataGen.city.__doc__ or "")
+state = _shortcut("state", DataGen.state.__doc__ or "")
+birthdate = _shortcut("birthdate", DataGen.birthdate.__doc__ or "")
+correlated = _shortcut("correlated", DataGen.correlated.__doc__ or "")
+choice_by = _shortcut("choice_by", DataGen.choice_by.__doc__ or "")

nini_datagen/config/__init__.py

@@ -0,0 +1,83 @@
+"""Configurações dos geradores (modelos Pydantic imutáveis; parâmetro com nome errado vira erro)."""
+
+from __future__ import annotations
+
+from .address import AddressConfig, CepConfig, CityConfig, StateConfig
+from .base import BaseConfig
+from .business import CompanyConfig, OccupationConfig, VehicleConfig
+from .choice import ChoiceConfig
+from .contact import EmailConfig, PhoneConfig, UsernameConfig
+from .dirty import DirtyConfig
+from .documents import (
+    CNHConfig,
+    CNPJConfig,
+    CPFConfig,
+    CreditCardConfig,
+    EAN13Config,
+    IBANConfig,
+    LicensePlateConfig,
+    PISConfig,
+    RGConfig,
+    VoterIDConfig,
+)
+from .network import IPv4Config, IPv6Config, MACConfig, URLConfig, UUIDConfig
+from .numbers import (
+    BooleanConfig,
+    DateConfig,
+    DatetimeConfig,
+    IntegerConfig,
+    LognormalConfig,
+    NormalConfig,
+    UniformConfig,
+)
+from .person import AgeConfig, FirstNameConfig, FullNameConfig, LastNameConfig, SexConfig
+from .relations import BirthdateConfig, ChoiceByConfig, CorrelatedConfig
+from .text import ParagraphConfig, SentenceConfig
+
+__all__ = [
+    "AddressConfig",
+    "AgeConfig",
+    "BaseConfig",
+    "BirthdateConfig",
+    "BooleanConfig",
+    "CNHConfig",
+    "CNPJConfig",
+    "CPFConfig",
+    "CepConfig",
+    "ChoiceByConfig",
+    "ChoiceConfig",
+    "CityConfig",
+    "CompanyConfig",
+    "CorrelatedConfig",
+    "CreditCardConfig",
+    "DateConfig",
+    "DatetimeConfig",
+    "DirtyConfig",
+    "EAN13Config",
+    "EmailConfig",
+    "FirstNameConfig",
+    "FullNameConfig",
+    "IBANConfig",
+    "IPv4Config",
+    "IPv6Config",
+    "IntegerConfig",
+    "LastNameConfig",
+    "LicensePlateConfig",
+    "LognormalConfig",
+    "MACConfig",
+    "NormalConfig",
+    "OccupationConfig",
+    "PISConfig",
+    "ParagraphConfig",
+    "PhoneConfig",
+    "RGConfig",
+    "SentenceConfig",
+    "SexConfig",
+    "StateConfig",
+    "URLConfig",
+    "UUIDConfig",
+    "UniformConfig",
+    "UsernameConfig",
+    "VehicleConfig",
+    "VoterIDConfig",
+]