add helper for debugging python scripts in vscode (#4638)

.vscode/README.md

@@ -42,3 +42,25 @@ In order to stop the server so you can start debugging again run the vscode comm
 ```
 >Remote-Containers: Rebuild Container
 ```
+
+## Debugging a python script executed through the terminal (e.g. a django management command)
+
+There's a helper script which will wrap any execution of a python script with vscode's debugger.
+
+To use it, run:
+
+```
+.vscode/debug-python <script and arguments here>
+```
+
+e.g.
+
+```
+./vscode/debug-python ./manage.py help
+```
+
+The script's execution is paused until the debugger attaches to it.
+So to start it,
+open the run sidebar in vscode,
+select "Attach to .vscode/debug-python" from the dropdown,
+and click run.

.vscode/debug-python

@@ -0,0 +1,3 @@
+#!/bin/bash
+
+python -m debugpy --listen 5678 --wait-for-client "$@"

.vscode/launch.json

@@ -29,6 +29,16 @@
                 "--config",
                 "wsgi/config.py"
             ]
+        },
+
+        {
+            "name": "Attach to .vscode/debug-python",
+            "type": "python",
+            "request": "attach",
+            "connect": {
+                "host": "127.0.0.1",
+                "port": 5678
+            }
         }
 
     ]