haraka 0.2.52__py3-none-any.whl → 0.2.54__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-0.2.52.dist-info → haraka-0.2.54.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: haraka
-Version: 0.2.52
+Version: 0.2.54
 Summary: Reusable post-generation helper for Cookiecutter micro-service templates
 Author-email: Will Burks <will@example.com>
 License: MIT
@@ -12,3 +12,13 @@ Classifier: Intended Audience :: Developers
 Classifier: Topic :: Software Development :: Build Tools
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
+Requires-Dist: pathspec==0.10.3
+Requires-Dist: PyYAML==6.0.1
+Requires-Dist: wcwidth==0.2.5
+Requires-Dist: fastapi==0.115.14
+Provides-Extra: gen
+Requires-Dist: pathspec==0.10.3; extra == "gen"
+Requires-Dist: PyYAML==6.0.1; extra == "gen"
+Requires-Dist: wcwidth==0.2.5; extra == "gen"
+Provides-Extra: pyfast
+Requires-Dist: fastapi==0.115.14; extra == "pyfast"

{haraka-0.2.52.dist-info → haraka-0.2.54.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
@@ -31,7 +31,7 @@ haraka/utils/manifests/GoUltraFast.yml,sha256=LBSlT2QyOi_reUfZ7AAvs0U6Ju47K94eG_
 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/go-grpc-gateway-buf.yml,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-haraka-0.2.52.dist-info/METADATA,sha256=vNCewvL4ofzzptj1q0sUaH5zQgi5zkC1R5k2eY9Qyqg,579
-haraka-0.2.52.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-haraka-0.2.52.dist-info/top_level.txt,sha256=1khpwypLKWoklVd_CgFiwAfcctVSXRoRPc3BI9lyIXo,7
-haraka-0.2.52.dist-info/RECORD,,
+haraka-0.2.54.dist-info/METADATA,sha256=_c-5V5xUhcAJZgoeTNfWuRcF32SwhXsdnflESOl_V5o,937
+haraka-0.2.54.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+haraka-0.2.54.dist-info/top_level.txt,sha256=1khpwypLKWoklVd_CgFiwAfcctVSXRoRPc3BI9lyIXo,7
+haraka-0.2.54.dist-info/RECORD,,