haraka 0.2.53__tar.gz → 0.2.55__tar.gz

{haraka-0.2.53 → haraka-0.2.55}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: haraka
-Version: 0.2.53
+Version: 0.2.55
 Summary: Reusable post-generation helper for Cookiecutter micro-service templates
 Author-email: Will Burks <will@example.com>
 License: MIT

haraka-0.2.55/haraka/PyFast/Runtime.py

@@ -0,0 +1,49 @@
+from enum import Enum, auto
+from fastapi import FastAPI
+import socket
+from haraka.utils import Logger
+
+
+class LifecycleState(Enum):
+    UNINITIALIZED = auto()
+    STARTED = auto()
+    DESTROYED = auto()
+
+
+class Lifecycle:
+    """
+    A helper class to handle initialization and shutdown messaging for a FastAPI application.
+    Tracks internal state to guard against invalid transitions.
+    """
+    def __init__(self, variant: str = "PyFast"):
+        self.variant = variant
+        self.logger = Logger(self.variant).start_logger()
+        self.state = LifecycleState.UNINITIALIZED
+
+    async def start(self, settings, app: FastAPI):
+        if self.state != LifecycleState.UNINITIALIZED:
+            self.logger.warn(f"🟡 Attempted to start, but state is already {self.state.name}")
+            return
+
+        try:
+            port = settings.port
+            docs_path = app.docs_url or "/docs"
+            local_url = f"http://localhost:{port}{docs_path}"
+
+            host = socket.gethostbyname(socket.gethostname())
+            network_url = f"http://{host}:{port}{docs_path}"
+
+            self.logger.info(f"✅ Swagger UI available at: {local_url}")
+            self.logger.info(f"🌐 Network Swagger UI available at: {network_url}")
+            self.state = LifecycleState.STARTED
+
+        except Exception as e:
+            self.logger.warn(f"⚠️ Failed to determine network URL: {e}")
+
+    async def destroy(self):
+        if self.state == LifecycleState.DESTROYED:
+            self.logger.warn("🟡 destroy() called, but app is already shut down.")
+            return
+
+        self.logger.info("🛑 Application is shutting down!")
+        self.state = LifecycleState.DESTROYED

{haraka-0.2.53 → haraka-0.2.55}/haraka/utils/manifests/PyFast.yml

@@ -17,8 +17,8 @@ keep:
   - README.md
 
   # ── IDE / run configs ──────────────────────────────
-  - runConfigurations/Python/
-  - runConfigurations/Python/FastAPI.run.xml
+  - runConfigurations/FastAPI/
+  - runConfigurations/FastAPI/FastAPI.run.xml
 
   # ── deployment & infra (shared) ────────────────────
   - skaffold.yaml

{haraka-0.2.53 → haraka-0.2.55}/haraka.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: haraka
-Version: 0.2.53
+Version: 0.2.55
 Summary: Reusable post-generation helper for Cookiecutter micro-service templates
 Author-email: Will Burks <will@example.com>
 License: MIT

{haraka-0.2.53 → haraka-0.2.55}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name            = "haraka"
-version         = "0.2.53"  # Incremented version
+version         = "0.2.55"  # Incremented version
 description     = "Reusable post-generation helper for Cookiecutter micro-service templates"
 readme          = "README.md"
 license         = {text = "MIT"}

haraka-0.2.53/haraka/PyFast/Runtime.py

@@ -1,47 +0,0 @@
-from fastapi import FastAPI
-import socket
-from haraka.utils import Logger
-
-class Lifecycle:
-    """
-    A helper class to handle initialization and shutdown messaging for a FastAPI application.
-    """
-    def __init__(self, variant: str = "PyFast"):
-        """
-        Initializes the PyFast instance with a logger.
-
-        Args:
-            variant (str): A string identifier for the application. Default is 'PyFast'.
-        """
-        self.variant = variant
-        self.logger = Logger(self.variant).start_logger()
-
-    def start(self, settings, app: FastAPI):
-        """
-        Initializes the application and logs Swagger UI availability.
-
-        Args:
-            settings: A settings object containing application configuration (e.g., port).
-            app (FastAPI): The FastAPI application instance.
-        """
-        try:
-            port = settings.port
-            docs_path = app.docs_url or "/docs"  # Default to '/docs' if not set
-            local_url = f"http://localhost:{port}{docs_path}"
-
-            # Resolve the network-accessible hostname
-            host = socket.gethostbyname(socket.gethostname())
-            network_url = f"http://{host}:{port}{docs_path}"
-
-            # Log the Swagger UI URLs
-            self.logger.info(f"Swagger UI available at: {local_url}")
-            self.logger.info(f"Network Swagger UI available at: {network_url}")
-
-        except Exception as e:
-            self.logger.warn(f"Failed to determine network URL: {e}")
-
-    def destroy(self):
-        """
-        Logs a shutdown message when the application is shutting down.
-        """
-        self.logger.info("🛑 Application is shutting down!")