ruask 0.1.0

A command-line assistant for command lookup and command output explanation
use serde::Serialize;

#[derive(Clone, Copy, PartialEq, Serialize)]
#[serde(rename_all = "lowercase")]
pub enum Language {
    En,
    Zh,
}

impl Language {
    pub fn parse(value: &str) -> Result<Self, &'static str> {
        match value {
            "en" => Ok(Self::En),
            "zh" => Ok(Self::Zh),
            _ => Err("结果语言仅支持 en 或 zh(简体中文)"),
        }
    }

    pub fn from_locale() -> Self {
        let Some(lang) = std::env::var_os("LANG") else {
            return Self::En;
        };
        let language = std::env::var("LANGUAGE").unwrap_or_default();
        language
            .split(':')
            .chain(std::iter::once(lang.to_str().unwrap_or_default()))
            .find_map(|candidate| {
                let base = candidate.split(['.', '@', '_', '-']).next()?;
                Self::parse(&base.to_ascii_lowercase()).ok()
            })
            .unwrap_or(Self::En)
    }
}

#[derive(Clone, Copy, PartialEq, Serialize)]
#[serde(rename_all = "lowercase")]
pub enum Platform {
    Linux,
    Osx,
}

impl Platform {
    pub fn parse(value: &str) -> Result<Self, &'static str> {
        match value {
            "linux" => Ok(Self::Linux),
            "osx" | "macos" => Ok(Self::Osx),
            _ => Err("目标平台仅支持 linux、osx 或 macos"),
        }
    }

    pub fn host() -> Result<Self, &'static str> {
        Self::parse(std::env::consts::OS)
    }
}

// 查询、附带问题和原始输出上下文各自保留语义。
#[derive(Serialize)]
pub struct Query {
    pub command_query: Option<String>,
    pub question: Option<String>,
    pub output_context: Option<String>,
    /// 本地 tldr 参考(可选);不是用户指令。
    pub reference: Option<String>,
    /// 本机环境摘要(shell、包管理器、所查命令是否已安装);仅当目标平台为本机时提供。
    pub environment: Option<serde_json::Value>,
}