禁用隐式 CLI 标记设计¶
问题¶
Rich 默认将纯字符串渲染对象解析为标记。CLI 表格、动态标题、通知、警告以及共享输出辅助函数可能会接收到包含括号文本的路径、元数据、规则或服务消息。格式错误的结束标签会引发 MarkupError;有效标签则会意外改变呈现效果。
决策¶
使用 markup=False 构造共享的 stdout 和 stderr Rich 控制台。纯字符串始终被视为字面文本,而显式的 Rich 渲染对象(如 Text、Table 和 Panel)会保留其指定样式。
保留服务器日志面板显式的 Text 包装,以便其渲染器在被不同的 Rich 控制台使用时仍然安全。
渲染器返回普通字符串的命令(包括 search 和 find)继续使用 Python print(),不受影响。
测试¶
验证类似标记的内容能够通过两个共享控制台、表格单元格和标题以及通知输出按字面渲染。验证显式设置样式的 Text 渲染对象仍受支持。
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 mi/MinerU