test: add runtime tests, integration tests, and CI with local MongoDB

.github/workflows/ci.yml

@@ -0,0 +1,122 @@
+name: CI
+
+on:
+  push:
+  pull_request:
+  workflow_dispatch:
+
+jobs:
+  smoke:
+    runs-on: ubuntu-latest
+
+    services:
+      mongodb:
+        image: mongo:latest
+        options: >-
+          --health-cmd mongosh
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+        ports:
+          - 27017:27017
+        env:
+          MONGO_INITDB_ROOT_USERNAME: admin
+          MONGO_INITDB_ROOT_PASSWORD: mongodb
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Set up Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+
+      - name: Repo smoke checks
+        shell: bash
+        run: |
+          set -euo pipefail
+
+          echo "Validating repository structure and basic runnable signals"
+
+          has_signal=0
+
+          if find . -maxdepth 4 -type f -name "package.json" | grep -q .; then
+            has_signal=1
+            while IFS= read -r pkg; do
+              [ -z "$pkg" ] && continue
+              node -e "const fs=require('fs'); JSON.parse(fs.readFileSync(process.argv[1],'utf8'));" "$pkg"
+            done < <(find . -maxdepth 4 -type f -name "package.json")
+          fi
+
+          if find . -maxdepth 4 -type f \( -name "pyproject.toml" -o -name "requirements.txt" -o -name "setup.py" -o -name "manage.py" \) | grep -q .; then
+            has_signal=1
+          fi
+
+          if find . -maxdepth 4 -type f \( -name "app.py" -o -name "main.py" -o -name "wsgi.py" -o -name "asgi.py" \) | grep -q .; then
+            has_signal=1
+          fi
+
+          if find . -maxdepth 4 -type f \( -name "pom.xml" -o -name "build.gradle" -o -name "build.gradle.kts" -o -name "gradlew" \) | grep -q .; then
+            has_signal=1
+          fi
+
+          if find . -maxdepth 4 -type f -name "go.mod" | grep -q .; then
+            has_signal=1
+          fi
+
+          if find . -maxdepth 4 -type f -name "Cargo.toml" | grep -q .; then
+            has_signal=1
+          fi
+
+          if find . -maxdepth 4 -type f \( -name "*.csproj" -o -name "*.sln" \) | grep -q .; then
+            has_signal=1
+          fi
+
+          if find . -maxdepth 4 -type f \( -name "Dockerfile" -o -name "docker-compose.yml" -o -name "docker-compose.yaml" \) | grep -q .; then
+            has_signal=1
+          fi
+
+          if find . -maxdepth 4 -type f -name "Makefile" | grep -q .; then
+            has_signal=1
+          fi
+
+          if [ "$has_signal" -ne 1 ]; then
+            echo "No runnable/build signals found in repository"
+            exit 1
+          fi
+
+          echo "Running Python syntax smoke check"
+          python_files="$(find . -type f -name '*.py' -not -path './.git/*' 2>/dev/null || true)"
+          if [ -n "$python_files" ]; then
+            while IFS= read -r f; do
+              [ -z "$f" ] && continue
+              python -m py_compile "$f"
+            done <<< "$python_files"
+          fi
+
+          echo "Smoke checks passed"
+
+      - name: Run repository runtime smoke test
+        shell: bash
+        run: |
+          set -euo pipefail
+          if [ -f tests/test_runtime.py ]; then
+            python tests/test_runtime.py
+          else
+            echo "No runtime smoke test file found"
+            exit 1
+          fi
+
+      - name: Install integration test dependencies
+        run: pip install pytest pymongo
+
+      - name: Run integration tests
+        env:
+          MONGODB_URI: mongodb://admin:mongodb@localhost:27017/
+        run: pytest tests/test_integration.py -v

backend/pyproject.toml

@@ -15,7 +15,7 @@ authors = [
 classifiers = ["Private :: Do Not Upload"]
 dependencies = [
     "fastapi[all] ~= 0.112.2",
-    "motor[srv] ~= 3.5.1",
+    "pymongo[srv] ~= 4.13.1",
     "beanie == 1.26.0",
 ]
 

backend/scripts/odm_comparison.py

@@ -1,6 +1,6 @@
 import asyncio
 import os
-from motor.motor_asyncio import AsyncIOMotorClient
+from pymongo import AsyncMongoClient
 
 from pprint import pprint
 
@@ -24,7 +24,7 @@ class ToDoList(Document):
         class Settings:
             name = COLLECTION_NAME
 
-    client = AsyncIOMotorClient(MONGODB_URI)
+    client = AsyncMongoClient(MONGODB_URI)
     await init_beanie(
         database=client.get_default_database(), document_models=[ToDoList]
     )
@@ -60,7 +60,7 @@ def from_doc(doc) -> "ToDoList":
                 items=[Item.from_doc(item) for item in doc["items"]],
             )
 
-    client = AsyncIOMotorClient(MONGODB_URI)
+    client = AsyncMongoClient(MONGODB_URI)
     collection = client.get_default_database().get_collection(COLLECTION_NAME)
     pprint(
         ToDoList.from_doc(doc)

backend/src/todo/dal_beanie.py

@@ -1,5 +1,5 @@
 from bson import ObjectId
-from motor.motor_asyncio import AsyncIOMotorDatabase
+from pymongo.asynchronous.database import AsyncDatabase
 from pymongo import ReturnDocument
 from beanie import Document, init_beanie
 
@@ -38,12 +38,12 @@ class Settings:
     items: list[ToDoListItem]
 
 
-async def get_instance(database: AsyncIOMotorDatabase) -> "ToDoDALBeanie":
+async def get_instance(database: AsyncDatabase) -> "ToDoDALBeanie":
     return await ToDoDALBeanie(database)
 
 
 class ToDoDALBeanie:
-    def __init__(self, database: AsyncIOMotorDatabase):
+    def __init__(self, database: AsyncDatabase):
         self._database = database
 
     def __await__(self):

backend/src/todo/dal_motor.py

@@ -1,5 +1,5 @@
 from bson import ObjectId
-from motor.motor_asyncio import AsyncIOMotorDatabase
+from pymongo.asynchronous.database import AsyncDatabase
 from pymongo import ReturnDocument
 
 from pydantic import BaseModel, Field
@@ -49,12 +49,12 @@ def from_doc(doc) -> "ToDoList":
         )
 
 
-async def get_instance(database: AsyncIOMotorDatabase):
+async def get_instance(database: AsyncDatabase):
     return ToDoDALMotor(database)
 
 
 class ToDoDALMotor:
-    def __init__(self, database: AsyncIOMotorDatabase):
+    def __init__(self, database: AsyncDatabase):
         self._todo_collection = database.get_collection("todo_lists")
 
     async def list_todo_lists(self, session=None):

backend/src/todo/server.py

@@ -2,7 +2,7 @@
 import os
 
 from fastapi import FastAPI, status
-from motor.motor_asyncio import AsyncIOMotorClient
+from pymongo import AsyncMongoClient
 from pydantic import BaseModel
 
 from .dal_beanie import get_instance, ListSummary, ToDoList
@@ -17,7 +17,7 @@
 @asynccontextmanager
 async def lifespan(app: FastAPI):
     # Startup:
-    client = AsyncIOMotorClient(MONGODB_URI, appName="sample-app-python-farm-tutorial")
+    client = AsyncMongoClient(MONGODB_URI, appName="sample-app-python-farm-tutorial")
     database = client.get_default_database()
 
     # Ensure the database is available:

backend/tests/conftest.py

@@ -2,12 +2,12 @@
 
 import pytest
 import pytest_asyncio
-from motor.motor_asyncio import AsyncIOMotorClient
+from pymongo import AsyncMongoClient
 
 
 @pytest_asyncio.fixture(scope="session")
 async def motor_client():
-    client = AsyncIOMotorClient(os.environ["MONGODB_URI"])
+    client = AsyncMongoClient(os.environ["MONGODB_URI"])
     pong = await client.local.command("ping")
     assert int(pong["ok"]) == 1
     yield client
@@ -25,7 +25,7 @@ def app_db(motor_client):
 
 
 @pytest_asyncio.fixture(scope="session")
-async def rollback_session(motor_client: AsyncIOMotorClient):
+async def rollback_session(motor_client: AsyncMongoClient):
     """
     This fixture provides a session that will be aborted at the end of the test, to clean up any written data.
     """