update return type of project create

Author: eleanorjboyd

src/api.ts

@@ -702,11 +702,14 @@ export interface PythonProjectCreator {
     readonly iconPath?: IconPath;
 
     /**
-     * Creates a new Python project or projects.
-     * @param options - Optional parameters for creating the Python project.
-     * @returns A promise that resolves to a Python project, an array of Python projects, or undefined.
-     */
-    create(options?: PythonProjectCreatorOptions): Promise<PythonProject | PythonProject[] | undefined>;
+     * Creates a new Python project(s) or, if files are not a project, returns Uri(s) to the created files.
+     * @param options Optional parameters for creating the Python project.
+     * @returns A promise that resolves to one of the following:
+     *   - PythonProject or PythonProject[]: when a single or multiple projects are created.
+     *   - Uri or Uri[]: when files are created that do not constitute a project.
+     *   - undefined: if project creation fails.
+     */
+    create(options?: PythonProjectCreatorOptions): Promise<PythonProject | PythonProject[] | Uri | Uri[] | undefined>;
 }
 
 /**

src/features/creators/existingProjects.ts

@@ -13,7 +13,9 @@ export class ExistingProjects implements PythonProjectCreator {
 
     constructor(private readonly pm: PythonProjectManager) {}
 
-    async create(_options?: PythonProjectCreatorOptions): Promise<PythonProject | PythonProject[] | undefined> {
+    async create(
+        _options?: PythonProjectCreatorOptions,
+    ): Promise<PythonProject | PythonProject[] | Uri | Uri[] | undefined> {
         const results = await showOpenDialog({
             canSelectFiles: true,
             canSelectFolders: true,

src/features/envCommands.ts

@@ -368,7 +368,7 @@ export async function addPythonProject(
             return;
         }
 
-        let results: PythonProject | PythonProject[] | undefined;
+        let results: PythonProject | PythonProject[] | Uri | Uri[] | undefined;
         try {
             results = await creator.create();
             if (results === undefined) {
@@ -381,6 +381,15 @@ export async function addPythonProject(
             throw ex;
         }
 
+        if (
+            results instanceof Uri ||
+            (Array.isArray(results) && results.length > 0 && results.every((r) => r instanceof Uri))
+        ) {
+            // the results are Uris, which means they aren't projects and shouldn't be added
+            return;
+        }
+        results = results as PythonProject | PythonProject[];
+
         if (!Array.isArray(results)) {
             results = [results];
         }