PyCharm 2.7.2 Web Help

When you reference a class that has not been imported, PyCharm helps you locate this file and add it to the list of imports. You can import a single class or an entire package, depending on your settings. The import statement adds to the imports section, but the cursor does not move from the current position, and your current editing session does not interrupt. This feature is known as the Import Assistant.

When you type a tag with an unbound namespace, import assistant suggests to create a namespace and offers a list of appropriate choices.

In this topic:

To import packages on the fly, follow these general steps
  1. Start typing a name in the editor. If the name references a class that has not been imported, the following prompt appears:

    import assistance

    Note

    If you the pop-up annoys you, change this behavior for the current file. Just click Hector hector.gif in the Status bar, and clear the check box Import Pop-up:

    import_popup

    The unresolved references will be underlined, and you will have to invoke intention action Add import explicitly.

  2. Press Alt+EnterAlt+Enter. If there are multiple choices, select the desired import from the list.

    choose imported classes

2.5+

Note

PyCharm provides a quick fix that automatically installs the package you’re trying to import: if, after the keyword import, you type a name of a package that is not currently available on your machine, a quick fix suggests you to either ignore the unresolved reference, or download and install the missing package:

py_import_inspection

To import a namespace, follow these general steps
  1. Open the desired file for editing, and start typing a tag. If a namespace is not bound, the following prompt appears:

    unboundNameSpace1.png

  2. Press Alt+EnterAlt+Enter. If there are multiple choices, select the desired namespace from the list.

    unboundNameSpace2.png

To complete a short class name and import a PHP namespace on the fly
  1. To enable on-the-fly namespace import, open the PyCharm settings, and then click Auto Import under the Editor node. In the Editor: Auto Import page that opens, configure automatic namespace import in the PHP section.
    • To have PyCharm automatically import PHP namespaces, add use statements, and complete short class names on the fly when you are typing in a class or file that belongs to a certain namespace, select the Enable auto-import in namespace scope check box. This check box is selected by default.
    • To have automatic namespace import applied when you are typing in a file that does not belong to any specific namespace, select the Enable auto-import in file scope check box.
  2. Open the desired file for editing and start typing the short name of a class.
  3. From the suggested variants for completion, select the relevant class name:

    ps_complete_short_class_name_select_class.png

    PyCharm completes the short class name and inserts a use statement with the namespace where the selected class is defined:

    ps_complete_short_class_name_use_statement_added.png

See Also

Web Resources: