Populate projects

Create new files

1. Do one of the following:

   • In the Project tool window (Alt+1), select the directory or package in which you want to create a new file, and then choose File | New from the main menu.

   • Right-click the directory or package and select New from the context menu.

   • Select the directory and press Alt+Insert.

2. Select the desired file type. Generally, all the options except File, Package and Directory correspond to using a file template.

   

   An existing file template may be missing from the list if this is a custom template whose filename extension (template extension) does not match the registered patterns of any of the recognized file types. In such a case, you may want to register the corresponding pattern for an existing recognized file type or add a new file type and register the corresponding pattern for this new type. For more information, refer to File type associations.

3. In the dialog that opens, type the name of the file in the corresponding field. Note that you should not type the filename extension.

   

   You can specify the whole directory structure prepending the new filename. If the nested directories do not yet exist, they will be created.

   

   If required, specify the kind of the new template-based file, its extension, and other parameters. For example, if you select to create an HTML file, you'll be able to create HTML, HTML4, or XHTML file. In other words, use one of the corresponding related file templates.

   Specify other information as required. For example, you may be asked to define the values of custom variables if the corresponding file template contains such variables and their values are not currently set.

4. Click OK. The new file that corresponds to the selected file template will be created under the target location.

   If the names of non-existent sub-directories were specified before the new filename, the whole structure will be created under the target directory :

   

   Sometimes, you may want to change the auto-generated filename extension. To do that, use the Rename refactoring (Refactor | Rename).

Create directories

1. Open the Project tool window (for example View | Tool Windows | Project).

2. Select the destination directory.

3. Do one of the following:

   • Select File | New | Directory.

   • Select New | Directory from the context menu.

   • Press Alt+Insert and select Directory.

   

4. In the dialog that opens, specify the directory name. If you want to create a number of nested directories, specify the directory names separated with slashes.

   

   Press Enter to complete the task.

Create Python Packages

1. In the Project tool window, select the destination directory.

2. From the context menu of the selection, choose New | Python Package, or press Alt+Insert to invoke the context menu:

   

3. In the New Package dialog that opens, specify the package name.

   You can also specify nested packages; in this case, the names should be delimited with dots:

   

   Click OK. PyCharm creates the new package or package structure:

   

Mark a directory as a namespace package

1. Consider two packages, lib1 and lib2 that reside in the same directory. Try to include a lib1 import statement into lib2.py. PyCharm reports a relative import outside of the package.

   

2. To resolve the import and avoid the warning, mark the mydir directory as a namespace package. You have the following options:

   • Place the caret at the import statement, press Alt+Enter (or click the yellow bulb), and apply the corresponding quick-fix.

   • Right-click the directory in the Project tool window and select Mark Directory as | Namespace Package.

You can add existing files and folders to your project using one of the following options:

• Drag the item from your system file manager to the node in the Project tool window (Alt+1).

• Copy the item in the system file manager and then paste in to the node in the IDE Project tool window.

• Manually move the item to the project folder in your system file manager.