cloe-logging 0.3.9__py3-none-any.whl → 0.3.11__py3-none-any.whl

cloe_logging/formatters/devops_formatter.py

@@ -9,8 +9,8 @@ class DevOpsFormatter(logging.Formatter):
     info_format = "%(message)s"  # "%(name)s -- %(message)s"
     section_format = "%(name)s -- %(message)s"
 
-    def __init__(self, fmt="%(levelno)s: %(msg)s", section_info=False):
-        super().__init__(fmt=fmt)
+    def __init__(self, fmt="%(levelno)s: %(msg)s", datefmt=None, section_info=False):
+        super().__init__(fmt=fmt, datefmt=datefmt)
         self._section_info = section_info
 
     def parse_progress(self, message: str) -> str:

cloe_logging/handlers/log_analytics_handler.py

@@ -7,9 +7,11 @@ from datetime import UTC, datetime
 
 try:
     import requests
+
+    _REQUESTS_AVAILABLE = True
 except ImportError:
     requests = None  # type: ignore
-    print("Optional dependency 'log_analytics' is not installed. Some functionalities may not be available.")
+    _REQUESTS_AVAILABLE = False
 
 from cloe_logging.utility.serializer import create_logserializer
 
@@ -37,6 +39,7 @@ class LogAnalyticsHandler(logging.Handler):
         test_connectivity: bool = True,
         column_split_char: str = "|",
         key_value_split_char: str = ":",
+        datefmt: str | None = None,
         **kwargs,  # noqa: ARG002 required to work with the Factory
     ):
         """Initializes a new instance of the LogAnalyticsHandler class.
@@ -48,6 +51,7 @@ class LogAnalyticsHandler(logging.Handler):
             column_split_char (str, optional): The character used to split columns in the log message. Defaults to "|".
             key_value_split_char (str, optional): The character used to split keys and values in the log message.
                                                   Defaults to ":".
+            datefmt (str, optional): The format of the date/time in log messages. If None, uses the default format.
             test_connectivity (bool, optional): Whether to test connectivity to Azure Log Analytics when initializing
                                                 the handler. Defaults to True.
         """
@@ -60,9 +64,13 @@ class LogAnalyticsHandler(logging.Handler):
             raise ValueError(
                 "The workspace_id, shared_key, and log_type must be provided or set as environment variables."
             )
+        if not _REQUESTS_AVAILABLE:
+            raise ImportError(
+                "Requests library is not installed. Install it with: pip install cloe-logging[log-analytics]"
+            )
         logging.Handler.__init__(self)
         self.session = requests.Session()
-        formatter = logging.Formatter("timestamp:%(asctime)s | level: %(levelname)-8s | %(message)s")
+        formatter = logging.Formatter("timestamp:%(asctime)s | level: %(levelname)-8s | %(message)s", datefmt=datefmt)
         self.setFormatter(formatter)
         self.serializer = create_logserializer()
         self.serializer.column_split_char = self.column_split_char

cloe_logging/handlers/snowflake_handler.py

@@ -6,10 +6,12 @@ try:
         ConnectionParameters,
     )
     from cloe_util_snowflake_connector.snowflake_interface import SnowflakeInterface  # type: ignore[import-not-found]
+
+    _SNOWFLAKE_AVAILABLE = True
 except ImportError:
     ConnectionParameters = None  # type: ignore
     SnowflakeInterface = None  # type: ignore
-    print("Optional dependency 'snowflake' is not installed. Some functionalities may not be available.")
+    _SNOWFLAKE_AVAILABLE = False
 from cloe_logging.utility.serializer import create_logserializer
 
 
@@ -26,6 +28,7 @@ class SnowflakeHandler(logging.Handler):
         target_table: str = "",
         column_split_char: str = "|",
         key_value_split_char: str = ":",
+        datefmt: str | None = None,
         **kwargs,  # noqa: ARG002 required to work with the Factory
     ):
         """Initializes a new instance of the SnowflakeHandler class.
@@ -37,6 +40,7 @@ class SnowflakeHandler(logging.Handler):
             column_split_char (str, optional): The character used to split columns in the log message. Defaults to "|".
             key_value_split_char (str, optional): The character used to split keys and values in the log message.
                                                   Defaults to ":".
+            datefmt (str, optional): The format of the date/time in log messages. If None, uses the default format.
         """
         self.column_split_char: str = column_split_char
         self.key_value_split_char: str = key_value_split_char
@@ -45,7 +49,7 @@ class SnowflakeHandler(logging.Handler):
         self.target_table: str = os.environ.get("CLOE_SNOWFLAKE_TABLE", target_table)
         logging.Handler.__init__(self)
         self.connection = self._get_snowflake_connection()
-        formatter = logging.Formatter("timestamp:%(asctime)s | level: %(levelname)-8s | %(message)s")
+        formatter = logging.Formatter("timestamp:%(asctime)s | level: %(levelname)-8s | %(message)s", datefmt=datefmt)
         self.setFormatter(formatter)
         self.serializer = create_logserializer()
 
@@ -80,6 +84,10 @@ class SnowflakeHandler(logging.Handler):
         return hash((self.target_db, self.target_schema, self.target_table))
 
     def _get_snowflake_connection(self) -> SnowflakeInterface:
+        if not _SNOWFLAKE_AVAILABLE:
+            raise ImportError(
+                "Snowflake dependencies are not installed. Install them with: pip install cloe-logging[snowflake]"
+            )
         conn_params = ConnectionParameters.init_from_env_variables()
         return SnowflakeInterface(conn_params)
 

cloe_logging/handlers/unity_catalog_handler.py

@@ -1,14 +1,17 @@
 import json
 import logging
-from typing import cast
+from typing import TYPE_CHECKING, cast
 
 try:
     from databricks.sdk import WorkspaceClient  # type: ignore[import-not-found]
     from databricks.sdk.service.sql import ExecuteStatementRequestOnWaitTimeout  # type: ignore[import-not-found]
+
+    _DATABRICKS_AVAILABLE = True
 except ImportError:
-    WorkspaceClient = None  # type: ignore
-    ExecuteStatementRequestOnWaitTimeout = None  # type: ignore
-    print("Optional dependency 'databricks' is not installed. Some functionalities may not be available.")
+    _DATABRICKS_AVAILABLE = False
+
+if TYPE_CHECKING:
+    from databricks.sdk import WorkspaceClient  # type: ignore[import-not-found]
 
 from ..formatters import DictFormatter
 
@@ -29,7 +32,8 @@ class UnityCatalogHandler(logging.Handler):
         warehouse_id: str | None = None,
         column_split_char: str = "|",
         key_value_split_char: str = ":",
-        workspace_client: WorkspaceClient | None = None,
+        datefmt: str | None = None,
+        workspace_client: "WorkspaceClient | None" = None,
         formatter: DictFormatter | None = None,
         **kwargs,  # required to work with the Factory
     ):
@@ -48,6 +52,7 @@ class UnityCatalogHandler(logging.Handler):
             warehouse_id: The ID of the Databricks warehouse.
             column_split_char: The character used to split columns in the log message. Defaults to "|".
             key_value_split_char: The character used to split keys and values in the log message. Defaults to ":".
+            datefmt: The format of the date/time in log messages. If None, uses the default format.
             workspace_client: An instance of WorkspaceClient for dependency injection.
             formatter: An instance of DictFormatter for dependency injection.
         """
@@ -64,10 +69,15 @@ class UnityCatalogHandler(logging.Handler):
                 " schema, and table to create a DatabricksHandler."
             )
         self.table_identifier = f"{self.catalog}.{self.schema}.{self.table}"
+        if not _DATABRICKS_AVAILABLE:
+            raise ImportError("Databricks SDK is not installed. Install it with: pip install cloe-logging[databricks]")
         self.workspace_client = workspace_client or WorkspaceClient(host=self.workspace_url)
         super().__init__(**kwargs)
         self.setFormatter(
-            formatter or DictFormatter(column_split_char=column_split_char, key_value_split_char=key_value_split_char)
+            formatter
+            or DictFormatter(
+                column_split_char=column_split_char, key_value_split_char=key_value_split_char, datefmt=datefmt
+            )
         )
         self.ensure_table_exists(columns)
 

cloe_logging/logger_factory.py

@@ -15,6 +15,7 @@ class LoggerFactory:
         logger_name: str = __name__,
         logging_level: int = logging.INFO,
         log_format: str = "%(asctime)s - %(name)s - %(levelname)s - %(message)s",
+        datefmt: str | None = None,
         **kwargs,
     ) -> logging.Logger:
         """Creates a logger with the specified handler types.
@@ -24,6 +25,7 @@ class LoggerFactory:
             logger_name: The name of the logger.
             logging_level: The logging level for the logger.
             log_format: The format of the log messages.
+            datefmt: The format of the date/time in log messages. If None, uses the default format.
             kwargs: Additional arguments to pass to the handler.
 
         Note:
@@ -38,7 +40,7 @@ class LoggerFactory:
             handler_types = [handler_types]
 
         for handler_type in handler_types:
-            handler = LoggerFactory.get_handler(handler_type, log_format, **kwargs)
+            handler = LoggerFactory.get_handler(handler_type, log_format, datefmt=datefmt, **kwargs)
             LoggerFactory.add_handler_if_not_exists(logger, handler)
         return logger
 
@@ -46,6 +48,7 @@ class LoggerFactory:
     def get_handler(
         handler_type: str,
         log_format: str = "%(asctime)s - %(name)s - %(levelname)s - %(message)s",
+        datefmt: str | None = None,
         **kwargs,
     ) -> logging.Handler:
         handler_functions: dict[str, Callable] = {
@@ -55,18 +58,19 @@ class LoggerFactory:
             "snowflake": LoggerFactory.get_snowflake_handler,
             "log_analytics": LoggerFactory.get_log_analytics_handler,
         }
-        handler = handler_functions[handler_type](**kwargs, log_format=log_format)
+        handler = handler_functions[handler_type](**kwargs, log_format=log_format, datefmt=datefmt)
         return cast(logging.Handler, handler)
 
     @staticmethod
-    def get_console_handler(log_format: str, **kwargs) -> logging.Handler:  # noqa: ARG004
+    def get_console_handler(log_format: str, datefmt: str | None = None, **kwargs) -> logging.Handler:  # noqa: ARG004
         handler = logging.StreamHandler()
-        handler.setFormatter(logging.Formatter(log_format))
+        handler.setFormatter(logging.Formatter(log_format, datefmt=datefmt))
         return handler
 
     @staticmethod
     def get_file_handler(
         log_format: str,
+        datefmt: str | None = None,
         filename: str | None = None,
         mode: str = "a",
         encoding: str | None = None,
@@ -76,7 +80,7 @@ class LoggerFactory:
         if filename is None:
             raise ValueError("filename is required for file logger")
         handler = logging.FileHandler(filename, mode, encoding, delay)
-        handler.setFormatter(logging.Formatter(log_format))
+        handler.setFormatter(logging.Formatter(log_format, datefmt=datefmt))
         return handler
 
     @classmethod

{cloe_logging-0.3.9.dist-info → cloe_logging-0.3.11.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cloe-logging
-Version: 0.3.9
+Version: 0.3.11
 Summary: A Standardized Solution for logging to various targets.
 Author-email: David Achilles <david.achilles@accenture.com>, Ole Steinbrueck <ole.steinbrueck@accenture.com>
 License: Proprietary
@@ -12,7 +12,7 @@ Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Topic :: Database
-Requires-Python: <3.13,>=3.11
+Requires-Python: <3.14,>=3.11
 Requires-Dist: pydantic<3.0.0,>=2.7.0
 Requires-Dist: typing-extensions<5.0.0,>=4.12.2
 Provides-Extra: databricks

{cloe_logging-0.3.9.dist-info → cloe_logging-0.3.11.dist-info}/RECORD

@@ -1,17 +1,17 @@
 cloe_logging/__init__.py,sha256=3rsW-XtJbAaENMtN9ah2qRZyQnZOtqTnkCE_OqXBLNw,74
-cloe_logging/logger_factory.py,sha256=3H_5_Ry-l2ap2-aGe-bkh9lmDcHr0a81qLN8X7mkXaA,5666
+cloe_logging/logger_factory.py,sha256=XnC6hhr--_2Zwk--G7OHqcWfip_SF2p-RRAL7NQMvfk,5970
 cloe_logging/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 cloe_logging/decorators/__init__.py,sha256=ZFfADCScnpZ3ofxNgle1UybF322cdH9vuIGCx3S9wUU,71
 cloe_logging/decorators/devops_decorator.py,sha256=npuOLa2HLxPlhTN9HMa_EBqyVWQxv8HvlTtaICyfVRw,1961
 cloe_logging/formatters/__init__.py,sha256=1hhmT6qeIGuom63oHrg_2SHQZpLWG2GclMSTmF-fR_g,136
-cloe_logging/formatters/devops_formatter.py,sha256=EeTgN932jGisW1Q_z9RXdd0yvXuOgbN-CuFaSQ3usss,3315
+cloe_logging/formatters/devops_formatter.py,sha256=Sgf8eUj4AqP9kfMR4N-VKMPnGAl9KeSgmp09xzX-6Po,3346
 cloe_logging/formatters/dict_formatter.py,sha256=QGUcCx3KrCAXFGkYD3SY4s13k0OIgSBn6fhijgJ4m0Y,1553
 cloe_logging/handlers/__init__.py,sha256=5RTIz8UooLgVc9h5GnXvI2yF-FkOKiJBfHbSKHKitRE,236
-cloe_logging/handlers/log_analytics_handler.py,sha256=x5gX98srlvBsEFmIWTISzO0v1Fx-O6CfsBDvyigA4YI,9048
-cloe_logging/handlers/snowflake_handler.py,sha256=TWctiCR10UacVrkDCIF6Z1GvuhfhC7iIpNefzdTgd0Q,5049
-cloe_logging/handlers/unity_catalog_handler.py,sha256=DabwGA-2_F1BGGUZnEA9YMSIPmeaUkhkKjo3Fm-rXps,6928
+cloe_logging/handlers/log_analytics_handler.py,sha256=YMm9CgUluXC0dziNnAlIokP_lDdN7N1L1v61iIWCmWs,9370
+cloe_logging/handlers/snowflake_handler.py,sha256=9AdgQbpx2x_KRbmuAB6rT4ZYJEdP0y_n_grL324cXSY,5375
+cloe_logging/handlers/unity_catalog_handler.py,sha256=55bzN5WpZodvwXF6v9Tc7pvpGXoW0m2RAFHrba001F0,7252
 cloe_logging/utility/__init__.py,sha256=wp758l5P1M20bNUbbGojSkBUscFUgRd_TLLdnHgQ_l8,70
 cloe_logging/utility/serializer.py,sha256=a_XNHC3DTPongLXcEBp7UCvVdmdjT-qAQ9ZHubCV0oI,2656
-cloe_logging-0.3.9.dist-info/METADATA,sha256=QsOVBzsajELGWn-VhU9_uLYuVAEfAuYA7q5fcv7-GpQ,2487
-cloe_logging-0.3.9.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-cloe_logging-0.3.9.dist-info/RECORD,,
+cloe_logging-0.3.11.dist-info/METADATA,sha256=5cvMi8OEqTu5lH8_ZFPRhvMbqsuxn1Wiq_-GSGzPr-U,2488
+cloe_logging-0.3.11.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+cloe_logging-0.3.11.dist-info/RECORD,,

{cloe_logging-0.3.9.dist-info → cloe_logging-0.3.11.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: hatchling 1.27.0
+Generator: hatchling 1.28.0
 Root-Is-Purelib: true
 Tag: py3-none-any