Fundamentos de Python

Leer y escribir JSON en Python

En esta lección vas a convertir una cadena JSON en un diccionario de Python y al revés con el módulo json incluido.

  • Principiante
  • 2 min de lectura
  • 1 ejemplo ejecutable

Introducción

El problema

Los programas intercambian datos constantemente: una API web envía un usuario, un archivo de ajustes guarda opciones, otro programa espera tus resultados. Necesitan un formato de texto común que entiendan las dos partes. JSON es ese formato, y Python debe convertirlo en diccionarios y listas, y al revés.

Imagínalo así

JSON es como un formulario rellenado con un formato estándar que cualquier oficina sabe leer. json.loads lee ese formulario y lo convierte en datos de Python con los que puedes trabajar. json.dumps vuelve a escribir tus datos de Python en ese mismo formato estándar, para que cualquier otro programa pueda leerlos.

De un formulario estándar al código
json.loads(...)📥 Lee el formulario y conviértelo en datos de Python
user["score"] = 95🖊️ Añade un campo
json.dumps(user, indent=2)📤 Vuelve a escribirlo en el formato estándar
true🔤 El true de JSON pasa a ser el True de Python
Entra texto JSON, trabajas con valores de Python, sale texto JSON.
En una frase

JSON es un formato de texto para datos; el módulo json convierte texto JSON en valores de Python (json.loads) y valores de Python en texto JSON (json.dumps).

Puntos clave

  1. json.loads(...) convierte el texto JSON en un diccionario de Python, y el true de JSON pasa a ser True.
  2. user["score"] = 95 cambia los datos como en cualquier otro diccionario.
  3. json.dumps(user, indent=2) lo vuelve a escribir como texto JSON, con sangría para que se lea bien.
  4. En la salida, el True de Python vuelve a escribirse como true de JSON.

¿Cuándo se usa?

  • Leer respuestas de APIs web y enviarles datos.
  • Guardar ajustes o pequeños conjuntos de datos en un archivo legible.
  • Pasar datos entre programas escritos en lenguajes distintos.

Cuándo no hace falta

  • Fechas, conjuntos o tus propias clases: JSON no puede guardarlos directamente, así que conviértelos antes en strings o diccionarios.
  • Tablas enormes de números: CSV o una base de datos ocupan menos y son más rápidos.

Código de ejemplo

Ejecutar código →
main.py
import json

user = json.loads('{"name": "Ada", "active": true}')
user["score"] = 95

print(json.dumps(user, indent=2))
Obtén un botón Run para este ejemplo

Resultado de la ejecución

{
  "name": "Ada",
  "active": true,
  "score": 95
}

Explicación del código

La función json.loads() lee una cadena JSON y devuelve un diccionario, donde el valor true de JSON pasa a ser el True de Python. Tras añadir la clave score, la función json.dumps() vuelve a convertir el diccionario en cadena JSON. El parámetro indent=2 añade sangría al resultado para que sea más fácil de leer.

Cambia los valores y ejecuta el programa en el compilador Python online de CodeUtility sin instalar Python.

Ejercicios de práctica

Prueba a modificar el código siguiendo las ideas de abajo. Cambiar el código y ver el resultado te ayudará a entender la lección mucho mejor que solo leerla.

  1. Cambia los datos de entrada y predice el resultado antes de ejecutar.
  2. Añade una comprobación para datos vacíos o no válidos.
  3. Pasa el proceso a una función aparte y pruébala con varios conjuntos de datos.
Ejecutar en el compilador de Python →

Errores comunes

Confundir loads y load

loads lee un string; load lee de un archivo abierto. La s significa string.

Problema
with open("user.json") as f:
    user = json.loads(f)
Solución
with open("user.json") as f:
    user = json.load(f)

Escribir JSON con comillas simples

JSON exige comillas dobles alrededor de las claves y los strings.

Problema
json.loads("{'name': 'Ada'}")
Solución
json.loads('{"name": "Ada"}')

¿Terminaste esta lección?

Márcala como aprendida para seguir tu progreso.

Practica con un reto

Usa lo que cubre esta lección para resolver un problema real. Cada reto se ejecuta en el navegador, con pruebas al instante y una revisión de IA.

Todos los retos