✨ (pagetop): Añade subida y descarga de archivos

- `web::Upload` guarda los archivos de un envío multipart en disco por
  trozos, con nombre aleatorio, extensiones y tamaño máximo por archivo.
  `receive()` deserializa además los campos de texto con serde_qs.
- `web::Download` sirve un archivo subido con rangos y peticiones
  condicionales, inline sólo para tipos pasivos y con nosniff.
- `form::File`, componente para elegir archivos, y soporte en Bootsier.
- Límite del cuerpo según el tipo de contenido: `server.max_body_size`
  baja a 2 MiB y el nuevo `upload.max_request_size` (32 MiB) se aplica
  sólo a multipart/form-data.
This commit is contained in:
Manuel Cillero 2026-10-31 15:28:58 +01:00
parent 5540c0c6a0
commit f3228d6b59
21 changed files with 2240 additions and 17 deletions

View file

@ -2,9 +2,11 @@
//!
//! Define rutas y handlers: el [`Router`], las operaciones HTTP ([`get`], [`post`], [`put`],
//! [`delete`], [`patch`]), los extractores ([`Path`], [`Query`], [`Form`], [`RawForm`],
//! [`Request`]) e [`IntoResponse`], el módulo [`middleware`] para *middlewares* de función, y
//! re-exporta el módulo `http` para tipos de bajo nivel como `StatusCode`, `HeaderName` o `Method`.
//! También ofrece utilidades para servir archivos estáticos, [`ServeDir`] y [`ServeEmbedded`].
//! [`Multipart`], [`Request`]) e [`IntoResponse`], el módulo [`middleware`] para *middlewares* de
//! función, y re-exporta el módulo `http` para tipos de bajo nivel como `StatusCode`, `HeaderName`
//! o `Method`. También ofrece utilidades para servir archivos estáticos, [`ServeDir`] y
//! [`ServeEmbedded`], para recibir y guardar los archivos subidos en formularios, [`Upload`], y
//! para servirlos después con control de acceso, [`Download`].
//!
//! Los handlers son las funciones asíncronas que el servidor invoca al recibir una petición HTTP en
//! una ruta concreta.
@ -18,7 +20,10 @@ pub use axum::http;
pub use axum::Router;
// Extractores de petición.
pub use axum::extract::{Form, Path, Query, RawForm, Request};
pub use axum::extract::{Form, Multipart, Path, Query, RawForm, Request};
// Partes y errores del extractor `Multipart`.
pub use axum::extract::multipart;
// Para implementar respuestas.
pub use axum::response::{IntoResponse, Response};
@ -29,6 +34,14 @@ pub use axum::routing::{delete, get, patch, post, put};
// Middlewares de función (`from_fn`) y tipos asociados (`Next`).
pub use axum::middleware;
// Guardado de los archivos subidos en formularios `multipart/form-data`.
mod upload;
pub use upload::{Upload, UploadError, UploadedFile, UploadedForm};
// Respuestas con los archivos subidos.
mod download;
pub use download::Download;
use axum::body::Body;
use axum::extract::FromRequestParts;
@ -505,6 +518,15 @@ pub mod test {
self.header("content-type", "application/x-www-form-urlencoded")
}
/// Envía como cuerpo de la petición el texto indicado, tal cual.
///
/// Combinado con [`header()`](Self::header) para fijar `Content-Type`, permite probar
/// cuerpos con otros formatos, como los formularios `multipart/form-data` con archivos.
pub fn body(mut self, body: impl Into<String>) -> Self {
self.body = body.into();
self
}
/// Inserta un valor en las extensiones de la petición.
///
/// Útil para simular lo que un middleware haría en producción antes de que el handler