javadoc

python/psi-api/src/com/jetbrains/python/psi/PyFile.java

@@ -2,6 +2,7 @@ package com.jetbrains.python.psi;
 
 import com.intellij.psi.PsiFile;
 import com.jetbrains.python.codeInsight.controlflow.ScopeOwner;
+import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
 import java.util.List;
@@ -28,6 +29,12 @@ public interface PyFile extends PyElement, PsiFile, PyDocStringOwner, ScopeOwner
 
   List<PyFromImportStatement> getFromImports();
 
+  /**
+   * Returns the list of import elements in all 'import xxx' statements within the file.
+   *
+   * @return the list of import targets.
+   */
+  @NotNull
   List<PyImportElement> getImportTargets();
 
   /**

python/src/com/jetbrains/python/psi/impl/PyFileImpl.java

@@ -513,6 +513,7 @@ public class PyFileImpl extends PsiFileBase implements PyFile, PyExpression {
     return false;
   }
 
+  @NotNull
   public List<PyImportElement> getImportTargets() {
     List<PyImportElement> ret = new ArrayList<PyImportElement>();
     List<PyImportStatement> imports = PyPsiUtils.collectStubChildren(this, this.getStub(), PyElementTypes.IMPORT_STATEMENT, PyImportStatement.class);