This is an extension for Visual Studio Code designed to improve readability of Python docstrings using the Sphinx docstring format.
The source code shown is the example from the Read the Docs Sphinx docstring format introduction.
Sphinx docstrings are compact and can easily be converted into HTML or PDF documentation using Sphinx and its Autodoc extension, but are generally harder to work with in the source code.
This extension alleviates this drawback by highlighting select Sphinx and reStructuredText directives within Python docstrings.
This extension is only compatible with the default VS Code Python extension. It is not compatible with Python for VSCode, see #6 for details.
-
Multi-word tag values (such as
:param int y:) are now permitted. This is used by Sphinx autodoc to include the argument type in a single line:def foo(x, y): """ :param int x: Argument with autodoc shorthand :param y: Argument with separate type tag :type y: int """ ...
Both variants are correct and highlighted when using this extension.
- Single character tag values (such as
:param x:) are now recognized as tags
- The value portion of a named tag (such as
:param arg:) is now selectable individually via theentity.name.tag.value.sphinxscope (#7)
- The closing colon of a Sphinx tag will now be correctly scoped as
punctuation.definition.interpreted.sphinx(#8)
- Parameters ending in numbers will now be highlighted properly (#4)
- Fixed parameters using wildcard notation (
*args,**kwargs) not being recognized as sphinx tags (#4) - Inline formatting will no longer be applied when the control characters are surrounded by whitespace (#5)
Initial release