fix: show back button with create environment (#323)

fixes:
#321

The following fields are supported when using `python-envs.createAny`
command:
```
    /**
     * Default `false`. If `true` the creation provider should show back button when showing QuickPick or QuickInput.
     */
    showBackButton?: boolean;

    /**
     * Default `true`. If `true`, the environment after creation will be selected.
     */
    selectEnvironment?: boolean;
```

Author: karthiknadig

README.md

@@ -12,7 +12,6 @@ The Python Environments and Package Manager extension for VS Code helps you mana
 
 <img src=https://raw.githubusercontent.com/microsoft/vscode-python-environments/main/images/python-envs-overview.gif width=734 height=413>
 
-
 ### Environment Management
 
 This extension provides an Environments view, which can be accessed via the VS Code Activity Bar, where you can manage your Python environments. Here, you can create, delete, and switch between environments, as well as install and uninstall packages within the selected environment. It also provides APIs for extension developers to contribute their own environment managers.
@@ -54,19 +53,44 @@ See [api.ts](https://github.com/microsoft/vscode-python-environments/blob/main/s
 To consume these APIs you can look at the example here:
 https://github.com/microsoft/vscode-python-environments/blob/main/examples/README.md
 
+### Callable Commands
+
+The extension provides a set of callable commands that can be used to interact with the environment and package managers. These commands can be invoked from other extensions or from the command palette.
+
+#### `python-envs.createAny`
+
+Create a new environment using any of the available environment managers. This command will prompt the user to select the environment manager to use. Following options are available on this command:
+
+```typescript
+{
+    /**
+     * Default `false`. If `true` the creation provider should show back button when showing QuickPick or QuickInput.
+     */
+    showBackButton?: boolean;
+
+    /**
+     * Default `true`. If `true`, the environment after creation will be selected.
+     */
+    selectEnvironment?: boolean;
+}
+```
+
+usage: `await vscode.commands.executeCommand('python-envs.createAny', options);`
 
 ## Extension Dependency
 
-This section provides an overview of how the Python extension interacts with the Python Environments extension and other tool-specific extensions. The Python Environments extension allows users to create, manage, and remove Python environments and packages. It also provides an API that other extensions can use to support environment management or consume it for running Python tools or projects.  
+This section provides an overview of how the Python extension interacts with the Python Environments extension and other tool-specific extensions. The Python Environments extension allows users to create, manage, and remove Python environments and packages. It also provides an API that other extensions can use to support environment management or consume it for running Python tools or projects.
 
 Tools that may rely on these APIs in their own extensions include:
-- **Debuggers** (e.g., `debugpy`)
-- **Linters** (e.g., Pylint, Flake8, Mypy)
-- **Formatters** (e.g., Black, autopep8)
-- **Language Server extensions** (e.g., Pylance, Jedi)
-- **Environment and Package Manager extensions** (e.g., Pixi, Conda, Hatch)
+
+-   **Debuggers** (e.g., `debugpy`)
+-   **Linters** (e.g., Pylint, Flake8, Mypy)
+-   **Formatters** (e.g., Black, autopep8)
+-   **Language Server extensions** (e.g., Pylance, Jedi)
+-   **Environment and Package Manager extensions** (e.g., Pixi, Conda, Hatch)
 
 ### API Dependency
+
 The relationship between these extensions can be represented as follows:
 
 <img src=https://raw.githubusercontent.com/microsoft/vscode-python-environments/refs/heads/main/images/extension_relationships.png width=734 height=413>
@@ -75,7 +99,7 @@ Users who do not need to execute code or work in **Virtual Workspaces** can use
 
 ### Trust Relationship Between Python and Python Environments Extensions
 
-VS Code supports trust management, allowing extensions to function in either **trusted** or **untrusted** scenarios. Code execution and tools that can modify the user’s environment are typically unavailable in untrusted scenarios.  
+VS Code supports trust management, allowing extensions to function in either **trusted** or **untrusted** scenarios. Code execution and tools that can modify the user’s environment are typically unavailable in untrusted scenarios.
 
 The relationship is illustrated below:
 

src/common/pickers/managers.ts

@@ -21,6 +21,7 @@ function getDescription(mgr: InternalEnvironmentManager | InternalPackageManager
 export async function pickEnvironmentManager(
     managers: InternalEnvironmentManager[],
     defaultManagers?: InternalEnvironmentManager[],
+    showBackButton?: boolean,
 ): Promise<string | undefined> {
     if (managers.length === 0) {
         return;
@@ -72,6 +73,7 @@ export async function pickEnvironmentManager(
     const item = await showQuickPickWithButtons(items, {
         placeHolder: Pickers.Managers.selectEnvironmentManager,
         ignoreFocusOut: true,
+        showBackButton,
     });
     return (item as QuickPickItem & { id: string })?.id;
 }

src/features/envCommands.ts

@@ -115,7 +115,7 @@ export async function createEnvironmentCommand(
 export async function createAnyEnvironmentCommand(
     em: EnvironmentManagers,
     pm: PythonProjectManager,
-    options?: CreateEnvironmentOptions & { selectEnvironment: boolean },
+    options?: CreateEnvironmentOptions & { selectEnvironment?: boolean; showBackButton?: boolean },
 ): Promise<PythonEnvironment | undefined> {
     const select = options?.selectEnvironment;
     const projects = pm.getProjects();
@@ -130,7 +130,7 @@ export async function createAnyEnvironmentCommand(
             return env;
         }
     } else if (projects.length > 0) {
-        const selected = await pickProjectMany(projects);
+        const selected = await pickProjectMany(projects, options?.showBackButton);
 
         if (selected && selected.length > 0) {
             const defaultManagers: InternalEnvironmentManager[] = [];
@@ -151,6 +151,7 @@ export async function createAnyEnvironmentCommand(
                 let managerId = await pickEnvironmentManager(
                     em.managers.filter((m) => m.supportsCreate),
                     defaultManagers,
+                    options?.showBackButton,
                 );
                 if (managerId?.startsWith('QuickCreate#')) {
                     quickCreate = true;