schrodinger.infra.epydoc_to_sphinx module

Code for converting epytext docstrings so they can be used in Sphinx. This module may be used as either a Sphinx plugin to allow sphinx-build to parse epytext, or as a command line program to convert files from epytext to reST.

schrodinger.infra.epydoc_to_sphinx.setup(app)[source]

Hook up process_docstring so it can convert all docstrings. This function is called automatically by Sphinx.

Parameters

app (sphinx.Sphinx) – The currently running Sphinx instance.

schrodinger.infra.epydoc_to_sphinx.process_docstring(app, what, name, obj, options, lines)[source]

Convert the given docstring from Epytext to Sphinx reST format.

Parameters

lines (list(str)) – A list of all lines in the docstring to convert. This list will be modified in place.

All other arguments are ignored and are present only for compatibility with the autodoc-process-docstring connection.

schrodinger.infra.epydoc_to_sphinx.convert_file(filename, all_triple_quoted_strings=False)[source]

Convert the specified file from epytext to reST.

Parameters
  • filename (str) – The name of the file to convert.

  • all_triple_quoted_strings (bool) – Whether to convert all comments enclosed within triple quotes or only proper doc strings

schrodinger.infra.epydoc_to_sphinx.main()[source]