Skip to content

fix: PNG 裁剪失败时回退到未裁剪图片 - #704

Merged
DavidLYP merged 2 commits into
OpenHUTB:masterfrom
DavidLYP:fix/plot-utils-png-fallback
Nov 16, 2026
Merged

DavidLYP merged 2 commits into
OpenHUTB:masterfrom
DavidLYP:fix/plot-utils-png-fallback

Conversation

@DavidLYP

Copy link
Copy Markdown
Contributor

问题

当前 PR Build 在 test_plot_utils_save_fallback 中稳定失败:

subprocess.CalledProcessError: Command
['convert', '...png', '-trim', '.../figure.png']
returned non-zero exit status 1

plot_utils.save_fig 的 PNG 分支使用 subprocess.check_call,裁剪命令返回非零状态时会直接抛出异常,导致后面的“保存未裁剪图片”回退逻辑无法执行。

该失败在多个 PR 的 CI 中都能复现,与具体文档改动无关。

修复

  • 将 PNG 分支改为使用可检查返回值的 subprocess.call。
  • 捕获裁剪器不存在时的 OSError,继续走回退逻辑。
  • 裁剪失败时删除可能生成的不完整输出,避免把部分结果当成成功文件。
  • 保持已有的 shutil.copy2 未裁剪图片回退和警告日志。

验证

python -m unittest tests.test_plot_utils_save_fallback -v

测试通过:Ran 1 test ... OK。

影响

  • 只修改 docs/src/python/plot_utils.py。
  • 不改变正常裁剪成功时的输出路径。
  • 修复后可以解除当前多个文档 PR 的 hooks 测试阻塞。

将 PNG 转换从 check_call 改为可检查返回值的 call;转换失败或裁剪器不可用时删除不完整输出,并走已有的未裁剪图片回退逻辑。
测试新的回退行为:裁剪命令返回非零时保存未裁剪图片,而不是抛出异常。
@DavidLYP DavidLYP mentioned this pull request Nov 16, 2026
5 tasks done
@DavidLYP
DavidLYP merged commit 93c0999 into OpenHUTB:master Nov 16, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant