Repository navigation
Embed Native REPL description link in the terminal #24754
Description
Activity
Hi Don, this is good feedback.
We do have a web page for this specifically, but hearing this makes me think maybe we should embed the url https://code.visualstudio.com/docs/python/run#_native-repl directly under the "click to launch native repl..." link.- changed the title
[-]How do learn about what this new `VS Code Native REPL` is?[/-][+]Embed Native REPL description link in the terminal [/+]on Jan 29, 2025 aybe we should embed the url https://code.visualstudio.com/docs/python/run#_native-repl directly under the "click to launch native repl..." link.
Yes thats the request, to have such a learn link in the terminal or the like.
Else I have no idea what I'm clicking into.Reacted by Anthony Kim- added a commit that references this issue
on Sep 2, 2026 Sharing media and context from merged PR #26134 for verification:
This pull request refactors how shell integration sequences are managed in
python_files/pythonrc.pyby introducing a dedicatedShellIntegrationSequenceenum, and updates related string formatting to use this enum. It also updates user-facing messages in both the Python startup script and the VS Code terminal link provider to include a documentation URL. These changes improve maintainability, clarity, and user guidance.Shell integration refactoring:
- Introduced the
ShellIntegrationSequenceenum to centralize shell integration control sequences, replacing hard-coded string literals throughout the code. [1] [2] - Refactored the
__str__method in the prompt class to use the new enum values, improving readability and reducing duplication.
User guidance improvements:
- Updated the printed startup message in
pythonrc.pyto include a documentation URL, guiding users to more information about the VS Code Native REPL. - Updated the expected link text in
pythonStartupLinkProvider.tsto match the new message format (excluding the URL), ensuring the link detection logic remains consistent with the Python script output.
Source PR: #26134
- Introduced the
Testing #24747
As a user who has no idea about this
Native REPL, I now have a way to launch this in the terminal, thats great.But I have no idea what this is? There no way to learn more about this feature apart from playing with this, but that too doesn't tell me what it is, what it can do.
I think we need a link to learn more about the
Native REPLin the terminal output before users can click on this.