stackport 0.1.0__py3-none-any.whl

backend/routes/stats.py

@@ -0,0 +1,158 @@
+import logging
+import time
+from concurrent.futures import ThreadPoolExecutor, as_completed
+
+from fastapi import APIRouter
+
+from backend.aws_client import get_client
+
+logger = logging.getLogger(__name__)
+from backend.cache import cache
+from backend.config import STACKPORT_SERVICES
+
+router = APIRouter()
+
+SERVICE_REGISTRY: dict[str, list[tuple[str, str, str, str]]] = {
+    "s3": [("buckets", "s3", "list_buckets", "Buckets")],
+    "sqs": [("queues", "sqs", "list_queues", "QueueUrls")],
+    "sns": [("topics", "sns", "list_topics", "Topics")],
+    "dynamodb": [("tables", "dynamodb", "list_tables", "TableNames")],
+    "lambda": [("functions", "lambda", "list_functions", "Functions")],
+    "iam": [
+        ("roles", "iam", "list_roles", "Roles"),
+        ("users", "iam", "list_users", "Users"),
+        ("policies", "iam", "list_policies", "Policies"),
+    ],
+    "logs": [("log_groups", "logs", "describe_log_groups", "logGroups")],
+    "ssm": [("parameters", "ssm", "describe_parameters", "Parameters")],
+    "secretsmanager": [("secrets", "secretsmanager", "list_secrets", "SecretList")],
+    "kinesis": [("streams", "kinesis", "list_streams", "StreamNames")],
+    "events": [
+        ("rules", "events", "list_rules", "Rules"),
+        ("event_buses", "events", "list_event_buses", "EventBuses"),
+    ],
+    "ec2": [
+        ("instances", "ec2", "describe_instances", "Reservations"),
+        ("vpcs", "ec2", "describe_vpcs", "Vpcs"),
+        ("subnets", "ec2", "describe_subnets", "Subnets"),
+        ("security_groups", "ec2", "describe_security_groups", "SecurityGroups"),
+        ("volumes", "ec2", "describe_volumes", "Volumes"),
+    ],
+    "route53": [("hosted_zones", "route53", "list_hosted_zones", "HostedZones")],
+    "kms": [("keys", "kms", "list_keys", "Keys")],
+    "cloudformation": [("stacks", "cloudformation", "list_stacks", "StackSummaries")],
+    "stepfunctions": [
+        ("state_machines", "stepfunctions", "list_state_machines", "stateMachines"),
+    ],
+    "rds": [
+        ("db_instances", "rds", "describe_db_instances", "DBInstances"),
+        ("db_clusters", "rds", "describe_db_clusters", "DBClusters"),
+    ],
+    "ecs": [
+        ("clusters", "ecs", "list_clusters", "clusterArns"),
+        ("task_definitions", "ecs", "list_task_definitions", "taskDefinitionArns"),
+    ],
+    "monitoring": [
+        ("alarms", "cloudwatch", "describe_alarms", "MetricAlarms"),
+        ("dashboards", "cloudwatch", "list_dashboards", "DashboardEntries"),
+    ],
+    "ses": [("identities", "ses", "list_identities", "Identities")],
+    "acm": [("certificates", "acm", "list_certificates", "CertificateSummaryList")],
+    "wafv2": [("web_acls", "wafv2", "list_web_acls", "WebACLs")],
+    "ecr": [("repositories", "ecr", "describe_repositories", "repositories")],
+    "elasticache": [("cache_clusters", "elasticache", "describe_cache_clusters", "CacheClusters")],
+    "glue": [
+        ("databases", "glue", "get_databases", "DatabaseList"),
+        ("crawlers", "glue", "get_crawlers", "Crawlers"),
+    ],
+    "athena": [("workgroups", "athena", "list_work_groups", "WorkGroups")],
+    "apigateway": [("apis", "apigatewayv2", "get_apis", "Items")],
+    "firehose": [("delivery_streams", "firehose", "list_delivery_streams", "DeliveryStreamNames")],
+    "cognito-idp": [("user_pools", "cognito-idp", "list_user_pools", "UserPools")],
+    "cognito-identity": [("identity_pools", "cognito-identity", "list_identity_pools", "IdentityPools")],
+    "elasticmapreduce": [("clusters", "emr", "list_clusters", "Clusters")],
+    "elasticloadbalancing": [("load_balancers", "elbv2", "describe_load_balancers", "LoadBalancers")],
+    "elasticfilesystem": [("file_systems", "efs", "describe_file_systems", "FileSystems")],
+    "cloudfront": [("distributions", "cloudfront", "list_distributions", "DistributionList")],
+    "appsync": [("graphql_apis", "appsync", "list_graphql_apis", "graphqlApis")],
+    "sts": [],
+}
+
+_start_time = time.time()
+
+
+@router.get("/health")
+def health():
+    return {"status": "ok", "uptime_seconds": round(time.time() - _start_time, 1)}
+
+
+# Some APIs require extra parameters to call
+_METHOD_KWARGS: dict[tuple[str, str], dict] = {
+    ("cognito-idp", "list_user_pools"): {"MaxResults": 60},
+    ("cognito-identity", "list_identity_pools"): {"MaxResults": 60},
+    ("wafv2", "list_web_acls"): {"Scope": "REGIONAL"},
+}
+
+
+def _count_items(resp, response_key: str) -> int:
+    """Extract item count from a response, handling nested structures."""
+    items = resp.get(response_key, [])
+    # cloudfront list_distributions returns {"DistributionList": {"Items": [...]}}
+    if isinstance(items, dict) and "Items" in items:
+        return len(items.get("Items", []) or [])
+    if isinstance(items, list):
+        return len(items)
+    return 0
+
+
+def _probe_service(service: str) -> tuple[str, dict]:
+    """Probe a single service and return (service_name, result_dict)."""
+    registry_entries = SERVICE_REGISTRY.get(service)
+    if not registry_entries:
+        return service, {"status": "unavailable", "resources": {}}
+
+    resources: dict[str, int] = {}
+    try:
+        for resource_type, boto3_service, method_name, response_key in registry_entries:
+            client = get_client(boto3_service)
+            method = getattr(client, method_name)
+            kwargs = _METHOD_KWARGS.get((boto3_service, method_name), {})
+            try:
+                resp = method(**kwargs)
+                resources[resource_type] = _count_items(resp, response_key)
+            except Exception:
+                logger.debug("Failed to probe %s/%s", service, resource_type, exc_info=True)
+                resources[resource_type] = 0
+        return service, {"status": "available", "resources": resources}
+    except Exception:
+        logger.warning("Service %s unavailable", service, exc_info=True)
+        return service, {"status": "unavailable", "resources": {}}
+
+
+@router.get("/stats")
+def get_stats():
+    cached = cache.get("stats")
+    if cached is not None:
+        return cached
+
+    enabled_services = [s.strip() for s in STACKPORT_SERVICES.split(",") if s.strip()]
+    services: dict = {}
+    total_resources = 0
+
+    with ThreadPoolExecutor(max_workers=min(len(enabled_services), 10)) as executor:
+        futures = {executor.submit(_probe_service, svc): svc for svc in enabled_services}
+        for future in as_completed(futures):
+            svc_name, result = future.result()
+            services[svc_name] = result
+            total_resources += sum(result["resources"].values())
+
+    # Sort services alphabetically for stable dashboard ordering
+    sorted_services = dict(sorted(services.items()))
+
+    response = {
+        "services": sorted_services,
+        "total_resources": total_resources,
+        "uptime_seconds": round(time.time() - _start_time, 1),
+    }
+    cache.set("stats", response, ttl=5)
+    return response

stackport-0.1.0.dist-info/METADATA

@@ -0,0 +1,102 @@
+Metadata-Version: 2.4
+Name: stackport
+Version: 0.1.0
+Summary: Universal AWS resource browser for local emulators
+Author: Davi Reis Vieira
+License: MIT
+Project-URL: Homepage, https://github.com/DaviReisVieira/stackport
+Project-URL: Repository, https://github.com/DaviReisVieira/stackport
+Project-URL: Issues, https://github.com/DaviReisVieira/stackport/issues
+Keywords: aws,localstack,s3,browser,devtools,emulator
+Classifier: Development Status :: 4 - Beta
+Classifier: Framework :: FastAPI
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Testing
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: fastapi>=0.115.0
+Requires-Dist: uvicorn>=0.30.0
+Requires-Dist: boto3>=1.35.0
+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)
+
+Universal AWS resource browser for local emulators. Works with **LocalStack**, **MiniStack**, **Moto**, or any AWS-compatible endpoint.
+
+<!-- TODO: Add screenshot here -->
+<!-- ![StackPort Dashboard](docs/screenshot.png) -->
+
+## Features
+
+- Browse and inspect resources across **35 AWS services**
+- S3 file browser with folder navigation, search, pagination, and download
+- Dashboard with service health, resource counts, and auto-refresh
+- Single Docker image, zero AWS dependencies
+
+## Quick Start
+
+### pip
+
+```bash
+pip install stackport
+AWS_ENDPOINT_URL=http://localhost:4566 stackport
+# Open http://localhost:8080
+```
+
+### Docker
+
+```bash
+docker run -p 8080:8080 -e AWS_ENDPOINT_URL=http://host.docker.internal:4566 davireis/stackport
+```
+
+### Docker Compose
+
+```bash
+curl -O https://raw.githubusercontent.com/DaviReisVieira/stackport/main/docker-compose.yml
+docker compose up -d
+# Open http://localhost:8080
+```
+
+## Configuration
+
+| Variable | Default | Description |
+|---|---|---|
+| `AWS_ENDPOINT_URL` | `http://localhost:4566` | Target AWS endpoint |
+| `AWS_REGION` | `us-east-1` | AWS region |
+| `AWS_ACCESS_KEY_ID` | `test` | AWS access key |
+| `AWS_SECRET_ACCESS_KEY` | `test` | AWS secret key |
+| `STACKPORT_PORT` | `8080` | StackPort server port |
+| `STACKPORT_SERVICES` | *(35 services)* | Comma-separated services to probe |
+
+## Supported Services (35)
+
+ACM, API Gateway, AppSync, Athena, CloudFormation, CloudFront, Cognito (IDP + Identity), DynamoDB, EC2, ECR, ECS, ElastiCache, EFS, ELB, EMR, EventBridge, Firehose, Glue, IAM, Kinesis, KMS, Lambda, CloudWatch Logs, CloudWatch Monitoring, RDS, Route 53, S3, Secrets Manager, SES, SNS, SQS, SSM, Step Functions, WAFv2
+
+S3 has a dedicated file browser. All other services use the generic resource table with detail view.
+
+## Development
+
+```bash
+git clone https://github.com/DaviReisVieira/stackport.git
+cd stackport
+pip install -e .
+cd ui && npm install && npm run dev
+```
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for full details.
+
+## License
+
+MIT

stackport-0.1.0.dist-info/RECORD

@@ -0,0 +1,19 @@
+backend/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+backend/aws_client.py,sha256=rNt-qQqeCy54Hb3gPKxtSuVnDKViGTl8M5fgV63XrpI,526
+backend/cache.py,sha256=6OF0I9cyi7fmfCr5QBrYxvvWGulHDhzOr340Hz9vR6Y,567
+backend/config.py,sha256=YFrWTMHCOhJ5jmg4ytGwoDTtRIHgdpKryxZPe75PGv4,767
+backend/main.py,sha256=peVDdrrK5mVfMX7BuBh2o_qDEMSnVfM8stgF-7g4fiQ,1550
+backend/routes/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+backend/routes/resources.py,sha256=z97_ph8oLYLPWfL1gkhpYzaWDkUiTCAbuNZOhnD45pI,9911
+backend/routes/s3.py,sha256=J1ZpekThENncS1ddi10BasRSRBfti78asjQY-0MVr_g,5259
+backend/routes/stats.py,sha256=_4yhy2Cwk7iv2-356Ci3azm0rswmIGAVaXsRSSUch0Y,6872
+stackport-0.1.0.dist-info/licenses/LICENSE,sha256=58bwgd-mfpDxJnsVLaUd8vpVdhrsufjHNoBv6IMlS5Q,1071
+ui/dist/favicon.png,sha256=0xof-VmBrejR01bF6At7sxsxbQpL_cbhA9XzjFIAaY8,38314
+ui/dist/index.html,sha256=WSoujeiRMoSatVgCRLHbAn3dl5uAwp9vSVakfz4V6bk,452
+ui/dist/assets/index-CRqBg0t6.js,sha256=imUrDe2KAbHRgORYqtJ94xI2KiRU-aIjg0ngjELBWkw,408923
+ui/dist/assets/index-Is3dIbZM.css,sha256=8Cg-AelGUt0uLM4bgXv2uX5iVfpMH7w_s_ubAf3wIV0,25321
+stackport-0.1.0.dist-info/METADATA,sha256=72RzL-l4ku-oPyTBK-p1O5e8c1X0nwtHuGQ73WNTH_M,3585
+stackport-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+stackport-0.1.0.dist-info/entry_points.txt,sha256=T4aCL0UM7BHwKodc8AFp41bhoVfApgbPkjeJz9IwMhI,47
+stackport-0.1.0.dist-info/top_level.txt,sha256=o0r_qMzzBDDtK9APrv2QVcIw9oc00JRmCEsTE2-AFr0,8
+stackport-0.1.0.dist-info/RECORD,,

stackport-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

stackport-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+stackport = backend.main:cli

stackport-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 DaviReisVieira
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

stackport-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+backend