Skip to content

Expose graphviz stderr from successful renders#14438

Open
Mirochill wants to merge 1 commit into
sphinx-doc:masterfrom
Mirochill:fix-14362-graphviz-stderr
Open

Expose graphviz stderr from successful renders#14438
Mirochill wants to merge 1 commit into
sphinx-doc:masterfrom
Mirochill:fix-14362-graphviz-stderr

Conversation

@Mirochill
Copy link
Copy Markdown

@Mirochill Mirochill commented May 18, 2026

Purpose

Surface Graphviz diagnostics that are currently lost when dot exits successfully but writes warnings to stderr.

This keeps successful renders successful, but forwards the captured stderr through Sphinx's warning channel so users can see messages such as unsupported-style warnings instead of having them silently discarded.

The change also adds a focused regression test for the successful-render-with-stderr path. While exercising the new behavior in Sphinx's own docs build, it exposed stale p1 port references in the bundled build-flow diagram; those invalid references are removed so the diagram remains warning-clean under Graphviz.

References

Validation

  • Not run locally
  • relying on the repository's GitHub Actions / Read the Docs checks for remote validation

@Mirochill Mirochill force-pushed the fix-14362-graphviz-stderr branch from e738d88 to 506414d Compare May 18, 2026 16:12
@Mirochill Mirochill marked this pull request as ready for review May 18, 2026 16:20
@jdillard jdillard added the extensions:graphviz The `sphinx.ext.graphviz` or `sphinx.ext.inheritance_diagram` extensions label May 21, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

extensions:graphviz The `sphinx.ext.graphviz` or `sphinx.ext.inheritance_diagram` extensions

Projects

None yet

Development

Successfully merging this pull request may close these issues.

graphviz warnings are silently discarded

2 participants