You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
It would be great being able to ignore warnings like WARNING: Cannot resolve forward reference in type annotations of…
(In reference to sphinx-doc/sphinx#10219 (comment))
The reason is that some warnings are due to limited capabilities of the extension, and cannot always be resolved with reasonable effort. I would think (sarcastically), "if you can't support a feature reliably, don't implement it". Practically, I would interpret that as make such features optional or their warnings silenceable.
This is relevant because when users are flooded with hundreds of irrelevant warnings, they cannot detect and resolve relevant warnings. They can also not turn warnings into errors to enforce fixing them.
I had no success using Python's standard warnings filter mechanism (Sphinx warnings seem not accessible by it).
Inspite of extensions not being covered by default by suppress_warnings (sphinx-doc/sphinx#10219), autodoc is able to provide custom warning types autodoc, autodoc.import_object.
The text was updated successfully, but these errors were encountered:
It would be great being able to ignore warnings like
WARNING: Cannot resolve forward reference in type annotations of
…(In reference to sphinx-doc/sphinx#10219 (comment))
The reason is that some warnings are due to limited capabilities of the extension, and cannot always be resolved with reasonable effort. I would think (sarcastically), "if you can't support a feature reliably, don't implement it". Practically, I would interpret that as make such features optional or their warnings silenceable.
This is relevant because when users are flooded with hundreds of irrelevant warnings, they cannot detect and resolve relevant warnings. They can also not turn warnings into errors to enforce fixing them.
I had no success using Python's standard warnings filter mechanism (Sphinx warnings seem not accessible by it).
Inspite of extensions not being covered by default by
suppress_warnings
(sphinx-doc/sphinx#10219),autodoc
is able to provide custom warning typesautodoc
,autodoc.import_object
.The text was updated successfully, but these errors were encountered: