Rename managePackageVersions command

Author: edvilme

api/src/main.ts

@@ -1,6 +1,7 @@
 // Copyright (c) Microsoft Corporation. All rights reserved.
 // Licensed under the MIT License.
 
+import type { Pep440Version } from '@renovatebot/pep440';
 import {
     Disposable,
     Event,
@@ -21,7 +22,6 @@ import {
  */
 
 export type { Pep440Version } from '@renovatebot/pep440';
-import type { Pep440Version } from '@renovatebot/pep440';
 /**
  * The path to an icon, or a theme-specific configuration of icons.
  */
@@ -695,7 +695,7 @@ export interface PackageManager {
     clearCache?(): Promise<void>;
 
     /**
-     * Returns the version of the underlying package management tool (e.g., pip, conda).
+     * Returns the version of the underlying package management tool (e.g., pip, uv, conda).
      * @param environment - The Python environment context.
      * @returns A promise that resolves to a {@link Pep440Version} object, or `undefined` if not available.
      */

src/extension.ts

@@ -50,7 +50,7 @@ import {
     createTerminalCommand,
     getPackageCommandOptions,
     handlePackageUninstall,
-    handlePackageVersionManagement,
+    managePackageVersion,
     refreshPackagesCommand,
     removeEnvironmentCommand,
     removePythonProject,
@@ -299,7 +299,7 @@ export async function activate(context: ExtensionContext): Promise<PythonEnviron
             await handlePackageUninstall(context, envManagers);
         }),
         commands.registerCommand('python-envs.managePackageVersion', async (context: unknown) => {
-            await handlePackageVersionManagement(context, envManagers);
+            await managePackageVersion(context, envManagers);
         }),
         commands.registerCommand('python-envs.set', async (item) => {
             await setEnvironmentCommand(item, envManagers, projectManager);

src/features/envCommands.ts

@@ -317,7 +317,11 @@ export async function handlePackageUninstall(context: unknown, em: EnvironmentMa
     traceError(`Invalid context for uninstall command: ${typeof context}`);
 }
 
-export async function handlePackageVersionManagement(context: unknown, em: EnvironmentManagers) {
+/**
+ * Manages package versions by allowing the user to select from available versions or enter a specific version.
+ * If available versions can be fetched, a QuickPick is shown. Otherwise, an InputBox is used for free-text version entry.
+ */
+export async function managePackageVersion(context: unknown, em: EnvironmentManagers) {
     if (context instanceof PackageTreeItem || context instanceof ProjectPackage) {
         const pkg = context.pkg;
         const environment = context.parent.environment;