BuzzerboyAWSLightsail 0.331.1__tar.gz → 0.333.1__tar.gz

{buzzerboyawslightsail-0.331.1 → buzzerboyawslightsail-0.333.1}/BuzzerboyAWSLightsail.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: BuzzerboyAWSLightsail
-Version: 0.331.1
+Version: 0.333.1
 Summary: Buzzerboy Architecture for Deploying Web Applications on AWS LightSail
 Home-page: https://www.buzzerboy.com/
 Author: Buzzerboy Inc
@@ -163,6 +163,96 @@ cdktf deploy
 cdktf destroy
 ```
 
+## ✅ ArchitectureMaker Usage
+
+The preferred entrypoint is `ArchitectureMaker`, which builds stacks from a
+simple definition dict. Examples are mirrored in the samples directory.
+
+### Container + Database (default)
+
+```python
+from BuzzerboyAWSLightsailStack import ArchitectureMaker
+
+definition = {
+    "product": "bb",
+    "name": "sample-container-db",
+    "tier": "dev",
+    "organization": "buzzerboy",
+    "region": "us-east-1",
+}
+
+ArchitectureMaker.auto_main(definition, include_compliance=False)
+```
+
+### Container Only
+
+```python
+from BuzzerboyAWSLightsailStack import ArchitectureMaker
+
+definition = {
+    "product": "bb",
+    "name": "sample-container",
+    "tier": "dev",
+    "organization": "buzzerboy",
+    "region": "us-east-1",
+}
+
+ArchitectureMaker.auto_main_container_only(definition, include_compliance=False)
+```
+
+### Database Only
+
+```python
+from BuzzerboyAWSLightsailStack import ArchitectureMaker
+
+definition = {
+    "product": "bb",
+    "name": "sample-db",
+    "tier": "dev",
+    "organization": "buzzerboy",
+    "region": "us-east-1",
+    "databases": ["app_db", "analytics_db", "logging_db", "audit_db"],
+}
+
+ArchitectureMaker.auto_stack_db_only(definition, include_compliance=False)
+```
+
+### Example `cdktf.json`
+
+```json
+{
+  "language": "python",
+  "app": "python main.py",
+  "projectId": "9bad9bb7-b21d-4513-9ce9-74a6e2f7e0d9",
+  "sendCrashReports": "true",
+  "terraformProviders": [
+    "aws@~> 5.0",
+    "random@~> 3.5",
+    "null@~> 3.2"
+  ],
+  "terraformModules": [],
+  "codeMakerOutput": "imports",
+  "context": {}
+}
+```
+
+### Example `requirements.txt`
+
+```text
+cdktf>=0.17.0,<1.0
+constructs>=10.0.0,<11.0
+cdktf-cdktf-provider-aws>=12.0.0
+cdktf-cdktf-provider-random>=8.0.0
+cdktf-cdktf-provider-null>=9.0.0
+-e ../../BuzzerboyAWSLightsail
+```
+
+### Sample Paths
+
+- `samples/ContainerAndDB`
+- `samples/ContainerOnly`
+- `samples/DBOnly`
+
 ## 🛠 Useful Commands
 
 | Command         | Description                     |

{buzzerboyawslightsail-0.331.1 → buzzerboyawslightsail-0.333.1}/BuzzerboyAWSLightsail.egg-info/SOURCES.txt

@@ -9,9 +9,15 @@ BuzzerboyAWSLightsail.egg-info/SOURCES.txt
 BuzzerboyAWSLightsail.egg-info/dependency_links.txt
 BuzzerboyAWSLightsail.egg-info/requires.txt
 BuzzerboyAWSLightsail.egg-info/top_level.txt
+BuzzerboyAWSLightsailStack/ArchitectureMaker.py
 BuzzerboyAWSLightsailStack/LightSailPostDeploy.py
 BuzzerboyAWSLightsailStack/LightsailAIContainer.py
 BuzzerboyAWSLightsailStack/LightsailBase.py
+BuzzerboyAWSLightsailStack/LightsailBaseStandalone.py
 BuzzerboyAWSLightsailStack/LightsailContainer.py
+BuzzerboyAWSLightsailStack/LightsailContainerStandalone.py
 BuzzerboyAWSLightsailStack/LightsailDatabase.py
+BuzzerboyAWSLightsailStack/LightsailDatabaseStandalone.py
+BuzzerboyAWSLightsailStack/LightsailFlags.py
+BuzzerboyAWSLightsailStack/LightsailMixins.py
 BuzzerboyAWSLightsailStack/__init__.py

buzzerboyawslightsail-0.333.1/BuzzerboyAWSLightsailStack/ArchitectureMaker.py

@@ -0,0 +1,229 @@
+"""
+ArchitectureMaker
+=================
+
+Helper routines to build common Lightsail architectures using CDKTF.
+"""
+
+from typing import Any, Dict, List
+
+from cdktf import App
+
+from BuzzerboyAWSLightsailStack.LightsailDatabase import (
+    LightsailDatabaseStack,
+)
+from BuzzerboyAWSLightsailStack.LightsailDatabaseStandalone import (
+    LightsailDatabaseStandaloneStack,
+)
+from BuzzerboyAWSLightsailStack.LightsailContainer import (
+    LightsailContainerStack,
+)
+from BuzzerboyAWSLightsailStack.LightsailContainerStandalone import (
+    LightsailContainerStandaloneStack,
+)
+from BuzzerboyArchetypeStack.BuzzerboyArchetype import BuzzerboyArchetype
+
+
+class ArchitectureMaker:
+    """
+    Factory utilities for building Lightsail architectures from a definition dict.
+    """
+
+    @staticmethod
+    def auto_stack_db_only(definition: Dict[str, Any], include_compliance: bool = False) -> App:
+        """
+        Create a DB-only Lightsail stack from a definition dictionary.
+
+        Expected keys in definition:
+            - product (str)
+            - name or app (str)
+            - tier (str)
+            - organization (str)
+            - region (str)
+            - databases (list[str])
+        Optional keys:
+            - profile (str)
+            - db_instance_size (str)
+            - master_username (str)
+            - flags (list[str])
+        """
+        if not isinstance(definition, dict):
+            raise ValueError("definition must be a dictionary")
+
+        product = definition.get("product")
+        app_name = definition.get("name") or definition.get("app")
+        tier = definition.get("tier")
+        organization = definition.get("organization")
+        region = definition.get("region")
+        databases = definition.get("databases", [])
+
+        missing = [key for key, value in {
+            "product": product,
+            "name/app": app_name,
+            "tier": tier,
+            "organization": organization,
+            "region": region,
+            "databases": databases,
+        }.items() if not value]
+        if missing:
+            raise ValueError(f"definition is missing required keys: {', '.join(missing)}")
+
+        archetype = BuzzerboyArchetype(
+            product=product,
+            app=app_name,
+            tier=tier,
+            organization=organization,
+            region=region,
+        )
+
+        flags: List[str] = list(definition.get("flags", []))
+        flags = list(dict.fromkeys(flags))
+
+        app = App()
+
+        stack_class = LightsailDatabaseStack if include_compliance else LightsailDatabaseStandaloneStack
+        stack_class(
+            app,
+            f"{archetype.get_project_name()}-db-stack",
+            project_name=archetype.get_project_name(),
+            environment=archetype.get_tier(),
+            region=archetype.get_region(),
+            secret_name=archetype.get_secret_name(),
+            databases=databases,
+            profile=definition.get("profile", "default"),
+            db_instance_size=definition.get("db_instance_size", "micro_2_0"),
+            master_username=definition.get("master_username", "dbmasteruser"),
+            flags=flags,
+        )
+
+        app.synth()
+        return app
+
+    @staticmethod
+    def auto_main_container_only(definition: Dict[str, Any], include_compliance: bool = False) -> App:
+        """
+        Create a container-only Lightsail stack from a definition dictionary.
+
+        Expected keys in definition:
+            - product (str)
+            - name or app (str)
+            - tier (str)
+            - organization (str)
+            - region (str)
+        Optional keys:
+            - profile (str)
+            - flags (list[str])
+        """
+        if not isinstance(definition, dict):
+            raise ValueError("definition must be a dictionary")
+
+        product = definition.get("product")
+        app_name = definition.get("name") or definition.get("app")
+        tier = definition.get("tier")
+        organization = definition.get("organization")
+        region = definition.get("region")
+
+        missing = [key for key, value in {
+            "product": product,
+            "name/app": app_name,
+            "tier": tier,
+            "organization": organization,
+            "region": region,
+        }.items() if not value]
+        if missing:
+            raise ValueError(f"definition is missing required keys: {', '.join(missing)}")
+
+        archetype = BuzzerboyArchetype(
+            product=product,
+            app=app_name,
+            tier=tier,
+            organization=organization,
+            region=region,
+        )
+
+        flags: List[str] = list(definition.get("flags", []))
+        flags.extend([
+            "skip_database",
+            "skip_domain",
+        ])
+        flags = list(dict.fromkeys(flags))
+
+        app = App()
+
+        stack_class = LightsailContainerStack if include_compliance else LightsailContainerStandaloneStack
+        stack_class(
+            app,
+            f"{archetype.get_project_name()}-stack",
+            project_name=archetype.get_project_name(),
+            environment=archetype.get_tier(),
+            region=archetype.get_region(),
+            secret_name=archetype.get_secret_name(),
+            profile=definition.get("profile", "default"),
+            flags=flags,
+        )
+
+        app.synth()
+        return app
+
+    @staticmethod
+    def auto_main(definition: Dict[str, Any], include_compliance: bool = False) -> App:
+        """
+        Create a container + database Lightsail stack from a definition dictionary.
+
+        Expected keys in definition:
+            - product (str)
+            - name or app (str)
+            - tier (str)
+            - organization (str)
+            - region (str)
+        Optional keys:
+            - profile (str)
+            - flags (list[str])
+        """
+        if not isinstance(definition, dict):
+            raise ValueError("definition must be a dictionary")
+
+        product = definition.get("product")
+        app_name = definition.get("name") or definition.get("app")
+        tier = definition.get("tier")
+        organization = definition.get("organization")
+        region = definition.get("region")
+
+        missing = [key for key, value in {
+            "product": product,
+            "name/app": app_name,
+            "tier": tier,
+            "organization": organization,
+            "region": region,
+        }.items() if not value]
+        if missing:
+            raise ValueError(f"definition is missing required keys: {', '.join(missing)}")
+
+        archetype = BuzzerboyArchetype(
+            product=product,
+            app=app_name,
+            tier=tier,
+            organization=organization,
+            region=region,
+        )
+
+        flags: List[str] = list(definition.get("flags", []))
+        flags.append("skip_domain")
+        flags = list(dict.fromkeys(flags))
+
+        app = App()
+
+        stack_class = LightsailContainerStack if include_compliance else LightsailContainerStandaloneStack
+        stack_class(
+            app,
+            f"{archetype.get_project_name()}-stack",
+            project_name=archetype.get_project_name(),
+            environment=archetype.get_tier(),
+            region=archetype.get_region(),
+            secret_name=archetype.get_secret_name(),
+            profile=definition.get("profile", "default"),
+            flags=flags,
+        )
+
+        app.synth()
+        return app