Launch Native REPL using terminal link

python_files/pythonrc.py

@@ -8,7 +8,6 @@
 use_shell_integration = sys.version_info < (3, 13)
 is_wsl = "microsoft-standard-WSL" in platform.release()
 
-
 class REPLHooks:
     def __init__(self):
         self.global_exit = None
@@ -77,3 +76,8 @@ def __str__(self):
 
 if sys.platform != "win32" and (not is_wsl) and use_shell_integration:
     sys.ps1 = PS1()
+
+if sys.platform == "darwin":
+    print("Cmd click to launch VS Code Native REPL")
+else:
+    print("Ctrl click to launch VS Code Native REPL")

python_files/tests/test_shell_integration.py

@@ -2,7 +2,7 @@
 import platform
 import sys
 from unittest.mock import Mock
-
+import pytest
 import pythonrc
 
 is_wsl = "microsoft-standard-WSL" in platform.release()
@@ -61,3 +61,18 @@ def test_excepthook_call():
 
     hooks.my_excepthook("mock_type", "mock_value", "mock_traceback")
     mock_excepthook.assert_called_once_with("mock_type", "mock_value", "mock_traceback")
+
+def test_print_statement_darwin(monkeypatch):
+    monkeypatch.setattr(sys, 'platform', 'darwin')
+    with monkeypatch.context() as m:
+        m.setattr('builtins.print', Mock())
+        importlib.reload(sys.modules['pythonrc'])
+        print.assert_any_call("Cmd click to launch VS Code Native REPL")
+
+
+def test_print_statement_non_darwin(monkeypatch):
+    monkeypatch.setattr(sys, 'platform', 'win32')
+    with monkeypatch.context() as m:
+        m.setattr('builtins.print', Mock())
+        importlib.reload(sys.modules['pythonrc'])
+        print.assert_any_call("Ctrl click to launch VS Code Native REPL")

src/client/common/vscodeApis/windowApis.ts

@@ -21,6 +21,7 @@ import {
     TerminalShellExecutionStartEvent,
     LogOutputChannel,
     OutputChannel,
+    TerminalLinkProvider,
 } from 'vscode';
 import { createDeferred, Deferred } from '../utils/async';
 import { Resource } from '../types';
@@ -258,3 +259,7 @@ export function createOutputChannel(name: string, languageId?: string): OutputCh
 export function createLogOutputChannel(name: string, options: { log: true }): LogOutputChannel {
     return window.createOutputChannel(name, options);
 }
+
+export function registerTerminalLinkProvider(provider: TerminalLinkProvider): Disposable {
+    return window.registerTerminalLinkProvider(provider);
+}

src/client/extensionActivation.ts

@@ -55,6 +55,7 @@ import { registerReplCommands, registerReplExecuteOnEnter, registerStartNativeRe
 import { registerTriggerForTerminalREPL } from './terminals/codeExecution/terminalReplWatcher';
 import { registerPythonStartup } from './terminals/pythonStartup';
 import { registerPixiFeatures } from './pythonEnvironments/common/environmentManagers/pixi';
+import { registerCustomTerminalLinkProvider } from './terminals/pythonStartupLinkProvider';
 
 export async function activateComponents(
     // `ext` is passed to any extra activation funcs.
@@ -115,6 +116,7 @@ export function activateFeatures(ext: ExtensionState, _components: Components):
     registerStartNativeReplCommand(ext.disposables, interpreterService);
     registerReplCommands(ext.disposables, interpreterService, executionHelper, commandManager);
     registerReplExecuteOnEnter(ext.disposables, interpreterService, commandManager);
+    registerCustomTerminalLinkProvider(ext.disposables);
 }
 
 /// //////////////////////////

src/client/terminals/pythonStartupLinkProvider.ts

@@ -0,0 +1,47 @@
+/* eslint-disable class-methods-use-this */
+import {
+    CancellationToken,
+    Disposable,
+    ProviderResult,
+    TerminalLink,
+    TerminalLinkContext,
+    TerminalLinkProvider,
+    l10n,
+} from 'vscode';
+import { executeCommand } from '../common/vscodeApis/commandApis';
+import { registerTerminalLinkProvider } from '../common/vscodeApis/windowApis';
+
+interface CustomTerminalLink extends TerminalLink {
+    command: string;
+}
+
+export class CustomTerminalLinkProvider implements TerminalLinkProvider<CustomTerminalLink> {
+    provideTerminalLinks(
+        context: TerminalLinkContext,
+        _token: CancellationToken,
+    ): ProviderResult<CustomTerminalLink[]> {
+        const links: CustomTerminalLink[] = [];
+        // Question: What if context.line is truncated because of user zoom setting?
+        // Meaning what if this line is separated into two+ line in terminal?
+        const expectedNativeLink = 'VS Code Native REPL';
+
+        // eslint-disable-next-line no-cond-assign
+        if (context.line.includes(expectedNativeLink)) {
+            links.push({
+                startIndex: context.line.indexOf(expectedNativeLink),
+                length: expectedNativeLink.length,
+                tooltip: l10n.t('Launch VS Code Native REPL'),
+                command: 'python.startNativeREPL',
+            });
+        }
+        return links;
+    }
+
+    async handleTerminalLink(link: CustomTerminalLink): Promise<void> {
+        await executeCommand(link.command);
+    }
+}
+
+export function registerCustomTerminalLinkProvider(disposables: Disposable[]): void {
+    disposables.push(registerTerminalLinkProvider(new CustomTerminalLinkProvider()));
+}

src/test/terminals/shellIntegration/pythonStartup.test.ts

@@ -3,10 +3,11 @@
 
 import * as sinon from 'sinon';
 import * as TypeMoq from 'typemoq';
-import { GlobalEnvironmentVariableCollection, Uri, WorkspaceConfiguration } from 'vscode';
+import { GlobalEnvironmentVariableCollection, Uri, WorkspaceConfiguration, Disposable } from 'vscode';
 import * as workspaceApis from '../../../client/common/vscodeApis/workspaceApis';
 import { registerPythonStartup } from '../../../client/terminals/pythonStartup';
 import { IExtensionContext } from '../../../client/common/types';
+import * as pythonStartupLinkProvider from '../../../client/terminals/pythonStartupLinkProvider';
 
 suite('Terminal - Shell Integration with PYTHONSTARTUP', () => {
     let getConfigurationStub: sinon.SinonStub;
@@ -20,7 +21,6 @@ suite('Terminal - Shell Integration with PYTHONSTARTUP', () => {
     setup(() => {
         context = TypeMoq.Mock.ofType<IExtensionContext>();
         globalEnvironmentVariableCollection = TypeMoq.Mock.ofType<GlobalEnvironmentVariableCollection>();
-
         // Question: Why do we have to set up environmentVariableCollection and globalEnvironmentVariableCollection in this flip-flop way?
         // Reference: /vscode-python/src/test/interpreters/activation/terminalEnvVarCollectionService.unit.test.ts
         context.setup((c) => c.environmentVariableCollection).returns(() => globalEnvironmentVariableCollection.object);
@@ -122,4 +122,18 @@ suite('Terminal - Shell Integration with PYTHONSTARTUP', () => {
 
         globalEnvironmentVariableCollection.verify((c) => c.delete('PYTHONSTARTUP'), TypeMoq.Times.once());
     });
+
+    test('Ensure registering terminal link calls registerTerminalLinkProvider', async () => {
+        const registerTerminalLinkProviderStub = sinon.stub(
+            pythonStartupLinkProvider,
+            'registerCustomTerminalLinkProvider',
+        );
+        const disposableArray: Disposable[] = [];
+        pythonStartupLinkProvider.registerCustomTerminalLinkProvider(disposableArray);
+
+        sinon.assert.calledOnce(registerTerminalLinkProviderStub);
+        sinon.assert.calledWith(registerTerminalLinkProviderStub, disposableArray);
+
+        registerTerminalLinkProviderStub.restore();
+    });
 });