如何防止 PlantUML 创建错误图像？

如何解决如何防止 PlantUML 创建错误图像？

当 PlantUML 控制台工具在图表中遇到语法错误时，它会生成一个带有错误回溯的图像，如下所示：

有没有办法禁用生成错误图像并可能将回溯输出到标准错误中？

---

我使用 PlantUML CLI 从多个源文件生成图像，如下所示：

$ plantuml diag1.puml diag2.puml diag3.puml

其中一些图表可能有语法错误，我需要跳过错误的。

我可以解析 stderr 并从那里获取错误的图表名称，但这是最后的手段。我相信提到的行为应该有一个本机选项。

解决方法

似乎在普通模式下不可能，但在-pipe模式下是可能的。寻求的参数是 -pipeNoStderr。

如果你在控制台以管道模式运行 PlantUML，你可以输入图表代码，在每个图表之后它会立即输出图像的二进制代码。您也可以在脚本中使用它在标准输入中输入代码并在标准输出中获得结果。

---

你应该像这样运行plantuml：

$ plantuml -pipe -pipeNoStderr -pipedelimitor ___sep___

这里：

• -pipe 表示在管道模式下启动plantuml。它将接受标准输入中的图表代码，立即处理它并以二进制格式在标准输出中返回结果；
• -pipeNoStderr 告诉 plantuml 不要渲染错误图像。相反，它将以文本格式返回错误回溯；
• -pipedelimitor 告诉 plantuml 如果您将多个图表源发送到管道中，则在图表之间添加分隔符。通过这种方式，您可以确定一幅图像的结束位置和另一幅图​​像的开始位置；
• ___sep___ 是我选择作为分隔符的字符串，它可以是您喜欢的任何内容，但足够独特。

---

管道工作流迫使我完全重写我们生成图表的工具。 Python 中的具体示例超出了这个问题的范围，但一般步骤是：

1. 收集您要呈现的所有图表源。
2. 检查每个来源是否以 @startuml 开头并以 @enduml 结尾（否则此类错误来源可能会破坏相邻图表）。
3. 将所有来源放入一个 string 变量中，并由多个换行符分隔。
4. 在管道模式下运行 Plantuml 子进程。
5. 将合并的源字符串提供给它。
6. 从标准输出获取响应并按分隔符拆分（在我的例子中为 ___sep___）
7. 在结果列表中循环并提醒用户注意以 ERROR 开头的元素，并以二进制格式保存不是的元素。

This article 有很大帮助。它有一个关于 JavaScript 的示例项目，它异步地解决了这个问题（与我不同）。