Saltar a contenido

WSBuilder Docs

HTTP + WebSocket + ORM + cache + seguridad + proxy

Una base completa para construir servicios Python sin cargar mas de lo necesario.

WSBuilder agrupa el servidor, el router, el ORM, el cache, la observabilidad y las utilidades de red en un solo paquete. La documentacion esta organizada para que puedas ir de cero a produccion sin perderte.

Empezar Ver referencia Entender arquitectura

Mapa rapido

Punto de entrada

App

Define rutas HTTP, WebSocket, caches, seguridad, metricas, logs y tareas en background.

Persistencia

ORM SQLite

Modelos declarativos, filtros, transacciones, replicas de lectura y optimizacion SQLite.

Observabilidad

Metricas y logs

Snapshots JSON, streaming en vivo y logs NDJSON para seguimiento simple y automatizable.

Infraestructura

Proxy y DNS

Balanceo de trafico, virtual hosts, DNS local y utilidades para escenarios de borde.

Lo que vas a encontrar

Guia de inicio

Instalacion, primer servidor, docs en vivo y ejemplos listos para copiar.

Abrir guia

Arquitectura

Como entra una request, donde se aplica seguridad, cache, metricas y tareas.

Ver arquitectura

Referencia

Lista de modulos y exportaciones publicas, agrupadas por caso de uso.

Abrir referencia

Ayuda

Errores comunes, arranque local, validaciones y puntos de diagnostico rapido.

Ir a ayuda

Flujo recomendado

  1. Lee la guia de inicio y levanta un App minimo.
  2. Sigue la arquitectura para entender el flujo de request a response.
  3. Abre la referencia cuando necesites firmas, parametros o nombres exactos.
  4. Usa la ayuda para resolver problemas de instalacion, build o despliegue.

Resumen de uso

Si quieres... Lee primero
Servir HTML o JSON HTTP
Mantener conexiones persistentes WebSocket
Guardar datos localmente Persistencia
Reducir costo de respuestas Cache
Controlar acceso y rate limit Seguridad
Medir carga y eventos Observabilidad
Ejecutar trabajo en segundo plano Tareas
Proxy y balanceo Proxy
Resolver nombres localmente DNS
Entrenar modelos sencillos IA

Atajo util

Si solo quieres probar la libreria, instala el paquete en editable y arranca el demo:

python -m pip install -e .
python -m wsbuilder --host 0.0.0.0 --port 8765

Enlaces utiles