How to raise an exception to debug sphinx execution

[mmcky]

It is unclear how to halt execution in sphinx extension using the standard approaches

import pdb; pdb.set_trace() is ignored -P option for sphinx-build is ignored when raise Exception is issued and print statements are clearly captured

anyone have any tips. I have read: http://www.sphinx-doc.org/en/master/man/sphinx-build.html http://www.sphinx-doc.org/en/master/devguide.html#debugging-tips

I have a problem where I would like to expose the node structure and introspect the object at a specific point in time.

[mmcky]

@FelipeMaldonado specifically I would like to inspect the node object while executing visit_only().

[mmcky]

@NickSifniotis if you had a spare minute - do you remember how you inspected the node object? while one is debugging the sphinx extension.

[mmcky]

I think we need to integrate with sphinx.util.logging but not sure how this works. I have tried setting

logger = logging.getLogger("sphinx")

and then issuing messages using logger.info(<msg>) but this doesn't work.

[mmcky]

this has been resolved. I was trying to raise an exception in an element of the document that was parsed during transform phase and therefore was already handled prior to Writer phase in Sphinx.