Skip to main content

A pytest plugin to easily enable debugging tests within Visual Studio Code

Project description

PyPI version Python versions See Build Status on Travis CI

A pytest plugin to easily enable debugging tests within Visual Studio Code.


Enables debugging a test session within Visual Studio Code, via attaching the debugger.


You can install “pytest-vscodedebug” via pip from PyPI:

$ pip install pytest-vscodedebug

You will need to configure the debugging in Visual Studio Code, via editing .vscode/launch.json:

  "configurations": [
      "name": "Python: Remote Attach",
      "type": "python",
      "request": "attach",
      "connect": {
        "host": "localhost",
        "port": 10001,
      "pathMappings": [
          "localRoot": "${workspaceFolder}",
          "remoteRoot": "."


You can enable pytest-vscodedebug when running tests with the --vscodedebug flag:

$ py.test --vscodedebug

By default, it will listen on port 10001, but you can change it via the --vscodedebug-port option:

$ py.test --vscodedebug --vscodedebug-port=5001


Distributed under the terms of the MIT license, “pytest-vscodedebug” is free and open source software.

This code is largely based on adriencaccia’s tutorial “Flask Debugging in VS Code with Hot-Reload 🔥”.


If you encounter any problems, please file an issue along with a detailed description.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pytest-vscodedebug-0.1.0.tar.gz (6.2 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page