README and launch.json.default

Author: JamesW1-NHS

README.md

@@ -147,6 +147,10 @@ Steps:
     AWS_PROFILE={your_profile}
     IMMUNIZATION_ENV=local
     ```
+    For unit tests to run successfully, you may also need to add an environment variable for PYTHONPATH. This should be:
+    ```
+    PYTHONPATH=src:tests
+    ```
 
 4. Configure `direnv` by creating a `.envrc` file in the backend folder. This points direnv to the `.venv` created by poetry and loads env variables specified in the `.env` file
     ```
@@ -178,20 +182,34 @@ The current team uses VS Code mainly. So this setup is targeted towards VS code.
 
 ### VS Code
 
-The project must be opened as a multi-root workspace for VS Code to know that `backend` has its own environment.
+The project must be opened as a multi-root workspace for VS Code to know that specific lambdas (e.g. `backend`) have their own environment.
+This example is for `backend`; substitute another lambda name in where applicable.
 
 - Open the workspace `immunisation-fhir-api.code-workspace`.
 - Copy `backend/.vscode/settings.json.default` to `backend/.vscode/settings.json`, or merge the contents with
   your existing file.
+- Similarly, copy or merge `backend/.vscode/launch.json.default` to `backend/.vscode/launch.json`.
 
 VS Code will automatically use the `backend` environment when you're editing a file under `backend`.
 
 Depending on your existing setup VS Code might automatically choose the wrong virtualenvs. Change it
 with `Python: Select Interpreter`.
 
-The root (`immunisation-fhir-api`) should point to `/mnt/d/Source/immunisation-fhir-api/.venv/bin/python`.
+The root (`immunisation-fhir-api`) should point to the root .venv, `/mnt/d/Source/immunisation-fhir-api/.venv/bin/python`.
+
+Meanwhile, `backend` should be pointing at `/mnt/d/Source/immunisation-fhir-api/backend/.venv/bin/python`
+
+#### Running Unit Tests
+
+In order that VSCode can resolve modules in unit tests, it needs the PYTHONPATH. This should be setup in `backend/.vscode/launch.json` (see above).
 
-`backend` should be pointing at `/mnt/d/Source/immunisation-fhir-api/backend/.venv/bin/python`
+*NOTE:* In order to run unit test suites, you may need to manually switch to the correct virtual environment each time you wish to
+run a different set of tests. To do this: 
+- Show and Run Commands (Ctrl-Shift-P on Windows)
+        -> Python: Create Environment
+        -> Venv
+        -> Select the venv named for the test suite you wish to run, e.g. `backend`
+        -> Use Existing
 
 ### IntelliJ
 

backend/.vscode/launch.json.default

@@ -0,0 +1,33 @@
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "name": "File",
+      "type": "debugpy",
+      "request": "launch",
+      "module": "unittest",
+      "args": [
+        "${fileBasenameNoExtension}" // Run tests in the current file
+      ],
+      "console": "integratedTerminal",
+      "env": {
+        "PYTHONPATH": "${workspaceFolder}:${workspaceFolder}/src:${workspaceFolder}/tests" // Add root, src, and tests
+      }
+    },
+    {
+      "name": "Here",
+      "type": "debugpy",
+      "request": "launch",
+      "module": "unittest",
+      "args": [
+        "-k",
+        "${selectedText}" // Run the test method or class under the cursor
+      ],
+      "console": "integratedTerminal",
+      "justMyCode": true,
+      "env": {
+        "PYTHONPATH": "${workspaceFolder}:${workspaceFolder}/src:${workspaceFolder}/tests" // Add root, src, and tests
+      }
+    }
+  ]
+}