1919
2020 from _pytest .fixtures import SubRequest
2121
22+ from sphinx .application import Sphinx
23+ from sphinx .builders import Builder
24+ from sphinx .environment import BuildEnvironment
2225 from sphinx .testing .util import SphinxTestApp
2326
2427
@@ -42,7 +45,12 @@ def test_nitpicky_warning(app: SphinxTestApp) -> None:
4245 freshenv = True ,
4346)
4447def test_missing_reference (app : SphinxTestApp ) -> None :
45- def missing_reference (app_ , env_ , node_ , contnode_ ):
48+ def missing_reference (
49+ app_ : Sphinx ,
50+ env_ : BuildEnvironment ,
51+ node_ : addnodes .pending_xref ,
52+ contnode_ : nodes .Node ,
53+ ) -> nodes .inline :
4654 assert app_ is app
4755 assert env_ is app .env
4856 assert node_ ['reftarget' ] == 'io.StringIO'
@@ -65,7 +73,12 @@ def missing_reference(app_, env_, node_, contnode_):
6573 freshenv = True ,
6674)
6775def test_missing_reference_conditional_pending_xref (app : SphinxTestApp ) -> None :
68- def missing_reference (_app , _env , _node , contnode ):
76+ def missing_reference (
77+ _app : Sphinx ,
78+ _env : BuildEnvironment ,
79+ _node : addnodes .pending_xref ,
80+ contnode : nodes .Node ,
81+ ) -> nodes .Node :
6982 return contnode
7083
7184 app .warning .truncate (0 )
@@ -140,11 +153,13 @@ def translator_class(self, request: SubRequest) -> type[nodes.NodeVisitor]:
140153 class BaseCustomTranslatorClass (nodes .NodeVisitor ):
141154 """Base class for a custom translator class, orthogonal to ``SphinxTranslator``."""
142155
143- def __init__ (self , document , * _a ):
156+ def __init__ (
157+ self , document : nodes .document , _builder : Builder | None = None
158+ ) -> None :
144159 super ().__init__ (document )
145160 # ignore other arguments
146161
147- def dispatch_visit (self , node ) :
162+ def dispatch_visit (self , node : nodes . Node ) -> None :
148163 for node_class in node .__class__ .__mro__ :
149164 if method := getattr (self , f'visit_{ node_class .__name__ } ' , None ):
150165 method (node )
@@ -153,11 +168,11 @@ def dispatch_visit(self, node):
153168 logger .info ('generic visit: %r' , node .__class__ .__name__ )
154169 super ().dispatch_visit (node )
155170
156- def unknown_visit (self , node ) :
171+ def unknown_visit (self , node : nodes . Node ) -> None :
157172 logger .warning ('unknown visit: %r' , node .__class__ .__name__ )
158173 raise nodes .SkipDeparture # ignore unknown departure
159174
160- def visit_document (self , node ) :
175+ def visit_document (self , node : nodes . document ) -> None :
161176 raise nodes .SkipDeparture # ignore departure
162177
163178 def mark_node (self , node : nodes .Node ) -> NoReturn :
0 commit comments