<type>documentation</type>
<domain>commands</domain>
<id>commands/proj</id>
<title>Project Manager Commands</title>
<product>per+</product>

Project Manager Commands
------------------------

Commands for controlling the current project and Project tool, regardless of keyboard focus.

**add-current-file-to-project** ()

Add the frontmost currently open file to project   *Key Bindings: Wing: Ctrl-Shift-I; Brief: Ctrl-Shift-I; Eclipse: Ctrl-Shift-I; Emacs: Ctrl-Shift-I; MATLAB: Ctrl-Shift-I; VI/VIM: Ctrl-Shift-I; Visual Studio: Ctrl-Shift-I; macOS: Command-Shift-I*

**add-directory-to-project** (loc=None, recursive=True, filter='\*', include_hidden=False, gui=True)

Add directory to project. 

**add-file-to-project** ()

Add an existing file to the project. 

**browse-selected-from-project** ()

Browse file currently selected in the project manager 

**clear-project-main-entry-point** ()

Clear main entry point to nothing, so that debugging and execution starts with the
file in the current editor

**close-project** ()

Close currently open project file 

**debug-selected-from-project** ()

Start debugging the file currently selected in the project manager 

**execute-selected-from-project** ()

Execute the file currently selected in the project manager 

**new-project** (show_dialog=True)

Create a new project.  When show_dialog is False, a new blank project is
created.  Otherwise, the New Project dialog is shown.

**open-ext-selected-from-project** ()

Open file currently selected in the project manager 

**open-project** (filename=None)

Open the given project file, or prompt the user to select a
file if the filename is not given.

**open-project-remote** ()

Open a project file from a remote host

**open-selected-from-project** ()

Open files currently selected in the project manager 

**remove-directory-from-project** (loc=None, gui=True)

Remove directory from project. 

**remove-selection-from-project** ()

Remove currently selected file or package from the project 

**rescan-project-directories** (dirs=None, recursive=True)

Scan project directories for changes.  If list of directories is not
specified, currently selected directories are used. 

**save-project** ()

Save project file. 

**save-project-as** (filename=None)

Save project file under the given name, or prompt user for a name
if the filename is not given.

**save-project-as-remote** (filename=None)

Save current project to a remote host

**set-current-as-main-entry-point** ()

Set current editor file as the main entry point for this project 

**set-selected-as-main-entry-point** ()

Set selected file as the main entry point for this project 

**show-current-file-in-project-tool** ()

Show the currently selected file in the project view, if present.
The selection may be the current editor, if it has focus, or files
selected in other views.

**show-project-window** ()

Raise the project manager window 

**show-python-environment** ()

Show the effective Python version and path for the current configuration

**use-shared-project** ()

Store project in sharable (two file) format.  The .wpr file can be checked into revision
control or other shared with other users and machines.  This is the default and the format
cannot be read by Wing Personal.

**use-single-user-project** ()

Store project single-user (one file) format, which can also be read by Wing Personal.

**view-directory-properties** (loc=None)

Show the project manager's directory properties dialog

**view-file-properties** (loc=None, page=None, highlighted_attribs=None)

View project properties for a particular file (current file if none
is given)  *Key Bindings: Eclipse: Alt-Enter; macOS: Command-I*

**view-project-as-flat-tree** ()

View project as flattened directory tree from project file

**view-project-as-tree** ()

View project as directory tree from project file

**view-project-properties** (highlighted_attrib=None, show_page=None)

View or change project-wide properties  *Key Bindings: Visual Studio: Alt-F7*

Project Tool Commands
---------------------

Commands that are available only when the Project tool has the
keyboard focus.

**browse-selected-from-project** ()

Browse file currently selected in the project manager 

**debug-selected-from-project** ()

Start debugging the file currently selected in the project manager 

**execute-selected-from-project** ()

Execute the file currently selected in the project manager 

**move-files-selected-in-project-to-trash** ()

Move the files and/or directories currently selected in the project
view to the trash or recycling bin 

**open-ext-selected-from-project** ()

Open file currently selected in the project manager 

**open-selected-from-project** ()

Open files currently selected in the project manager 

**remove-selection-from-project** ()

Remove currently selected file or package from the project 

**rename-selected-in-project** (new_name)

Rename the currently selected file or directory in the project view

**search-in-selected-from-project** ()

Search in file or directory currently selected in the project manager 

**set-selected-as-main-entry-point** ()

Set selected file as the main entry point for this project 

**view-project-as-flat-tree** ()

View project as flattened directory tree from project file

**view-project-as-tree** ()

View project as directory tree from project file
