HTTP: de la ruta a la respuesta

La capa HTTP de Orionis ofrece una API común sobre ASGI y RSGI. El mismo controlador puede recibir una solicitud normalizada, validar datos y devolver una respuesta JSON, HTML, archivo, stream o SSE. Las conexiones WebSocket utilizan una API separada sobre el mismo sistema de rutas.

Necesitas Python 3.14+, las dependencias declaradas del framework y una aplicación inicializada para utilizar facades y servicios del contenedor. Los ejemplos de funciones son código de aplicación: se ejecutan cuando el kernel atiende una petición. Los ejemplos que solo construyen respuestas pueden utilizarse sin arrancar un servidor.

Crea primero un proyecto Orionis siguiendo instalación. Las rutas de archivo siguientes parten de tu aplicación, no del paquete instalado del framework. Las declaraciones de rutas se ejecutan al iniciar la aplicación; los handlers se ejecutan cuando una petición coincide con su ruta.

Comprueba la llamada existente app.withRouting(...) en bootstrap/app.py: debe registrar los archivos que uses, normalmente web="routes/web.py" y api="routes/api.py". Crear un archivo de rutas sin registrarlo no publica sus endpoints. Conserva los argumentos existentes al añadir otro archivo.

Recorrido recomendado

1. Ciclo de petición y controladores: servicios, scopes y ejecución asíncrona.
2. Rutas, parámetros y grupos: diseña una API y organiza acceso.
3. Entrada y validación: lee metadatos y cuerpos correctamente.
4. Formularios y archivos: entradas repetidas y recursos temporales.
5. Respuestas y cookies: JSON, vistas, redirecciones y descargas.
6. Streaming y SSE: entrega progresiva y limpieza.
7. WebSocket: conexión, mensajes y middleware.
8. Middleware y seguridad: CSRF, CORS, proxies y límites.
9. Páginas y rutas predeterminadas: salud, errores y autenticación opcional.

Continúa con sesiones, autenticación, schemas, vistas y hubs Realtime.