De JSON a CSV y de CSV a JSON

Dos formatos, una conversión de todos los días

JSON es lo que intercambian programas y servicios web, y CSV es lo que importan hojas de cálculo y bases de datos. Los dos se encuentran constantemente: la respuesta de una API que alguien quiere abrir en Excel, una hoja de cálculo que debe alimentar una aplicación, una exportación que hay que cargar en una base de datos o un conjunto de datos de prueba. Este conversor va en ambos sentidos y se ocupa de los detalles que hacen penosa la conversión a mano.

De JSON a CSV

La mejor entrada es una lista de objetos, donde cada objeto pasa a ser una fila y cada clave una columna. La lista de columnas es la unión de todas las claves encontradas, en el orden en que aparecen por primera vez, de modo que registros con campos distintos caben en una sola tabla, y los valores que faltan se dejan vacíos. Los objetos anidados se aplanan con puntos, así que {"direccion": {"ciudad": "Madrid"}} pasa a ser una columna llamada direccion.ciudad. Las listas dentro de un registro se pueden unir en una celda, dejar como texto JSON o repartir en varias columnas, según lo que necesite el destino. Un solo objeto pasa a ser una tabla de una fila, y una lista de valores simples pasa a ser una columna.

De CSV a JSON

Con fila de encabezado, cada línea pasa a ser un objeto cuyas claves son los títulos de las columnas; sin ella obtienes una lista de listas. El separador se puede detectar, así que se leen archivos de hojas de cálculo configuradas con coma, punto y coma o tabulador. Los campos entrecomillados se tratan bien, con comas y saltos de línea dentro de las comillas y comillas dobles duplicadas. Opcionalmente, el texto que parece un número, true, false o null se convierte en el valor JSON correspondiente, en lugar de dejarlo todo como texto, y las celdas vacías pueden escribirse como cadena vacía o como null.

Cuidado con los detalles

Los números se tratan como texto siempre que es posible, de modo que un identificador largo no pierde cifras, y los valores con ceros a la izquierda, como códigos postales o teléfonos, no se convierten en números, lo que haría perder el cero. En la salida CSV, cualquier valor que contenga el separador, unas comillas o un salto de línea se entrecomilla correctamente, según la convención estándar.

Lo que no hace

CSV es plano y JSON no lo es, así que convertir un JSON con mucho anidamiento a CSV es un compromiso. No se intenta reconstruir el anidamiento original a partir de nombres de columna con puntos. Los archivos muy grandes se manejan mejor con un script o una herramienta de importación de base de datos, porque todo se procesa en la memoria de tu navegador. Para ver o limpiar antes un CSV, usa el visor de CSV.