GNU/Linux命令解析器通用接口设计及多响应模式咨询

我正在为GNU/Linux命令编写解析器，现有hostnamectl的解析实现示例：

from pydantic import BaseModel

from mmiac.core.system import run_cmd
from mmiac.core.parsing import create_key


class HostnamectlResponse(BaseModel):
    static_hostname: str
    transient_hostname: str | None
    pretty_hostname: str | None
    icon_name: str | None
    chassis: str | None
    deployment: str | None
    location: str | None
    virtualization: str | None
    cpe_os_name: str | None
    operating_system: str | None
    os_support_end: str | None
    os_support_expired: str | None
    os_support_remaining: str | None
    kernel: str | None
    machine_id: str | None
    boot_id: str | None
    # 注：原代码存在重复的kernel字段，此处保留原始内容
    kernel: str | None
    hardware_vendor: str | None
    hardware_model: str | None
    firmware_version: str | None
    firmware_date: str | None


def parse() -> HostnamectlResponse:
    """Parses output from hostnamectl command.
    
    The only required field is static hostname.
    """
    content = run_cmd("hostnamectl").split("\n")
    data = {}
    for line in content:
        try:
            k, v = line.strip().split(":", 1)
        except ValueError:
            continue
        k = create_key(k)
        data[k] = v.strip()
    return HostnamectlResponse(**data)

我曾考虑将每个命令解析器实现为类，但目前认为函数即可满足需求，计划通过调度表动态加载包含parse()方法的模块并调用。核心问题在于：parse()接口统一，但ps、lspci等命令的输出结构差异极大，无法使用通用响应格式。我想了解适用于此类场景的设计模式，同时希望优化库的易用性，减少用户查阅文档的频率。

适用的设计模式 #

1. 策略模式 #

• 将每个命令的解析逻辑封装为独立的策略函数，用调度表（字典）作为策略注册表，键为命令名称，值为对应的parse()函数
• 保留统一的调用入口，但每个策略可以返回专属的Pydantic模型，通过类型提示让用户明确返回结构
• 示例调度表：COMMAND_PARSERS = {"hostnamectl": hostnamectl.parse, "ps": ps.parse}，调用时根据命令名匹配执行对应解析逻辑

2. 工厂模式 #

• 实现一个解析器工厂函数，接收命令名称作为参数，动态加载对应模块并执行解析逻辑
• 工厂层统一处理命令合法性检查、通用异常捕获等逻辑，用户只需传入命令名即可获取结构化结果，无需关注底层加载细节

3. 适配器模式 #

• 定义基础响应模型（如BaseCommandResponse），包含command、success等通用字段，每个命令的响应模型继承该基础模型并扩展专属字段
• 对于输出格式复杂的命令，在解析函数中完成原始输出到专属模型的适配，既保留统一的基础接口，又支持个性化字段

易用性优化方案 #

• 强类型提示：为每个parse()函数明确标注返回的Pydantic模型类型，IDE会自动提供字段补全和类型检查，用户无需查文档即可了解返回结构
• 内置示例与快速预览：在解析模块的docstring中添加示例输出，或提供preview()辅助函数，让用户快速查看命令的解析结果结构
• 字段按需提取：对于ps这类多字段输出，允许用户通过参数指定需要提取的字段集合，默认返回常用字段，减少信息过载
• 友好的异常提示：解析失败时返回具体错误信息（如命令未安装、输出格式异常），并给出可行的解决方案建议
• 交互式帮助：为库添加命令行交互式工具，用户可以通过list_commands查看支持的命令，通过show_schema <command>查看对应命令的返回结构

内容的提问来源于stack exchange，提问作者Franz Kafka