pagetop 0.5.0

use crate::AutoDefault;

use serde::{Deserialize, Deserializer};

/// Modos disponibles para negociar el idioma de una petición HTTP.
///
/// El ajuste [`global::SETTINGS.app.lang_negotiation`](crate::global::App::lang_negotiation)
/// determina qué fuentes intervienen en la resolución del idioma efectivo utilizado por
/// [`RequestLocale`](crate::locale::RequestLocale) y en la generación de URLs mediante
/// [`Context::route()`](crate::core::component::Context::route).
#[derive(AutoDefault, Clone, Copy, Debug, Eq, PartialEq)]
pub enum LangNegotiation {
    /// Usa todas las fuentes disponibles para determinar el idioma, en este orden: comprueba el
    /// parámetro `?lang` de la URL; si no está presente o no es válido, usa la cabecera HTTP
    /// `Accept-Language`; si tampoco está disponible o no es válido, usa el idioma configurado en
    /// [`global::SETTINGS.app.language`](crate::global::App::language) o, en su defecto, el idioma
    /// de respaldo. Es el comportamiento por defecto.
    #[default]
    Full,

    /// Igual que `LangNegotiation::Full`, pero sin tener en cuenta el parámetro `?lang` de la URL.
    /// El idioma depende únicamente de la cabecera `Accept-Language` del navegador y, en última
    /// instancia, de la configuración o idioma de respaldo.
    NoQuery,

    /// Usa sólo la configuración o, en su defecto, el idioma de respaldo; ignora la cabecera
    /// `Accept-Language` y el parámetro de la URL. Este modo proporciona un comportamiento estable
    /// con idioma fijo.
    ConfigOnly,
}

impl<'de> Deserialize<'de> for LangNegotiation {
    fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>
    where
        D: Deserializer<'de>,
    {
        let raw = String::deserialize(deserializer)?;
        let result = match raw.trim().to_ascii_lowercase().as_str() {
            "full" => Self::Full,
            "noquery" => Self::NoQuery,
            "configonly" => Self::ConfigOnly,
            _ => {
                let default = Self::default();
                println!(
                    concat!(
                        "\nInvalid value \"{}\" for [app].lang_negotiation. ",
                        "Using \"{:?}\". Check settings.",
                    ),
                    raw, default,
                );
                default
            }
        };
        Ok(result)
    }
}