PyCharm
 
2022.2
Shortcuts: Windows
Get PyCharm
You are viewing the documentation for an earlier version of PyCharm.
  1. Reference
  2. Tool Windows Reference
  3. Project tool window
  4. File nesting dialog

File nesting dialog

Last modified: 17 March 2022

Open the dialog: Project tool window | App general gear plain | File Nesting

Use this dialog to configure presentation of files with the same names but different suffixes.

Such bunches of files may appear in framework-specific projects, for example, if you use Angular.

Angular application: a bunch of app files with various extensions

Also consider compilation of TypeScript into JavaScript with source maps generated:

A typescript file leftpad.ts with a compiled JavaScript file leftpad.js and a generated source map file leftpad.js.map shown at the same level

PyCharm can present such file bunches as plain structures or show parent files as folders (nests) with their child files inside.

PyCharm provides a set of predefined rules for file nesting. You can edit these rules as well as define your own custom ones. To configure file nesting, specify the suffixes of parent files and the suffixes of the child files.

tip

Note that the nesting rules are applied only to files with the same names within the same directory.

If the names of two files match a pattern but the files are stored in different directories, PyCharm does not visually "move" any of them.

Item

Shortcut

Description

Show files with the same names as nested

  • When the checkbox is selected, PyCharm recognizes child files based on the patterns from the list and shows them grouped under the corresponding parents. Compare the presentation of the above TypeScript example with file nesting enabled

    A typescript file leftpad.ts with a compiled JavaScript file leftpad.js and a generated source map file leftpad.js.map shown as a nest

  • When the checkbox is cleared, PyCharm shows parents and children at the same level.

the Add button

Alt+Insert

Add a new row and specify the "parent" file suffix and the matching "child" file suffix. List all patterns explicitly without using wildcards or regular expressions.

the Remove button

Alt+Delete

Remove the selected rule from the list.

Reset to Default

Discard all your custom patterns and reload the default rules.