当前位置：首页 > news >正文

【typst-rs】info.rs文件

news 2026/6/6 22:24:47

Typst Info 命令代码解析

这段代码是 Typst 编译器typst info命令的实现，用于显示 Typst 环境信息，包括版本、构建配置、运行时特性、字体配置、包配置和相关环境变量。

主要数据结构

Info 结构体

structInfo{version:&'staticstr,// Typst 版本build:Build,// 构建信息features:Features,// 运行时特性fonts:Fonts,// 字体配置packages:Packages,// 包配置env:Environment,// 环境变量}

Build 结构体

structBuild{commit:Option<&'staticstr>,// Git commit hashplatform:Platform,// 目标平台settings:Settings,// 编译时设置}

Platform 结构体

structPlatform{os:&'staticstr,// 操作系统 (如 "linux", "windows", "macos")arch:&'staticstr,// 架构 (如 "x86_64", "aarch64")}

Settings 结构体

structSettings{self_update:bool,// 是否启用 self-update 功能http_server:bool,// 是否启用 http-server 功能}

核心函数

info 函数

主入口函数，处理typst info命令：

pubfninfo(command:&InfoCommand)->StrResult<()>{// 1. 获取环境变量letenv=get_vars()?;// 2. 解析运行时特性letruntime_features=parse_features(...)?;// 3. 解析字体路径letfont_paths=env.typst_font_paths.split(':').filter(|s|!s.is_empty()).map(PathBuf::from).collect();// 4. 构建 Info 结构体letvalue=Info{...};// 5. 输出信息ifletSome(format)=command.format{// 机器可读格式 (JSON/YAML)println!("{serialized}");}else{// 人类可读格式format_human_readable(&value)?;}}

get_vars 函数

收集所有相关的环境变量：

fnget_vars()->StrResult<Environment>{fnget_var(key:&'staticstr)->StrResult<Option<String>>{matchstd::env::var(key){Ok(val)=>Ok(Some(val)),Err(VarError::NotPresent)=>Ok(None),Err(VarError::NotUnicode(_))=>{// 处理非 UTF-8 变量值crate::print_error(...)?;Ok(None)}}}Ok(Environment{typst_cert:get_var("TYPST_CERT")?,typst_features:get_var("TYPST_FEATURES")?,// ... 其他变量})}

parse_features 函数

解析运行时特性字符串（逗号分隔）：

fnparse_features(feature_list:&str)->StrResult<Features>{letmutfeatures=Features::default();forfeatureinfeature_list.split(',').filter(|s|!s.is_empty()){matchFeature::from_str(feature,true){Ok(Feature::Html)=>features.html=true,Ok(Feature::Bundle)=>features.bundle=true,Ok(Feature::A11yExtras)=>features.a11y_extras=true,Err(_)=>crate::print_error(...)?,}}Ok(features)}

格式化输出

人类可读格式

使用彩色终端输出：

fnformat_human_readable(value:&Info)->io::Result<()>{letmutout=terminal::out();// 版本信息（带颜色）write_key(&mutout,"Version",None)?;write_value_simple(&mutout,value.version,None)?;// 构建设置writeln!(out,"Build settings")?;forfeatureinvalue.build.settings.compile_features(){feature.format(&mutout,key_pad,Some(3))?;}// ... 其他部分}

颜色方案

键名: 青色 (Cyan)
普通值: 绿色 (Green)
特殊值(如<unset>,on,off): 蓝色 (Blue)

收集的环境变量

Typst 专用变量

TYPST_CERT- TLS 证书
TYPST_FEATURES- 运行时特性
TYPST_FONT_PATHS- 自定义字体路径（冒号分隔）
TYPST_IGNORE_SYSTEM_FONTS- 忽略系统字体
TYPST_IGNORE_EMBEDDED_FONTS- 忽略嵌入字体
TYPST_PACKAGE_PATH- 包路径
TYPST_PACKAGE_CACHE_PATH- 包缓存路径
TYPST_ROOT- Typst 根目录
TYPST_UPDATE_BACKUP_PATH- 更新备份路径

标准环境变量

SOURCE_DATE_EPOCH- 可重现构建时间戳
NO_COLOR- 禁用彩色输出
HTTP_PROXY/HTTPS_PROXY/ALL_PROXY- 代理设置
NO_PROXY- 代理排除列表

Linux/Unix 专用变量

XDG_CACHE_HOME- XDG 缓存目录
XDG_DATA_HOME- XDG 数据目录
FONTCONFIG_FILE- Fontconfig 配置
OPENSSL_CONF- OpenSSL 配置

输出示例

人类可读格式

Version 0.1.0 (abc1234, linux on x86_64) Build settings self-update on (Update Typst via `typst update`) http-server off (Serve HTML via `typst watch`) Features html off (Experimental HTML export) bundle off (Experimental bundle export) a11y-extras off (Experimental accessibility additions) Fonts Custom font paths - /usr/share/fonts - ~/.local/share/fonts System fonts on Embedded fonts off Packages Package path /home/user/.local/share/typst/packages Package cache path /home/user/.cache/typst/packages Environment variables TYPST_FEATURES html,bundle TYPST_FONT_PATHS /usr/share/fonts:/usr/local/share/fonts NO_COLOR <unset>

JSON 格式

{"version":"0.1.0","build":{"commit":"abc1234","platform":{"os":"linux","arch":"x86_64"},"settings":{"self-update":true,"http-server":false}},"features":{"html":false,"bundle":false,"a11y-extras":false}}