beans-logging 6.0.2__tar.gz → 7.0.0__tar.gz

{beans_logging-6.0.2/src/beans_logging.egg-info → beans_logging-7.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: beans_logging
-Version: 6.0.2
+Version: 7.0.0
 Summary: 'beans-logging' is a python package for simple logger and easily managing logs.
 Author-email: Batkhuu Byambajav <batkhuu10@gmail.com>
 Project-URL: Homepage, https://github.com/bybatkhuu/module-python-logging
@@ -21,13 +21,13 @@ Classifier: Programming Language :: Python :: 3.13
 Requires-Python: <4.0,>=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE.txt
-Requires-Dist: PyYAML<7.0,>=6.0.2
-Requires-Dist: pydantic[timezone]!=2.1.0,<3.0.0,>=2.0.3
+Requires-Dist: pydantic[timezone]<3.0.0,>=2.5.3
 Requires-Dist: loguru<1.0.0,>=0.7.3
+Requires-Dist: potato_util<1.0.0,>=0.2.0
 Provides-Extra: fastapi
 Requires-Dist: beans-logging-fastapi<2.0.0,>=1.0.0; extra == "fastapi"
 Provides-Extra: test
-Requires-Dist: pytest<9.0.0,>=8.0.2; extra == "test"
+Requires-Dist: pytest<10.0.0,>=8.0.2; extra == "test"
 Requires-Dist: pytest-cov<8.0.0,>=5.0.0; extra == "test"
 Requires-Dist: pytest-xdist<4.0.0,>=3.6.1; extra == "test"
 Requires-Dist: pytest-benchmark<6.0.0,>=5.0.1; extra == "test"
@@ -37,13 +37,13 @@ Requires-Dist: wheel<1.0.0,>=0.43.0; extra == "build"
 Requires-Dist: build<2.0.0,>=1.1.1; extra == "build"
 Requires-Dist: twine<7.0.0,>=6.0.1; extra == "build"
 Provides-Extra: docs
-Requires-Dist: pylint<4.0.0,>=3.0.4; extra == "docs"
+Requires-Dist: pylint<5.0.0,>=3.0.4; extra == "docs"
 Requires-Dist: mkdocs-material<10.0.0,>=9.5.50; extra == "docs"
 Requires-Dist: mkdocs-awesome-nav<4.0.0,>=3.0.0; extra == "docs"
-Requires-Dist: mkdocstrings[python]<1.0.0,>=0.24.3; extra == "docs"
+Requires-Dist: mkdocstrings[python]<2.0.0,>=0.24.3; extra == "docs"
 Requires-Dist: mike<3.0.0,>=2.1.3; extra == "docs"
 Provides-Extra: dev
-Requires-Dist: pytest<9.0.0,>=8.0.2; extra == "dev"
+Requires-Dist: pytest<10.0.0,>=8.0.2; extra == "dev"
 Requires-Dist: pytest-cov<8.0.0,>=5.0.0; extra == "dev"
 Requires-Dist: pytest-xdist<4.0.0,>=3.6.1; extra == "dev"
 Requires-Dist: pytest-benchmark<6.0.0,>=5.0.1; extra == "dev"
@@ -51,10 +51,10 @@ Requires-Dist: setuptools<81.0.0,>=70.3.0; extra == "dev"
 Requires-Dist: wheel<1.0.0,>=0.43.0; extra == "dev"
 Requires-Dist: build<2.0.0,>=1.1.1; extra == "dev"
 Requires-Dist: twine<7.0.0,>=6.0.1; extra == "dev"
-Requires-Dist: pylint<4.0.0,>=3.0.4; extra == "dev"
+Requires-Dist: pylint<5.0.0,>=3.0.4; extra == "dev"
 Requires-Dist: mkdocs-material<10.0.0,>=9.5.50; extra == "dev"
 Requires-Dist: mkdocs-awesome-nav<4.0.0,>=3.0.0; extra == "dev"
-Requires-Dist: mkdocstrings[python]<1.0.0,>=0.24.3; extra == "dev"
+Requires-Dist: mkdocstrings[python]<2.0.0,>=0.24.3; extra == "dev"
 Requires-Dist: mike<3.0.0,>=2.1.3; extra == "dev"
 Requires-Dist: pyright<2.0.0,>=1.1.392; extra == "dev"
 Requires-Dist: pre-commit<5.0.0,>=4.0.1; extra == "dev"
@@ -217,12 +217,18 @@ logger.info("Logging info.")
 
 ```yml
 logger:
-  app_name: "my-app"
-  level: "TRACE"
-  file:
-    log_handlers:
+  app_name: my-app
+  default:
+    level:
+      base: TRACE
+  handlers:
+    default.all.file_handler:
       enabled: true
-    json_handlers:
+    default.err.file_handler:
+      enabled: true
+    default.all.json_handler:
+      enabled: true
+    default.err.json_handler:
       enabled: true
 ```
 
@@ -273,28 +279,28 @@ python ./main.py
 **Output**:
 
 ```txt
-[2023-09-01 00:00:00.000 +09:00 | TRACE | beans_logging._base:478]: Intercepted modules: ['concurrent', 'concurrent.futures', 'asyncio']; Muted modules: [];
-[2023-09-01 00:00:00.000 +09:00 | TRACE | __main__:7]: Tracing...
-[2023-09-01 00:00:00.000 +09:00 | DEBUG | __main__:8]: Debugging...
-[2023-09-01 00:00:00.000 +09:00 | INFO  | __main__:9]: Logging info.
-[2023-09-01 00:00:00.000 +09:00 | OK    | __main__:10]: Success.
-[2023-09-01 00:00:00.000 +09:00 | WARN  | __main__:11]: Warning something.
-[2023-09-01 00:00:00.000 +09:00 | ERROR | __main__:12]: Error occured.
-[2023-09-01 00:00:00.000 +09:00 | CRIT  | __main__:13]: CRITICAL ERROR.
-[2023-09-01 00:00:00.000 +09:00 | ERROR | __main__:25]: division by zero
-[2023-09-01 00:00:00.000 +09:00 | ERROR | __main__:32]: Show me, what value is wrong:
+[2025-11-01 00:00:00.735 +09:00 | TRACE | beans_logging._intercept:96]: Intercepted modules: ['potato_util._base', 'potato_util.io', 'concurrent', 'concurrent.futures', 'asyncio', 'potato_util.io._sync', 'potato_util']; Muted modules: [];
+[2025-11-01 00:00:00.736 +09:00 | TRACE | __main__:6]: Tracing...
+[2025-11-01 00:00:00.736 +09:00 | DEBUG | __main__:7]: Debugging...
+[2025-11-01 00:00:00.736 +09:00 | INFO  | __main__:8]: Logging info.
+[2025-11-01 00:00:00.736 +09:00 | OK    | __main__:9]: Success.
+[2025-11-01 00:00:00.736 +09:00 | WARN  | __main__:10]: Warning something.
+[2025-11-01 00:00:00.736 +09:00 | ERROR | __main__:11]: Error occured.
+[2025-11-01 00:00:00.736 +09:00 | CRIT  | __main__:12]: CRITICAL ERROR.
+[2025-11-01 00:00:00.736 +09:00 | ERROR | __main__:24]: division by zero
+[2025-11-01 00:00:00.737 +09:00 | ERROR | __main__:31]: Show me, what value is wrong:
 Traceback (most recent call last):
 
-> File "/home/user/workspaces/projects/beans_logging/examples/simple/./main.py", line 30, in <module>
+> File "/home/user/workspaces/projects/my/module-python-logging/examples/simple/./main.py", line 29, in <module>
     nested(0)
-    └ <function nested at 0x10802a4c0>
+    └ <function nested at 0x102f37910>
 
-  File "/home/user/workspaces/projects/beans_logging/examples/simple/./main.py", line 23, in nested
+  File "/home/user/workspaces/projects/my/module-python-logging/examples/simple/./main.py", line 22, in nested
     divide(5, c)
     │         └ 0
-    └ <function divide at 0x1052f31f0>
+    └ <function divide at 0x102f377f0>
 
-  File "/home/user/workspaces/projects/beans_logging/examples/simple/./main.py", line 17, in divide
+  File "/home/user/workspaces/projects/my/module-python-logging/examples/simple/./main.py", line 16, in divide
     _result = a / b
               │   └ 0
               └ 5
@@ -312,37 +318,54 @@ ZeroDivisionError: division by zero
 
 ```yaml
 logger:
-  # app_name: "app"
-  level: "INFO"
-  use_diagnose: false
-  stream:
-    use_color: true
-    use_icon: false
-    format_str: "[<c>{time:YYYY-MM-DD HH:mm:ss.SSS Z}</c> | <level>{level_short:<5}</level> | <w>{name}:{line}</w>]: <level>{message}</level>"
-    std_handler:
-      enabled: true
-  file:
-    logs_dir: "./logs"
-    rotate_size: 10000000 # 10MB
-    rotate_time: "00:00:00"
-    backup_count: 90
-    log_handlers:
-      enabled: false
-      format_str: "[{time:YYYY-MM-DD HH:mm:ss.SSS Z} | {level_short:<5} | {name}:{line}]: {message}"
-      log_path: "{app_name}.std.all.log"
-      err_path: "{app_name}.std.err.log"
-    json_handlers:
-      enabled: false
-      use_custom: false
-      log_path: "{app_name}.json.all.log"
-      err_path: "{app_name}.json.err.log"
+  # app_name: app
+  default:
+    level:
+      base: INFO
+      err: WARNING
+    std:
+      format_str: "[<c>{time:YYYY-MM-DD HH:mm:ss.SSS Z}</c> | <level>{extra[level_short]:<5}</level> | <w>{name}:{line}</w>]: <level>{message}</level>"
+      colorize: true
+    format_str: "[{time:YYYY-MM-DD HH:mm:ss.SSS Z} | {extra[level_short]:<5} | {name}:{line}]: {message}"
+    file:
+      logs_dir: "./logs"
+      rotate_size: 10000000
+      rotate_time: "00:00:00"
+      retention: 90
+      encoding: utf8
+      plain:
+        log_path: "{app_name}.all.log"
+        err_path: "{app_name}.err.log"
+      json:
+        log_path: "json/{app_name}.json.all.log"
+        err_path: "json/{app_name}.json.err.log"
+    custom_serialize: false
   intercept:
-    auto_load:
-      enabled: true
-      only_base: false
-      ignore_modules: []
+    enabled: true
+    only_base: false
+    ignore_modules: []
     include_modules: []
     mute_modules: []
+  handlers:
+    default.all.std_handler:
+      type: STD
+      enabled: true
+    default.all.file_handler:
+      type: FILE
+      enabled: false
+    default.err.file_handler:
+      type: FILE
+      error: true
+      enabled: false
+    default.all.json_handler:
+      type: FILE
+      serialize: true
+      enabled: false
+    default.err.json_handler:
+      type: FILE
+      serialize: true
+      error: true
+      enabled: false
   extra:
 ```
 
@@ -354,10 +377,6 @@ logger:
 # ENV=LOCAL
 # DEBUG=false
 # TZ=UTC
-
-# BEANS_LOGGING_DISABLE_DEFAULT=false
-# BEANS_LOGGING_CONFIG_PATH="./configs/logger.yml"
-# BEANS_LOGGING_LOGS_DIR="./logs"
 ```
 
 ---

{beans_logging-6.0.2 → beans_logging-7.0.0}/README.md

@@ -155,12 +155,18 @@ logger.info("Logging info.")
 
 ```yml
 logger:
-  app_name: "my-app"
-  level: "TRACE"
-  file:
-    log_handlers:
+  app_name: my-app
+  default:
+    level:
+      base: TRACE
+  handlers:
+    default.all.file_handler:
       enabled: true
-    json_handlers:
+    default.err.file_handler:
+      enabled: true
+    default.all.json_handler:
+      enabled: true
+    default.err.json_handler:
       enabled: true
 ```
 
@@ -211,28 +217,28 @@ python ./main.py
 **Output**:
 
 ```txt
-[2023-09-01 00:00:00.000 +09:00 | TRACE | beans_logging._base:478]: Intercepted modules: ['concurrent', 'concurrent.futures', 'asyncio']; Muted modules: [];
-[2023-09-01 00:00:00.000 +09:00 | TRACE | __main__:7]: Tracing...
-[2023-09-01 00:00:00.000 +09:00 | DEBUG | __main__:8]: Debugging...
-[2023-09-01 00:00:00.000 +09:00 | INFO  | __main__:9]: Logging info.
-[2023-09-01 00:00:00.000 +09:00 | OK    | __main__:10]: Success.
-[2023-09-01 00:00:00.000 +09:00 | WARN  | __main__:11]: Warning something.
-[2023-09-01 00:00:00.000 +09:00 | ERROR | __main__:12]: Error occured.
-[2023-09-01 00:00:00.000 +09:00 | CRIT  | __main__:13]: CRITICAL ERROR.
-[2023-09-01 00:00:00.000 +09:00 | ERROR | __main__:25]: division by zero
-[2023-09-01 00:00:00.000 +09:00 | ERROR | __main__:32]: Show me, what value is wrong:
+[2025-11-01 00:00:00.735 +09:00 | TRACE | beans_logging._intercept:96]: Intercepted modules: ['potato_util._base', 'potato_util.io', 'concurrent', 'concurrent.futures', 'asyncio', 'potato_util.io._sync', 'potato_util']; Muted modules: [];
+[2025-11-01 00:00:00.736 +09:00 | TRACE | __main__:6]: Tracing...
+[2025-11-01 00:00:00.736 +09:00 | DEBUG | __main__:7]: Debugging...
+[2025-11-01 00:00:00.736 +09:00 | INFO  | __main__:8]: Logging info.
+[2025-11-01 00:00:00.736 +09:00 | OK    | __main__:9]: Success.
+[2025-11-01 00:00:00.736 +09:00 | WARN  | __main__:10]: Warning something.
+[2025-11-01 00:00:00.736 +09:00 | ERROR | __main__:11]: Error occured.
+[2025-11-01 00:00:00.736 +09:00 | CRIT  | __main__:12]: CRITICAL ERROR.
+[2025-11-01 00:00:00.736 +09:00 | ERROR | __main__:24]: division by zero
+[2025-11-01 00:00:00.737 +09:00 | ERROR | __main__:31]: Show me, what value is wrong:
 Traceback (most recent call last):
 
-> File "/home/user/workspaces/projects/beans_logging/examples/simple/./main.py", line 30, in <module>
+> File "/home/user/workspaces/projects/my/module-python-logging/examples/simple/./main.py", line 29, in <module>
     nested(0)
-    └ <function nested at 0x10802a4c0>
+    └ <function nested at 0x102f37910>
 
-  File "/home/user/workspaces/projects/beans_logging/examples/simple/./main.py", line 23, in nested
+  File "/home/user/workspaces/projects/my/module-python-logging/examples/simple/./main.py", line 22, in nested
     divide(5, c)
     │         └ 0
-    └ <function divide at 0x1052f31f0>
+    └ <function divide at 0x102f377f0>
 
-  File "/home/user/workspaces/projects/beans_logging/examples/simple/./main.py", line 17, in divide
+  File "/home/user/workspaces/projects/my/module-python-logging/examples/simple/./main.py", line 16, in divide
     _result = a / b
               │   └ 0
               └ 5
@@ -250,37 +256,54 @@ ZeroDivisionError: division by zero
 
 ```yaml
 logger:
-  # app_name: "app"
-  level: "INFO"
-  use_diagnose: false
-  stream:
-    use_color: true
-    use_icon: false
-    format_str: "[<c>{time:YYYY-MM-DD HH:mm:ss.SSS Z}</c> | <level>{level_short:<5}</level> | <w>{name}:{line}</w>]: <level>{message}</level>"
-    std_handler:
-      enabled: true
-  file:
-    logs_dir: "./logs"
-    rotate_size: 10000000 # 10MB
-    rotate_time: "00:00:00"
-    backup_count: 90
-    log_handlers:
-      enabled: false
-      format_str: "[{time:YYYY-MM-DD HH:mm:ss.SSS Z} | {level_short:<5} | {name}:{line}]: {message}"
-      log_path: "{app_name}.std.all.log"
-      err_path: "{app_name}.std.err.log"
-    json_handlers:
-      enabled: false
-      use_custom: false
-      log_path: "{app_name}.json.all.log"
-      err_path: "{app_name}.json.err.log"
+  # app_name: app
+  default:
+    level:
+      base: INFO
+      err: WARNING
+    std:
+      format_str: "[<c>{time:YYYY-MM-DD HH:mm:ss.SSS Z}</c> | <level>{extra[level_short]:<5}</level> | <w>{name}:{line}</w>]: <level>{message}</level>"
+      colorize: true
+    format_str: "[{time:YYYY-MM-DD HH:mm:ss.SSS Z} | {extra[level_short]:<5} | {name}:{line}]: {message}"
+    file:
+      logs_dir: "./logs"
+      rotate_size: 10000000
+      rotate_time: "00:00:00"
+      retention: 90
+      encoding: utf8
+      plain:
+        log_path: "{app_name}.all.log"
+        err_path: "{app_name}.err.log"
+      json:
+        log_path: "json/{app_name}.json.all.log"
+        err_path: "json/{app_name}.json.err.log"
+    custom_serialize: false
   intercept:
-    auto_load:
-      enabled: true
-      only_base: false
-      ignore_modules: []
+    enabled: true
+    only_base: false
+    ignore_modules: []
     include_modules: []
     mute_modules: []
+  handlers:
+    default.all.std_handler:
+      type: STD
+      enabled: true
+    default.all.file_handler:
+      type: FILE
+      enabled: false
+    default.err.file_handler:
+      type: FILE
+      error: true
+      enabled: false
+    default.all.json_handler:
+      type: FILE
+      serialize: true
+      enabled: false
+    default.err.json_handler:
+      type: FILE
+      serialize: true
+      error: true
+      enabled: false
   extra:
 ```
 
@@ -292,10 +315,6 @@ logger:
 # ENV=LOCAL
 # DEBUG=false
 # TZ=UTC
-
-# BEANS_LOGGING_DISABLE_DEFAULT=false
-# BEANS_LOGGING_CONFIG_PATH="./configs/logger.yml"
-# BEANS_LOGGING_LOGS_DIR="./logs"
 ```
 
 ---

{beans_logging-6.0.2 → beans_logging-7.0.0}/requirements/requirements.docs.txt

@@ -1,5 +1,5 @@
-pylint>=3.0.4,<4.0.0
+pylint>=3.0.4,<5.0.0
 mkdocs-material>=9.5.50,<10.0.0
 mkdocs-awesome-nav>=3.0.0,<4.0.0
-mkdocstrings[python]>=0.24.3,<1.0.0
+mkdocstrings[python]>=0.24.3,<2.0.0
 mike>=2.1.3,<3.0.0

{beans_logging-6.0.2 → beans_logging-7.0.0}/requirements/requirements.test.txt

@@ -1,4 +1,4 @@
-pytest>=8.0.2,<9.0.0
+pytest>=8.0.2,<10.0.0
 pytest-cov>=5.0.0,<8.0.0
 pytest-xdist>=3.6.1,<4.0.0
 pytest-benchmark>=5.0.1,<6.0.0

beans_logging-7.0.0/requirements.txt

@@ -0,0 +1,3 @@
+pydantic[timezone]>=2.5.3,<3.0.0
+loguru>=0.7.3,<1.0.0
+potato_util>=0.2.0,<1.0.0

{beans_logging-6.0.2 → beans_logging-7.0.0}/src/beans_logging/__init__.py

@@ -1,14 +1,14 @@
-from ._base import Logger, logger, LoggerLoader
-from .schemas import LoggerConfigPM
-from ._consts import WarnEnum
+from __future__ import annotations
+
 from .__version__ import __version__
+from .config import LoggerConfigPM
+from ._core import Logger, logger, LoggerLoader
 
 
 __all__ = [
+    "__version__",
+    "LoggerConfigPM",
     "Logger",
     "logger",
     "LoggerLoader",
-    "LoggerConfigPM",
-    "WarnEnum",
-    "__version__",
 ]

beans_logging-7.0.0/src/beans_logging/__version__.py

@@ -0,0 +1 @@
+__version__ = "7.0.0"

beans_logging-7.0.0/src/beans_logging/_builder.py

@@ -0,0 +1,154 @@
+import os
+from typing import Any
+
+from pydantic import validate_call
+
+from ._constants import LogHandlerTypeEnum, LogLevelEnum
+from .schemas import LogHandlerPM
+from .config import LoggerConfigPM
+from .sinks import std_sink
+from .formats import json_formatter
+from .filters import (
+    use_all_filter,
+    use_std_filter,
+    use_file_filter,
+    use_file_err_filter,
+    use_file_json_filter,
+    use_file_json_err_filter,
+)
+from .rotators import Rotator
+
+
+@validate_call
+def build_handler(handler: LogHandlerPM, config: LoggerConfigPM) -> dict[str, Any]:
+    """Build handler config as dictionary for Loguru logger to add new handler.
+
+    Args:
+        handler (LogHandlerPM  , required): Target log handler model.
+        config  (LoggerConfigPM, required): Default main config model to fill missing values.
+
+    Raises:
+        ValueError: 'sink' attribute is empty, required for any log handler except std and file handlers!
+
+    Returns:
+        dict[str, Any]: Loguru handler config as dictionary.
+    """
+
+    _handler_dict = handler.model_dump(by_alias=True, exclude_none=True)
+
+    if _handler_dict.get("sink") is None:
+        if _handler_dict.get("type") == LogHandlerTypeEnum.STD:
+            _handler_dict["sink"] = std_sink
+        elif _handler_dict.get("type") == LogHandlerTypeEnum.FILE:
+            _logs_path: str = ""
+            if _handler_dict.get("serialize") or _handler_dict.get("custom_serialize"):
+                if _handler_dict.get("error"):
+                    _logs_path = os.path.join(
+                        config.default.file.logs_dir,
+                        config.default.file.json_.err_path,
+                    )
+                else:
+                    _logs_path = os.path.join(
+                        config.default.file.logs_dir,
+                        config.default.file.json_.log_path,
+                    )
+            else:
+                if _handler_dict.get("error"):
+                    _logs_path = os.path.join(
+                        config.default.file.logs_dir,
+                        config.default.file.plain.err_path,
+                    )
+                else:
+                    _logs_path = os.path.join(
+                        config.default.file.logs_dir,
+                        config.default.file.plain.log_path,
+                    )
+
+            if "{app_name}" in _logs_path:
+                _logs_path = _logs_path.format(app_name=config.app_name)
+
+            _handler_dict["sink"] = _logs_path
+        else:
+            raise ValueError(
+                "'sink' attribute is empty, required for any log handler except std and file handlers!"
+            )
+
+    if _handler_dict.get("level") is None:
+        if _handler_dict.get("error"):
+            _handler_dict["level"] = config.default.level.err
+        else:
+            _handler_dict["level"] = config.default.level.base
+
+    if (_handler_dict.get("custom_serialize") is None) and _handler_dict.get(
+        "serialize"
+    ):
+        _handler_dict["custom_serialize"] = config.default.custom_serialize
+
+    if _handler_dict.get("custom_serialize"):
+        _handler_dict["serialize"] = False
+        _handler_dict["format"] = json_formatter
+
+    if (_handler_dict.get("format") is None) and (not _handler_dict.get("serialize")):
+        if _handler_dict.get("type") == LogHandlerTypeEnum.STD:
+            _handler_dict["format"] = config.default.std.format_str
+        else:
+            _handler_dict["format"] = config.default.format_str
+
+    if _handler_dict.get("filter") is None:
+        if _handler_dict.get("type") == LogHandlerTypeEnum.STD:
+            _handler_dict["filter"] = use_std_filter
+        elif _handler_dict.get("type") == LogHandlerTypeEnum.FILE:
+            if _handler_dict.get("serialize") or _handler_dict.get("custom_serialize"):
+                if _handler_dict.get("error"):
+                    _handler_dict["filter"] = use_file_json_err_filter
+                else:
+                    _handler_dict["filter"] = use_file_json_filter
+            else:
+                if _handler_dict.get("error"):
+                    _handler_dict["filter"] = use_file_err_filter
+                else:
+                    _handler_dict["filter"] = use_file_filter
+        else:
+            _handler_dict["filter"] = use_all_filter
+
+    if _handler_dict.get("backtrace") is None:
+        _handler_dict["backtrace"] = True
+
+    if (_handler_dict.get("diagnose") is None) and (
+        (_handler_dict.get("level") == LogLevelEnum.TRACE)
+        or (_handler_dict.get("level") == 5)
+    ):
+        _handler_dict["diagnose"] = True
+
+    if (_handler_dict.get("colorize") is None) and (
+        _handler_dict.get("type") == LogHandlerTypeEnum.STD
+    ):
+        _handler_dict["colorize"] = config.default.std.colorize
+
+    if _handler_dict.get("type") == LogHandlerTypeEnum.FILE:
+        if _handler_dict.get("enqueue") is None:
+            _handler_dict["enqueue"] = True
+
+        if _handler_dict.get("rotation") is None:
+            _handler_dict["rotation"] = Rotator(
+                rotate_size=config.default.file.rotate_size,
+                rotate_time=config.default.file.rotate_time,
+            ).should_rotate
+
+        if _handler_dict.get("retention") is None:
+            _handler_dict["retention"] = config.default.file.retention
+
+        if _handler_dict.get("encoding") is None:
+            _handler_dict["encoding"] = config.default.file.encoding
+
+    _handler_dict.pop("type", None)
+    _handler_dict.pop("error", None)
+    _handler_dict.pop("custom_serialize", None)
+    _handler_dict.pop("enabled", None)
+
+    return _handler_dict
+
+
+__all__ = [
+    "build_handler",
+]

beans_logging-7.0.0/src/beans_logging/_constants.py

@@ -0,0 +1,30 @@
+from enum import Enum
+
+
+class LogHandlerTypeEnum(str, Enum):
+    STD = "STD"
+    FILE = "FILE"
+    SOCKET = "SOCKET"
+    HTTP = "HTTP"
+    SYSLOG = "SYSLOG"
+    QUEUE = "QUEUE"
+    MEMORY = "MEMORY"
+    NULL = "NULL"
+    CUSTOM = "CUSTOM"
+    UNKNOWN = "UNKNOWN"
+
+
+class LogLevelEnum(str, Enum):
+    TRACE = "TRACE"
+    DEBUG = "DEBUG"
+    INFO = "INFO"
+    SUCCESS = "SUCCESS"
+    WARNING = "WARNING"
+    ERROR = "ERROR"
+    CRITICAL = "CRITICAL"
+
+
+__all__ = [
+    "LogHandlerTypeEnum",
+    "LogLevelEnum",
+]