Python Venv Switcher

Automatic virtual environment switching for Python monorepos.

This extension automatically finds and activates the correct Python virtual environment in VS Code for the current file. It requires no configuration and does not rely on folder structure conventions.

Features

This extension supports virtual environments managed by:

• PDM
• Poetry
• Pipenv

Since this extension queries the tool to locate the environment, environments can live outside of the VS Code workspace.

Multiple environments for a single file are supported. Use your tool to switch environments (such as poetry env use for Poetry). Then run the Activate Python Environment command in VS Code to pick up the new environment.

The working directory for Python test discovery can be configured based on the active environment.

Requirements

This extension relies on the official Python VS Code extension.

Extension Settings

python.testing.cwdTemplate

Default: null

If set, update the python.testing.cwd setting used by the Python extension to discover tests based on the active project. Use ${projectRoot} as a placeholder for the root directory of the active project.

For example, use ${projectRoot} to locate tests in a tests directory:

project1/
    project1/
        __init__.py
        code.py
    tests/
        __init__.py
        test_code.py
    pyproject.toml

Known Issues

You must reload this extension after installing a supported Python tool. (Available tools are checked when the extension is first activated.)

If the environment for a given file has changed, the Activate Python Environment command must be run.

Manually created virtual environments are currently not supported.

Release Notes

0.3.1

Update readme.

0.3.0

Add ability to configure location of Python tests based on project root.

0.2.0

Fix an issue where unavailable tools were still considered available when checking for environments.

Add logging.

0.1.1

Add extension icon.

0.1.0

Initial release.