haraka 0.2.53__py3-none-any.whl → 0.2.55__py3-none-any.whl

haraka/PyFast/Runtime.py

@@ -1,47 +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"):
-        """
-        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()
+        self.state = LifecycleState.UNINITIALIZED
 
-    def start(self, settings, app: FastAPI):
-        """
-        Initializes the application and logs Swagger UI availability.
+    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
 
-        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
+            docs_path = app.docs_url or "/docs"
             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}")
+            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}")
+            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
 
-    def destroy(self):
-        """
-        Logs a shutdown message when the application is shutting down.
-        """
         self.logger.info("🛑 Application is shutting down!")
+        self.state = LifecycleState.DESTROYED

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.dist-info → haraka-0.2.55.dist-info}/METADATA

@@ -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.dist-info → haraka-0.2.55.dist-info}/RECORD

@@ -1,5 +1,5 @@
 haraka/__init__.py,sha256=b8t9TwJ3drfLFkYAsiXvKuyat7ppKnhRkAtMlb1kt_A,221
-haraka/PyFast/Runtime.py,sha256=uRkz-kGbQxxeC1NgZtEtiM_v9sZPRBQF45WlbbrB_80,1670
+haraka/PyFast/Runtime.py,sha256=eZXLdL2gw3pQd6gX2l8ydeWXsEN6-WdOprk49h2LwC0,1700
 haraka/PyFast/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 haraka/art/__init__.py,sha256=-b1KHQiLkaI2sXaHS05XDaE27tZfXvVLitILjJfSiKs,112
 haraka/art/create.py,sha256=D2VPJtuwI0Ed7CcreHRHhxSN1VzV7PQfC1q-NW8l0DY,631
@@ -29,9 +29,9 @@ haraka/utils/logging/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hS
 haraka/utils/logging/log_util.py,sha256=Atlhutx4tKTtme9nj0JjObZNiCkwpEixGjhsGvI9544,1143
 haraka/utils/manifests/GoUltraFast.yml,sha256=LBSlT2QyOi_reUfZ7AAvs0U6Ju47K94eG_fjs7SNuN8,975
 haraka/utils/manifests/JavaFein.yml,sha256=TSTo45Q-NMMqaDS4ogYwU0PpxW-sl0MCYj-RG-Hc_M0,989
-haraka/utils/manifests/PyFast.yml,sha256=dfUXDsxWj-Ex_DQX9sNNezIjfAW_ipjHEh1g8sEs8eQ,924
+haraka/utils/manifests/PyFast.yml,sha256=q2UXbBEGYfxP-BSqx-zmWnp_YoAN7Z4hjAHEVK6KdKo,926
 haraka/utils/manifests/go-grpc-gateway-buf.yml,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-haraka-0.2.53.dist-info/METADATA,sha256=0-6sBgrZrpnLDwzfgbVrdanPBuJ99O0UtcIW2B9w26w,937
-haraka-0.2.53.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-haraka-0.2.53.dist-info/top_level.txt,sha256=1khpwypLKWoklVd_CgFiwAfcctVSXRoRPc3BI9lyIXo,7
-haraka-0.2.53.dist-info/RECORD,,
+haraka-0.2.55.dist-info/METADATA,sha256=GIgAH_G45cxHgJaU17Mgzep8P-EqdOw-ipAXW2iRY6A,937
+haraka-0.2.55.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+haraka-0.2.55.dist-info/top_level.txt,sha256=1khpwypLKWoklVd_CgFiwAfcctVSXRoRPc3BI9lyIXo,7
+haraka-0.2.55.dist-info/RECORD,,