{

"name": "python",

"displayName": "Python",

"description": "Python language support with extension access points for IntelliSense (Pylance), Debugging (Python Debugger), linting, formatting, refactoring, unit tests, and more.",

"version": "2025.9.0-dev",

"featureFlags": {

"usingNewInterpreterStorage": true

},

"capabilities": {

"untrustedWorkspaces": {

"supported": "limited",

"description": "Only Partial IntelliSense with Pylance is supported. Cannot execute Python with untrusted files."

},

"virtualWorkspaces": {

"supported": "limited",

"description": "Only Partial IntelliSense supported."

}

},

"publisher": "ms-python",

"enabledApiProposals": [

"contribEditorContentMenu",

"quickPickSortByLabel",

"testObserver",

"quickPickItemTooltip",

"terminalDataWriteEvent",

"terminalExecuteCommandEvent",

"codeActionAI",

"notebookReplDocument",

"notebookVariableProvider"

],

"author": {

"name": "Microsoft Corporation"

},

"license": "MIT",

"homepage": "https://github.com/Microsoft/vscode-python",

"repository": {

"type": "git",

"url": "https://github.com/Microsoft/vscode-python"

},

"bugs": {

"url": "https://github.com/Microsoft/vscode-python/issues"

},

"qna": "https://github.com/microsoft/vscode-python/discussions/categories/q-a",

"icon": "icon.png",

"galleryBanner": {

"color": "#1e415e",

"theme": "dark"

},

"engines": {

"vscode": "^1.95.0"

},

"enableTelemetry": false,

"keywords": [

"python",

"django",

"unittest",

"multi-root ready"

],

"categories": [

"Programming Languages",

"Debuggers",

"Other",

"Data Science",

"Machine Learning"

],

"activationEvents": [

"onDebugInitialConfigurations",

"onLanguage:python",

"onDebugResolve:python",

"onCommand:python.copilotSetupTests",

"workspaceContains:mspythonconfig.json",

"workspaceContains:pyproject.toml",

"workspaceContains:Pipfile",

"workspaceContains:setup.py",

"workspaceContains:requirements.txt",

"workspaceContains:pylock.toml",

"workspaceContains:**/pylock.*.toml",

"workspaceContains:manage.py",

"workspaceContains:app.py",

"workspaceContains:.venv",

"workspaceContains:.conda",

"onLanguageModelTool:get_python_environment_details",

"onLanguageModelTool:get_python_executable_details",

"onLanguageModelTool:install_python_packages",

"onLanguageModelTool:configure_python_environment",

"onLanguageModelTool:create_virtual_environment"

],

"main": "./out/client/extension",

"browser": "./dist/extension.browser.js",

"l10n": "./l10n",

"contributes": {

"problemMatchers": [

{

"name": "python",

"owner": "python",

"source": "python",

"fileLocation": "autoDetect",

"pattern": [

{

"regexp": "^.*File \\\"([^\\\"]|.*)\\\", line (\\d+).*",

"file": 1,

"line": 2

},

{

"regexp": "^\\s*(.*)\\s*$"

},

{

"regexp": "^\\s*(.*Error.*)$",

"message": 1

}

]

}

],

"walkthroughs": [

{

"id": "pythonWelcome",

"title": "%walkthrough.pythonWelcome.title%",

"description": "%walkthrough.pythonWelcome.description%",

"when": "workspacePlatform != webworker",

"steps": [

{

"id": "python.createPythonFolder",

"title": "%walkthrough.step.python.createPythonFolder.title%",

"description": "%walkthrough.step.python.createPythonFolder.description%",

"media": {

"svg": "resources/walkthrough/open-folder.svg",

"altText": "%walkthrough.step.python.createPythonFile.altText%"

},

"when": "workspaceFolderCount = 0"

},

{

"id": "python.createPythonFile",

"title": "%walkthrough.step.python.createPythonFile.title%",

"description": "%walkthrough.step.python.createPythonFile.description%",

"media": {

"svg": "resources/walkthrough/open-folder.svg",

"altText": "%walkthrough.step.python.createPythonFile.altText%"

}

},

{

"id": "python.installPythonWin8",

"title": "%walkthrough.step.python.installPythonWin8.title%",

"description": "%walkthrough.step.python.installPythonWin8.description%",

"media": {

"markdown": "resources/walkthrough/install-python-windows-8.md"

},

"when": "workspacePlatform == windows && showInstallPythonTile"

},

{

"id": "python.installPythonMac",

"title": "%walkthrough.step.python.installPythonMac.title%",

"description": "%walkthrough.step.python.installPythonMac.description%",

"media": {

"markdown": "resources/walkthrough/install-python-macos.md"

},

"when": "workspacePlatform == mac && showInstallPythonTile",

"command": "workbench.action.terminal.new"

},

{

"id": "python.installPythonLinux",

"title": "%walkthrough.step.python.installPythonLinux.title%",

"description": "%walkthrough.step.python.installPythonLinux.description%",

"media": {

"markdown": "resources/walkthrough/install-python-linux.md"

},

"when": "workspacePlatform == linux && showInstallPythonTile",

"command": "workbench.action.terminal.new"

},

{

"id": "python.createEnvironment",

"title": "%walkthrough.step.python.createEnvironment.title%",

"description": "%walkthrough.step.python.createEnvironment.description%",

"media": {

"svg": "resources/walkthrough/create-environment.svg",

"altText": "%walkthrough.step.python.createEnvironment.altText%"

}

},

{

"id": "python.runAndDebug",

"title": "%walkthrough.step.python.runAndDebug.title%",

"description": "%walkthrough.step.python.runAndDebug.description%",

"media": {

"svg": "resources/walkthrough/rundebug2.svg",

"altText": "%walkthrough.step.python.runAndDebug.altText%"

}

},

{

"id": "python.learnMoreWithDS",

"title": "%walkthrough.step.python.learnMoreWithDS.title%",

"description": "%walkthrough.step.python.learnMoreWithDS.description%",

"media": {

"altText": "%walkthrough.step.python.learnMoreWithDS.altText%",

"svg": "resources/walkthrough/learnmore.svg"

}

}

]

},

{

"id": "pythonDataScienceWelcome",

"title": "%walkthrough.pythonDataScienceWelcome.title%",

"description": "%walkthrough.pythonDataScienceWelcome.description%",

"when": "false",

"steps": [

{

"id": "python.installJupyterExt",

"title": "%walkthrough.step.python.installJupyterExt.title%",

"description": "%walkthrough.step.python.installJupyterExt.description%",

"media": {

"svg": "resources/walkthrough/data-science.svg",

"altText": "%walkthrough.step.python.installJupyterExt.altText%"

}

},

{

"id": "python.createNewNotebook",

"title": "%walkthrough.step.python.createNewNotebook.title%",

"description": "%walkthrough.step.python.createNewNotebook.description%",

"media": {

"svg": "resources/walkthrough/create-notebook.svg",

"altText": "%walkthrough.step.python.createNewNotebook.altText%"

},

"completionEvents": [

"onCommand:jupyter.createnewnotebook",

"onCommand:workbench.action.files.openFolder",

"onCommand:workbench.action.files.openFileFolder"

]

},

{

"id": "python.openInteractiveWindow",

"title": "%walkthrough.step.python.openInteractiveWindow.title%",

"description": "%walkthrough.step.python.openInteractiveWindow.description%",

"media": {

"svg": "resources/walkthrough/interactive-window.svg",

"altText": "%walkthrough.step.python.openInteractiveWindow.altText%"

},

"completionEvents": [

"onCommand:jupyter.createnewinteractive"

]

},

{

"id": "python.dataScienceLearnMore",

"title": "%walkthrough.step.python.dataScienceLearnMore.title%",

"description": "%walkthrough.step.python.dataScienceLearnMore.description%",

"media": {

"svg": "resources/walkthrough/learnmore.svg",

"altText": "%walkthrough.step.python.dataScienceLearnMore.altText%"

}

}

]

}

],

"breakpoints": [

{

"language": "html"

},

{

"language": "jinja"

},

{

"language": "python"

},

{

"language": "django-html"

},

{

"language": "django-txt"

}

],

"commands": [

{

"title": "%python.command.python.createNewFile.title%",

"shortTitle": "%python.menu.createNewFile.title%",

"category": "Python",

"command": "python.createNewFile"

},

{

"category": "Python",

"command": "python.analysis.restartLanguageServer",

"title": "%python.command.python.analysis.restartLanguageServer.title%"

},

{

"category": "Python",

"command": "python.clearCacheAndReload",

"title": "%python.command.python.clearCacheAndReload.title%"

},

{

"category": "Python",

"command": "python.clearWorkspaceInterpreter",

"title": "%python.command.python.clearWorkspaceInterpreter.title%"

},

{

"category": "Python",

"command": "python.configureTests",

"title": "%python.command.python.configureTests.title%"

},

{

"category": "Python",

"command": "python.createTerminal",

"title": "%python.command.python.createTerminal.title%"

},

{

"category": "Python",

"command": "python.createEnvironment",

"title": "%python.command.python.createEnvironment.title%"

},

{

"category": "Python",

"command": "python.createEnvironment-button",

"title": "%python.command.python.createEnvironment.title%"

},

{

"category": "Python",

"command": "python.execInTerminal",

"title": "%python.command.python.execInTerminal.title%"

},

{

"category": "Python",

"command": "python.execInTerminal-icon",

"icon": "$(play)",

"title": "%python.command.python.execInTerminalIcon.title%"

},

{

"category": "Python",

"command": "python.execInDedicatedTerminal",

"icon": "$(play)",

"title": "%python.command.python.execInDedicatedTerminal.title%"

},

{

"category": "Python",

"command": "python.execSelectionInDjangoShell",

"title": "%python.command.python.execSelectionInDjangoShell.title%"

},

{

"category": "Python",

"command": "python.execSelectionInTerminal",

"title": "%python.command.python.execSelectionInTerminal.title%",

"shortTitle": "%python.command.python.execSelectionInTerminal.shortTitle%"

},

{

"category": "Python",

"command": "python.execInREPL",

"title": "%python.command.python.execInREPL.title%"

},

{

"category": "Python",

"command": "python.reportIssue",

"title": "%python.command.python.reportIssue.title%"

},

{

"category": "Test",

"command": "testing.reRunFailTests",

"icon": "$(run-errors)",

"title": "%python.command.testing.rerunFailedTests.title%"

},

{

"category": "Python",

"command": "python.setInterpreter",

"title": "%python.command.python.setInterpreter.title%"

},

{

"category": "Python",

"command": "python.startREPL",

"title": "%python.command.python.startTerminalREPL.title%"

},

{

"category": "Python",

"command": "python.startNativeREPL",

"title": "%python.command.python.startNativeREPL.title%"

},

{

"category": "Python",

"command": "python.viewLanguageServerOutput",

"enablement": "python.hasLanguageServerOutputChannel",

"title": "%python.command.python.viewLanguageServerOutput.title%"

},

{

"category": "Python",

"command": "python.viewOutput",

"icon": {

"dark": "resources/dark/repl.svg",

"light": "resources/light/repl.svg"

},

"title": "%python.command.python.viewOutput.title%"

},

{

"category": "Python",

"command": "python.installJupyter",

"title": "%python.command.python.installJupyter.title%"

}

],

"configuration": {

"properties": {

"python.activeStateToolPath": {

"default": "state",

"description": "%python.activeStateToolPath.description%",

"scope": "machine-overridable",

"type": "string"

},

"python.autoComplete.extraPaths": {

"default": [],

"description": "%python.autoComplete.extraPaths.description%",

"scope": "resource",

"type": "array",

"uniqueItems": true

},

"python.createEnvironment.contentButton": {

"default": "hide",

"markdownDescription": "%python.createEnvironment.contentButton.description%",

"scope": "machine-overridable",

"type": "string",

"enum": [

"show",

"hide"

]

},

"python.createEnvironment.trigger": {

"default": "prompt",

"markdownDescription": "%python.createEnvironment.trigger.description%",

"scope": "machine-overridable",

"type": "string",

"enum": [

"off",

"prompt"

]

},

"python.condaPath": {

"default": "",

"description": "%python.condaPath.description%",

"scope": "machine",

"type": "string"

},

"python.defaultInterpreterPath": {

"default": "python",

"markdownDescription": "%python.defaultInterpreterPath.description%",

"scope": "machine-overridable",

"type": "string"

},

"python.envFile": {

"default": "${workspaceFolder}/.env",

"description": "%python.envFile.description%",

"scope": "resource",

"type": "string"

},

"python.experiments.enabled": {

"default": true,

"description": "%python.experiments.enabled.description%",

"scope": "window",

"type": "boolean"

},

"python.experiments.optInto": {

"default": [],

"markdownDescription": "%python.experiments.optInto.description%",

"items": {

"enum": [

"All",

"pythonSurveyNotification",

"pythonPromptNewToolsExt",

"pythonTerminalEnvVarActivation",

"pythonDiscoveryUsingWorkers",

"pythonTestAdapter"

],

"enumDescriptions": [

"%python.experiments.All.description%",

"%python.experiments.pythonSurveyNotification.description%",

"%python.experiments.pythonPromptNewToolsExt.description%",

"%python.experiments.pythonTerminalEnvVarActivation.description%",

"%python.experiments.pythonDiscoveryUsingWorkers.description%",

"%python.experiments.pythonTestAdapter.description%"

]

},

"scope": "window",

"type": "array",

"uniqueItems": true

},

"python.experiments.optOutFrom": {

"default": [],

"markdownDescription": "%python.experiments.optOutFrom.description%",

"items": {

"enum": [

"All",

"pythonSurveyNotification",

"pythonPromptNewToolsExt",

"pythonTerminalEnvVarActivation",

"pythonDiscoveryUsingWorkers",

"pythonTestAdapter"

],

"enumDescriptions": [

"%python.experiments.All.description%",

"%python.experiments.pythonSurveyNotification.description%",

"%python.experiments.pythonPromptNewToolsExt.description%",

"%python.experiments.pythonTerminalEnvVarActivation.description%",

"%python.experiments.pythonDiscoveryUsingWorkers.description%",

"%python.experiments.pythonTestAdapter.description%"

]

},

"scope": "window",

"type": "array",

"uniqueItems": true

},

"python.globalModuleInstallation": {

"default": false,

"description": "%python.globalModuleInstallation.description%",

"scope": "resource",

"type": "boolean"

},

"python.languageServer": {

"default": "Default",

"description": "%python.languageServer.description%",

"enum": [

"Default",

"Jedi",

"Pylance",

"None"

],

"enumDescriptions": [

"%python.languageServer.defaultDescription%",

"%python.languageServer.jediDescription%",

"%python.languageServer.pylanceDescription%",

"%python.languageServer.noneDescription%"

],

"scope": "window",

"type": "string"

},

"python.interpreter.infoVisibility": {

"default": "onPythonRelated",

"description": "%python.interpreter.infoVisibility.description%",

"enum": [

"never",

"onPythonRelated",

"always"

],

"enumDescriptions": [

"%python.interpreter.infoVisibility.never.description%",

"%python.interpreter.infoVisibility.onPythonRelated.description%",

"%python.interpreter.infoVisibility.always.description%"

],

"scope": "machine",

"type": "string"

},

"python.logging.level": {

"default": "error",

"deprecationMessage": "%python.logging.level.deprecation%",

"description": "%python.logging.level.description%",

"enum": [

"debug",

"error",

"info",

"off",

"warn"

],

"scope": "machine",

"type": "string"

},

"python.missingPackage.severity": {

"default": "Hint",

"description": "%python.missingPackage.severity.description%",

"enum": [

"Error",

"Hint",

"Information",

"Warning"

],

"scope": "resource",

"type": "string"

},

"python.locator": {

"default": "js",

"description": "%python.locator.description%",

"enum": [

"js",

"native"

],

"tags": [

"onExP",

"preview"

],

"scope": "machine",

"type": "string"

},

"python.pipenvPath": {

"default": "pipenv",

"description": "%python.pipenvPath.description%",

"scope": "machine-overridable",

"type": "string"

},

"python.poetryPath": {

"default": "poetry",

"description": "%python.poetryPath.description%",

"scope": "machine-overridable",

"type": "string"

},

"python.pixiToolPath": {

"default": "pixi",

"description": "%python.pixiToolPath.description%",

"scope": "machine-overridable",

"type": "string"

},

"python.terminal.activateEnvInCurrentTerminal": {

"default": false,

"description": "%python.terminal.activateEnvInCurrentTerminal.description%",

"scope": "resource",

"type": "boolean"

},

"python.terminal.activateEnvironment": {

"default": true,

"description": "%python.terminal.activateEnvironment.description%",

"scope": "resource",

"type": "boolean"

},

"python.terminal.executeInFileDir": {

"default": false,

"description": "%python.terminal.executeInFileDir.description%",

"scope": "resource",

"type": "boolean"

},

"python.terminal.focusAfterLaunch": {

"default": false,

"description": "%python.terminal.focusAfterLaunch.description%",

"scope": "resource",

"type": "boolean"

},

"python.terminal.launchArgs": {

"default": [],

"description": "%python.terminal.launchArgs.description%",

"scope": "resource",

"type": "array"

},

"python.terminal.shellIntegration.enabled": {

"default": false,

"markdownDescription": "%python.terminal.shellIntegration.enabled.description%",

"scope": "resource",

"type": "boolean",

"tags": [

"preview"

]

},

"python.REPL.enableREPLSmartSend": {

"default": true,

"description": "%python.EnableREPLSmartSend.description%",

"scope": "resource",

"type": "boolean"

},

"python.REPL.sendToNativeREPL": {

"default": false,

"description": "%python.REPL.sendToNativeREPL.description%",

"scope": "resource",

"type": "boolean"

},

"python.REPL.provideVariables": {

"default": true,

"description": "%python.REPL.provideVariables.description%",

"scope": "resource",

"type": "boolean"

},

"python.testing.autoTestDiscoverOnSaveEnabled": {

"default": true,

"description": "%python.testing.autoTestDiscoverOnSaveEnabled.description%",

"scope": "resource",

"type": "boolean"

},

"python.testing.autoTestDiscoverOnSavePattern": {

"default": "**/*.py",

"description": "%python.testing.autoTestDiscoverOnSavePattern.description%",

"scope": "resource",

"type": "string"

},

"python.testing.cwd": {

"default": null,

"description": "%python.testing.cwd.description%",

"scope": "resource",

"type": "string"

},

"python.testing.debugPort": {

"default": 3000,

"description": "%python.testing.debugPort.description%",

"scope": "resource",

"type": "number"

},

"python.testing.promptToConfigure": {

"default": true,

"description": "%python.testing.promptToConfigure.description%",

"scope": "resource",

"type": "boolean"

},

"python.testing.pytestArgs": {

"default": [],

"description": "%python.testing.pytestArgs.description%",

"items": {

"type": "string"

},

"scope": "resource",

"type": "array"

},

"python.testing.pytestEnabled": {

"default": false,

"description": "%python.testing.pytestEnabled.description%",

"scope": "resource",

"type": "boolean"

},

"python.testing.pytestPath": {

"default": "pytest",

"description": "%python.testing.pytestPath.description%",

"scope": "machine-overridable",

"type": "string"

},

"python.testing.unittestArgs": {

"default": [

"-v",

"-s",

".",

"-p",

"*test*.py"

],

"description": "%python.testing.unittestArgs.description%",

"items": {

"type": "string"

},

"scope": "resource",

"type": "array"

},

"python.testing.unittestEnabled": {

"default": false,

"description": "%python.testing.unittestEnabled.description%",

"scope": "resource",

"type": "boolean"

},

"python.venvFolders": {

"default": [],

"description": "%python.venvFolders.description%",

"items": {

"type": "string"

},

"scope": "machine",

"type": "array",

"uniqueItems": true

},

"python.venvPath": {

"default": "",

"description": "%python.venvPath.description%",

"scope": "machine",

"type": "string"

}

},

"title": "Python",

"type": "object"

},

"debuggers": [

{

"configurationAttributes": {

"attach": {

"properties": {

"connect": {

"label": "Attach by connecting to debugpy over a socket.",

"properties": {

"host": {

"default": "127.0.0.1",

"description": "Hostname or IP address to connect to.",

"type": "string"

},

"port": {

"description": "Port to connect to.",

"type": "number"

}

},

"required": [

"port"

],

"type": "object"

},

"debugAdapterPath": {

"description": "Path (fully qualified) to the python debug adapter executable.",

"type": "string"

},

"django": {

"default": false,

"description": "Django debugging.",

"type": "boolean"

},

"host": {

"default": "127.0.0.1",

"description": "Hostname or IP address to connect to.",

"type": "string"

},

"jinja": {

"default": null,

"description": "Jinja template debugging (e.g. Flask).",

"enum": [

false,

null,

true

]

},

"justMyCode": {

"default": true,

"description": "If true, show and debug only user-written code. If false, show and debug all code, including library calls.",

"type": "boolean"

},

"listen": {

"label": "Attach by listening for incoming socket connection from debugpy",

"properties": {

"host": {

"default": "127.0.0.1",

"description": "Hostname or IP address of the interface to listen on.",

"type": "string"

},

"port": {

"description": "Port to listen on.",

"type": "number"

}

},

"required": [

"port"

],

"type": "object"

},

"logToFile": {

"default": false,

"description": "Enable logging of debugger events to a log file.",

"type": "boolean"

},

"pathMappings": {

"default": [],

"items": {

"label": "Path mapping",

"properties": {

"localRoot": {

"default": "${workspaceFolder}",

"label": "Local source root.",

"type": "string"

},

"remoteRoot": {

"default": "",

"label": "Remote source root.",

"type": "string"

}

},

"required": [

"localRoot",

"remoteRoot"

],

"type": "object"

},

"label": "Path mappings.",

"type": "array"

},

"port": {

"description": "Port to connect to.",

"type": "number"

},

"processId": {

"anyOf": [

{

"default": "${command:pickProcess}",

"description": "Use process picker to select a process to attach, or Process ID as integer.",

"enum": [

"${command:pickProcess}"

]

},

{

"description": "ID of the local process to attach to.",

"type": "integer"

}

]

},

"redirectOutput": {

"default": true,

"description": "Redirect output.",

"type": "boolean"

},

"showReturnValue": {

"default": true,

"description": "Show return value of functions when stepping.",

"type": "boolean"

},

"subProcess": {

"default": false,

"description": "Whether to enable Sub Process debugging",

"type": "boolean"

}

}

},

"launch": {

"properties": {

"args": {

"default": [],

"description": "Command line arguments passed to the program.",

"items": {

"type": "string"

},

"type": [

"array",

"string"

]

},

"autoReload": {

"default": {},

"description": "Configures automatic reload of code on edit.",

"properties": {

"enable": {

"default": false,

"description": "Automatically reload code on edit.",

"type": "boolean"

},

"exclude": {

"default": [

"**/.git/**",

"**/.metadata/**",

"**/__pycache__/**",

"**/node_modules/**",

"**/site-packages/**"

],

"description": "Glob patterns of paths to exclude from auto reload.",

"items": {

"type": "string"

},

"type": "array"

},

"include": {

"default": [

"**/*.py",

"**/*.pyw"

],

"description": "Glob patterns of paths to include in auto reload.",

"items": {

"type": "string"

},

"type": "array"

}

},

"type": "object"

},

"console": {

"default": "integratedTerminal",

"description": "Where to launch the debug target: internal console, integrated terminal, or external terminal.",

"enum": [

"externalTerminal",

"integratedTerminal",

"internalConsole"

]

},

"consoleTitle": {

"default": "Python Debug Console",

"description": "Display name of the debug console or terminal"

},

"cwd": {

"default": "${workspaceFolder}",

"description": "Absolute path to the working directory of the program being debugged. Default is the root directory of the file (leave empty).",

"type": "string"

},

"debugAdapterPath": {

"description": "Path (fully qualified) to the python debug adapter executable.",

"type": "string"

},

"django": {

"default": false,

"description": "Django debugging.",

"type": "boolean"

},

"env": {

"additionalProperties": {

"type": "string"

},

"default": {},

"description": "Environment variables defined as a key value pair. Property ends up being the Environment Variable and the value of the property ends up being the value of the Env Variable.",

"type": "object"

},

"envFile": {

"default": "${workspaceFolder}/.env",

"description": "Absolute path to a file containing environment variable definitions.",

"type": "string"

},

"gevent": {

"default": false,

"description": "Enable debugging of gevent monkey-patched code.",

"type": "boolean"

},

"host": {

"default": "localhost",

"description": "IP address of the of the local debug server (default is localhost).",

"type": "string"

},

"jinja": {

"default": null,

"description": "Jinja template debugging (e.g. Flask).",

"enum": [

false,

null,

true

]

},

"justMyCode": {

"default": true,

"description": "Debug only user-written code.",

"type": "boolean"

},

"logToFile": {

"default": false,

"description": "Enable logging of debugger events to a log file.",

"type": "boolean"

},

"module": {