Improve event listener names

Author: felix-hilden

src/sphinx_codeautolink/__init__.py

@@ -23,9 +23,9 @@ def setup(app: Sphinx):
     app.add_directive('implicit-import', ImplicitImport)
     app.add_directive('autolink-skip', AutoLinkSkip)
 
-    app.connect('builder-inited', state.builder_inited)
-    app.connect('doctree-read', state.doctree_read)
-    app.connect('doctree-resolved', state.doctree_resolved)
-    app.connect('build-finished', state.build_finished)
+    app.connect('builder-inited', state.read_references)
+    app.connect('doctree-read', state.parse_blocks)
+    app.connect('doctree-resolved', state.generate_backref_tables)
+    app.connect('build-finished', state.apply_links)
     app.connect('autodoc-process-docstring', state.autodoc_process_docstring)
     return {'version': __version__}

src/sphinx_codeautolink/extension/__init__.py

@@ -33,7 +33,7 @@ def flat_refs(self):
 
         return self._flat_refs
 
-    def builder_inited(self, app):
+    def read_references(self, app):
         """Nullify extension if not on HTML builder, read ref file."""
         if app.builder.name != 'html':
             self.do_nothing = True
@@ -55,7 +55,7 @@ def builder_inited(self, app):
                 for obj, examples in ref.items()
             }
 
-    def doctree_read(self, app, doctree):
+    def parse_blocks(self, app, doctree):
         """Parse code blocks for later link substitution."""
         if self.do_nothing:
             return
@@ -69,16 +69,16 @@ def doctree_read(self, app, doctree):
         self.code_refs[visitor.current_document] = visitor.code_refs
         self.block_visitors.append(visitor)
 
-    def doctree_resolved(self, app, doctree, docname):
-        """Replace deferred code reference directives."""
+    def generate_backref_tables(self, app, doctree, docname):
+        """Generate backreference tables."""
         visitor = CodeRefsVisitor(
             doctree,
             code_refs=self.flat_refs,
             remove_directives=self.do_nothing,
         )
         doctree.walk(visitor)
 
-    def build_finished(self, app, exception):
+    def apply_links(self, app, exception):
         """Apply links to HTML output and write refs file."""
         if self.do_nothing or exception is not None:
             return