[petercorke]

Summary

sphinx-pyrunblock prints !! [RUNBLOCK-ERROR] for a docstring example that raises, but the docs build still succeeds, so the tracebacks were being published. This fixes the examples that are example or signature mistakes:

• Blobs.vc: blobs.v → blobs.vc
• Image.array_as: array_int() → array_as()
• Image.A: build a new Image instead of assigning to the now read-only .A
• Image.fiducial: tags.png is not shipped; use apriltag12.png with '36h11'
• Image.showwindow: ax now defaults to None (the current axes), as the inner Window class and the documented examples already assumed. This is a small API fix, not just a docs fix. Also fixed the runblock, removed a duplicate .. plot:: block that used an undefined window, and corrected Window.move's return annotation. Adds tests/test_image_showwindow.py (3 tests; showwindow was untested).
• ImageTensor.Tensor and docs/source/tensor.rst: PyTorch is optional and not installed in the docs build, so these are now non-executed code-block:: pycon blocks.
• Blobs.plot_labelbox: the .. plot:: source had its statements on one line (a SyntaxError that the plot directive reports only as a warning); also removes a leftover debugging print(options).

Related issue

Refs #159 (not Fixes: the checklist there is not finished, see below).

Not in this PR

• Image.draw_point still fails in the docs build on OpenCV; that is a library bug, fixed separately in the PR for Image.draw_* fail on images from Image.Read: pixel data is not C-contiguous (cv2 line/circle/putText layout error) #158.
• pycon_fail_on_error is not enabled here. It should be turned on once both PRs are merged and the build shows no RUNBLOCK-ERROR lines, so these can't regress silently.

Verification

Local sphinx-build -b html docs/source docs/build/html in a clean venv (Sphinx 9.1.0, sphinx-pyrunblock 1.2.0, OpenCV 5.0.0.93), compared with main at 77a3da9c: RUNBLOCK-ERROR lines 19 → 2 (both draw_point), ordinary warnings 111 → 109. Each fixed example was also run directly. pytest tests: 986 passed, 96 skipped. The combined effect with the #158 fix has not been built together.

Checklist

• PR title follows Conventional Commits
• Tests pass locally (pytest)
• Added tests for the changed showwindow signature
• Docstrings updated; no new typed signatures other than -> np.ndarray | None on Window.move

🤖 Generated with Claude Code

[codacy-production]

Up to standards ✅

🟢 Issues 0 issues

Results:
0 new issues

View in Codacy

🟢 Metrics 7 complexity · 0 duplication

Metric	Results
Complexity	7
Duplication	0

View in Codacy

_{NEW Get contextual insights on your PRs based on Codacy's metrics, along with PR and Jira context, without leaving GitHub. Enable AI reviewer
TIP This summary will be updated as you push new changes.}