Merge branch 'main' into switch-who-handles-adding-project

Author: eleanorjboyd

src/api.ts

@@ -707,18 +707,20 @@ export interface PythonProjectCreator {
     readonly iconPath?: IconPath;
 
     /**
-
-     * A flag indicating whether the project creator supports quick create where no user input is required.
+     * Creates a new Python project(s) or, if files are not a project, returns Uri(s) to the created files.
+     * Anything that needs its own python environment constitutes a project.
+     * @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.
      */
-    readonly supportsQuickCreate?: boolean;
+    create(options?: PythonProjectCreatorOptions): Promise<PythonProject | PythonProject[] | Uri | Uri[] | undefined>;
 
     /**
-     * * Creates a new Python project or projects. The create method is required to add the created project if successful to the
-     * list of 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.
+     * A flag indicating whether the project creator supports quick create where no user input is required.
      */
-    create(options?: PythonProjectCreatorOptions): Promise<PythonProject | PythonProject[] | undefined>;
+    readonly supportsQuickCreate?: boolean;
 }
 
 /**

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

@@ -377,6 +377,7 @@ export async function addPythonProjectCommand(
         return;
     }
 
+
     let results: PythonProject | PythonProject[] | undefined;
     try {
         results = await creator.create(options);