Ejemplos en Python

Estos flujos reflejan escenarios ya cubiertos por las pruebas del proyecto.

Inicio rapido Guardar tablas

Convertir JSON a CSV

Round-trip simple desde archivo

from pytabify import DataTableCreator, DataTableSaver

datatable = DataTableCreator.from_file("people.json")
DataTableSaver.into_csv(datatable, "people.csv")

Comportamiento esperado

Este flujo esta cubierto por los tests end-to-end del proyecto. Es el mejor ejemplo base para usuarios que solo quieren transformar un archivo rapidamente.

Cargar XLSX y persistir como JSON

XLSX -> JSON

from pytabify import DataTableCreator, DataTableSaver

datatable = DataTableCreator.from_file("people.xlsx", sheet_name="People")
DataTableSaver.into_json(datatable, "people.json")

Si falta sheet_name

La lectura de XLSX lanza una excepcion cuando no recibe un nombre de hoja. Si no conoces la hoja correcta, revisa primero el archivo fuente.

Enriquecer registros antes de guardar

Expandir el esquema y exportar

from pytabify import DataTableCreator, DataTableSaver

datatable = DataTableCreator.from_records(
    [
        {"name": "Alice", "age": 30},
        {"name": "Bob", "age": 25},
    ]
)

datatable[0]["country"] = "MX"

DataTableSaver.into_json(datatable, "people-enriched.json")

AntesDespues

Registros iniciales

[
    {"name": "Alice", "age": 30},
    {"name": "Bob", "age": 25},
]

Salida serializada

[
    {"name": "Alice", "age": 30, "country": "MX"},
    {"name": "Bob", "age": 25, "country": None},
]

Usarlo en pruebas

Fixtures y assertions

from pytabify import DataTableCreator

datatable = DataTableCreator.from_records(
    [
        {"name": "Alice", "active": True, "nickname": None},
        {"name": "Bob", "active": False, "nickname": None},
    ]
)

assert datatable[0].active.value is True
assert datatable[1].nickname.value is None

Eleccion de formato

Si las assertions dependen de tipos nativos, usa from_records, JSON o XLSX. Evita basarte en tipos al leer desde CSV.