nats/analysis.md

name, lang, domain, description, tags, uses_functions, uses_types, framework, entry_point, dir_path, repo_url

name	lang	domain	description	tags	uses_functions	uses_types	framework	entry_point	dir_path	repo_url
nats	py	datascience	Demostracion de envio de datos por pub/sub entre procesos con NATS (core pub/sub, wildcards, queue groups, request/reply, JetStream y procesos OS reales)	nats pubsub messaging jetstream asyncio docker			jupyterlab	notebooks/01_core_pubsub.ipynb	analysis/nats

Notas

Analisis didactico de NATS como sistema de mensajeria pub/sub entre procesos. El broker corre en Docker (nats:latest -js, puerto 4222) y el cliente es nats-py (asyncio). Tres notebooks progresivos:

Notebook	Contenido
01_core_pubsub.ipynb	Modelo base: conexion, publish/subscribe, fan-out a N subscribers, wildcards * y >.
02_queue_request_jetstream.ipynb	Queue groups (reparto de carga), request/reply (RPC con inbox temporal), JetStream (stream persistente + consumer durable + replay).
03_procesos_reales.ipynb	Publisher y subscribers como procesos del SO independientes (subprocess), cada uno con su PID. Demuestra el desacople real: el publisher no conoce a sus subscribers.

Los scripts notebooks/procs/publisher.py y notebooks/procs/subscriber.py son los programas que el notebook 03 lanza como procesos reales.

Como usar

1. Requiere Docker disponible (con permisos para el usuario actual). La primera celda de cada notebook arranca el broker de forma idempotente con la funcion ensure_nats, asi que cada notebook funciona de forma aislada.
2. Lanzar Jupyter del analisis: cd analysis/nats && ./run-jupyter-lab.sh (puerto 8890).
3. Abrir cualquier notebook y ejecutar las celdas en orden.

Requisitos

• nats-py (instalado en el .venv del analisis).
• Imagen Docker nats:latest (se descarga con docker pull nats:latest la primera vez).
• El broker comparte el contenedor nats_demo entre los tres notebooks.

Parar el broker

Cuando termines, para y elimina el contenedor:

docker stop nats_demo && docker rm nats_demo

Reproducir / regenerar los notebooks

El script build_notebooks.py regenera los tres .ipynb desde cero con nbformat (sin ejecutar). La ejecucion se hace luego desde JupyterLab o via el MCP de Jupyter:

.venv/bin/python build_notebooks.py

Nota tecnica sobre el MCP de Jupyter

Si abres Claude desde la raiz de fn_registry, su MCP de Jupyter apunta al servidor global (puerto 8899, root fn_registry), no al servidor de este analisis (8890). Para usar el MCP contra este analisis con su propio .venv, abre Claude desde el directorio del analisis: cd analysis/nats && claude — el .mcp.json local enlaza el MCP al puerto 8890.