docs: def run(self):  # pragma: no cover
          """Called by Sphinx to generate documentation for this directive."""
          if self.directive_name is None:
              raise NotImplementedError('directive_name must be implemented by '
                                        'subclasses of BaseDirective')
          env, state = self._prepare_env()
          state.doc_names.add(env.docname)
          directive_name = '<{}>'.format(self.directive_name)
          node = nodes.section()
          node.document = self.state.document
          result = ViewList()
          for line in self._render_rst():
              if line.startswith(HEADING_TOKEN):
                  # Remove heading token, then append 2 lines, one with
                  # the heading text, and the other with the dashes to
                  # underline the heading.
                  heading = line[HEADING_TOKEN_LENGTH:]
                  result.append(heading, directive_name)
                  result.append('-' * len(heading), directive_name)
              else:
                  result.append(line, directive_name)
          nested_parse_with_titles(self.state, result, node)
          return node.children