AutoDocstring
Insert or update python docstrings; an improved docblockr for python
Details
Installs
- Total 18K
- Win 7K
- Mac 6K
- Linux 6K
Mar 31 | Mar 30 | Mar 29 | Mar 28 | Mar 27 | Mar 26 | Mar 25 | Mar 24 | Mar 23 | Mar 22 | Mar 21 | Mar 20 | Mar 19 | Mar 18 | Mar 17 | Mar 16 | Mar 15 | Mar 14 | Mar 13 | Mar 12 | Mar 11 | Mar 10 | Mar 9 | Mar 8 | Mar 7 | Mar 6 | Mar 5 | Mar 4 | Mar 3 | Mar 2 | Mar 1 | Feb 28 | Feb 27 | Feb 26 | Feb 25 | Feb 24 | Feb 23 | Feb 22 | Feb 21 | Feb 20 | Feb 19 | Feb 18 | Feb 17 | Feb 16 | Feb 15 | Feb 14 | |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Windows | 0 | 0 | 0 | 1 | 1 | 0 | 3 | 1 | 0 | 0 | 1 | 1 | 0 | 2 | 1 | 1 | 1 | 1 | 2 | 0 | 1 | 1 | 0 | 0 | 0 | 3 | 1 | 0 | 1 | 1 | 1 | 1 | 1 | 0 | 0 | 1 | 0 | 0 | 0 | 1 | 0 | 0 | 1 | 0 | 0 | 2 |
Mac | 0 | 0 | 1 | 0 | 1 | 0 | 1 | 0 | 0 | 0 | 0 | 1 | 1 | 0 | 1 | 0 | 0 | 1 | 0 | 0 | 1 | 0 | 0 | 0 | 0 | 0 | 1 | 0 | 2 | 0 | 0 | 1 | 0 | 0 | 1 | 1 | 1 | 0 | 0 | 0 | 1 | 1 | 1 | 0 | 0 | 0 |
Linux | 0 | 0 | 1 | 1 | 0 | 1 | 0 | 0 | 0 | 1 | 0 | 0 | 0 | 0 | 1 | 0 | 1 | 2 | 3 | 2 | 0 | 0 | 1 | 0 | 0 | 0 | 0 | 2 | 1 | 0 | 1 | 0 | 2 | 1 | 0 | 1 | 4 | 0 | 1 | 0 | 0 | 1 | 0 | 0 | 0 | 1 |
Readme
- Source
- raw.githubusercontent.com
SublimeAutoDocstring
SublimeText plugin for inserting / updating docstrings in Python after analyzing function parameters and the like.
Features
- Inspects function definitions and inserts a stub for each parameter
- Inspects class / module attributes and inserts a stub for each
- Convert single docstrings or whole modules from one style to another with one command
- Pull parameter and return type information from Python 3 annotations
- Discovers what exceptions are raised in a function and inserts a stub for each
- Rearranges parameters to reflect their order in the function definition
- Automatically detects style: Google or Numpy
Installation
This plugin is indexed on Package Control. Once Package Control is installed, this package can be installed from the command palette using Package Control: Install Package
.
Alternatively, you can unzip this repository into your Packages
directory. This directory is easily opened using the Sublime Text > Preferences > Browse Packages...
menu on MacOS, or Preferences > Browse Packages...
on Linux / Windows.
Usage
Use these keyboard shortcuts, or the commands below from the Command Pallete.
- <
cmd
+alt
+'
> will update a docstring for the first module/class/function preceding the cursor. - <
cmd
+alt
+shift
+'
> will update docstrings for every class/method/function in the current file
Note that on linux / windows, ctrl
is used in place of cmd
.
Commands
AutoDocstring: Current
: Create or update the docstring for the next declaration that preceeds the cursorAutoDocstring: All
: Create or update docstrings for all declarations in a moduleAutoDocstring: Convert...
: Convert the docstring of the the next declaration that preceeds the cursor to a specific styleAutoDocstring: Convert All...
: Convert all existing docstrings in a module to a specific style
Settings
A shortcut to open the settings file is in menu under Preferences/Package Settings/AutoDocstring/Settings - User
. Settings can also be in a JSON hash (dictionary) called “AutoDocstring” in a project-settings file. Project settings will override package settings.
default_description
(default=“Description”): Filler text for descriptionsdefault_return_name
(default=“name”): Numpy style only. Default parameter name for return values. Set as an empty string to leave return values unnamed.default_summary
(default=“Summary”): Filler text for summarydefault_type
(default=“TYPE”): Filler text for typedefault_qstyle
(default=“”“): Type of quote to use for new docstrings.inspect_class_attributes
(default=true): add / remove class attributes to stay in sync with the codeinspect_exceptions
(default=true): add / remove exceptions to stay in sync with the code.inspect_function_parameters
(default=true): add / remove function parameters to stay in sync with the code.inspect_module_attributes
(default=true): add / remove module attributes to stay in sync with the code.optional_tag
(default="optional”): text to add to the type of keyword arguments. Supplying an empty string won't add anything special to new keyword arguments.sort_class_attributes
(default=true): Whether or not to alphabetically sort class attributes.sort_exceptions
(default=true): Whether or not to alphabetically sort exceptions.sort_module_attributes
(default=true): Whether or not to alphabetically sort module attributes.style
(default=“auto_google”): can be “google”, “numpy”, or “auto” for auto-detection based on the other docstrings in the module. A fallback can be specified with something like “auto_google” in case auto-detection fails.template_order
(default=false): If true, then reorder sections to the same order that they appear in the style's template. If false, section order of existings docstrings is preserved.use_snippet
(default=true): If true, then insert a snippet so that you can tab through newly inserted fields (Summary / Types / Desciptions).start_with_newline
(default=“”): Comma separated list of styles ('numpy', 'google') for which you want new docstrings to start with a newline. Can also be true or false to affect all styles.extra_class_newlines
default=true: According to PEP257, docstrings for classes should be surrounded by extra blank lines. Set this to false for more compact, but less PEP257 compliant class docstrings.keep_previous
(default=false): If true, then always append the existing docstring to the newly updated docstring. Could be useful for processing legacy code.