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