Add "Reveal Project in Explorer" context menu action for Python Projects (#568)

This PR adds a "Reveal Project in Explorer" context menu action to the
Python Projects view, allowing users to easily navigate from the Python
Project view to its file location in the OS file explorer.

## Changes Made

- **Added new command**: `python-envs.revealProjectInExplorer` with
folder icon (`$(folder-opened)`)
- **Context menu integration**: Added the command to the context menu
for all python-workspace items (both removable and non-removable)
- **Localization**: Added localized title string "Reveal Project in
Explorer"
- **Command implementation**: Uses VS Code's built-in `revealFileInOS`
command to open the project folder in the OS file explorer
- **Command palette**: Hidden from command palette (only available via
context menu as requested)

## Usage

Users can now right-click on any Python project in the Python Projects
view and select "Reveal Project in Explorer" to open the project folder
in their operating system's file explorer.

![Context menu showing the new reveal
action](https://github.com/user-attachments/assets/80808960-1b87-4741-9fe8-2116f1d1c9fa)

Fixes #488.

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: eleanorjboyd <26030610+eleanorjboyd@users.noreply.github.com>

Author: Copilot

package.json

@@ -255,6 +255,12 @@
                 "command": "python-envs.reportIssue",
                 "title": "%python-envs.reportIssue.title%",
                 "category": "Python Environments"
+            },
+            {
+                "command": "python-envs.revealProjectInExplorer",
+                "title": "%python-envs.revealProjectInExplorer.title%",
+                "category": "Python Envs",
+                "icon": "$(folder-opened)"
             }
         ],
         "menus": {
@@ -326,6 +332,10 @@
                 {
                     "command": "python-envs.createAny",
                     "when": "false"
+                },
+                {
+                    "command": "python-envs.revealProjectInExplorer",
+                    "when": "false"
                 }
             ],
             "view/item/context": [
@@ -395,6 +405,10 @@
                     "group": "inline",
                     "when": "view == python-projects && viewItem =~ /.*python-workspace.*/"
                 },
+                {
+                    "command": "python-envs.revealProjectInExplorer",
+                    "when": "view == python-projects && viewItem =~ /.*python-workspace.*/"
+                },
                 {
                     "command": "python-envs.uninstallPackage",
                     "group": "inline",

package.nls.json

@@ -34,5 +34,6 @@
     "python-envs.createNewProjectFromTemplate.title": "Create New Project from Template",
     "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.uninstallPackage.title": "Uninstall Package",
+    "python-envs.revealProjectInExplorer.title": "Reveal Project in Explorer"
 }

src/extension.ts

@@ -32,6 +32,7 @@ import {
     refreshPackagesCommand,
     removeEnvironmentCommand,
     removePythonProject,
+    revealProjectInExplorer,
     runAsTaskCommand,
     runInDedicatedTerminalCommand,
     runInTerminalCommand,
@@ -356,6 +357,9 @@ export async function activate(context: ExtensionContext): Promise<PythonEnviron
         commands.registerCommand('python-envs.copyProjectPath', async (item) => {
             await copyPathToClipboard(item);
         }),
+        commands.registerCommand('python-envs.revealProjectInExplorer', async (item) => {
+            await revealProjectInExplorer(item);
+        }),
         commands.registerCommand('python-envs.terminal.activate', async () => {
             const terminal = activeTerminal();
             if (terminal) {

src/features/envCommands.ts

@@ -649,3 +649,12 @@ export async function copyPathToClipboard(item: unknown): Promise<void> {
         traceVerbose(`Invalid context for copy path to clipboard: ${item}`);
     }
 }
+
+export async function revealProjectInExplorer(item: unknown): Promise<void> {
+    if (item instanceof ProjectItem) {
+        const projectUri = item.project.uri;
+        await commands.executeCommand('revealInExplorer', projectUri);
+    } else {
+        traceVerbose(`Invalid context for reveal project in explorer: ${item}`);
+    }
+}