Add command to run Python Environment Tool (PET) in terminal (#608)

This PR adds a new command that allows users to run the Python
Environment Tool (PET) binary in a terminal to search for Python
installations interactively.

## Changes Made

### Command Registration
- Added `python-envs.runPetInTerminal` command to `package.json`
- Added localized title "Run Python Environment Tool (PET) in Terminal"
to `package.nls.json`
- Command is categorized under "Python" and only shown when the
environments extension is enabled

### Implementation
- Exported `getNativePythonToolsPath()` function from
`nativePythonFinder.ts`
- Added command handler in `extension.ts` that:
  - Gets the PET executable path using `getNativePythonToolsPath()`
  - Creates a new terminal named "Python Environment Tool (PET)"
  - Executes the PET binary in the terminal with proper path quoting
  - Shows the terminal to the user immediately
  - Includes comprehensive error handling with user-friendly messages

### Usage
Users can now:
1. Open the Command Palette (`Ctrl+Shift+P` / `Cmd+Shift+P`)
2. Search for "Run Python Environment Tool (PET) in Terminal"
3. Execute the command to open a terminal running PET
4. Interactively explore and search for Python installations

The implementation follows existing codebase patterns for terminal
commands and maintains consistency with other extension features.

Fixes #607.

<!-- START COPILOT CODING AGENT TIPS -->
---

💬 Share your feedback on Copilot coding agent for the chance to win a
$200 gift card! Click
[here](https://survey.alchemer.com/s3/8343779/Copilot-Coding-agent) to
start the survey.

---------

Co-authored-by: copilot-swe-agent[bot] <[email protected]>
Co-authored-by: eleanorjboyd <[email protected]>

Author: Copilot

package.json

@@ -262,6 +262,13 @@
                 "title": "%python-envs.revealProjectInExplorer.title%",
                 "category": "Python Envs",
                 "icon": "$(folder-opened)"
+            },
+            {
+                "command": "python-envs.runPetInTerminal",
+                "title": "%python-envs.runPetInTerminal.title%",
+                "category": "Python",
+                "icon": "$(terminal)",
+                "when": "config.python.useEnvironmentsExtension != false"
             }
         ],
         "menus": {

package.nls.json

@@ -35,5 +35,6 @@
     "python-envs.terminal.activate.title": "Activate Environment in Current Terminal",
     "python-envs.terminal.deactivate.title": "Deactivate Environment in Current Terminal",
     "python-envs.uninstallPackage.title": "Uninstall Package",
-    "python-envs.revealProjectInExplorer.title": "Reveal Project in Explorer"
+    "python-envs.revealProjectInExplorer.title": "Reveal Project in Explorer",
+    "python-envs.runPetInTerminal.title": "Run Python Environment Tool (PET) in Terminal"
 }

src/extension.ts

@@ -12,6 +12,7 @@ import { createDeferred } from './common/utils/deferred';
 import {
     activeTerminal,
     createLogOutputChannel,
+    createTerminal,
     onDidChangeActiveTerminal,
     onDidChangeTerminalShellIntegration,
 } from './common/window.apis';
@@ -66,7 +67,11 @@ import { ProjectItem } from './features/views/treeViewItems';
 import { EnvironmentManagers, ProjectCreators, PythonProjectManager } from './internal.api';
 import { registerSystemPythonFeatures } from './managers/builtin/main';
 import { SysPythonManager } from './managers/builtin/sysPythonManager';
-import { createNativePythonFinder, NativePythonFinder } from './managers/common/nativePythonFinder';
+import {
+    createNativePythonFinder,
+    getNativePythonToolsPath,
+    NativePythonFinder,
+} from './managers/common/nativePythonFinder';
 import { IDisposable } from './managers/common/types';
 import { registerCondaFeatures } from './managers/conda/main';
 import { registerPoetryFeatures } from './managers/poetry/main';
@@ -429,6 +434,20 @@ export async function activate(context: ExtensionContext): Promise<PythonEnviron
                 window.showErrorMessage(`Failed to open issue reporter: ${error}`);
             }
         }),
+        commands.registerCommand('python-envs.runPetInTerminal', async () => {
+            try {
+                const petPath = await getNativePythonToolsPath();
+                const terminal = createTerminal({
+                    name: 'Python Environment Tool (PET)',
+                });
+                terminal.show();
+                terminal.sendText(`"${petPath}"`, true);
+                traceInfo(`Running PET in terminal: ${petPath}`);
+            } catch (error) {
+                traceError('Error running PET in terminal', error);
+                window.showErrorMessage(`Failed to run Python Environment Tool: ${error}`);
+            }
+        }),
         terminalActivation.onDidChangeTerminalActivationState(async (e) => {
             await setActivateMenuButtonContext(e.terminal, e.environment, e.activated);
         }),

src/managers/common/nativePythonFinder.ts

@@ -1,20 +1,20 @@
+import * as ch from 'child_process';
 import * as fs from 'fs-extra';
 import * as path from 'path';
+import { PassThrough } from 'stream';
+import { Disposable, ExtensionContext, LogOutputChannel, Uri } from 'vscode';
 import * as rpc from 'vscode-jsonrpc/node';
-import * as ch from 'child_process';
+import { PythonProjectApi } from '../../api';
 import { ENVS_EXTENSION_ID, PYTHON_EXTENSION_ID } from '../../common/constants';
 import { getExtension } from '../../common/extension.apis';
-import { noop } from './utils';
-import { Disposable, ExtensionContext, LogOutputChannel, Uri } from 'vscode';
-import { PassThrough } from 'stream';
-import { PythonProjectApi } from '../../api';
-import { getConfiguration } from '../../common/workspace.apis';
-import { createRunningWorkerPool, WorkerPool } from '../../common/utils/workerPool';
 import { traceVerbose } from '../../common/logging';
-import { isWindows } from '../../common/utils/platformUtils';
 import { getUserHomeDir, untildify } from '../../common/utils/pathUtils';
+import { isWindows } from '../../common/utils/platformUtils';
+import { createRunningWorkerPool, WorkerPool } from '../../common/utils/workerPool';
+import { getConfiguration } from '../../common/workspace.apis';
+import { noop } from './utils';
 
-async function getNativePythonToolsPath(): Promise<string> {
+export async function getNativePythonToolsPath(): Promise<string> {
     const envsExt = getExtension(ENVS_EXTENSION_ID);
     if (envsExt) {
         const petPath = path.join(envsExt.extensionPath, 'python-env-tools', 'bin', isWindows() ? 'pet.exe' : 'pet');