pysorex/stanza/ - Intérprete de Stanzas y construcción de Stanzas.
pysorex/xmlstream/ - Gestión del tráfico XML de entrada y salida tras recibirse de network.
pysorex/auth/ - Métodos de autentificación.
pysorex/auth/plugins/ - Plugins a los métodos de autentificación.
pysorex/db/ - Bases de datos.
pysorex/db/wrappers/ - Wrappers de las bases de datos.
pysorex/plugins/ - Extensiones XEP y funcionalidades añadidas no estándar.
pysorex/test/ - Batería de tests.
pysorex/xmpp/ - Elementos comunes de s2c y s2s del RFC.
pysorex/xmpp/s2s/ - Comunicación servidor a servidor perteneciente al RFC.
pysorex/xmpp/s2c/ - Comunicación servidor a cliente perteneciente al RFC.
pysorex/exceptions.py - Excepciones posibles.
pysorex/testall.py - Iniciar batería de tests.
Directorios y archivos de almacenamiento
/var/log/pysorex.log - Logs del servidor.
/etc/pysorex/ - Directorio de configuración y datos.
/etc/pysorex/plugins/ - Directorio de datos y configuración de los plugins.
/etc/pysorex/db/ - Directorio de bases de datos.
/etc/pysorex/pysorex.cfg - Archivo de configuración.
Hilos de ejecución
Un hilo de entrada de Stanzas
Un hilo de salida de Stanzas
Un número variable de hilos para el procesado de las stanzas
Un hilo para la base de datos
Un hilo para la cola de clientes y servidores conectados
Hilo principal a la espera de que se de la orden de cierre del servidor
Almacenamiento de datos
Los tipos de datos que se almacenan pueden diferenciarse en:
Configuraciones generales del servidor
Datos de plugins, usuarios, etc.
El primero, para facilitar su edición manual, se haría con configpaser. El segundo, consistiría en bases de datos creados y mantenidos por el wrapper de la base de datos. El primero contendría datos para el funcionamiento del servidor, tales como el puerto, dominio, tipo de base de datos a usar... Y el segundo, datos de los usuarios, mensajes pendientes por entregar, etc. Opcionalmente, los plugins pueden gestionar datos con métodos propios, como almacenar logs de las conversaciones de las salas en XML.
Procesamiento de entrada de datos
Un cliente o servidor establece envía una Stanza.
Se solicita al hilo de gestión de conexiones de usuarios y servidores activo, el objeto Connection para la conexión.
Si no hay un objeto Connnection para la conexión (es una nueva conexión), se crea.
La Stanza entra en la lista de stanzas a procesar (hilo main).
Se parsea la Stanza. Si la stanza no cumple los estándares xml, se desecha.
Si el objeto Connection tiene como propiedad que el servidor o cliente no está autentificado, se interpreta la Stanza mediante el plugin correspondiente de auth.
Si el cliente o servidor está autentificado, se continua en los siguientes pasos.
se comprueba que la stanza es válido (el from es correcto).
Se crea un objeto Stanza de la stanza parseado. El objeto stanza añade funcionalidades como agregar un callback, responder al remitente devolviendo la stanza, añadir errores, etc.
Mediante eventos xpath, se comprueba qué XEPs? y partes del Core (pysorex/xmpp) tienen como evento el susodicho Stanza.
La Stanza es devuelto junto con el objeto Connection como evento.
Opcionalmente, la función que recibe el evento, puede hacer ejecutar un nuevo evento. Por ejemplo, una función que recibe los stanzas de los mensajes, puede enviar el callback "message" para los XEPs? y otros plugins que necesitan recibir los mensajes. La Stanza entonces, vendría en un objeto Message que es heredado de Stanza, que agrega nuevas funcionalidades al objeto Stanza específicas para los mensajes.
Procesamiento de salida de datos
Si la stanza es un objeto Stanza o un elemento Element construido mediante ElementTree? o Lxml, se crea el string del árbol XML.
Se añade el xml a la cola junto con el objeto Connection y el callback que se ejecutará tras enviarse la stanza.
Si al enviar la stanza la conexión del Connection se ha roto (el cliente o servidor se ha desconectado), en el callback se pondrá como argumento que la entrega falló o el mensaje fue almacenado para ser entregado para más tarde. Si el cliente no pertenece al servidor, deberá ser este es que notifique del error. Si es el servidor remoto el que está desconectado, el mensaje se desecha y la entrega fallará.
