Protocolo JSON con el juez
Tema: Interactivos · Catálogo de recetas · temario: Syllabus IOAI
📍 Dónde se aprende: módulo 22 de la Ruta de Aprendizaje.
Qué hace
El esqueleto de una tarea interactiva: leer un mensaje JSON por línea, responder otro, y depurar sin romper nada.
Cuándo usarla
En toda tarea con juez en vivo: Potato (2026) y Concepts (2025).
Implementación
Necesita: solo la biblioteca estándar.
import json
import sys
def depurar(*args):
"""Los mensajes de depuración van a stderr. SIEMPRE.
En una tarea interactiva `stdout` es el canal por el que hablas con el juez:
cualquier print ahí se lee como un mensaje del protocolo y te rompe la
partida. El enunciado de Potato (IOAI 2026) lo advierte en negrita.
"""
print(*args, file=sys.stderr, flush=True)
def responder(mensaje, salida=sys.stdout):
"""Manda un mensaje JSON al juez, en una línea y con flush."""
salida.write(json.dumps(mensaje) + "\n")
salida.flush()
def jugar(estrategia, entrada=sys.stdin, salida=sys.stdout):
"""Bucle de protocolo línea a línea: lee un JSON, responde otro.
`estrategia(mensaje)` devuelve el diccionario a enviar, o None para terminar
la partida. Cada línea de la entrada es un objeto JSON completo.
"""
for linea in entrada:
linea = linea.strip()
if not linea:
continue
mensaje = json.loads(linea)
respuesta = estrategia(mensaje)
if respuesta is None:
break
responder(respuesta, salida)⚠️ Notas
stdout es el canal del protocolo. Un print() de depuración ahí adentro se lee como un mensaje al juez y te descalifica la partida — por eso depurar() escribe a stderr. El enunciado de Potato lo advierte en negrita.
El flush no es paranoia: sin él Python puede dejar tu respuesta en el buffer mientras el juez espera, y la partida se cuelga hasta agotar el tiempo.
🔗 Relacionadas
Verificada
Este código se ejecuta en cada publicación, contra una referencia obviamente correcta, en
herramientas/pruebas/basicas.py. Si se rompe, el sitio no se actualiza.
Las otras puertas del vault: Ruta de Aprendizaje · Referencia · IOAI