Intention Actions
In this section:
- Intention Actions
- Disabling Intention Actions
- Configuring Intention Actions
- Applying Intention Actions
- Examples of Python-Specific Intention Actions
Introduction
PyCharm helps you handle the situations when you use classes that haven't been imported, or methods that haven't been written etc., which can result in errors. When a possible problem is suspected, PyCharm suggests a solution, and in certain cases can implement this solution (properly assign variables, create missing references and more). Besides syntax problems, PyCharm recognizes code constructs that can be optimized or improved, and suggests appropriate intention actions, denoted with the special icons.
Intention action icons
Intention action types
Find descriptions of specific intention actions on the Intentions page of the editor settings/preferences, where they are grouped according to the areas of their usage. Generally, intention actions can be divided into several categories, for example:
- Create from usage
- This type of intention action creates new code items: classes, methods, etc. They are smart enough to analyze your code and provide actions suitable for a particular case. The main concept behind this type is that you can begin using new things without declaring them first. You are not taken away from your current task for mundane minutiae like creating declarations, new files, etc. which PyCharm handles while you keep focused.
For example, if you refer to a non-existent symbol, PyCharm suggests you to create one:
- Quick fixes
- This type of intention action responds to common coding mistakes: using an improper access modifier, or an expression of the wrong type, or missing resources, etc. PyCharm catches these kinds of problems as you type, and provides a quick way to fix them using Intentions Actions with appropriate suggestions for the error.
It is a common practice to delay import of a symbol to the point where it is actually used. For this purpose, PyCharm suggests a dedicated quick fix Import this name locally:
- Micro-refactorings
- These intention actions appear for code that is syntactically correct, but can be structurally improved by such things as:
- Converting code constructs.
- Splitting declarations and assignments.
- Splitting or merging statements and tags, etc.- Convert lambda to function. A lambda function can be turned into def statements:
- Split/join if's. PyCharm provides two inverse intention actions: split
if
statement into two, and join the nestedif
statements provided that only the inner one contains code:
- Marking an unresolved variable as global, to have it ignored in the future. This can be done "on-the-fly": or in the inspection settings:
- Converting parameters between normal and variadic:
- Edit <Injected Language> Fragment
- For string literals that represent language injections, the Edit <Injected Language> Fragment intention action is available. You can use this intention action to open the corresponding code fragment in a separate editor.