CLion 2021.1 Help

Python Integrated Tools

File | Settings | Tools | Python Integrated Tools for Windows and Linux
CLion | Preferences | Tools | Python Integrated Tools for macOS
Ctrl+Alt+S
Icons general settings

Use this page to configure requirements management file, default test runner, and documentation strings treatment.

ItemDescription
Default test runnerSelect the test run/debug configuration that CLion will suggest every time you choose Run on the context menu of a test case.

The possible options are:

  • Unittests

  • pytest

  • Nosetests

  • Twisted Trial

Docstring formatSelect the format of the documentation strings to be recognized by CLion.

Depending on the selected docstring format, CLion will generate the stub documentation comments and render text in the Quick Documentation:

  • Plain: on pressing Enter or Space after opening quotes, an empty stub is generated; quick documentation shows as plain text.

  • reStructuredText: on pressing Enter or Space after opening quotes, stub doc comment is generated according to reStructuredText format; the quick documentation is rendered by Docutils.

  • Epytext: on pressing Enter or Space after opening quotes, stub doc comment is generated according to the epytext format; quick documentation is rendered by epydoc.

  • NumPy: on pressing Enter or Space after opening quotes, stub doc comment is generated according to the NumPy format; the quick documentation is rendered by Napoleon and Docutils.

  • Google: on pressing Enter or Space after opening quotes, stub doc comment is generated according to Google format; the quick documentation is rendered by Napoleon and Docutils.

All types of docstrings feature:

  • Proper generation of docstrings

  • Updates after applying intention actions and quick-fixes

  • Coding assistance

  • Autocompletion for section headers

Note that the information provided in the docstrings, is used for code insight.

Py docstrings
Analyze Python code in docstringsIf this checkbox is selected, CLion highlights the code examples and performs syntax checks and code inspections.
If this checkbox is not selected, the code fragments inside docstrings are not analyzed.
Render external documentation for stdlib.Enables showing documentation for standard library functions from http://docs.python.org in View | Quick Documentation.
Sphinx working directorySpecify here the path to the directory that contains .rst files.
Treat .txt files as reStructuredTextIf this checkbox is selected, the files with .txt extension will be highlighted same way, as the files with .rst extension.
Last modified: 08 March 2021