Implement issue report (#260)

* Add template

* Add report command

* Ass telemetry

* add tests

* fix extension root

* prettier

* fix tests

Author: paulacamargo25

package.json

@@ -5,7 +5,8 @@
     "version": "2024.3.0-dev",
     "publisher": "ms-python",
     "enabledApiProposals": [
-        "portsAttributes"
+        "portsAttributes",
+        "contribIssueReporter"
     ],
     "license": "MIT",
     "homepage": "https://github.com/Microsoft/vscode-python-debugger",
@@ -63,9 +64,19 @@
                     "light": "resources/light/repl.svg"
                 },
                 "title": "%debugpy.command.viewOutput.title%"
+            },
+            {
+                "category": "Python Debugger",
+                "command": "debugpy.reportIssue",
+                "title": "%debugpy.command.reportIssue.title%"
             }
         ],
         "menus": {
+            "issue/reporter": [
+				{
+					"command": "debugpy.reportIssue"
+				}
+			],
             "commandPalette": [
                 {
                     "category": "Python Debugger",
@@ -90,6 +101,12 @@
                     "category": "Python Debugger",
                     "command": "debugpy.viewOutput",
                     "title": "%debugpy.command.viewOutput.title%"
+                },
+                {
+                    "category": "Python Debugger",
+                    "command": "debugpy.reportIssue",
+                    "title": "%debugpy.command.reportIssue.title%",
+                    "when": "!virtualWorkspace && shellExecutionSupported"
                 }
             ],
             "editor/title/run": [

package.nls.json

@@ -1,7 +1,8 @@
 {
+    "debugpy.command.clearCacheAndReload.title": "Clear Cache and Reload Window",
     "debugpy.command.debugInTerminal.title": "Python Debugger: Debug Python File",
     "debugpy.command.debugUsingLaunchConfig.title": "Python Debugger: Debug using launch.json",
-    "debugpy.command.clearCacheAndReload.title": "Clear Cache and Reload Window",
+    "debugpy.command.reportIssue.title": "Report Issue...",
     "debugpy.command.viewOutput.title": "Show Output",
     "debugpy.debugJustMyCode": "When debugging only step through user-written code. Disable this to allow stepping into library code."
 }

resources/report_issue_template.md

@@ -0,0 +1,56 @@
+<!-- Please fill in all XXX markers -->
+# Behaviour
+
+XXX
+
+## Steps to reproduce:
+
+1. XXX
+
+<!--
+**After** creating the issue on GitHub, you can add screenshots and GIFs of what is happening. Consider tools like https://www.cockos.com/licecap/, https://github.com/phw/peek or https://www.screentogif.com/ for GIF creation.
+-->
+
+<!-- **NOTE**: Please do provide logs from the Python and Python Debugger Output panel. -->
+# Diagnostic data
+<details>
+
+<summary><code>launch.json</code> configuration
+</summary>
+
+<p>
+
+```
+XXX
+```
+
+</p>
+</details>
+
+<details>
+
+<summary>Output for <code>Python</code> in the <code>Output</code> panel (<code>View</code>→<code>Output</code>, change the drop-down the upper-right of the <code>Output</code> panel to <code>Python</code>)
+</summary>
+
+<p>
+
+```
+XXX
+```
+
+</p>
+</details>
+
+<details>
+
+<summary>Output for <code>Python Debugger</code> in the <code>Output</code> panel (<code>View</code>→<code>Output</code>, change the drop-down the upper-right of the <code>Output</code> panel to <code>Python Debugger</code>)
+</summary>
+
+<p>
+
+```
+XXX
+```
+
+</p>
+</details>

resources/report_issue_user_data_template.md

@@ -0,0 +1,2 @@
+-   Python version (& distribution if applicable, e.g. Anaconda): {0}
+-   Type of virtual environment used (e.g. conda, venv, virtualenv, etc.): {1}

src/extension/common/application/commands/reportIssueCommand.ts

@@ -0,0 +1,34 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+
+'use strict';
+
+import * as fs from 'fs-extra';
+import * as path from 'path';
+import { executeCommand } from '../../vscodeapi';
+import { getActiveEnvironmentPath, resolveEnvironment } from '../../python';
+import { EXTENSION_ROOT_DIR } from '../../constants';
+import { getRawVersion } from '../../settings';
+import { sendTelemetryEvent } from '../../../telemetry';
+import { EventName } from '../../../telemetry/constants';
+
+/**
+ * Allows the user to report an issue related to the Python Debugger extension using our template.
+ */
+export async function openReportIssue(): Promise<void> {
+    const templatePath = path.join(EXTENSION_ROOT_DIR, 'resources', 'report_issue_template.md');
+    const userDataTemplatePath = path.join(EXTENSION_ROOT_DIR, 'resources', 'report_issue_user_data_template.md');
+    const template = await fs.readFile(templatePath, 'utf8');
+    const userTemplate = await fs.readFile(userDataTemplatePath, 'utf8');
+    const interpreterPath = await getActiveEnvironmentPath();
+    const interpreter = await resolveEnvironment(interpreterPath);
+    const virtualEnvKind = interpreter?.environment?.type || 'Unknown';
+
+    const pythonVersion = getRawVersion(interpreter?.version);
+    await executeCommand('workbench.action.openIssueReporter', {
+        extensionId: 'ms-python.debugpy',
+        issueBody: template,
+        data: userTemplate.replace('{0}', pythonVersion).replace('{1}', virtualEnvKind),
+    });
+    sendTelemetryEvent(EventName.USE_REPORT_ISSUE_COMMAND, undefined, {});
+}

src/extension/common/constants.ts

@@ -7,7 +7,7 @@ import * as path from 'path';
 export const PYTHON_LANGUAGE = 'python';
 const folderName = path.basename(__dirname);
 export const EXTENSION_ROOT_DIR =
-    folderName === 'common' ? path.dirname(path.dirname(__dirname)) : path.dirname(__dirname);
+    folderName === 'common' ? path.dirname(path.dirname(path.dirname(__dirname))) : path.dirname(__dirname);
 export const BUNDLED_PYTHON_SCRIPTS_DIR = path.join(EXTENSION_ROOT_DIR, 'bundled');
 export const SERVER_SCRIPT_PATH = path.join(BUNDLED_PYTHON_SCRIPTS_DIR, 'tool', `server.py`);
 export const DEBUG_SERVER_SCRIPT_PATH = path.join(BUNDLED_PYTHON_SCRIPTS_DIR, 'tool', `_debug_server.py`);
@@ -39,6 +39,7 @@ export namespace Commands {
     export const Enable_SourceMap_Support = 'debugpy.enableSourceMapSupport';
     export const SelectDebugConfig = 'debugpy.SelectAndInsertDebugConfiguration';
     export const Set_Interpreter = 'python.setInterpreter';
+    export const ReportIssue = 'debugpy.reportIssue';
 }
 
 export type Channel = 'stable' | 'insiders';

src/extension/common/settings.ts

@@ -5,6 +5,7 @@ import { ConfigurationChangeEvent, ConfigurationTarget, Uri, WorkspaceConfigurat
 import { getInterpreterDetails } from './python';
 import { getConfiguration, getWorkspaceFolder, getWorkspaceFolders } from './vscodeapi';
 import { isUnitTestExecution } from './constants';
+import { VersionInfo } from '@vscode/python-extension';
 
 export interface ISettings {
     workspace: string;
@@ -15,7 +16,6 @@ export interface ISettings {
 export async function getExtensionSettings(namespace: string, includeInterpreter?: boolean): Promise<ISettings[]> {
     const settings: ISettings[] = [];
     const workspaces = getWorkspaceFolders();
-
     for (const workspace of workspaces) {
         const workspaceSetting = await getWorkspaceSettings(namespace, workspace, includeInterpreter);
         settings.push(workspaceSetting);
@@ -149,3 +149,10 @@ export async function verifySetting(
         } while (retries < 20);
     }
 }
+
+export function getRawVersion(version: VersionInfo | undefined) {
+    if (version) {
+        return `${version.major}.${version.minor}.${version.micro}`;
+    }
+    return ``;
+}

src/extension/extensionInit.ts

@@ -34,6 +34,7 @@ import { pickArgsInput } from './common/utils/localize';
 import { DebugPortAttributesProvider } from './debugger/debugPort/portAttributesProvider';
 import { getConfigurationsByUri } from './debugger/configuration/launch.json/launchJsonReader';
 import { DebugpySocketsHandler } from './debugger/hooks/debugpySocketsHandler';
+import { openReportIssue } from './common/application/commands/reportIssueCommand';
 
 export async function registerDebugger(context: IExtensionContext): Promise<void> {
     const childProcessAttachService = new ChildProcessAttachService();
@@ -63,6 +64,8 @@ export async function registerDebugger(context: IExtensionContext): Promise<void
         ),
     );
 
+    context.subscriptions.push(registerCommand(Commands.ReportIssue, () => openReportIssue()));
+
     context.subscriptions.push(
         registerCommand(Commands.Debug_In_Terminal, async (file?: Uri) => {
             sendTelemetryEvent(EventName.DEBUG_IN_TERMINAL_BUTTON);

src/extension/telemetry/constants.ts

@@ -19,4 +19,5 @@ export enum EventName {
     DEBUGGER_CONFIGURATION_PROMPTS = 'DEBUGGER.CONFIGURATION.PROMPTS',
     DEBUGGER_CONFIGURATION_PROMPTS_IN_LAUNCH_JSON = 'DEBUGGER.CONFIGURATION.PROMPTS.IN.LAUNCH.JSON',
     ENVFILE_VARIABLE_SUBSTITUTION = 'ENVFILE_VARIABLE_SUBSTITUTION',
+    USE_REPORT_ISSUE_COMMAND = 'USE_REPORT_ISSUE_COMMAND',
 }

src/extension/telemetry/index.ts

@@ -660,4 +660,11 @@ export interface IEventNamePropertyMapping {
        "envfile_variable_substitution" : { "owner": "karthiknadig" }
      */
     [EventName.ENVFILE_VARIABLE_SUBSTITUTION]: never | undefined;
+    /**
+     * Telemetry event sent when the user use the report issue command.
+     */
+    /* __GDPR__
+      "use_report_issue_command" : { "owner": "paulacamargo25" }
+     */
+    [EventName.USE_REPORT_ISSUE_COMMAND]: unknown;
 }