Tipos y utilidades de soporte

Descripción general

orionis.support es la capa compartida de utilidades de Orionis. Contiene las fachadas para acceder a servicios del framework, tipos auxiliares orientados a valores, serialización de entidades, estructuras inmutables, metaclases reutilizables, formateo de excepciones, medición de tiempo, dimensionamiento de workers y el proveedor integrado de citas inspiradoras.

El paquete tiene deliberadamente dos niveles de API. orionis.support.facades y orionis.support.types ofrecen importaciones seleccionadas; los auxiliares de menor nivel se importan desde sus módulos de definición. El paquete raíz orionis.support no reexporta estos objetos.

Requisitos

• Python 3.14 o posterior.
• El runtime de Orionis y sus dependencias declaradas. Este módulo usa directamente pendulum, dotty-dict y psutil.
• Una aplicación Orionis inicializada antes de invocar fachadas respaldadas por servicios. DateTime es una clase autónoma y no requiere el contenedor para las operaciones de fecha normales.

Recorrido del módulo

• Transformar colecciones y cadenas
• Entidades y estructuras de datos
• Facades, fechas y utilidades del runtime

Continúa por: container · schemas.

Elegir una utilidad según la tarea

Tarea de la aplicación	Punto de partida
Transformar una lista ya cargada	Collection, desde orionis.support.types.
Normalizar texto o crear un slug	Stringable, desde orionis.support.types.
Serializar un resultado con campos conocidos	Una dataclass que herede de BaseEntity.
Trabajar con fechas y zonas horarias	DateTime, desde orionis.support.facades; las operaciones habituales no requieren contenedor.
Invocar un servicio configurado del framework	Su fachada después del arranque, o su contrato mediante inyección de dependencias.

Son utilidades Python que puedes importar en tu aplicación; no crean tablas SQL ni validan una petición automáticamente. Usa schemas para la entrada externa y el contenedor para las dependencias de servicios.