stackport 0.1.2__tar.gz → 0.1.3__tar.gz

{stackport-0.1.2/stackport.egg-info → stackport-0.1.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: stackport
-Version: 0.1.2
+Version: 0.1.3
 Summary: Universal AWS resource browser for local emulators
 Author: Davi Reis Vieira
 License: MIT
@@ -24,19 +24,33 @@ License-File: LICENSE
 Requires-Dist: fastapi>=0.115.0
 Requires-Dist: uvicorn>=0.30.0
 Requires-Dist: boto3>=1.35.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: httpx>=0.27.0; extra == "dev"
+Requires-Dist: moto[dynamodb,iam,lambda,s3,sqs]>=5.0; extra == "dev"
 Dynamic: license-file
 
 # StackPort
 
-[![CI](https://github.com/DaviReisVieira/stackport/actions/workflows/ci.yml/badge.svg)](https://github.com/DaviReisVieira/stackport/actions/workflows/ci.yml)
-[![PyPI](https://img.shields.io/pypi/v/stackport)](https://pypi.org/project/stackport/)
-[![Docker](https://img.shields.io/docker/pulls/davireis/stackport)](https://hub.docker.com/r/davireis/stackport)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+<p>
+  <a href="https://github.com/DaviReisVieira/stackport/actions/workflows/ci.yml"><img src="https://github.com/DaviReisVieira/stackport/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="https://pypi.org/project/stackport/"><img src="https://img.shields.io/pypi/v/stackport" alt="PyPI Version"></a>
+  <a href="https://hub.docker.com/r/davireis/stackport"><img src="https://img.shields.io/docker/pulls/davireis/stackport" alt="Docker Pulls"></a>
+  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"></a>
+</p>
 
 Universal AWS resource browser for local emulators. Built to work with [**MiniStack**](https://github.com/Nahuel990/ministack), and also compatible with LocalStack, Moto, or any AWS-compatible endpoint.
 
-<!-- TODO: Add screenshot here -->
-<!-- ![StackPort Dashboard](docs/screenshot.png) -->
+## Screenshots
+
+**Dashboard** — Service overview with resource counts and health status
+![StackPort Dashboard](docs/images/dashboard.jpeg)
+
+**DynamoDB Browser** — Generic resource table with search, pagination, and detail view
+![DynamoDB Resources](docs/images/dynamo.jpeg)
+
+**S3 Browser** — File browser with folder navigation and object preview
+![S3 Browser](docs/images/s3.jpeg)
 
 ## Features
 
@@ -62,8 +76,10 @@ stackport
 
 ### Docker Compose (MiniStack + StackPort)
 
+This example uses [MiniStack](https://github.com/Nahuel990/ministack) as the emulator, but you can swap it for LocalStack, Moto, or any AWS-compatible endpoint — just update `AWS_ENDPOINT_URL`.
+
 ```bash
-curl -O https://raw.githubusercontent.com/DaviReisVieira/stackport/main/docker-compose.yml
+curl -O https://raw.githubusercontent.com/DaviReisVieira/stackport/main/examples/docker-compose.yml
 docker compose up -d
 # Open http://localhost:8080
 ```

{stackport-0.1.2 → stackport-0.1.3}/README.md

@@ -1,14 +1,24 @@
 # StackPort
 
-[![CI](https://github.com/DaviReisVieira/stackport/actions/workflows/ci.yml/badge.svg)](https://github.com/DaviReisVieira/stackport/actions/workflows/ci.yml)
-[![PyPI](https://img.shields.io/pypi/v/stackport)](https://pypi.org/project/stackport/)
-[![Docker](https://img.shields.io/docker/pulls/davireis/stackport)](https://hub.docker.com/r/davireis/stackport)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+<p>
+  <a href="https://github.com/DaviReisVieira/stackport/actions/workflows/ci.yml"><img src="https://github.com/DaviReisVieira/stackport/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="https://pypi.org/project/stackport/"><img src="https://img.shields.io/pypi/v/stackport" alt="PyPI Version"></a>
+  <a href="https://hub.docker.com/r/davireis/stackport"><img src="https://img.shields.io/docker/pulls/davireis/stackport" alt="Docker Pulls"></a>
+  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"></a>
+</p>
 
 Universal AWS resource browser for local emulators. Built to work with [**MiniStack**](https://github.com/Nahuel990/ministack), and also compatible with LocalStack, Moto, or any AWS-compatible endpoint.
 
-<!-- TODO: Add screenshot here -->
-<!-- ![StackPort Dashboard](docs/screenshot.png) -->
+## Screenshots
+
+**Dashboard** — Service overview with resource counts and health status
+![StackPort Dashboard](docs/images/dashboard.jpeg)
+
+**DynamoDB Browser** — Generic resource table with search, pagination, and detail view
+![DynamoDB Resources](docs/images/dynamo.jpeg)
+
+**S3 Browser** — File browser with folder navigation and object preview
+![S3 Browser](docs/images/s3.jpeg)
 
 ## Features
 
@@ -34,8 +44,10 @@ stackport
 
 ### Docker Compose (MiniStack + StackPort)
 
+This example uses [MiniStack](https://github.com/Nahuel990/ministack) as the emulator, but you can swap it for LocalStack, Moto, or any AWS-compatible endpoint — just update `AWS_ENDPOINT_URL`.
+
 ```bash
-curl -O https://raw.githubusercontent.com/DaviReisVieira/stackport/main/docker-compose.yml
+curl -O https://raw.githubusercontent.com/DaviReisVieira/stackport/main/examples/docker-compose.yml
 docker compose up -d
 # Open http://localhost:8080
 ```

{stackport-0.1.2 → stackport-0.1.3}/backend/main.py

@@ -9,7 +9,7 @@ from fastapi.responses import FileResponse
 from fastapi.staticfiles import StaticFiles
 
 from backend.config import STACKPORT_PORT
-from backend.routes import resources, s3, stats
+from backend.routes import dynamodb, resources, s3, stats
 
 logging.basicConfig(
     level=logging.INFO,
@@ -28,6 +28,7 @@ app.add_middleware(
 
 app.include_router(stats.router, prefix="/api")
 app.include_router(s3.router, prefix="/api/s3")
+app.include_router(dynamodb.router, prefix="/api/dynamodb")
 app.include_router(resources.router, prefix="/api")
 
 # Serve UI static files — mount assets under /assets, SPA fallback for everything else

stackport-0.1.3/backend/routes/dynamodb.py

@@ -0,0 +1,218 @@
+import logging
+from typing import Any
+
+from fastapi import APIRouter, Query
+from pydantic import BaseModel
+
+from backend.aws_client import get_client
+from backend.cache import cache
+
+logger = logging.getLogger(__name__)
+
+router = APIRouter()
+
+
+def _get_table_item_count(table_name: str) -> int:
+    """Return item count for a table. Cached 30s."""
+    cache_key = f"dynamodb:item_count:{table_name}"
+    cached = cache.get(cache_key)
+    if cached is not None:
+        return cached
+
+    dynamodb = get_client("dynamodb")
+    try:
+        resp = dynamodb.describe_table(TableName=table_name)
+        item_count = resp["Table"].get("ItemCount", 0)
+        cache.set(cache_key, item_count, ttl=30)
+        return item_count
+    except Exception:
+        logger.debug("Failed to get item count for %s", table_name, exc_info=True)
+        return 0
+
+
+@router.get("/tables")
+def list_tables():
+    dynamodb = get_client("dynamodb")
+    paginator = dynamodb.get_paginator("list_tables")
+    table_names = []
+
+    for page in paginator.paginate():
+        table_names.extend(page.get("TableNames", []))
+
+    tables = []
+    for name in table_names:
+        try:
+            resp = dynamodb.describe_table(TableName=name)
+            table = resp["Table"]
+            item_count = table.get("ItemCount", 0)
+            table_size = table.get("TableSizeBytes", 0)
+
+            key_schema = table.get("KeySchema", [])
+            partition_key = next((k["AttributeName"] for k in key_schema if k["KeyType"] == "HASH"), None)
+            sort_key = next((k["AttributeName"] for k in key_schema if k["KeyType"] == "RANGE"), None)
+
+            tables.append(
+                {
+                    "name": name,
+                    "status": table.get("TableStatus", "UNKNOWN"),
+                    "item_count": item_count,
+                    "size_bytes": table_size,
+                    "partition_key": partition_key,
+                    "sort_key": sort_key,
+                    "billing_mode": table.get("BillingModeSummary", {}).get("BillingMode", "PROVISIONED"),
+                    "created": table.get("CreationDateTime").isoformat() if table.get("CreationDateTime") else None,
+                }
+            )
+        except Exception:
+            logger.debug("Failed to describe table %s", name, exc_info=True)
+            continue
+
+    return {"tables": tables}
+
+
+@router.get("/tables/{name}")
+def get_table_detail(name: str):
+    dynamodb = get_client("dynamodb")
+
+    try:
+        resp = dynamodb.describe_table(TableName=name)
+        table = resp["Table"]
+
+        key_schema = table.get("KeySchema", [])
+        attribute_defs = {attr["AttributeName"]: attr["AttributeType"] for attr in table.get("AttributeDefinitions", [])}
+
+        partition_key = next((k["AttributeName"] for k in key_schema if k["KeyType"] == "HASH"), None)
+        sort_key = next((k["AttributeName"] for k in key_schema if k["KeyType"] == "RANGE"), None)
+
+        return {
+            "name": name,
+            "status": table.get("TableStatus", "UNKNOWN"),
+            "item_count": table.get("ItemCount", 0),
+            "size_bytes": table.get("TableSizeBytes", 0),
+            "partition_key": partition_key,
+            "partition_key_type": attribute_defs.get(partition_key) if partition_key else None,
+            "sort_key": sort_key,
+            "sort_key_type": attribute_defs.get(sort_key) if sort_key else None,
+            "billing_mode": table.get("BillingModeSummary", {}).get("BillingMode", "PROVISIONED"),
+            "created": table.get("CreationDateTime").isoformat() if table.get("CreationDateTime") else None,
+            "attribute_definitions": attribute_defs,
+            "key_schema": key_schema,
+            "global_secondary_indexes": table.get("GlobalSecondaryIndexes", []),
+            "local_secondary_indexes": table.get("LocalSecondaryIndexes", []),
+        }
+    except Exception as e:
+        logger.error("Failed to get table detail for %s: %s", name, e, exc_info=True)
+        return {"error": str(e)}
+
+
+@router.get("/tables/{name}/items")
+def scan_table(
+    name: str,
+    limit: int = Query(default=25, ge=1, le=100, description="Max items per page"),
+    exclusive_start_key: str = Query(default=None, description="Base64 encoded last evaluated key for pagination"),
+):
+    dynamodb = get_client("dynamodb")
+
+    scan_params: dict[str, Any] = {
+        "TableName": name,
+        "Limit": limit,
+    }
+
+    if exclusive_start_key:
+        import base64
+        import json
+
+        try:
+            decoded = base64.b64decode(exclusive_start_key).decode("utf-8")
+            scan_params["ExclusiveStartKey"] = json.loads(decoded)
+        except Exception:
+            logger.debug("Invalid exclusive_start_key", exc_info=True)
+
+    try:
+        resp = dynamodb.scan(**scan_params)
+        items = resp.get("Items", [])
+
+        last_evaluated_key = resp.get("LastEvaluatedKey")
+        next_token = None
+        if last_evaluated_key:
+            import base64
+            import json
+
+            next_token = base64.b64encode(json.dumps(last_evaluated_key).encode("utf-8")).decode("utf-8")
+
+        return {
+            "table": name,
+            "items": items,
+            "count": len(items),
+            "scanned_count": resp.get("ScannedCount", len(items)),
+            "next_token": next_token,
+        }
+    except Exception as e:
+        logger.error("Failed to scan table %s: %s", name, e, exc_info=True)
+        return {"error": str(e), "items": [], "count": 0}
+
+
+class QueryRequest(BaseModel):
+    partition_key_value: str
+    sort_key_value: str | None = None
+    sort_key_operator: str = "="  # =, <, <=, >, >=, BETWEEN, BEGINS_WITH
+    limit: int = 25
+
+
+@router.post("/tables/{name}/query")
+def query_table(name: str, request: QueryRequest):
+    dynamodb = get_client("dynamodb")
+
+    try:
+        # Get table key schema
+        table_resp = dynamodb.describe_table(TableName=name)
+        table = table_resp["Table"]
+        key_schema = table.get("KeySchema", [])
+        attribute_defs = {attr["AttributeName"]: attr["AttributeType"] for attr in table.get("AttributeDefinitions", [])}
+
+        partition_key = next((k["AttributeName"] for k in key_schema if k["KeyType"] == "HASH"), None)
+        sort_key = next((k["AttributeName"] for k in key_schema if k["KeyType"] == "RANGE"), None)
+
+        if not partition_key:
+            return {"error": "No partition key found in table schema", "items": [], "count": 0}
+
+        partition_key_type = attribute_defs.get(partition_key, "S")
+
+        # Build key condition expression
+        key_condition = f"#{partition_key} = :pk"
+        expression_attr_names = {f"#{partition_key}": partition_key}
+        expression_attr_values = {":pk": {partition_key_type: request.partition_key_value}}
+
+        if sort_key and request.sort_key_value:
+            sort_key_type = attribute_defs.get(sort_key, "S")
+            if request.sort_key_operator == "=":
+                key_condition += f" AND #{sort_key} = :sk"
+                expression_attr_values[":sk"] = {sort_key_type: request.sort_key_value}
+            elif request.sort_key_operator in ("<", "<=", ">", ">="):
+                key_condition += f" AND #{sort_key} {request.sort_key_operator} :sk"
+                expression_attr_values[":sk"] = {sort_key_type: request.sort_key_value}
+            elif request.sort_key_operator == "BEGINS_WITH":
+                key_condition += f" AND begins_with(#{sort_key}, :sk)"
+                expression_attr_values[":sk"] = {sort_key_type: request.sort_key_value}
+            expression_attr_names[f"#{sort_key}"] = sort_key
+
+        query_params = {
+            "TableName": name,
+            "KeyConditionExpression": key_condition,
+            "ExpressionAttributeNames": expression_attr_names,
+            "ExpressionAttributeValues": expression_attr_values,
+            "Limit": request.limit,
+        }
+
+        resp = dynamodb.query(**query_params)
+        items = resp.get("Items", [])
+
+        return {
+            "table": name,
+            "items": items,
+            "count": len(items),
+            "scanned_count": resp.get("ScannedCount", len(items)),
+        }
+    except Exception as e:
+        logger.error("Failed to query table %s: %s", name, e, exc_info=True)
+        return {"error": str(e), "items": [], "count": 0}

{stackport-0.1.2 → stackport-0.1.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "stackport"
-version = "0.1.2"
+version = "0.1.3"
 description = "Universal AWS resource browser for local emulators"
 readme = "README.md"
 license = {text = "MIT"}
@@ -26,6 +26,13 @@ Homepage = "https://github.com/DaviReisVieira/stackport"
 Repository = "https://github.com/DaviReisVieira/stackport"
 Issues = "https://github.com/DaviReisVieira/stackport/issues"
 
+[project.optional-dependencies]
+dev = ["pytest>=8.0", "httpx>=0.27.0", "moto[s3,sqs,lambda,dynamodb,iam]>=5.0"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["."]
+
 [build-system]
 requires = ["setuptools>=68.0"]
 build-backend = "setuptools.build_meta"

{stackport-0.1.2 → stackport-0.1.3/stackport.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: stackport
-Version: 0.1.2
+Version: 0.1.3
 Summary: Universal AWS resource browser for local emulators
 Author: Davi Reis Vieira
 License: MIT
@@ -24,19 +24,33 @@ License-File: LICENSE
 Requires-Dist: fastapi>=0.115.0
 Requires-Dist: uvicorn>=0.30.0
 Requires-Dist: boto3>=1.35.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: httpx>=0.27.0; extra == "dev"
+Requires-Dist: moto[dynamodb,iam,lambda,s3,sqs]>=5.0; extra == "dev"
 Dynamic: license-file
 
 # StackPort
 
-[![CI](https://github.com/DaviReisVieira/stackport/actions/workflows/ci.yml/badge.svg)](https://github.com/DaviReisVieira/stackport/actions/workflows/ci.yml)
-[![PyPI](https://img.shields.io/pypi/v/stackport)](https://pypi.org/project/stackport/)
-[![Docker](https://img.shields.io/docker/pulls/davireis/stackport)](https://hub.docker.com/r/davireis/stackport)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+<p>
+  <a href="https://github.com/DaviReisVieira/stackport/actions/workflows/ci.yml"><img src="https://github.com/DaviReisVieira/stackport/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="https://pypi.org/project/stackport/"><img src="https://img.shields.io/pypi/v/stackport" alt="PyPI Version"></a>
+  <a href="https://hub.docker.com/r/davireis/stackport"><img src="https://img.shields.io/docker/pulls/davireis/stackport" alt="Docker Pulls"></a>
+  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"></a>
+</p>
 
 Universal AWS resource browser for local emulators. Built to work with [**MiniStack**](https://github.com/Nahuel990/ministack), and also compatible with LocalStack, Moto, or any AWS-compatible endpoint.
 
-<!-- TODO: Add screenshot here -->
-<!-- ![StackPort Dashboard](docs/screenshot.png) -->
+## Screenshots
+
+**Dashboard** — Service overview with resource counts and health status
+![StackPort Dashboard](docs/images/dashboard.jpeg)
+
+**DynamoDB Browser** — Generic resource table with search, pagination, and detail view
+![DynamoDB Resources](docs/images/dynamo.jpeg)
+
+**S3 Browser** — File browser with folder navigation and object preview
+![S3 Browser](docs/images/s3.jpeg)
 
 ## Features
 
@@ -62,8 +76,10 @@ stackport
 
 ### Docker Compose (MiniStack + StackPort)
 
+This example uses [MiniStack](https://github.com/Nahuel990/ministack) as the emulator, but you can swap it for LocalStack, Moto, or any AWS-compatible endpoint — just update `AWS_ENDPOINT_URL`.
+
 ```bash
-curl -O https://raw.githubusercontent.com/DaviReisVieira/stackport/main/docker-compose.yml
+curl -O https://raw.githubusercontent.com/DaviReisVieira/stackport/main/examples/docker-compose.yml
 docker compose up -d
 # Open http://localhost:8080
 ```

{stackport-0.1.2 → stackport-0.1.3}/stackport.egg-info/SOURCES.txt

@@ -9,9 +9,10 @@ backend/config.py
 backend/main.py
 backend/../ui/dist/favicon.png
 backend/../ui/dist/index.html
-backend/../ui/dist/assets/index-CRqBg0t6.js
-backend/../ui/dist/assets/index-Is3dIbZM.css
+backend/../ui/dist/assets/index-CEFYqXru.css
+backend/../ui/dist/assets/index-DyyngEdQ.js
 backend/routes/__init__.py
+backend/routes/dynamodb.py
 backend/routes/resources.py
 backend/routes/s3.py
 backend/routes/stats.py
@@ -21,7 +22,13 @@ stackport.egg-info/dependency_links.txt
 stackport.egg-info/entry_points.txt
 stackport.egg-info/requires.txt
 stackport.egg-info/top_level.txt
+tests/test_cache.py
+tests/test_client.py
+tests/test_config.py
+tests/test_dynamodb_routes.py
+tests/test_registries.py
+tests/test_routes.py
 ui/dist/favicon.png
 ui/dist/index.html
-ui/dist/assets/index-CRqBg0t6.js
-ui/dist/assets/index-Is3dIbZM.css
+ui/dist/assets/index-CEFYqXru.css
+ui/dist/assets/index-DyyngEdQ.js

stackport-0.1.3/stackport.egg-info/requires.txt

@@ -0,0 +1,8 @@
+fastapi>=0.115.0
+uvicorn>=0.30.0
+boto3>=1.35.0
+
+[dev]
+pytest>=8.0
+httpx>=0.27.0
+moto[dynamodb,iam,lambda,s3,sqs]>=5.0

stackport-0.1.3/tests/test_cache.py

@@ -0,0 +1,63 @@
+import threading
+import time
+
+from backend.cache import TTLCache
+
+
+class TestTTLCache:
+    def test_set_and_get(self):
+        c = TTLCache()
+        c.set("k", "v", ttl=10)
+        assert c.get("k") == "v"
+
+    def test_get_missing_key(self):
+        c = TTLCache()
+        assert c.get("missing") is None
+
+    def test_expiry(self):
+        c = TTLCache()
+        c.set("k", "v", ttl=0.1)
+        time.sleep(0.15)
+        assert c.get("k") is None
+
+    def test_overwrite(self):
+        c = TTLCache()
+        c.set("k", "v1", ttl=10)
+        c.set("k", "v2", ttl=10)
+        assert c.get("k") == "v2"
+
+    def test_thread_safety(self):
+        c = TTLCache()
+        errors = []
+
+        def writer(n: int):
+            try:
+                for i in range(100):
+                    c.set(f"key-{n}-{i}", i, ttl=5)
+            except Exception as e:
+                errors.append(e)
+
+        def reader():
+            try:
+                for _ in range(100):
+                    c.get("key-0-0")
+            except Exception as e:
+                errors.append(e)
+
+        threads = [threading.Thread(target=writer, args=(i,)) for i in range(5)]
+        threads += [threading.Thread(target=reader) for _ in range(5)]
+        for t in threads:
+            t.start()
+        for t in threads:
+            t.join()
+
+        assert errors == []
+
+    def test_different_types(self):
+        c = TTLCache()
+        c.set("dict", {"a": 1}, ttl=10)
+        c.set("list", [1, 2, 3], ttl=10)
+        c.set("int", 42, ttl=10)
+        assert c.get("dict") == {"a": 1}
+        assert c.get("list") == [1, 2, 3]
+        assert c.get("int") == 42

stackport-0.1.3/tests/test_client.py

@@ -0,0 +1,17 @@
+from backend.aws_client import get_client
+
+
+class TestGetClient:
+    def test_returns_boto3_client(self):
+        client = get_client("s3")
+        assert hasattr(client, "list_buckets")
+
+    def test_lru_cache_returns_same_instance(self):
+        c1 = get_client("s3")
+        c2 = get_client("s3")
+        assert c1 is c2
+
+    def test_different_services_return_different_clients(self):
+        s3 = get_client("s3")
+        sqs = get_client("sqs")
+        assert s3 is not sqs

stackport-0.1.3/tests/test_config.py

@@ -0,0 +1,41 @@
+import os
+
+
+class TestConfig:
+    def test_defaults(self):
+        """Config module provides sensible defaults."""
+        from backend.config import (
+            AWS_ACCESS_KEY_ID,
+            AWS_ENDPOINT_URL,
+            AWS_REGION,
+            AWS_SECRET_ACCESS_KEY,
+            STACKPORT_PORT,
+            STACKPORT_SERVICES,
+        )
+
+        assert AWS_ENDPOINT_URL  # non-empty
+        assert AWS_REGION  # non-empty
+        assert AWS_ACCESS_KEY_ID  # non-empty
+        assert AWS_SECRET_ACCESS_KEY  # non-empty
+        assert isinstance(STACKPORT_PORT, int)
+        assert STACKPORT_PORT > 0
+        # Services string should contain known services
+        services = [s.strip() for s in STACKPORT_SERVICES.split(",")]
+        assert "s3" in services
+        assert "dynamodb" in services
+        assert "lambda" in services
+        assert len(services) >= 30  # at least 30 services configured
+
+    def test_env_override(self, monkeypatch):
+        """Config respects environment variable overrides."""
+        monkeypatch.setenv("STACKPORT_PORT", "9999")
+        # Re-import to pick up env change
+        import importlib
+
+        import backend.config
+
+        importlib.reload(backend.config)
+        assert backend.config.STACKPORT_PORT == 9999
+        # Restore
+        monkeypatch.delenv("STACKPORT_PORT")
+        importlib.reload(backend.config)