Added automatic testing and fixed docker. Updated README

Author: jamAM7

.gitignore

@@ -8,4 +8,5 @@ token.json
 NOTES_drive.md
 drive_plans_fetch.py
 SPEC.mc
-mls_spatial.db
+mls_spatial.db
+test_results.txt

Dockerfile

@@ -1,4 +1,4 @@
-FROM python:3.12-slim
+FROM python:3.11-slim
 WORKDIR /app
 COPY requirements.txt .
 RUN pip install --no-cache-dir -r requirements.txt

PLAN.md

@@ -70,10 +70,10 @@ All Python repos follow the same pattern: FastAPI service, structured as a packa
 
 **Engineering hygiene**
 - Rewrite all tests with mocked HTTP using `pytest-httpx` (no live API calls)           # DONE
-- Add `Dockerfile` and `docker-compose.yml`                                             # DONE needs testing though 
-- Add GitHub Actions workflow — runs pytest on every push                               # not done
+- Add `Dockerfile` and `docker-compose.yml`                                             # DONE
+- Add GitHub Actions workflow — runs pytest on every push                               # DONE
 - Add SQLite search history (`service/history.py`, `GET /history` endpoint)             # DONE
-- Convert NSW API calls to async using `httpx` + `asyncio`                              # not done
+- Convert NSW API calls to async using `httpx` + `asyncio`                              # check with surveyor, bit of a big change and already runs API calls in parallel using ThreadPoolExecutor
 
 ### Definition of done
 - All 3 GitHub issues closed with a PR each                                             # no pr

README.md

@@ -1,9 +1,11 @@
+![CI](https://github.com/jamAM7/mls-spatial/actions/workflows/ci.yml/badge.svg)
+
 # MLS Spatial Search
 
 NSW cadastral search tool — queries Spatial Services APIs to return lots, survey plans and survey marks for a given address. Generates cadastral drawings, CRE map images and downloads plan documents from Google Drive.
 
 ## Requirements
-- Python 3.x
+- Python 3.11
 - `credentials.json` — Google OAuth credentials (provided separately, never committed to git)
 - `token.json` — created automatically on first run after authenticating with Google
 
@@ -35,6 +37,31 @@ source venv/bin/activate
 pip install -r requirements.txt
 ```
 
+## Running with Docker (recommended)
+
+Docker is the easiest way to run the service without configuring a local Python environment.
+
+### Requirements
+- [Docker Desktop](https://www.docker.com/products/docker-desktop/)
+- `credentials.json` and `token.json` in the project root
+
+### Start the service
+```
+docker compose up --build
+```
+
+The service will be available at `http://localhost:8000`.
+
+To run in the background:
+```
+docker compose up --build -d
+```
+
+To stop:
+```
+docker compose down
+```
+
 ## Usage
 
 Run the console app:
@@ -62,7 +89,7 @@ Results are saved to `output/{address}-{date}/` containing:
 - `cre_map.png` — CRE raster map image (options 2, 3, 4)
 - `plans/` — downloaded plan PDFs from Google Drive (option 3)
 
-## Running the FastAPI Service (optional)
+## FastAPI Service
 
 For programmatic access or the AutoCAD add-in:
 ```
@@ -82,11 +109,19 @@ Interactive API documentation: `http://localhost:8000/docs`
 
 ## Testing
 
+Run the full test suite:
 ```
 pytest tests/ -v
 ```
 
-Tests use mocked HTTP via the `responses` library and require no internet connection. All NSW Spatial Services API calls are intercepted using fixture data in `tests/fixtures/`.
+To save output to a file:
+```
+pytest tests/ -v > test_results.txt 2>&1
+```
+
+Tests use mocked HTTP via the `responses` library — no internet connection or running server required. All NSW Spatial Services API calls are intercepted using fixture JSON files in `tests/fixtures/`.
+
+CI runs automatically on every push via GitHub Actions.
 
 ## Data Sources
 - NSW Spatial Services: https://portal.spatial.nsw.gov.au

logs/service-err.log

@@ -4056,3 +4056,25 @@ Unable to create process using '"C:\Users\jamez\AppData\Local\Microsoft\WindowsA
 Unable to create process using '"C:\Users\jamez\AppData\Local\Microsoft\WindowsApps\PythonSoftwareFoundation.Python.3.11_qbz5n2kfra8p0\python.exe" -m uvicorn server:app --host 0.0.0.0 --port 8000'
 Unable to create process using '"C:\Users\jamez\AppData\Local\Microsoft\WindowsApps\PythonSoftwareFoundation.Python.3.11_qbz5n2kfra8p0\python.exe" -m uvicorn server:app --host 0.0.0.0 --port 8000'
 Unable to create process using '"C:\Users\jamez\AppData\Local\Microsoft\WindowsApps\PythonSoftwareFoundation.Python.3.11_qbz5n2kfra8p0\python.exe" -m uvicorn server:app --host 0.0.0.0 --port 8000'
+Unable to create process using '"C:\Users\jamez\AppData\Local\Microsoft\WindowsApps\PythonSoftwareFoundation.Python.3.11_qbz5n2kfra8p0\python.exe" -m uvicorn server:app --host 0.0.0.0 --port 8000'
+Unable to create process using '"C:\Users\jamez\AppData\Local\Microsoft\WindowsApps\PythonSoftwareFoundation.Python.3.11_qbz5n2kfra8p0\python.exe" -m uvicorn server:app --host 0.0.0.0 --port 8000'
+Unable to create process using '"C:\Users\jamez\AppData\Local\Microsoft\WindowsApps\PythonSoftwareFoundation.Python.3.11_qbz5n2kfra8p0\python.exe" -m uvicorn server:app --host 0.0.0.0 --port 8000'
+Unable to create process using '"C:\Users\jamez\AppData\Local\Microsoft\WindowsApps\PythonSoftwareFoundation.Python.3.11_qbz5n2kfra8p0\python.exe" -m uvicorn server:app --host 0.0.0.0 --port 8000'
+Unable to create process using '"C:\Users\jamez\AppData\Local\Microsoft\WindowsApps\PythonSoftwareFoundation.Python.3.11_qbz5n2kfra8p0\python.exe" -m uvicorn server:app --host 0.0.0.0 --port 8000'
+Unable to create process using '"C:\Users\jamez\AppData\Local\Microsoft\WindowsApps\PythonSoftwareFoundation.Python.3.11_qbz5n2kfra8p0\python.exe" -m uvicorn server:app --host 0.0.0.0 --port 8000'
+Unable to create process using '"C:\Users\jamez\AppData\Local\Microsoft\WindowsApps\PythonSoftwareFoundation.Python.3.11_qbz5n2kfra8p0\python.exe" -m uvicorn server:app --host 0.0.0.0 --port 8000'
+Unable to create process using '"C:\Users\jamez\AppData\Local\Microsoft\WindowsApps\PythonSoftwareFoundation.Python.3.11_qbz5n2kfra8p0\python.exe" -m uvicorn server:app --host 0.0.0.0 --port 8000'
+Unable to create process using '"C:\Users\jamez\AppData\Local\Microsoft\WindowsApps\PythonSoftwareFoundation.Python.3.11_qbz5n2kfra8p0\python.exe" -m uvicorn server:app --host 0.0.0.0 --port 8000'
+Unable to create process using '"C:\Users\jamez\AppData\Local\Microsoft\WindowsApps\PythonSoftwareFoundation.Python.3.11_qbz5n2kfra8p0\python.exe" -m uvicorn server:app --host 0.0.0.0 --port 8000'
+Unable to create process using '"C:\Users\jamez\AppData\Local\Microsoft\WindowsApps\PythonSoftwareFoundation.Python.3.11_qbz5n2kfra8p0\python.exe" -m uvicorn server:app --host 0.0.0.0 --port 8000'
+Unable to create process using '"C:\Users\jamez\AppData\Local\Microsoft\WindowsApps\PythonSoftwareFoundation.Python.3.11_qbz5n2kfra8p0\python.exe" -m uvicorn server:app --host 0.0.0.0 --port 8000'
+Unable to create process using '"C:\Users\jamez\AppData\Local\Microsoft\WindowsApps\PythonSoftwareFoundation.Python.3.11_qbz5n2kfra8p0\python.exe" -m uvicorn server:app --host 0.0.0.0 --port 8000'
+Unable to create process using '"C:\Users\jamez\AppData\Local\Microsoft\WindowsApps\PythonSoftwareFoundation.Python.3.11_qbz5n2kfra8p0\python.exe" -m uvicorn server:app --host 0.0.0.0 --port 8000'
+Unable to create process using '"C:\Users\jamez\AppData\Local\Microsoft\WindowsApps\PythonSoftwareFoundation.Python.3.11_qbz5n2kfra8p0\python.exe" -m uvicorn server:app --host 0.0.0.0 --port 8000'
+Unable to create process using '"C:\Users\jamez\AppData\Local\Microsoft\WindowsApps\PythonSoftwareFoundation.Python.3.11_qbz5n2kfra8p0\python.exe" -m uvicorn server:app --host 0.0.0.0 --port 8000'
+Unable to create process using '"C:\Users\jamez\AppData\Local\Microsoft\WindowsApps\PythonSoftwareFoundation.Python.3.11_qbz5n2kfra8p0\python.exe" -m uvicorn server:app --host 0.0.0.0 --port 8000'
+Unable to create process using '"C:\Users\jamez\AppData\Local\Microsoft\WindowsApps\PythonSoftwareFoundation.Python.3.11_qbz5n2kfra8p0\python.exe" -m uvicorn server:app --host 0.0.0.0 --port 8000'
+Unable to create process using '"C:\Users\jamez\AppData\Local\Microsoft\WindowsApps\PythonSoftwareFoundation.Python.3.11_qbz5n2kfra8p0\python.exe" -m uvicorn server:app --host 0.0.0.0 --port 8000'
+Unable to create process using '"C:\Users\jamez\AppData\Local\Microsoft\WindowsApps\PythonSoftwareFoundation.Python.3.11_qbz5n2kfra8p0\python.exe" -m uvicorn server:app --host 0.0.0.0 --port 8000'
+Unable to create process using '"C:\Users\jamez\AppData\Local\Microsoft\WindowsApps\PythonSoftwareFoundation.Python.3.11_qbz5n2kfra8p0\python.exe" -m uvicorn server:app --host 0.0.0.0 --port 8000'
+Unable to create process using '"C:\Users\jamez\AppData\Local\Microsoft\WindowsApps\PythonSoftwareFoundation.Python.3.11_qbz5n2kfra8p0\python.exe" -m uvicorn server:app --host 0.0.0.0 --port 8000'

service/drive.py

@@ -187,7 +187,7 @@ def _is_exact_plan_match(filename: str, pl_exact: str, digits: str) -> bool:
         return True
     if re.search(r'\b' + prefix + r'[\s_]0*' + digits + r'\b', name_u):
         return True
-    plan_word = "DEPOSITED[\s_]PLAN" if prefix == "DP" else "STRATA[\s_]PLAN"
+    plan_word = r"DEPOSITED[\s_]PLAN" if prefix == "DP" else r"STRATA[\s_]PLAN"
     if re.search(plan_word + r'[\s_]0*' + digits + r'\b', name_u):
         return True
     if re.search(r'(?<![0-9])0*' + digits + r'(?![0-9])', name_u):