Main

.github/workflows/deploy.yml

@@ -4,6 +4,10 @@ on:
   push:
     branches: [ "main" ]
 
+env:
+  # Opt JS actions into Node 24 runtime now (stops Node20 deprecation warnings)
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
 permissions:
   id-token: write
   contents: read
@@ -14,36 +18,45 @@ jobs:
 
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
 
       - name: Configure AWS credentials via OIDC
-        uses: aws-actions/configure-aws-credentials@v4
+        uses: aws-actions/configure-aws-credentials@v6
         with:
           role-to-assume: arn:aws:iam::637423424745:role/GitHubActionsDeployRole
-          aws-region: us-east-1
+          aws-region: us-east-2
 
       - name: Set up Python
         uses: actions/setup-python@v5
         with:
           python-version: "3.12"
 
-      - name: Install dependencies
+      - name: Install dependencies (backend)
+        working-directory: backend
+        run: |
+          python -m pip install --upgrade pip
+          pip install -r requirements.txt
+          # Optional: if you create this file for moto/pytest/boto3
+          if [ -f requirements-dev.txt ]; then pip install -r requirements-dev.txt; fi
+
+      - name: Clean Python caches
+        working-directory: backend
         run: |
-          if [ -f src/requirements.txt ]; then
-            pip install -r src/requirements.txt
-          else
-            echo "No requirements file, skipping"
-          fi
-          pip install pytest
-
-      - name: Run unit tests
+          find . -type d -name "__pycache__" -prune -exec rm -rf {} +
+          find . -type f -name "*.pyc" -delete
+          rm -rf .pytest_cache
+
+      - name: Run unit tests (backend)
+        working-directory: backend
         run: pytest -q
 
       - name: Install SAM CLI
         run: pip install aws-sam-cli
 
       - name: SAM Build
+        working-directory: backend
         run: sam build --use-container
 
       - name: SAM Deploy
-        run: sam deploy --no-confirm-changeset --no-fail-on-empty-changeset
+        working-directory: backend
+        run: sam deploy --no-confirm-changeset --no-fail-on-empty-changeset

.gitignore

@@ -0,0 +1,16 @@
+# Python bytecode + cache
+__pycache__/
+*.pyc
+.pytest_cache/
+
+# Virtual environment
+.venv/
+
+# SAM build artifacts
+.aws-sam/
+
+# VSCode settings (optional)
+.vscode/
+
+# macOS/Linux junk (optional)
+.DS_Store

.vscode/settings.json

@@ -0,0 +1,5 @@
+{
+    "python.analysis.extraPaths": [
+        "./backend/src"
+    ]
+}

backend/pytest.ini

@@ -0,0 +1,4 @@
+#backend/pytest.ini
+[pytest]
+testpaths = tests
+pythonpath = src

backend/requirements-dev.txt

@@ -0,0 +1,3 @@
+pytest
+boto3
+moto[boto3]

src/requirements.txt → backend/requirements.txt

@@ -1,5 +1,3 @@
-boto3
-
-moto>=4.0
-
 pytest
+boto3
+moto[boto3]

src/app.py → backend/src/app.py

@@ -6,7 +6,7 @@
 TABLE_NAME = os.getenv("TABLE_NAME", "visitorCount")
 
 def _get_table():
-    # Construct the resource each time (or memoize after first call)
+    # Construct the resource each time to ensure it picks up any changes in environment variables (e.g., for testing)  
     dynamodb = boto3.resource("dynamodb", region_name=os.getenv("AWS_DEFAULT_REGION", "us-east-2"))
     return dynamodb.Table(TABLE_NAME)
 

backend/tests/test_app.py

@@ -0,0 +1,39 @@
+# tests/test_app.py
+import json
+import os
+import boto3
+import moto
+
+# Use a consistent region for moto/boto3
+os.environ.setdefault("AWS_DEFAULT_REGION", "us-east-2")
+
+@moto.mock_aws
+def test_lambda_handler_increments_count():
+    # ---- Arrange
+    # 1) Set env vars your handler expects
+    os.environ["TABLE_NAME"] = "visitorCount"
+
+    # 2) Create the mocked table
+    dynamodb = boto3.resource("dynamodb", region_name="us-east-2")
+    table = dynamodb.create_table(
+        TableName=os.environ["TABLE_NAME"],
+        KeySchema=[{"AttributeName": "id", "KeyType": "HASH"}],
+        AttributeDefinitions=[{"AttributeName": "id", "AttributeType": "S"}],
+        BillingMode="PAY_PER_REQUEST",
+    )
+    table.put_item(Item={"id": "count", "count": 0})
+
+    # 3) Import AFTER moto + env are in place (important if app.py binds boto3 at import)
+    from app import lambda_handler
+
+    # ---- Act
+    resp = lambda_handler({"requestContext": {"http": {"method": "GET"}}}, {})
+    assert resp["statusCode"] == 200
+
+    body = json.loads(resp["body"])
+
+    # ---- Assert
+    assert isinstance(body, dict)
+    assert body["count"] == 1
+    # (optional) assert content type if your lambda sets it:
+    # assert resp["headers"]["content-type"] == "application/json"