Add support for Projects in Testing by eleanorjboyd · Pull Request #25780 · microsoft/vscode-python · GitHub

fixes microsoft/vscode-python-environments#987

## Summary This PR implements **project-based test discovery** for pytest, enabling multi-project workspace support. When the Python Environments API is available, the extension now discovers Python projects within workspaces and creates separate test tree roots for each project with its own Python environment. ## What's New ### Project-Based Testing Architecture - **TestProjectRegistry**: Manages the lifecycle of Python test projects, including: - Discovering projects via Python Environments API - Creating ProjectAdapter instances per workspace - Computing nested project relationships for ignore lists - Fallback to "legacy" single-adapter mode when API unavailable - **ProjectAdapter**: Interface representing a single Python project with test infrastructure: - Project identity (ID, name, URI) - Python environment from the environments API - Test framework adapters (discovery/execution) - Nested project ignore paths ### Key Features - ✅ **Multi-project workspaces**: Each Python project gets its own test tree root - ✅ **Nested project handling**: Parent projects automatically ignore nested child projects via `--ignore` flags - ✅ **Graceful fallback**: Falls back to legacy single-adapter mode if Python Environments API is unavailable - ✅ **Project root path**: Python-side `get_test_root_path()` function returns appropriate root for test tree ### Code Improvements - Standardized logging prefixes to `[test-by-project]` across all files - Centralized adapter creation via `createTestAdapters()` helper method - Extracted reusable methods for discovery, execution, and file watching ## Scope & Limitations > **⚠️ Important: unittest is NOT supported in this PR** > > This PR focuses exclusively on **pytest**. unittest support for project-based testing will be implemented in a future PR. ## Testing - Added unit tests for `TestProjectRegistry` class - Added unit tests for Python-side `get_test_root_path()` function - Manual testing with multi-project workspaces ## Related Issues first step in: microsoft/vscode-python-environments#987 --------- Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>

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

This adds a place within the github workspace that developers can store any AI related artifacts they create that could be useful but they don't want to commit. Things like issue summarization, plans for features, code analysis etc

Pull request overview

This PR adds project-based (multi-project) testing support to the VS Code Python extension’s Test Explorer integration, leveraging the Python Environments API so each project can be discovered/run/debugged with its own environment (fixes microsoft/vscode-python-environments#987).

Changes:

Introduces a project registry + project adapter model to discover/register multiple Python projects per workspace and run discovery/execution per project.
Scopes VS Code test IDs by project (via a project ID separator) and threads project context through discovery/execution adapters (including PROJECT_ROOT_PATH support in Python runner scripts).
Adds extensive unit tests (TS + Python) covering project-based discovery/execution, nested project behavior, and debug session handling.

Reviewed changes

Copilot reviewed 36 out of 36 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
src/client/testing/testController/controller.ts	Adds project-based activation/discovery/execution flow and project-change handling.
src/client/testing/testController/common/testProjectRegistry.ts	New registry for discovering projects, creating project-specific adapters/resolvers, and nested ignore computation.
src/client/testing/testController/common/projectAdapter.ts	Defines per-project adapter shape (env + adapters + resolver + lifecycle).
src/client/testing/testController/common/projectUtils.ts	Adds project ID scoping utilities + shared adapter creation helper.
src/client/testing/testController/common/projectTestExecution.ts	Executes selected tests grouped by owning project with project-specific environment/debug/coverage behavior.
src/client/testing/testController/common/utils.ts	Adds project-scoped IDs in populateTestTree() and project-aware error labels.
src/client/testing/testController/common/testDiscoveryHandler.ts	Routes discovery into project-scoped IDs and project-scoped error nodes.
src/client/testing/testController/pytest/pytestDiscoveryAdapter.ts	Threads ProjectAdapter through discovery; adds nested --ignore support; sets PROJECT_ROOT_PATH.
src/client/testing/testController/pytest/pytestExecutionAdapter.ts	Threads ProjectAdapter through execution; uses project env when available; sets PROJECT_ROOT_PATH.
src/client/testing/testController/unittest/testDiscoveryAdapter.ts	Threads ProjectAdapter through discovery; uses project env when available; sets PROJECT_ROOT_PATH.
src/client/testing/testController/unittest/testExecutionAdapter.ts	Threads ProjectAdapter through execution/debug; uses project env when available; sets PROJECT_ROOT_PATH.
src/client/testing/testController/workspaceTestAdapter.ts	Allows passing a ProjectAdapter to execution for project-scoped runs.
src/client/testing/common/debugLauncher.ts	Adds multi-session tracking via markers; supports project-based debug naming + Python path resolution.
python_files/vscode_pytest/init.py	Uses PROJECT_ROOT_PATH to root discovery/execution payload cwd/test-tree root for project mode.
python_files/unittestadapter/discovery.py	Supports PROJECT_ROOT_PATH to override cwd/top-level behavior for project-rooted discovery.
python_files/unittestadapter/execution.py	Supports PROJECT_ROOT_PATH to override cwd in execution payloads.
src/test/vscode-mock.ts	Adds vscode.tests.createTestController() mock for unit tests.
src/test/testing/testController/**	Adds unit tests for project registry, project execution grouping, controller behavior, adapters, and utilities.
python_files/tests/**	Adds Python-side tests for PROJECT_ROOT_PATH behavior for both unittest + pytest.
.github/instructions/testing_feature_area.instructions.md	Documents the new project-based testing architecture and key files/tests.

Pull request overview

Copilot reviewed 36 out of 36 changed files in this pull request and generated 3 comments.

fixes microsoft/vscode-python-environments#987 --------- Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>

Eleanor Boyd (eleanorjboyd) and others added 6 commits February 5, 2026 21:37

Thick-puffin (#25768 )

2d53b1f

Unittest discovery with py-env Projects Support (#25767 )

5104ff6

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

fix bug with double error nodes

42fb7b7

Add python-environment's project support for pytest execution (#25772 )

3b87651

Eleanor Boyd (eleanorjboyd) added the feature-request Request for new features or functionality label Feb 9, 2026

Eleanor Boyd (eleanorjboyd) self-assigned this Feb 9, 2026

Eleanor Boyd (eleanorjboyd) added 2 commits February 9, 2026 13:48

Python Environments Project Support for Unittest Execution (#25779 )

f048ef4

Merge branch 'main' into test-project-support

0cfd96d

Eleanor Boyd (eleanorjboyd) requested a review from Copilot February 9, 2026 21:54

Eleanor Boyd (eleanorjboyd) marked this pull request as ready for review February 9, 2026 21:54

Eleanor Boyd (eleanorjboyd) requested review from Anthony Kim (anthonykim1) and Karthik Nadig (karthiknadig) February 9, 2026 21:54

Copilot started reviewing on behalf of Eleanor Boyd (eleanorjboyd) February 9, 2026 21:55 View session

vs-code-engineering Bot added this to the February 2026 milestone Feb 9, 2026

Copilot AI reviewed Feb 9, 2026

View reviewed changes

Comment thread src/client/testing/common/debugLauncher.ts Outdated

Comment thread src/client/testing/testController/common/testProjectRegistry.ts Outdated

Comment thread src/client/testing/testController/controller.ts Outdated

Eleanor Boyd (eleanorjboyd) added 2 commits February 9, 2026 18:54

based on copilot comments

c1f7fb1

test fix

bd2aadb

Eleanor Boyd (eleanorjboyd) requested a review from Copilot February 10, 2026 03:43

Copilot started reviewing on behalf of Eleanor Boyd (eleanorjboyd) February 10, 2026 03:43 View session

Copilot AI reviewed Feb 10, 2026

View reviewed changes

Comment thread src/client/testing/testController/common/utils.ts Outdated

Comment thread src/client/testing/testController/common/testProjectRegistry.ts

Comment thread src/client/testing/testController/controller.ts

Eleanor Boyd (eleanorjboyd) added 4 commits February 9, 2026 20:10

updates

275fbb6

fix path calc for windows compatibility

a485bfc

test fix

929600e

temp coverage disablement due to ubuntu changes causing failing runs

2e08364

Karthik Nadig (karthiknadig) approved these changes Feb 10, 2026

View reviewed changes

Eleanor Boyd (eleanorjboyd) merged commit 502ad70 into main Feb 10, 2026
86 checks passed

Eleanor Boyd (eleanorjboyd) deleted the test-project-support branch February 10, 2026 21:05

Wils Dawson (wdawson) mentioned this pull request Feb 11, 2026

pytest discovery does not use specified environment #25718

Open

Renan Santos (renan-r-santos) mentioned this pull request Feb 11, 2026

VSCode Python test discovery not activating the environment microsoft/vscode-python-environments#987

Closed

Glebs Ivanovskis (i-ky) mentioned this pull request Jul 9, 2026

Starting with v2026.2.0 unittest test discovery does not work for custom --start-directory (aka -s) in python.testing.unittestArgs #26033

Open

Add support for Projects in Testing by eleanorjboyd · Pull Request #25780 · microsoft/vscode-python · GitHub

Uh oh!

Add support for Projects in Testing - #25780

Add support for Projects in Testing #25780
Eleanor Boyd (eleanorjboyd) merged 14 commits into
mainfrom
test-project-support

Eleanor Boyd (eleanorjboyd) commented Feb 9, 2026 •
edited
Loading

Uh oh!

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Add support for Projects in Testing by eleanorjboyd · Pull Request #25780 · microsoft/vscode-python · GitHub

Uh oh!

Add support for Projects in Testing - #25780

Add support for Projects in Testing #25780Eleanor Boyd (eleanorjboyd) merged 14 commits intomainmicrosoft/vscode-python:mainfrom test-project-supportmicrosoft/vscode-python:test-project-supportCopy head branch name to clipboard

Conversation

Eleanor Boyd (eleanorjboyd) commented Feb 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Add support for Projects in Testing #25780
Eleanor Boyd (eleanorjboyd) merged 14 commits into
mainfrom
test-project-support

Eleanor Boyd (eleanorjboyd) commented Feb 9, 2026 •
edited
Loading