Working with Folders

Feature Showcase

Komodo has two distinct types of folders that can be used in projects or in the Toolbox:

Double-click a folder to display its contents. Double-click again to collapse a folder and hide its contents. Alternatively, click the plus and minus icons.

Folder Options

To access options for the selected folder, do one of the following:

The following options are available for folders:

Import from File System

This option imports the files and directories from a local or network filesystem into a Virtual Folder. Depending on the configuration of the options below, file and directory references are created in the same hierarchical structure as the filesystem. (Alternatively, all the file references in a recursive directory structure can be located at the same level within a folder.)

Use the following options on the Import from File System dialog box to configure the import:

After importing from the file system, you are prompted to confirm the addition of the files that match the specified criteria. You may remove one or more files from the import. Click OK to proceed with the import.

After using the Import from File System feature, if you attempt to re-import the same file system location into the same project, only files that are new since the last import are imported.

Export Contents to Package

Folders can be archived and distributed among multiple Komodo users via Packages. Packages are compressed archive files that contain the folder from which the Export Package option was invoked, as well as the folder's contents. Packages are stored in files with a ".kpz" extension, and can be opened by any archiving utility that supports libz (for example WinZip). The Export Package option differs from the Export to Project option in that a copy of filesystem-based components (such as files and dialog projects) is included in the archive. Conversely, Export to Project creates a project with a reference to the component's original location and does not create a copy of the component.

To export the contents of a folder to a package:

  1. In the Project Tab or Toolbox, right-click the folder containing the item(s) to be exported to a package and select Export Package.
  2. In the Package Export Wizard, enter the Package Name and Export Location. Click Next.
  3. Click Finish.

Import Contents from Package

Exported packages can only be imported into "container" objects in Komodo, such as projects, the Toolbox, and folders within projects and the Toolbox.

To import the contents of a package to a folder:

  1. In the Project Tab or Toolbox, right-click the folder and select Import Package.
  2. In the Package Import Wizard, enter the name of the package and the location on disk where files (as opposed to internal components like snippets and run commands) will be extracted. Click Next.
  3. Click Finish.

Refresh Folder Contents Status

The Refresh Status option checks read/write disk status for filesystem-based components (such as files and dialogs) contained within the folder. If a file is of a language for which "code intelligence" is supported and enabled (as configured in the Code Intelligence Preferences), Refresh Status will also update the code intelligence database with the contents of the file.

If the component is stored in a source code control system, Refresh Status also checks the repository status of the component. Komodo determines whether a file is contained in an SCC repository by the following methods:

Adding Components to Folders

Use this option to add components to the selected folder. All components can be added to folders, in the same manner they are added to projects. Refer to the individual component documentation, or the topics Adding Components to Projects or Adding Components to the Toolbox for more information.

Use the cut/copy/paste options to remove folders from a project or the Toolbox, or to move folders between the project and the Toolbox, between projects, or between folders.

Exporting Contents as Project File

When this option is invoked, a new project file is created that contains the folder (and its contents) from which the option is invoked. You are prompted to provide the name of the new project file and the directory where it will be stored. To open the new project file, select File|Open|Project.

Renaming Folders

To change the name of a folder, select this option and enter a new name.

Source Control on Folder Contents

Source Control on Contents refreshes the source code control status of all the files contained within the folder. A subset of Komodo's Source Code Control functions can be performed. See Source Code Control for a description of specific options.

Deleting Folders

To remove a folder from a project or the Toolbox, select the Delete option. Deleting a Komodo folder has no effect on the actual filesystem contents. The folder is removed from the project or Toolbox, but not deleted from the disk.