stackgen-sdk 0.4.0rc41__tar.gz → 0.4.0rc43__tar.gz

{stackgen_sdk-0.4.0rc41 → stackgen_sdk-0.4.0rc43}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: stackgen-sdk
-Version: 0.4.0rc41
+Version: 0.4.0rc43
 Summary: StackGen SDK — Aiden, SRE, and Vault from one client
 Project-URL: Homepage, https://appcd-dev.github.io/stackgen-sdk/
 Project-URL: Documentation, https://appcd-dev.github.io/stackgen-sdk/

{stackgen_sdk-0.4.0rc41 → stackgen_sdk-0.4.0rc43}/src/stackgen/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '0.4.0rc41'
-__version_tuple__ = version_tuple = (0, 4, 0, 'rc41')
+__version__ = version = '0.4.0rc43'
+__version_tuple__ = version_tuple = (0, 4, 0, 'rc43')
 
 __commit_id__ = commit_id = None

{stackgen_sdk-0.4.0rc41 → stackgen_sdk-0.4.0rc43}/src/stackgen/orgs/namespace.py

@@ -9,6 +9,7 @@ the org when the run finishes.
 from __future__ import annotations
 
 import json
+import urllib.parse
 from typing import Any
 
 from stackgen import _http
@@ -21,6 +22,31 @@ _log = get_logger("orgs")
 # Reserved AppCD system role (see rbacutil.RoleNameWorkspaceAdmin).
 _WORKSPACE_ADMIN_ROLE_ID = "00000000-0000-0000-0000-000000000006"
 
+# A create with no cloud provider fails IaC generation. Default the omitted
+# provider to aws so callers can send {"name": ..., "components": []}.
+_DEFAULT_APPSTACK_CLOUD_PROVIDER = "aws"
+
+
+def _appstack_create_body(body: dict[str, Any]) -> dict[str, Any]:
+    raw = body.get("coreConfig")
+    core_config = dict(raw) if isinstance(raw, dict) else {}
+    provider = core_config.get("provider")
+    if isinstance(provider, str) and provider.strip():
+        return body
+    core_config["provider"] = _DEFAULT_APPSTACK_CLOUD_PROVIDER
+    return {**body, "coreConfig": core_config}
+
+
+def _query_string(params: dict[str, Any]) -> str:
+    cleaned: dict[str, Any] = {}
+    for k, v in params.items():
+        if v is None or v == "":
+            continue
+        cleaned[k] = "true" if v is True else "false" if v is False else v
+    if not cleaned:
+        return ""
+    return "?" + urllib.parse.urlencode(cleaned)
+
 
 class OrgsNamespace:
     def __init__(self, config: StackgenConfig) -> None:
@@ -123,3 +149,82 @@ class OrgsNamespace:
                 _log.debug("delete organization id=%s already gone", org_id.strip())
                 return
             raise
+
+    # --- AppStacks (AppCD mothership; no IaC-gen topology) ---
+
+    def _appstacks_url(self, path: str = "", params: dict[str, Any] | None = None) -> str:
+        query = dict(params or {})
+        if self._config.org_id and "orgId" not in query:
+            query["orgId"] = self._config.org_id
+        return f"{self._config.appcd_url()}/v1/appstacks{path}{_query_string(query)}"
+
+    def create_app_stack(
+        self, body: dict[str, Any], params: dict[str, Any] | None = None
+    ) -> dict[str, Any]:
+        """POST /v1/appstacks. Creates an AppStack and its initial version.
+
+        Body is the AppStackCreate payload (name, coreConfig, components). A
+        missing or blank ``coreConfig.provider`` is sent as ``aws``. Pass
+        ``gcp``, ``azure``, ``civo``, ``oci``, or ``other`` to target another
+        cloud.
+        """
+        if not isinstance(body, dict):
+            raise StackgenError("create_app_stack: body is required")
+        payload = _appstack_create_body(body)
+        data = _http.request(
+            self._appstacks_url("", params),
+            self._config.api_token,
+            method="POST",
+            body=json.dumps(payload).encode("utf-8"),
+            content_type="application/json",
+            # Same CloudFront 502 case as org create: POST is not idempotent
+            # by default, but a gateway outage means the origin never saw
+            # the request.
+            retry_gateway_outage=True,
+        )
+        if not isinstance(data, dict):
+            raise StackgenError(f"unexpected create_app_stack response: {data!r}")
+        return data
+
+    def get_app_stack(self, uuid: str, params: dict[str, Any] | None = None) -> dict[str, Any]:
+        """GET /v1/appstacks/{uuid}."""
+        if not uuid or not uuid.strip():
+            raise StackgenError("get_app_stack: uuid is required")
+        data = _http.request(
+            self._appstacks_url(f"/{uuid.strip()}", params),
+            self._config.api_token,
+        )
+        if not isinstance(data, dict):
+            raise StackgenError(f"unexpected get_app_stack response: {data!r}")
+        return data
+
+    def list_app_stacks(self, params: dict[str, Any] | None = None) -> list[dict[str, Any]]:
+        """GET /v1/appstacks — list / filter AppStacks for the org."""
+        data = _http.request(
+            self._appstacks_url("", params),
+            self._config.api_token,
+        )
+        return _http.as_list(data)
+
+    def delete_app_stacks(
+        self,
+        body: dict[str, Any] | None = None,
+        params: dict[str, Any] | None = None,
+    ) -> None:
+        """DELETE /v1/appstacks — batch delete by ``appstackIds`` / ``appstackNames``.
+
+        Idempotent on 404.
+        """
+        try:
+            _http.request(
+                self._appstacks_url("", params),
+                self._config.api_token,
+                method="DELETE",
+                body=json.dumps(body or {}).encode("utf-8"),
+                content_type="application/json",
+                expect_json=False,
+            )
+        except HttpError as exc:
+            if exc.status_code == 404:
+                return
+            raise