PyCharm 2.7.2 Web Help

File | Settings | IDE Settings | Editor - Smart Keys

settings

PyCharm | Preferences | IDE Settings | Editor - Smart Keys

settings

Use this page to enable or disable specific smart keys and to define which actions you want to be invoked automatically.

ItemDescription
HomeWhen this check box is selected, on pressing HomeHome, the caret is positioned at the first non-space character of the current line. Pressing HomeHome subsequently moves the caret from the Smart Home position to the first column and back.
End (on blank line)When this check box is selected, on pressing EndEnd in an empty line, the caret is positioned with the indent, which PyCharm assumes to be reasonable in the current code point (indentation is based on the current Code Style Settings).
Insert pair bracketSelect this check box to have PyCharm automatically add a closing round or square bracket for each typed opening round or square bracket, respectively.
Insert pair quoteSelect this check box to have PyCharm automatically add a closing single or double quote for each typed opening single or double quote, respectively.
Use 'CamelHumps' words Select this check box to have PyCharm discern separate words within CamelHump names. Words within a name should start with a capital letter or an underscore. This option impacts some editor actions, for example:
  • Caret Move (Ctrl+RightCtrl+Right/Ctrl+LeftCtrl+Left)
  • Caret Move with Selection (Ctrl+Shift+RightCtrl+Shift+Right/Ctrl+Shift+LeftCtrl+Shift+Left)
  • Select Word at Caret (Ctrl+WCtrl+W)
  • Delete to Word Start/End (Ctrl+BackspaceCtrl+Backspace and Ctrl+DeleteCtrl+Delete respectively)
  • Double-clicking
1.2+Surround selection on typing quote or braceIf this check box is selected, the selected text on typing a quote, double-quote or brace, will be surrounded with these characters. If this check box is not selected, then the typed quotes, double-quotes or braces will replace the selection.
EnterUse this area to define the actions to be invoked by pressing EnterEnter.
  • Smart Indent - select this check box to have PyCharm add a new line and position the caret in it, with the indent that PyCharm assumes to be reasonable in the current point of code (indentation is based on the current Code Style Settings).

    If the check box is cleared, upon pressing EnterEnter in a blank line, PyCharm adds a new line and positions the caret at the current non-space character column.

  • Insert pair '}' - select this check box to have PyCharm automatically position a closing brace } at the proper column when EnterEnter is pressed in an empty line. In this case PyCharm seeks backward for the nearest unclosed opening brace { and places the closing one at the corresponding indentation level.
  • 1.5+Insert documentation comment stub - this check box defines the behavior on pressing EnterEnter after opening tag.
    • If this check box is selected, PyCharm generates a documentation comment stub. For the method comments, this stub contains the required tags (@param tags for each method parameter, @return, or @throws). Refer to Creating Documentation Comments for details.
    • If this check box is selected, PyCharm generates a documentation comment stub. For the function comments, this stub contains the required tags (@param tags for each parameter declared in the signature, and @return). Refer to Creating Documentation Comments for details.
    • If this check box is selected, PyCharm generates a documentation comment stub. For the function comments, this stub contains the required tags (@param tags for each parameter declared in the signature, and @return). Refer to Creating PHP Documentation Comments and Creating JSDoc Comments for details.
    • If this check box is selected, PyCharm generates a documentation comment stub. For the function comments, this stub contains the required tags (@param tags for each parameter declared in the signature, and @return). Refer to Creating JSDoc Comments for details.
    • If this check box is not selected, only the closing tag is generated.
Reformat on pasteUse this drop-down list to specify how to place pasted code blocks. The available options are:
  • None - The pasted code is inserted at the caret location as plain text without any reformatting or indenting.
  • Indent Block - The pasted code block is positioned at the proper indentation level, according to the current Code Style Settings, but its inner structure is not changed.
  • Indent Each Line- Each line of the pasted code block is positioned at the proper indentation level, according to the current Code Style Settings.
  • Reformat Block- The pasted code block is reformatted according to the current Code Style Settings.

Tip

This feature is applicable to lines that contain the trailing line feed characters.

XML/HTMLIn this area, define the actions to be invoked automatically when editing XML or HTML code.
  • Automatically insert closing tag: select this check box to have PyCharm automatically insert a closing XML or HTML tag upon entering the corresponding opening one.
  • Automatically insert required attributes: select this check box to have PyCharm display a template with all mandatory attributes of the typed tag.
  • Automatically start attribute: select this check box to have PyCharm display a template with the first mandatory attribute of the typed tag.
  • Enable Zen Coding: select this check box to use native Zen selectors in PyCharm.
  • Expand abbreviation with: in this drop-down box, specify the default key to expand Zen selectors with.

    Note

    This key will also by default expand Zen Coding live templates. You can re-define this default setting for each specific live template.

Indent pasted lines relative to caret locationIf this check box is selected, the pasted lines are indented relative to the current caret location. Otherwise, the pasted lines are indented relative to the first column.
1.5+Insert backslash when pressing Enter inside the statementIf this check box is selected, the continuation character will be inserted automatically on pressing EnterEnter, preserving the correct syntax.
If this check box is not selected, the line will be broken, and syntax error will be reported by on-the-fly code inspection.
1.5+Insert 'self' when defining a methodIf this check box is selected, the self parameter is inserted automatically after typing the opening brace, together with the closing brace and colon.

If this check box is cleared, only closing brace is generated automatically.

When necessary, use the suggested quick fix to insert self:

py_self

2.0+Insert 'type' and 'rtype' to the documentation comment stub If this check box is selected, the documentation comment stub will contain type tag for each parameter, and rtype tag for the return statement.
Auto-insert closing }} and %} in Django templatesIf this check box is selected, the closing characters will be automatically inserted after typing the opening ones.

See Also

Procedures:

Reference:

Web Resources: