RenderDocstring Class Reference

Inheritance diagram for RenderDocstring:

Public Member Functions
	run (self)

Public Attributes
	state

Detailed Description

Directive to Render Docstring as Docutils nodes.
This is useful as standard reStructuredText does not parse Google
Docstrings but we support it in docstrings for python functions, modules
and variables. So to show example docstrings in the documentation we don't
want to write the example in Google Docstring and keep that synchronous
with a reStructuredText version

Definition at line 61 of file basf2ext.py.

Member Function Documentation

run()

run

(

self

)

Just pass on the content to the autodoc-process-docstring event and
then parse the resulting reStructuredText.

Definition at line 76 of file basf2ext.py.

    def run(self):
        """Just pass on the content to the autodoc-process-docstring event and
        then parse the resulting reStructuredText."""
        env = self.state.document.settings.env
        content = list(self.content)
        try:
            start_index, end_index = (int(e) for e in self.options.get("lines", None).split(","))
            content = content[start_index:end_index]
        except Exception:
            pass
 
        # remove common whitespace
        content = textwrap.dedent("\n".join(content)).splitlines()
 
        env.app.emit('autodoc-process-docstring', "docstring", None, None, None, content)
        return parse_with_titles(self.state, content)
 
 

Member Data Documentation

state

state

Definition at line 91 of file basf2ext.py.

---

The documentation for this class was generated from the following file:

• site_scons/sphinx/extensions/basf2ext.py