Warning

This document is for an in-development version of Galaxy. You can alternatively view this page in the latest release if it exists or view the top of the latest release's documentation.

Debugging Galaxy

Debugging Galaxy in VS Code

The following instructions assume that you have cloned your Galaxy fork into the ~/galaxy directory and have created a VS Code workspace per instructions here

  1. Download this ini file and and save it as ~/galaxy/config/galaxy.ini.old

  2. Add the following code snippet to ~/galaxy/.vscode/launch.json (create the file if it does not already exist)

    {
        "version": "0.2.0",
        "configurations": [
            {
                "name": "Python: Current File (Integrated Terminal)",
                "type": "python",
                "request": "launch",
                "program": "${file}",
                "console": "integratedTerminal"
            },
            {
                "name": "Galaxy debug",
                "type": "python",
                "request": "launch",
                "program": "${workspaceFolder}/scripts/paster.py",
                "args": [
                    "serve",
                    "config/galaxy.ini.old",
                    "--log-file",
                    "galaxy.log",
                ],
            }
        ]
    }
    
  3. Re-start VS Code

  4. Add a breakpoint somewhere in your code

  5. Select Run and Debug on Activity Bar, on the far left hand side. In the RUN AND DEBUG drop down, select Galaxy debug (galaxy), and click the Start Debugging button (green arrow)

  6. Galaxy should stop right on the break point you added.

  7. Enjoy your debugging session :-)