reach_commons 0.14.95__py3-none-any.whl → 0.14.96__py3-none-any.whl

reach_commons/app_logging/log_deprecated_endpoints.py

@@ -1,55 +1,53 @@
-from datetime import datetime, timedelta
-from functools import wraps
+import datetime
 
-from fastapi import Request
-from fastapi.responses import Response
+from fastapi import Request, Response
 
 from reach_commons.app_logging.logger import get_reach_logger
 
 logger = get_reach_logger()
 
 
-def deprecated_warning(added_date: datetime, deprecation_period_days: int = 180):
+def add_deprecation_headers(
+    request: Request,
+    response: Response,
+    added_date: datetime.datetime,
+    deprecation_period_days: int = 180,
+    replacement_url: str = None,
+):
     """
-    Decorator to indicate that an endpoint is deprecated in FastAPI.
-
-    - Adds a "Warning" header to the response during the deprecation period.
-    - Uses HTTP status 409 ("Gone") after the deprecation period ends.
-    - Uses HTTP status 301 ("Moved Permanently") if a replacement URL is provided.
+    Adds deprecation headers to the response and logs deprecation information.
 
     Args:
-        added_date (datetime): The date when the deprecation was announced.
+        request (Request): The HTTP request object.
+        response (Response): The HTTP response object.
+        added_date (datetime.datetime): The date when deprecation was announced.
         deprecation_period_days (int): Number of days before the endpoint is removed (default: 180).
+        replacement_url (str, optional): URL of the replacement endpoint, if available.
     """
+    removal_date = added_date + datetime.timedelta(days=deprecation_period_days)
+    removal_date_str = removal_date.strftime("%a, %d %b %Y %H:%M:%S GMT")
+    current_date = datetime.datetime.utcnow()
 
-    def decorator(func):
-        @wraps(func)
-        async def wrapper(request: Request, response: Response, *args, **kwargs):
-            removal_date = added_date + timedelta(days=deprecation_period_days)
-            removal_date_str = removal_date.strftime("%a, %d %b %Y %H:%M:%S GMT")
-            current_date = datetime.utcnow()
-
-            path = request.url.path if request else "Unknown Path"
-            method = request.method if request else "Unknown Method"
-
-            warning_message = f'299 "{method} {path}" is deprecated and will be removed on [{removal_date_str}]"'
-
-            response.headers["Deprecation-Warning"] = warning_message
+    path = request.url.path if request else "Unknown Path"
+    method = request.method if request else "Unknown Method"
 
-            if current_date < removal_date:
-                logger.warning(
-                    f"Deprecated endpoint accessed: {method} {path}. "
-                    f"Deprecation period ends on {removal_date_str}."
-                )
+    deprecation_warning = f'299 "{method} {path}" is deprecated and will be removed on [{removal_date_str}]"'
 
-            elif current_date >= removal_date:
-                logger.error(
-                    f"Access to removed endpoint: {method} {path}. "
-                    f"Removal date was {removal_date_str}."
-                )
+    response.headers["Deprecation-Warning"] = deprecation_warning
 
-            return await func(request, response, *args, **kwargs)
+    if replacement_url:
+        response.headers["Replacement-Endpoint"] = replacement_url
 
-        return wrapper
+    if current_date < removal_date:
+        logger.warning(
+            f"Deprecated endpoint accessed: {method} {path}. "
+            f"Deprecation period ends on {removal_date_str}."
+            + (f" Replacement endpoint: {replacement_url}" if replacement_url else "")
+        )
 
-    return decorator
+    elif current_date >= removal_date:
+        logger.error(
+            f"Access to removed endpoint: {method} {path}. "
+            f"Removal date was {removal_date_str}."
+            + (f" Replacement endpoint: {replacement_url}" if replacement_url else "")
+        )

{reach_commons-0.14.95.dist-info → reach_commons-0.14.96.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: reach_commons
-Version: 0.14.95
+Version: 0.14.96
 Summary: Reach Commons is a versatile utility library designed to streamline and enhance development workflows within the Reach ecosystem.
 License: MIT
 Author: Wilson Moraes

{reach_commons-0.14.95.dist-info → reach_commons-0.14.96.dist-info}/RECORD

@@ -1,7 +1,7 @@
 reach_commons/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 reach_commons/app_logging/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 reach_commons/app_logging/http_logger.py,sha256=mljQCdmsmtD2HsC_gsFwZAxPlAiLPYVirVrCjXFxitY,2541
-reach_commons/app_logging/log_deprecated_endpoints.py,sha256=rWciFlOpLD7ouojQK8SMXmjWKSHYGjpL-wdFb_mtxDI,2106
+reach_commons/app_logging/log_deprecated_endpoints.py,sha256=MDGWr998TCWdGGf2L3r-NmnNhuKFDgKqRnkeAbgdkr4,2018
 reach_commons/app_logging/logger.py,sha256=Iq2XTl1zLgHDmVsTMdlFadcYJOqQNhBcFSscacKs_Xs,2295
 reach_commons/app_logging/logging_config.py,sha256=Y1JaZOoQBWgQjkOqYmeDRIm0p2eCOl3yTzgsgqyqm8I,1539
 reach_commons/clients/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -26,6 +26,6 @@ reach_commons/reach_base_model.py,sha256=oyAXoBwXLzsJ8GB1lxsJqiNf4QtfUJ_NI9MkiZ4
 reach_commons/redis_manager.py,sha256=_4FOYPMapwRmWU-5SO1Bm0Cb__Ngkx2hrOPlrJETzX0,1896
 reach_commons/utils.py,sha256=zny3JSj1Ljq1Bbt9RCLhqy0-sWrzb_cPoIccKpWk_Nk,8377
 reach_commons/validations.py,sha256=jc78boM62S9Z0Ip_nV1z7I983gGpW2Y7vOCQtmia8OU,964
-reach_commons-0.14.95.dist-info/METADATA,sha256=rwr7-JSLN1mGEpYo4H6xMDBVXEr79pcILSDynqjzWAE,1861
-reach_commons-0.14.95.dist-info/WHEEL,sha256=FMvqSimYX_P7y0a7UY-_Mc83r5zkBZsCYPm7Lr0Bsq4,88
-reach_commons-0.14.95.dist-info/RECORD,,
+reach_commons-0.14.96.dist-info/METADATA,sha256=ggrA_DRTLYpowCFQckm5achdzcxZZcieA5VY3ctA9f0,1861
+reach_commons-0.14.96.dist-info/WHEEL,sha256=FMvqSimYX_P7y0a7UY-_Mc83r5zkBZsCYPm7Lr0Bsq4,88
+reach_commons-0.14.96.dist-info/RECORD,,