Add strict selection-based component editing and frontend integration guide

Author: owenisas

backend/aws_clients.py

@@ -0,0 +1,47 @@
+"""Shared AWS client/resource helpers with optional local endpoint overrides."""
+
+from __future__ import annotations
+
+import os
+import re
+from typing import Any
+
+import boto3
+
+
+def _service_env_suffix(service_name: str) -> str:
+    normalized = re.sub(r"[^A-Za-z0-9]", "_", str(service_name or "").strip())
+    return normalized.upper()
+
+
+def resolve_endpoint_url(service_name: str) -> str | None:
+    """Resolve endpoint URL for a boto service.
+
+    Precedence:
+    1) AWS_ENDPOINT_URL_<SERVICE>
+    2) AWS_ENDPOINT_URL
+    """
+    suffix = _service_env_suffix(service_name)
+    service_specific = str(os.getenv(f"AWS_ENDPOINT_URL_{suffix}") or "").strip()
+    if service_specific:
+        return service_specific
+
+    global_endpoint = str(os.getenv("AWS_ENDPOINT_URL") or "").strip()
+    if global_endpoint:
+        return global_endpoint
+
+    return None
+
+
+def get_aws_client(service_name: str, **kwargs: Any):
+    endpoint_url = resolve_endpoint_url(service_name)
+    if endpoint_url and not kwargs.get("endpoint_url"):
+        kwargs["endpoint_url"] = endpoint_url
+    return boto3.client(service_name, **kwargs)
+
+
+def get_aws_resource(service_name: str, **kwargs: Any):
+    endpoint_url = resolve_endpoint_url(service_name)
+    if endpoint_url and not kwargs.get("endpoint_url"):
+        kwargs["endpoint_url"] = endpoint_url
+    return boto3.resource(service_name, **kwargs)