Basic Code Completion. Completing Names and Keywords
In this section:
Basic code completion helps you complete the names of classes, methods, and keywords within the visibility scope. When you invoke code completion, PyCharm analyses the context and suggests the choices that are reachable from the current position of the caret.
If basic code completion is applied to a part of a parameter, or variable declaration, PyCharm suggests a list of possible names with regard to the type of the item.
Invoking Basic code completion for the second time shows the names of classes, functions, modules and variables.
Code completion covers supported file types and custom file types. However, PyCharm does not recognize the structure of custom file types and suggests completion options regardless of whether a specific type is appropriate in the current context.
To automatically complete names in the current visibility scope, follow these general steps:
- Type a name or a part of a name.
While typing, use the following techniques:
Narrow down the suggestion list by typing
any part of a word, even the characters somewhere in the middle, or invoking code completion
after a dot separator. PyCharm will show suggestion list
that includes occurrences with all the possible positions of the entered characters.
This makes the use of the asterisk wildcard unnecessary:
- In case of CamelCase or snake_case names, type the initial letters only. So doing, PyCharm automatically recognizes and matches the initial letters.
- Narrow down the suggestion list by typing any part of a word, even the characters somewhere in the middle, or invoking code completion after a dot separator. PyCharm will show suggestion list that includes occurrences with all the possible positions of the entered characters.
- Do one of the following:
- On the main menu, choose Code | Completion | Basic .
- Press Ctrl+Space.
The images below show basic code completion for the following cases:
- Django templates:
If necessary, press Ctrl+Space for the second time.
This shows the names of classes, functions, modules and variables.
- Select the desired class from the suggestion list, and do one of the following:
- Press Enter or double-click the desired choice .
- Press Tab .
Tips and tricks
- The option Autocomplete common prefix ( Settings | Code Completion ) makes PyCharm look for common prefixes and automatically complete them in the editor. This feature is useful for classes with numerous similar-named members.
- If a suggestion list shows n variants of a class, type a dot, and the next suggestion list after dot will show all the possible qualified names of the members. After selecting the desired one, import statement will be added automatically.
- Suggestion list includes literals, already defined in a file: