✨ (mail): Añade cola de envío persistente
Nueva feature `queue`, con `pagetop-seaorm` y `pagetop-cron`: los correos se guardan ya compuestos en la tabla `mail_queue` y el trabajo `mail.queue` los envía por lotes, con reintentos de espera creciente y reserva por fila para varias instancias (entrega «al menos una vez»). - `Email::queue()` sólo guarda el correo; `send_later()` lo guarda y lo intenta enseguida, o lo deja para el lote si hay demasiados en espera. - SMTP con el transporte síncrono de `lettre` en `spawn_blocking`, con `timeout_secs` en cada lectura y escritura del socket. - Turnos de envío y límites configurables para todos los transportes: envíos simultáneos, correos en espera, tiempo máximo de entrega y espera máxima entre intentos, validados al arrancar. - Nuevos errores `Timeout`, `Overloaded`, `Interrupted`, `OutOfRange` y `Queue`; `MailError` pasa a ser `#[non_exhaustive]`.
This commit is contained in:
parent
86d9f0e213
commit
4c8eee3585
18 changed files with 1488 additions and 60 deletions
|
|
@ -26,6 +26,11 @@
|
|||
//!
|
||||
//! Las pruebas de un mismo binario se ejecutan en paralelo y comparten estos correos: con
|
||||
//! [`take_to()`] cada prueba recoge sólo los de sus destinatarios, sin llevarse los de otras.
|
||||
//!
|
||||
//! Con la *feature* `queue`, los correos de `Email::queue()` sólo llegan aquí cuando se ejecuta el
|
||||
//! trabajo que vacía la cola. En las pruebas no se ejecuta solo: hay que lanzarlo con
|
||||
//! `pagetop_cron::run_now("mail.queue")`. Los de [`Email::send_later()`] no esperan al trabajo,
|
||||
//! pero llegan en segundo plano, como sin la cola.
|
||||
|
||||
use pagetop::prelude::*;
|
||||
|
||||
|
|
@ -85,3 +90,24 @@ pub(crate) fn push(email: Email, envelope_to: Vec<String>, raw: Vec<u8>) {
|
|||
fn lock() -> MutexGuard<'static, Vec<SentEmail>> {
|
||||
OUTBOX.lock().unwrap_or_else(PoisonError::into_inner)
|
||||
}
|
||||
|
||||
// Correos completos de la cola de envío pendientes de entregar con este transporte, por su
|
||||
// identificador en la cola. La cola sólo guarda el mensaje compuesto, y las pruebas necesitan el
|
||||
// correo completo para consultarlo con `SentEmail::email()`.
|
||||
#[cfg(feature = "queue")]
|
||||
static QUEUED: Mutex<Vec<(i32, Email)>> = Mutex::new(Vec::new());
|
||||
|
||||
#[cfg(feature = "queue")]
|
||||
pub(crate) fn hold(id: i32, email: Email) {
|
||||
QUEUED
|
||||
.lock()
|
||||
.unwrap_or_else(PoisonError::into_inner)
|
||||
.push((id, email));
|
||||
}
|
||||
|
||||
#[cfg(feature = "queue")]
|
||||
pub(crate) fn release(id: i32) -> Option<Email> {
|
||||
let mut queued = QUEUED.lock().unwrap_or_else(PoisonError::into_inner);
|
||||
let index = queued.iter().position(|(queued_id, _)| *queued_id == id)?;
|
||||
Some(queued.swap_remove(index).1)
|
||||
}
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue