Scopes

Use this settings page to define scopes – sets of files to apply different operations to.

Item	Tooltip	Description
	Add Scope `Alt+Insert`	Add a new local or shared scope.
	Delete `Alt+Delete`	Delete the selected scope from the list.
	Copy Configuration `Ctrl+D`	Create a copy of the selected scope.
	Save As	Save the selected local scope as shared or the selected shared scope as local.
	Move Up/Move Down	Move the scopes up and down in the list.

Scope configuration controls

Item	Description
Name	Specify the scope name.
Pattern	Specify the pattern that defines the current scope. The following elements and structures can be used: The `file:` modifier. The element is mandatory. The `` asterisk to denote any symbol in a filename or file extension. Logical operators `AND (&&), OR (\|\|)`, and `NOT (!)`. For more information, refer to Scope language syntax reference. Storing empty or incorrect patterns is not allowed. In such cases, PyCharm shows a Syntax Error warning. Examples `file:.js\|\|file:.coffee` - include all JavaScript and CoffeeScript files. `file:js&&!file:.min.` - include all JavaScript files except those that were generated through minification, which is indicated by the `min` extension. Learn more from Minifying JavaScript. `!file:/.npm//` - exclude all .npm folders. `file[Scientific_Sample]:*.py` - include all Python files from the project `Scientific_Sample`. Specifying the project name in the brackets is particularly helpful when you have several projects attached to the current one.
Include	Included the selected item. If the current item is a folder, the nested subfolders are ignored.
Include Recursively	Include the selected folder and all nested subfolders with their contents.
Exclude	Exclude the selected item. If the current item is a folder, the nested subfolders remain in the scope.
Exclude Recursively	Exclude the selected folder and all nested subfolders with their contents.

Item	Tooltip	Description
Project tree view		The tree view contains all the files available in your project. In the view, select the desired files to be included in the current scope and have the scope definition pattern generated automatically.
	Show Files	When this option is enabled, source files are displayed explicitly in the tree view. When the files are shown, they can be selected for exclusion/inclusion into a pattern. If this option is not disabled, all files are hidden from the tree.
	Show Modules	When this option is enabled, items in the tree-view are shown below the corresponding module nodes. Otherwise, the project items are shown below the corresponding package (like a source path with packages).
	Show Included Only	When this option is enabled, the tree shows only the elements that are included in the scope.

Legend of the project tree view

Item	Description
	Folders and files included in a scope are marked with green.
	Folders that contain both excluded and included files and subfolders are marked with dark blue.

Last modified: 08 October 2024