stackport 0.1.3__tar.gz → 0.1.5__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: stackport
-Version: 0.1.3
+Version: 0.1.5
 Summary: Universal AWS resource browser for local emulators
 Author: Davi Reis Vieira
 License: MIT
@@ -30,17 +30,23 @@ 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>
+
+<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>
 
-<p>
+<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://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"></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>
 
-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.
-
 ## Screenshots
 
 **Dashboard** — Service overview with resource counts and health status
@@ -115,6 +121,7 @@ AWS_ENDPOINT_URL=http://my-emulator:4566 stackport
 | `AWS_SECRET_ACCESS_KEY` | `test` | AWS secret key |
 | `STACKPORT_PORT` | `8080` | StackPort server port |
 | `STACKPORT_SERVICES` | *(35 services)* | Comma-separated services to probe |
+| `LOG_LEVEL` | `INFO` | Python log level (DEBUG shows healthcheck logs) |
 
 ## Supported Services (35)
 

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

@@ -1,14 +1,20 @@
-# StackPort
+<p align="center">
+  <img src="docs/images/stackport_logo.svg" alt="StackPort — Universal AWS Resource Browser" width="150"/>
+</p>
+
+<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>
 
-<p>
+<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://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"></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>
 
-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.
-
 ## Screenshots
 
 **Dashboard** — Service overview with resource counts and health status
@@ -83,6 +89,7 @@ AWS_ENDPOINT_URL=http://my-emulator:4566 stackport
 | `AWS_SECRET_ACCESS_KEY` | `test` | AWS secret key |
 | `STACKPORT_PORT` | `8080` | StackPort server port |
 | `STACKPORT_SERVICES` | *(35 services)* | Comma-separated services to probe |
+| `LOG_LEVEL` | `INFO` | Python log level (DEBUG shows healthcheck logs) |
 
 ## Supported Services (35)
 

{stackport-0.1.3 → stackport-0.1.5}/backend/config.py

@@ -12,3 +12,4 @@ STACKPORT_SERVICES: str = os.environ.get(
     "ecr,elasticache,glue,athena,apigateway,firehose,cognito-idp,cognito-identity,"
     "elasticmapreduce,elasticloadbalancing,elasticfilesystem,cloudfront,appsync",
 )
+LOG_LEVEL: str = os.environ.get("LOG_LEVEL", "INFO").upper()

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

@@ -1,6 +1,5 @@
 import logging
 import os
-import time
 
 import uvicorn
 from fastapi import FastAPI
@@ -8,15 +7,29 @@ from fastapi.middleware.cors import CORSMiddleware
 from fastapi.responses import FileResponse
 from fastapi.staticfiles import StaticFiles
 
-from backend.config import STACKPORT_PORT
-from backend.routes import dynamodb, resources, s3, stats
+from backend.config import LOG_LEVEL, STACKPORT_PORT
+from backend.routes import dynamodb, ec2, iam, lambda_svc, logs, resources, s3, sqs, stats
+
+
+class HealthcheckFilter(logging.Filter):
+    """Suppress healthcheck access logs unless LOG_LEVEL is DEBUG."""
+
+    def filter(self, record: logging.LogRecord) -> bool:
+        if getattr(logging, LOG_LEVEL, logging.INFO) <= logging.DEBUG:
+            return True
+        message = record.getMessage()
+        return "/health" not in message
+
 
 logging.basicConfig(
-    level=logging.INFO,
+    level=LOG_LEVEL,
     format="%(asctime)s %(name)s %(levelname)s %(message)s",
 )
 logger = logging.getLogger(__name__)
 
+# Suppress noisy healthcheck access logs at non-DEBUG levels
+logging.getLogger("uvicorn.access").addFilter(HealthcheckFilter())
+
 app = FastAPI(title="StackPort", docs_url="/api/docs")
 
 app.add_middleware(
@@ -29,6 +42,11 @@ 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
@@ -47,7 +65,7 @@ if os.path.isdir(ui_dist):
 
 
 def cli():
-    uvicorn.run("backend.main:app", host="0.0.0.0", port=STACKPORT_PORT, reload=False)
+    uvicorn.run("backend.main:app", host="0.0.0.0", port=STACKPORT_PORT, log_level=LOG_LEVEL.lower(), reload=False)
 
 
 if __name__ == "__main__":

stackport-0.1.5/backend/routes/ec2.py

@@ -0,0 +1,326 @@
+"""EC2 service-specific routes."""
+
+import base64
+from typing import Any
+
+from fastapi import APIRouter, HTTPException
+
+from backend.aws_client import get_client
+
+router = APIRouter()
+
+
+def _get_instance_name(tags: list[dict] | None) -> str:
+    """Extract Name tag from instance tags."""
+    if not tags:
+        return ""
+    for tag in tags:
+        if tag.get("Key") == "Name":
+            return tag.get("Value", "")
+    return ""
+
+
+def _flatten_instances(reservations: list[dict]) -> list[dict]:
+    """Flatten Reservations structure to flat list of instances."""
+    instances = []
+    for reservation in reservations:
+        instances.extend(reservation.get("Instances", []))
+    return instances
+
+
+def _decode_user_data(encoded: str | None) -> str | None:
+    """Decode base64-encoded user data."""
+    if not encoded:
+        return None
+    try:
+        return base64.b64decode(encoded).decode("utf-8")
+    except Exception:
+        return None
+
+
+@router.get("/instances")
+def list_instances() -> dict[str, Any]:
+    """List all EC2 instances with enriched metadata."""
+    try:
+        client = get_client("ec2")
+        paginator = client.get_paginator("describe_instances")
+
+        all_instances = []
+        for page in paginator.paginate():
+            instances = _flatten_instances(page.get("Reservations", []))
+            for instance in instances:
+                all_instances.append(
+                    {
+                        "instanceId": instance["InstanceId"],
+                        "name": _get_instance_name(instance.get("Tags")),
+                        "state": instance["State"]["Name"],
+                        "instanceType": instance["InstanceType"],
+                        "imageId": instance.get("ImageId"),
+                        "launchTime": instance.get("LaunchTime").isoformat() if instance.get("LaunchTime") else None,
+                        "publicIpAddress": instance.get("PublicIpAddress"),
+                        "privateIpAddress": instance.get("PrivateIpAddress"),
+                        "vpcId": instance.get("VpcId"),
+                        "subnetId": instance.get("SubnetId"),
+                        "keyName": instance.get("KeyName"),
+                        "platform": instance.get("Platform"),
+                        "securityGroups": instance.get("SecurityGroups", []),
+                        "tags": instance.get("Tags", []),
+                    }
+                )
+
+        return {"instances": all_instances}
+    except Exception as e:
+        raise HTTPException(status_code=500, detail=str(e))
+
+
+@router.get("/instances/{instance_id}")
+def get_instance_detail(instance_id: str) -> dict[str, Any]:
+    """Get detailed information for a specific instance including user data."""
+    try:
+        client = get_client("ec2")
+
+        # Get instance details
+        response = client.describe_instances(InstanceIds=[instance_id])
+        reservations = response.get("Reservations", [])
+
+        if not reservations or not reservations[0].get("Instances"):
+            raise HTTPException(status_code=404, detail=f"Instance {instance_id} not found")
+
+        instance = reservations[0]["Instances"][0]
+
+        # Try to get user data
+        user_data = None
+        try:
+            user_data_response = client.describe_instance_attribute(
+                InstanceId=instance_id, Attribute="userData"
+            )
+            encoded_data = user_data_response.get("UserData", {}).get("Value")
+            user_data = _decode_user_data(encoded_data)
+        except Exception:
+            # User data may not exist or permission denied
+            pass
+
+        return {
+            "instance": {
+                "instanceId": instance["InstanceId"],
+                "name": _get_instance_name(instance.get("Tags")),
+                "state": instance["State"]["Name"],
+                "stateCode": instance["State"]["Code"],
+                "instanceType": instance["InstanceType"],
+                "imageId": instance.get("ImageId"),
+                "launchTime": instance.get("LaunchTime").isoformat() if instance.get("LaunchTime") else None,
+                "publicIpAddress": instance.get("PublicIpAddress"),
+                "privateIpAddress": instance.get("PrivateIpAddress"),
+                "vpcId": instance.get("VpcId"),
+                "subnetId": instance.get("SubnetId"),
+                "keyName": instance.get("KeyName"),
+                "platform": instance.get("Platform"),
+                "securityGroups": instance.get("SecurityGroups", []),
+                "networkInterfaces": instance.get("NetworkInterfaces", []),
+                "blockDeviceMappings": instance.get("BlockDeviceMappings", []),
+                "tags": instance.get("Tags", []),
+                "userData": user_data,
+            }
+        }
+    except HTTPException:
+        raise
+    except client.exceptions.ClientError as e:
+        error_code = e.response["Error"]["Code"]
+        if error_code == "InvalidInstanceID.NotFound":
+            raise HTTPException(status_code=404, detail=f"Instance {instance_id} not found")
+        raise HTTPException(status_code=500, detail=str(e))
+    except Exception as e:
+        raise HTTPException(status_code=500, detail=str(e))
+
+
+@router.post("/instances/{instance_id}/start")
+def start_instance(instance_id: str) -> dict[str, Any]:
+    """Start a stopped EC2 instance."""
+    try:
+        client = get_client("ec2")
+        response = client.start_instances(InstanceIds=[instance_id])
+
+        starting_instances = response.get("StartingInstances", [])
+        if not starting_instances:
+            raise HTTPException(status_code=500, detail="No state change returned")
+
+        return {
+            "success": True,
+            "state": {
+                "previous": starting_instances[0]["PreviousState"]["Name"],
+                "current": starting_instances[0]["CurrentState"]["Name"],
+            },
+        }
+    except client.exceptions.ClientError as e:
+        error_code = e.response["Error"]["Code"]
+        if error_code == "InvalidInstanceID.NotFound":
+            raise HTTPException(status_code=404, detail=f"Instance {instance_id} not found")
+        raise HTTPException(status_code=400, detail=str(e))
+    except Exception as e:
+        raise HTTPException(status_code=500, detail=str(e))
+
+
+@router.post("/instances/{instance_id}/stop")
+def stop_instance(instance_id: str) -> dict[str, Any]:
+    """Stop a running EC2 instance."""
+    try:
+        client = get_client("ec2")
+        response = client.stop_instances(InstanceIds=[instance_id])
+
+        stopping_instances = response.get("StoppingInstances", [])
+        if not stopping_instances:
+            raise HTTPException(status_code=500, detail="No state change returned")
+
+        return {
+            "success": True,
+            "state": {
+                "previous": stopping_instances[0]["PreviousState"]["Name"],
+                "current": stopping_instances[0]["CurrentState"]["Name"],
+            },
+        }
+    except client.exceptions.ClientError as e:
+        error_code = e.response["Error"]["Code"]
+        if error_code == "InvalidInstanceID.NotFound":
+            raise HTTPException(status_code=404, detail=f"Instance {instance_id} not found")
+        raise HTTPException(status_code=400, detail=str(e))
+    except Exception as e:
+        raise HTTPException(status_code=500, detail=str(e))
+
+
+@router.post("/instances/{instance_id}/reboot")
+def reboot_instance(instance_id: str) -> dict[str, Any]:
+    """Reboot an EC2 instance."""
+    try:
+        client = get_client("ec2")
+        client.reboot_instances(InstanceIds=[instance_id])
+
+        return {"success": True, "message": f"Instance {instance_id} reboot initiated"}
+    except client.exceptions.ClientError as e:
+        error_code = e.response["Error"]["Code"]
+        if error_code == "InvalidInstanceID.NotFound":
+            raise HTTPException(status_code=404, detail=f"Instance {instance_id} not found")
+        raise HTTPException(status_code=400, detail=str(e))
+    except Exception as e:
+        raise HTTPException(status_code=500, detail=str(e))
+
+
+@router.post("/instances/{instance_id}/terminate")
+def terminate_instance(instance_id: str) -> dict[str, Any]:
+    """Terminate an EC2 instance."""
+    try:
+        client = get_client("ec2")
+        response = client.terminate_instances(InstanceIds=[instance_id])
+
+        terminating_instances = response.get("TerminatingInstances", [])
+        if not terminating_instances:
+            raise HTTPException(status_code=500, detail="No state change returned")
+
+        return {
+            "success": True,
+            "state": {
+                "previous": terminating_instances[0]["PreviousState"]["Name"],
+                "current": terminating_instances[0]["CurrentState"]["Name"],
+            },
+        }
+    except client.exceptions.ClientError as e:
+        error_code = e.response["Error"]["Code"]
+        if error_code == "InvalidInstanceID.NotFound":
+            raise HTTPException(status_code=404, detail=f"Instance {instance_id} not found")
+        raise HTTPException(status_code=400, detail=str(e))
+    except Exception as e:
+        raise HTTPException(status_code=500, detail=str(e))
+
+
+@router.get("/security-groups")
+def list_security_groups() -> dict[str, Any]:
+    """List all security groups with rules."""
+    try:
+        client = get_client("ec2")
+        response = client.describe_security_groups()
+
+        security_groups = []
+        for sg in response.get("SecurityGroups", []):
+            security_groups.append(
+                {
+                    "groupId": sg["GroupId"],
+                    "groupName": sg["GroupName"],
+                    "description": sg.get("Description", ""),
+                    "vpcId": sg.get("VpcId"),
+                    "ipPermissions": sg.get("IpPermissions", []),
+                    "ipPermissionsEgress": sg.get("IpPermissionsEgress", []),
+                    "tags": sg.get("Tags", []),
+                }
+            )
+
+        return {"securityGroups": security_groups}
+    except Exception as e:
+        raise HTTPException(status_code=500, detail=str(e))
+
+
+@router.get("/vpcs")
+def list_vpcs() -> dict[str, Any]:
+    """List all VPCs with their subnets."""
+    try:
+        client = get_client("ec2")
+        vpcs_response = client.describe_vpcs()
+
+        vpcs = []
+        for vpc in vpcs_response.get("Vpcs", []):
+            vpc_id = vpc["VpcId"]
+
+            # Get subnets for this VPC
+            subnets_response = client.describe_subnets(
+                Filters=[{"Name": "vpc-id", "Values": [vpc_id]}]
+            )
+
+            subnets = []
+            for subnet in subnets_response.get("Subnets", []):
+                subnets.append(
+                    {
+                        "subnetId": subnet["SubnetId"],
+                        "cidrBlock": subnet["CidrBlock"],
+                        "availabilityZone": subnet["AvailabilityZone"],
+                        "availableIpAddressCount": subnet.get("AvailableIpAddressCount", 0),
+                        "state": subnet.get("State"),
+                        "tags": subnet.get("Tags", []),
+                    }
+                )
+
+            vpcs.append(
+                {
+                    "vpcId": vpc_id,
+                    "cidrBlock": vpc["CidrBlock"],
+                    "state": vpc.get("State"),
+                    "isDefault": vpc.get("IsDefault", False),
+                    "tags": vpc.get("Tags", []),
+                    "subnets": subnets,
+                }
+            )
+
+        return {"vpcs": vpcs}
+    except Exception as e:
+        raise HTTPException(status_code=500, detail=str(e))
+
+
+@router.get("/key-pairs")
+def list_key_pairs() -> dict[str, Any]:
+    """List all key pairs."""
+    try:
+        client = get_client("ec2")
+        response = client.describe_key_pairs()
+
+        key_pairs = []
+        for kp in response.get("KeyPairs", []):
+            key_pairs.append(
+                {
+                    "keyPairId": kp.get("KeyPairId"),
+                    "keyName": kp["KeyName"],
+                    "keyFingerprint": kp.get("KeyFingerprint"),
+                    "keyType": kp.get("KeyType", "rsa"),
+                    "tags": kp.get("Tags", []),
+                }
+            )
+
+        return {"keyPairs": key_pairs}
+    except Exception as e:
+        raise HTTPException(status_code=500, detail=str(e))