PyCharm 2023.3 Help

Extract constant

The Extract Constant refactoring makes your source code easier to read and maintain. It also helps you avoid using hardcoded constants without any explanations about their values or purpose.

Extract a Python constant in-place

The in-place refactorings are enabled in PyCharm by default. If you haven't changed this setting, the Extract Constant refactoring for Python is performed in place, right in the editor.

  1. Place the caret within the expression or declaration of a variable to be replaced by a constant.

  2. Do one of the following:

    • Press Ctrl+Alt+C.

    • Choose Refactor | Extract | Constant from the main menu or the context menu.

  3. If more than one expression is detected for the current caret position, the Expressions list appears. If this is the case, click the expression to select it. Alternatively, press Up or Down to navigate to the expression of interest, and then press Enter to select it.

  4. If more than one occurrence of the expression is found, specify whether you wish to replace only the selected occurrence, or all the found occurrences with the new constant.

    Extracting a constant
  5. Specify the name of the constant. Select the name from the list or type the name in the box with a red border.

    specifying a name for the extracting constant
  6. To complete the refactoring, press Tab or Enter.

    If you haven't completed the refactoring and want to cancel the changes you have made, press Escape.

Extract a constant using the dialog

If the in-place refactorings are disabled, the Extract Constant refactoring is performed by means of the Extract Constant Dialog dialog.

enableInplaceRefactoringCleared.png
  1. In the Extract Constant Dialog dialog that opens, specify the name of the new constant.

  2. To automatically replace all occurrences of the selected expression (if it is found more than once), select the option Replace all occurrences.

  3. Click OK to create the constant.

Last modified: 07 March 2024