stackport 0.1.2__tar.gz → 0.1.4__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: stackport
-Version: 0.1.2
+Version: 0.1.4
 Summary: Universal AWS resource browser for local emulators
 Author: Davi Reis Vieira
 License: MIT
@@ -24,19 +24,39 @@ 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
+<p align="center">
+  <img src="docs/images/stackport_logo.svg" alt="StackPort — Universal AWS Resource Browser" width="150"/>
+</p>
 
-[![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)
+<h1 align="center">StackPort</h1>
+<p align="center"><strong>Universal AWS resource browser for local emulators. Built to work with MiniStack, and also compatible with LocalStack, Moto, or any AWS-compatible endpoint.</strong></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.
+<p align="center">
+  <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://hub.docker.com/r/davireis/stackport"><img src="https://img.shields.io/docker/image-size/davireis/stackport/latest" alt="Docker Image Size"></a>
+  <a href="https://github.com/DaviReisVieira/stackport/blob/master/LICENSE"><img src="https://img.shields.io/github/license/DaviReisVieira/stackport" alt="License"></a>
+  <img src="https://img.shields.io/badge/python-3.12-slim" alt="Python">
+  <a href="https://github.com/DaviReisVieira/stackport/stargazers"><img src="https://img.shields.io/github/stars/DaviReisVieira/stackport" alt="GitHub stars"></a>
+</p>
 
-<!-- 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 +82,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.4}/README.md

@@ -1,14 +1,30 @@
-# StackPort
+<p align="center">
+  <img src="docs/images/stackport_logo.svg" alt="StackPort — Universal AWS Resource Browser" width="150"/>
+</p>
 
-[![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)
+<h1 align="center">StackPort</h1>
+<p align="center"><strong>Universal AWS resource browser for local emulators. Built to work with MiniStack, and also compatible with LocalStack, Moto, or any AWS-compatible endpoint.</strong></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.
+<p align="center">
+  <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://hub.docker.com/r/davireis/stackport"><img src="https://img.shields.io/docker/image-size/davireis/stackport/latest" alt="Docker Image Size"></a>
+  <a href="https://github.com/DaviReisVieira/stackport/blob/master/LICENSE"><img src="https://img.shields.io/github/license/DaviReisVieira/stackport" alt="License"></a>
+  <img src="https://img.shields.io/badge/python-3.12-slim" alt="Python">
+  <a href="https://github.com/DaviReisVieira/stackport/stargazers"><img src="https://img.shields.io/github/stars/DaviReisVieira/stackport" alt="GitHub stars"></a>
+</p>
 
-<!-- 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 +50,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.4}/backend/main.py

@@ -1,6 +1,5 @@
 import logging
 import os
-import time
 
 import uvicorn
 from fastapi import FastAPI
@@ -9,7 +8,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, ec2, iam, lambda_svc, logs, resources, s3, sqs, stats
 
 logging.basicConfig(
     level=logging.INFO,
@@ -28,6 +27,12 @@ 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(lambda_svc.router, prefix="/api/lambda", tags=["lambda"])
+app.include_router(sqs.router, prefix="/api/sqs", tags=["sqs"])
+app.include_router(iam.router, prefix="/api/iam", tags=["iam"])
+app.include_router(ec2.router, prefix="/api/ec2", tags=["ec2"])
+app.include_router(logs.router, prefix="/api/logs", tags=["logs"])
 app.include_router(resources.router, prefix="/api")
 
 # Serve UI static files — mount assets under /assets, SPA fallback for everything else

stackport-0.1.4/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}