(20241008) logging decorator and model improved.

utils_v2/api/response.py

@@ -30,9 +30,11 @@
 #   *****************************************************************************************************************
 
 
+# For data-modelling:
 from pydantic import BaseModel
 from typing import Any, Optional, List
 
+# My utils:
 from utils_v2.api.codes import StatusCodes, HttpCodes
 
 
@@ -64,6 +66,11 @@ from utils_v2.api.codes import StatusCodes, HttpCodes
 
 class ResponseModel(BaseModel):
 
+    """
+    A model for how the response should be when developing API endpoints.
+    """
+
+    # The fields that you want in your response:
     status_code: StatusCodes
     message: Optional[str | List] = None
     data: Optional[Any] = None
@@ -74,6 +81,11 @@ class ResponseModel(BaseModel):
 
     def for_quart(self):
 
+        """
+        Call this when you are using either Flask or Quart as your framework.
+        :return: The output as expected by Flask and Quart.
+        """
+
         # Construct the basic structure:
         response_dict = {
             "status": 1 if self.status_code.value[0] else 0,