beans-logging 6.0.0__py3-none-any.whl → 6.0.2__py3-none-any.whl

beans_logging/__init__.py

@@ -1,5 +1,3 @@
-# -*- coding: utf-8 -*-
-
 from ._base import Logger, logger, LoggerLoader
 from .schemas import LoggerConfigPM
 from ._consts import WarnEnum

beans_logging/__version__.py

@@ -1,3 +1 @@
-# -*- coding: utf-8 -*-
-
-__version__ = "6.0.0"
+__version__ = "6.0.2"

beans_logging/_base.py

@@ -1,13 +1,11 @@
-# -*- coding: utf-8 -*-
-
-## Standard libraries
+# Standard libraries
 import os
 import copy
 import json
 import logging
-from typing import Union, Dict, Any
+from typing import Any
 
-## Third-party libraries
+# Third-party libraries
 import yaml
 from loguru import logger
 from loguru._logger import Logger
@@ -18,7 +16,7 @@ if "2.0.0" <= pydantic.__version__:
 else:
     from pydantic import validate_arguments as validate_call
 
-## Internal modules
+# Internal modules
 from ._utils import create_dir, deep_merge
 from ._handlers import InterceptHandler
 from .rotation import RotationChecker
@@ -67,7 +65,7 @@ class LoggerLoader:
     @validate_call
     def __init__(
         self,
-        config: Union[LoggerConfigPM, Dict[str, Any], None] = None,
+        config: LoggerConfigPM | dict[str, Any] | None = None,
         config_file_path: str = _CONFIG_FILE_PATH,
         auto_config_file: bool = True,
         auto_load: bool = False,
@@ -75,12 +73,14 @@ class LoggerLoader:
         """LoggerLoader constructor method.
 
         Args:
-            config           (Union[LoggerConfigPM,
-                                    dict,
-                                    None           ], optional): New logger config to update loaded config. Defaults to None.
-            config_file_path (str                   , optional): Logger config file path. Defaults to `LoggerLoader._CONFIG_FILE_PATH`.
-            auto_config_file (bool                  , optional): Indicates whether to load logger config file or not. Defaults to True.
-            auto_load        (bool                  , optional): Indicates whether to load logger handlers or not. Defaults to False.
+            config           (LoggerConfigPM | dict | None], optional): New logger config to update loaded config.
+                                                                            Defaults to None.
+            config_file_path (str                          , optional): Logger config file path. Defaults to
+                                                                            `LoggerLoader._CONFIG_FILE_PATH`.
+            auto_config_file (bool                         , optional): Indicates whether to load logger config
+                                                                            file or not. Defaults to True.
+            auto_load        (bool                         , optional): Indicates whether to load logger
+                                                                            handlers or not. Defaults to False.
         """
 
         self.handlers_map = {"default": 0}
@@ -125,17 +125,15 @@ class LoggerLoader:
         return logger
 
     @validate_call
-    def remove_handler(
-        self, handler: Union[str, None] = None, handler_type: str = "NAME"
-    ):
+    def remove_handler(self, handler: str | None = None, handler_type: str = "NAME"):
         """Remove all handlers or specific handler by name or id from logger.
 
         Raises:
             ValueError: The `handler_type` argument value '{handler_type}' is invalid, must be 'NAME' or 'ID'!
 
         Args:
-            handler     (str, optional): Handler name or id to remove. Defaults to None.
-            hadler_type (int, optional): Handler type to remove, must be 'NAME' or 'ID'. Defaults to 'name'.
+            handler      (str, optional): Handler name or id to remove. Defaults to None.
+            handler_type (int, optional): Handler type to remove, must be 'NAME' or 'ID'. Defaults to 'name'.
         """
 
         if handler:
@@ -162,7 +160,7 @@ class LoggerLoader:
         self.handlers_map.clear()
 
     @validate_call
-    def update_config(self, config: Union[LoggerConfigPM, Dict[str, Any]]):
+    def update_config(self, config: LoggerConfigPM | dict[str, Any]):
         """Update logger config with new config.
 
         Args:
@@ -213,13 +211,11 @@ class LoggerLoader:
         # elif self.config_file_path.lower().endswith(".toml"):
         #     _file_format = "TOML"
 
-        ## Loading config from file, if it's exits:
+        # Loading config from file, if it's exits:
         if os.path.isfile(self.config_file_path):
             if _file_format == "YAML":
                 try:
-                    with open(
-                        self.config_file_path, "r", encoding="utf-8"
-                    ) as _config_file:
+                    with open(self.config_file_path, encoding="utf-8") as _config_file:
                         _new_config_dict = yaml.safe_load(_config_file) or {}
                         if "logger" not in _new_config_dict:
                             logger.warning(
@@ -242,9 +238,7 @@ class LoggerLoader:
                     raise
             elif _file_format == "JSON":
                 try:
-                    with open(
-                        self.config_file_path, "r", encoding="utf-8"
-                    ) as _config_file:
+                    with open(self.config_file_path, encoding="utf-8") as _config_file:
                         _new_config_dict = json.load(_config_file) or {}
                         if "logger" not in _new_config_dict:
                             logger.warning(
@@ -296,7 +290,7 @@ class LoggerLoader:
     def _check_env(self):
         """Check environment variables for logger config."""
 
-        ## Checking environment for DEBUG option:
+        # Checking environment for DEBUG option:
         _is_debug = False
         _ENV = str(os.getenv("ENV")).strip().lower()
         _DEBUG = str(os.getenv("DEBUG")).strip().lower()
@@ -314,7 +308,7 @@ class LoggerLoader:
             self.config.file.logs_dir = os.getenv("BEANS_LOGGING_LOGS_DIR")
 
         # if self.config.stream.use_color:
-        #     ## Checking terminal could support xterm colors:
+        #     # Checking terminal could support xterm colors:
         #     _TERM = str(os.getenv("TERM")).strip()
         #     if not "xterm" in _TERM:
         #         self.config.stream.use_color = False
@@ -536,7 +530,7 @@ class LoggerLoader:
 
         _intercept_handler = InterceptHandler()
 
-        ## Intercepting all logs from standard (root logger) logging:
+        # Intercepting all logs from standard (root logger) logging:
         logging.basicConfig(handlers=[_intercept_handler], level=0, force=True)
 
         _intercepted_modules = set()
@@ -579,10 +573,10 @@ class LoggerLoader:
             f"Intercepted modules: {list(_intercepted_modules)}; Muted modules: {list(_muted_modules)};"
         )
 
-    ### ATTRIBUTES ###
-    ## handlers_map ##
+    # ATTRIBUTES #
+    # handlers_map
     @property
-    def handlers_map(self) -> Dict[str, int]:
+    def handlers_map(self) -> dict[str, int]:
         try:
             return self.__handlers_map
         except AttributeError:
@@ -591,7 +585,7 @@ class LoggerLoader:
         return self.__handlers_map
 
     @handlers_map.setter
-    def handlers_map(self, handlers_map: Dict[str, int]):
+    def handlers_map(self, handlers_map: dict[str, int]):
         if not isinstance(handlers_map, dict):
             raise TypeError(
                 f"`handlers_map` attribute type {type(handlers_map)} is invalid, must be <dict>!."
@@ -599,9 +593,9 @@ class LoggerLoader:
 
         self.__handlers_map = copy.deepcopy(handlers_map)
 
-    ## handlers_map ##
+    # handlers_map
 
-    ## config ##
+    # config
     @property
     def config(self) -> LoggerConfigPM:
         try:
@@ -620,9 +614,9 @@ class LoggerLoader:
 
         self.__config = copy.deepcopy(config)
 
-    ## config ##
+    # config
 
-    ## config_file_path ##
+    # config_file_path
     @property
     def config_file_path(self) -> str:
         try:
@@ -648,11 +642,13 @@ class LoggerLoader:
         ):
             if not config_file_path.lower().endswith(".toml"):
                 raise NotImplementedError(
-                    f"`config_file_path` attribute value '{config_file_path}' is invalid, TOML file format is not supported yet!"
+                    f"`config_file_path` attribute value '{config_file_path}' is invalid, "
+                    f"TOML file format is not supported yet!"
                 )
 
             raise ValueError(
-                f"`config_file_path` attribute value '{config_file_path}' is invalid, file must be '.yml', '.yaml' or '.json' format!"
+                f"`config_file_path` attribute value '{config_file_path}' is invalid, "
+                f"file must be '.yml', '.yaml' or '.json' format!"
             )
 
         if not os.path.isabs(config_file_path):
@@ -660,5 +656,5 @@ class LoggerLoader:
 
         self.__config_file_path = config_file_path
 
-    ## config_file_path ##
-    ### ATTRIBUTES ###
+    # config_file_path
+    # ATTRIBUTES #

beans_logging/_consts.py

@@ -1,5 +1,3 @@
-# -*- coding: utf-8 -*-
-
 from enum import Enum
 
 

beans_logging/_handlers.py

@@ -1,5 +1,3 @@
-# -*- coding: utf-8 -*-
-
 import sys
 import logging
 from logging import LogRecord
@@ -25,13 +23,13 @@ class InterceptHandler(logging.Handler):
             record (LogRecord, required): Log needs to be handled.
         """
 
-        ## Get corresponding Loguru level if it exists
+        # Get corresponding Loguru level if it exists
         try:
             _level = logger.level(record.levelname).name
         except ValueError:
             _level = record.levelno
 
-        ## Find caller from where originated the logged message
+        # Find caller from where originated the logged message
         _frame, _depth = sys._getframe(6), 6
         while _frame and _frame.f_code.co_filename == logging.__file__:
             _frame = _frame.f_back

beans_logging/_utils.py

@@ -1,5 +1,3 @@
-# -*- coding: utf-8 -*-
-
 import os
 import sys
 import copy
@@ -22,7 +20,8 @@ def create_dir(create_dir: str, warn_mode: WarnEnum = WarnEnum.DEBUG):
 
     Args:
         create_dir (str, required): Create directory path.
-        warn_mode  (str, optional): Warning message mode, for example: 'ERROR', 'ALWAYS', 'DEBUG', 'IGNORE'. Defaults to "DEBUG".
+        warn_mode  (str, optional): Warning message mode, for example: 'ERROR', 'ALWAYS', 'DEBUG', 'IGNORE'.
+                                        Defaults to "DEBUG".
     """
 
     if not os.path.isdir(create_dir):

beans_logging/auto.py

@@ -1,11 +1,10 @@
-# -*- coding: utf-8 -*-
+# flake8: noqa
 
 import os
-from typing import Union
 
 from . import *
 
-logger_loader: Union[LoggerLoader, None] = None
+logger_loader: LoggerLoader | None = None
 _DISABLE_DEFAULT_LOGGER = (
     str(os.getenv("BEANS_LOGGING_DISABLE_DEFAULT")).strip().lower()
 )

beans_logging/filters.py

@@ -1,6 +1,3 @@
-# -*- coding: utf-8 -*-
-
-
 def add_level_short(record: dict) -> dict:
     """Filter for adding short level name to log record.
 

beans_logging/formats.py

@@ -1,5 +1,3 @@
-# -*- coding: utf-8 -*-
-
 import json
 import traceback
 

beans_logging/rotation.py

@@ -1,5 +1,3 @@
-# -*- coding: utf-8 -*-
-
 import datetime
 from typing import TextIO
 
@@ -35,8 +33,8 @@ class RotationChecker:
         )
 
         if _current_dtime >= self._dtime_limit:
-            ## The current time is already past the target time so it would rotate already.
-            ## Add one day to prevent an immediate rotation.
+            # The current time is already past the target time so it would rotate already.
+            # Add one day to prevent an immediate rotation.
             self._dtime_limit += datetime.timedelta(days=1)
 
     def should_rotate(self, message: Message, file: TextIO) -> bool:

beans_logging/schemas.py

@@ -1,7 +1,4 @@
-# -*- coding: utf-8 -*-
-
 import datetime
-from typing import List
 
 
 import pydantic
@@ -34,7 +31,10 @@ class StreamPM(ExtraBaseModel):
     use_color: bool = Field(default=True)
     use_icon: bool = Field(default=False)
     format_str: constr(strip_whitespace=True) = Field(
-        default="[<c>{time:YYYY-MM-DD HH:mm:ss.SSS Z}</c> | <level>{level_short:<5}</level> | <w>{name}:{line}</w>]: <level>{message}</level>",
+        default=(
+            "[<c>{time:YYYY-MM-DD HH:mm:ss.SSS Z}</c> | <level>{level_short:<5}</level> | <w>{name}:{line}</w>]: "
+            "<level>{message}</level>"
+        ),
         min_length=3,
         max_length=511,
     )
@@ -145,13 +145,13 @@ class FilePM(ExtraBaseModel):
 class AutoLoadPM(ExtraBaseModel):
     enabled: bool = Field(default=True)
     only_base: bool = Field(default=False)
-    ignore_modules: List[str] = Field(default=[])
+    ignore_modules: list[str] = Field(default=[])
 
 
 class InterceptPM(ExtraBaseModel):
     auto_load: AutoLoadPM = Field(default_factory=AutoLoadPM)
-    include_modules: List[str] = Field(default=[])
-    mute_modules: List[str] = Field(default=[])
+    include_modules: list[str] = Field(default=[])
+    mute_modules: list[str] = Field(default=[])
 
 
 class ExtraPM(ExtraBaseModel):

beans_logging/sinks.py

@@ -1,5 +1,3 @@
-# -*- coding: utf-8 -*-
-
 import sys
 
 from loguru._handler import Message

beans_logging-6.0.2.dist-info/METADATA

@@ -0,0 +1,424 @@
+Metadata-Version: 2.4
+Name: beans_logging
+Version: 6.0.2
+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
+Project-URL: Documentation, https://pylogging-docs.bybatkhuu.dev
+Project-URL: Repository, https://github.com/bybatkhuu/module-python-logging.git
+Project-URL: Issues, https://github.com/bybatkhuu/module-python-logging/issues
+Project-URL: Changelog, https://github.com/bybatkhuu/module-python-logging/blob/main/CHANGELOG.md
+Keywords: beans_logging,loguru,logging,logger,logs,python-logging,custom-logging
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+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: loguru<1.0.0,>=0.7.3
+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-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"
+Provides-Extra: build
+Requires-Dist: setuptools<81.0.0,>=70.3.0; extra == "build"
+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: 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: 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-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"
+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: 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: 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"
+Dynamic: license-file
+
+# Python Logging (beans-logging)
+
+[![MIT License](https://img.shields.io/badge/License-MIT-green.svg)](https://choosealicense.com/licenses/mit)
+[![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/bybatkhuu/module-python-logging/2.build-publish.yml?logo=GitHub)](https://github.com/bybatkhuu/module-python-logging/actions/workflows/2.build-publish.yml)
+[![GitHub release (latest SemVer)](https://img.shields.io/github/v/release/bybatkhuu/module-python-logging?logo=GitHub&color=blue)](https://github.com/bybatkhuu/module-python-logging/releases)
+[![PyPI](https://img.shields.io/pypi/v/beans-logging?logo=PyPi)](https://pypi.org/project/beans-logging)
+[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/beans-logging?logo=Python)](https://docs.conda.io/en/latest/miniconda.html)
+
+`beans-logging` is a python package for simple logger and easily managing logs.
+
+It is a `Loguru` based custom logging package for python projects.
+
+## ✨ Features
+
+- Main **logger** based on **Loguru** logging - <https://pypi.org/project/loguru>
+- Logging to **log files** (all, error, json)
+- **Pre-defined** logging configs and handlers
+- **Colorful** logging
+- Auto **intercepting** and **muting** modules
+- Load config from **YAML** or **JSON** file
+- Custom options as a **config**
+- Custom logging **formats**
+- **Multiprocess** compatibility (Linux, macOS - 'fork')
+- Add custom **handlers**
+- **Base** logging module
+
+---
+
+## 🛠 Installation
+
+### 1. 🚧 Prerequisites
+
+- Install **Python (>= v3.10)** and **pip (>= 23)**:
+    - **[RECOMMENDED] [Miniconda (v3)](https://www.anaconda.com/docs/getting-started/miniconda/install)**
+    - *[arm64/aarch64] [Miniforge (v3)](https://github.com/conda-forge/miniforge)*
+    - *[Python virutal environment] [venv](https://docs.python.org/3/library/venv.html)*
+
+[OPTIONAL] For **DEVELOPMENT** environment:
+
+- Install [**git**](https://git-scm.com/downloads)
+- Setup an [**SSH key**](https://docs.github.com/en/github/authenticating-to-github/connecting-to-github-with-ssh)
+
+### 2. 📥 Download or clone the repository
+
+[TIP] Skip this step, if you're going to install the package directly from **PyPi** or **GitHub** repository.
+
+**2.1.** Prepare projects directory (if not exists):
+
+```sh
+# Create projects directory:
+mkdir -pv ~/workspaces/projects
+
+# Enter into projects directory:
+cd ~/workspaces/projects
+```
+
+**2.2.** Follow one of the below options **[A]**, **[B]** or **[C]**:
+
+**OPTION A.** Clone the repository:
+
+```sh
+git clone https://github.com/bybatkhuu/module-python-logging.git && \
+    cd module-python-logging
+```
+
+**OPTION B.** Clone the repository (for **DEVELOPMENT**: git + ssh key):
+
+```sh
+git clone git@github.com:bybatkhuu/module-python-logging.git && \
+    cd module-python-logging
+```
+
+**OPTION C.** Download source code:
+
+1. Download archived **zip** file from [**releases**](https://github.com/bybatkhuu/module-python-logging/releases).
+2. Extract it into the projects directory.
+
+### 3. 📦 Install the package
+
+[NOTE] Choose one of the following methods to install the package **[A ~ F]**:
+
+**OPTION A.** [**RECOMMENDED**] Install from **PyPi**:
+
+```sh
+pip install -U beans-logging
+```
+
+**OPTION B.** Install latest version directly from **GitHub** repository:
+
+```sh
+pip install git+https://github.com/bybatkhuu/module-python-logging.git
+```
+
+**OPTION C.** Install from the downloaded **source code**:
+
+```sh
+# Install directly from the source code:
+pip install .
+
+# Or install with editable mode:
+pip install -e .
+```
+
+**OPTION D.** Install for **DEVELOPMENT** environment:
+
+```sh
+pip install -e .[dev]
+
+# Install pre-commit hooks:
+pre-commit install
+```
+
+**OPTION E.** Install from **pre-built release** files:
+
+1. Download **`.whl`** or **`.tar.gz`** file from [**releases**](https://github.com/bybatkhuu/module-python-logging/releases)
+2. Install with pip:
+
+```sh
+# Install from .whl file:
+pip install ./beans_logging-[VERSION]-py3-none-any.whl
+
+# Or install from .tar.gz file:
+pip install ./beans_logging-[VERSION].tar.gz
+```
+
+**OPTION F.** Copy the **module** into the project directory (for **testing**):
+
+```sh
+# Install python dependencies:
+pip install -r ./requirements.txt
+
+# Copy the module source code into the project:
+cp -r ./src/beans_logging [PROJECT_DIR]
+# For example:
+cp -r ./src/beans_logging /some/path/project/
+```
+
+## 🚸 Usage/Examples
+
+To use `beans_logging`, import the `logger` instance from the `beans_logging.auto` package:
+
+```python
+from beans_logging.auto import logger
+```
+
+You can call logging methods directly from the `logger` instance:
+
+```python
+logger.info("Logging info.")
+```
+
+### **Simple**
+
+[**`configs/logger.yml`**](./examples/simple/configs/logger.yml):
+
+```yml
+logger:
+  app_name: "my-app"
+  level: "TRACE"
+  file:
+    log_handlers:
+      enabled: true
+    json_handlers:
+      enabled: true
+```
+
+[**`main.py`**](./examples/simple/main.py):
+
+```python
+#!/usr/bin/env python
+
+from beans_logging.auto import logger
+
+
+logger.trace("Tracing...")
+logger.debug("Debugging...")
+logger.info("Logging info.")
+logger.success("Success.")
+logger.warning("Warning something.")
+logger.error("Error occured.")
+logger.critical("CRITICAL ERROR.")
+
+
+def divide(a, b):
+    _result = a / b
+    return _result
+
+
+def nested(c):
+    try:
+        divide(5, c)
+    except ZeroDivisionError as err:
+        logger.error(err)
+        raise
+
+
+try:
+    nested(0)
+except Exception:
+    logger.exception("Show me, what value is wrong:")
+```
+
+Run the [**`examples/simple`**](./examples/simple):
+
+```sh
+cd ./examples/simple
+
+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:
+Traceback (most recent call last):
+
+> File "/home/user/workspaces/projects/beans_logging/examples/simple/./main.py", line 30, in <module>
+    nested(0)
+    └ <function nested at 0x10802a4c0>
+
+  File "/home/user/workspaces/projects/beans_logging/examples/simple/./main.py", line 23, in nested
+    divide(5, c)
+    │         └ 0
+    └ <function divide at 0x1052f31f0>
+
+  File "/home/user/workspaces/projects/beans_logging/examples/simple/./main.py", line 17, in divide
+    _result = a / b
+              │   └ 0
+              └ 5
+
+ZeroDivisionError: division by zero
+```
+
+👍
+
+---
+
+## ⚙️ Configuration
+
+[**`templates/configs/logger.yml`**](./templates/configs/logger.yml):
+
+```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"
+  intercept:
+    auto_load:
+      enabled: true
+      only_base: false
+      ignore_modules: []
+    include_modules: []
+    mute_modules: []
+  extra:
+```
+
+### 🌎 Environment Variables
+
+[**`.env.example`**](./.env.example):
+
+```sh
+# ENV=LOCAL
+# DEBUG=false
+# TZ=UTC
+
+# BEANS_LOGGING_DISABLE_DEFAULT=false
+# BEANS_LOGGING_CONFIG_PATH="./configs/logger.yml"
+# BEANS_LOGGING_LOGS_DIR="./logs"
+```
+
+---
+
+## 🧪 Running Tests
+
+To run tests, run the following command:
+
+```sh
+# Install python test dependencies:
+pip install .[test]
+
+# Run tests:
+python -m pytest -sv -o log_cli=true
+# Or use the test script:
+./scripts/test.sh -l -v -c
+```
+
+## 🏗️ Build Package
+
+To build the python package, run the following command:
+
+```sh
+# Install python build dependencies:
+pip install -r ./requirements/requirements.build.txt
+
+# Build python package:
+python -m build
+# Or use the build script:
+./scripts/build.sh
+```
+
+## 📝 Generate Docs
+
+To build the documentation, run the following command:
+
+```sh
+# Install python documentation dependencies:
+pip install -r ./requirements/requirements.docs.txt
+
+# Serve documentation locally (for development):
+mkdocs serve -a 0.0.0.0:8000
+# Or use the docs script:
+./scripts/docs.sh
+
+# Or build documentation:
+mkdocs build
+# Or use the docs script:
+./scripts/docs.sh -b
+```
+
+## 📚 Documentation
+
+- [Docs](./docs)
+
+---
+
+## 📑 References
+
+- <https://github.com/Delgan/loguru>
+- <https://loguru.readthedocs.io/en/stable/api/logger.html>
+- <https://loguru.readthedocs.io/en/stable/resources/recipes.html>
+- <https://docs.python.org/3/library/logging.html>
+- <https://github.com/bybatkhuu/module-fastapi-logging>

beans_logging-6.0.2.dist-info/RECORD

@@ -0,0 +1,17 @@
+beans_logging/__init__.py,sha256=Ax1f3I26MSEorCBnkPVcuzEWN7IoJZuzPdVjCukvUv0,272
+beans_logging/__version__.py,sha256=lze97Y7ToUnpENKGAhOoSKx1zlZQe6ZfCSr8M50_K1g,22
+beans_logging/_base.py,sha256=fKwGgtkbUzg2Wtfb5XwIGF5UU56iPOT-R6OD3wqIBws,24645
+beans_logging/_consts.py,sha256=OqSvH2IvsUSbvIgthHeiv92i9CHXKYvO-PCb_DsMANI,320
+beans_logging/_handlers.py,sha256=cz2jcJR0MuVHWWNRAFT617njC_18Q56lNcgKIxLmFys,1106
+beans_logging/_utils.py,sha256=Vk8UT2mPTanP4KuLnxKk6Pv-Nr8iWDom0TwCxHb5EhA,2757
+beans_logging/auto.py,sha256=YQMfmWK6mFEwqabhimj8ZA_yStKZCDQEvteKv2UIbEA,494
+beans_logging/filters.py,sha256=iikVBMIhAF_DP1F0X0GJ7GUOvP-JdcH_CxAsYuz0UxM,3343
+beans_logging/formats.py,sha256=WTIDP0uJL9J9bcFZ2_Qe8zlw_l4SrE2k2agPLvrjfMM,1324
+beans_logging/rotation.py,sha256=t-ORXq7x4tDbvz8XMjCCuDZ6cUApcu3SBQzfgTwHQU8,2110
+beans_logging/schemas.py,sha256=CBaztXAnoqKiL3poLz0ymR8c0EdqKo4rJ_K4kXwDqjo,5631
+beans_logging/sinks.py,sha256=t2U4v95H_tV2ci6YS8aKCnTUKVRxEcsLnB55qn4wyrQ,331
+beans_logging-6.0.2.dist-info/licenses/LICENSE.txt,sha256=CUTK-r0BWIg1r0bBiemAcMhakgV0N7HuRhw6rQ-A9A4,1074
+beans_logging-6.0.2.dist-info/METADATA,sha256=E56H2f4nvUltwTr-k3ZfTrTsdeleUpGcb0FmtvaDInk,12652
+beans_logging-6.0.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+beans_logging-6.0.2.dist-info/top_level.txt,sha256=lx8JEqYGNha1sYbVrTtMo2Z01A7Shq8hX6bfsuKLTG8,14
+beans_logging-6.0.2.dist-info/RECORD,,

{beans_logging-6.0.0.dist-info → beans_logging-6.0.2.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: bdist_wheel (0.41.3)
+Generator: setuptools (80.9.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

{beans_logging-6.0.0.dist-info → beans_logging-6.0.2.dist-info/licenses}/LICENSE.txt

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2023 Batkhuu Byambajav
+Copyright (c) 2025 Batkhuu Byambajav
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

{beans_logging-6.0.0.dist-info → beans_logging-6.0.2.dist-info}/top_level.txt

@@ -1,2 +1 @@
 beans_logging
-tests

beans_logging-6.0.0.dist-info/METADATA

@@ -1,326 +0,0 @@
-Metadata-Version: 2.1
-Name: beans-logging
-Version: 6.0.0
-Summary: 'beans_logging' is a python package for simple logger and easily managing logging modules. It is a Loguru based custom logging package for python projects.
-Home-page: https://github.com/bybatkhuu/module.python-logging
-Download-URL: https://github.com/bybatkhuu/module.python-logging/archive/v6.0.0.tar.gz
-Author: Batkhuu Byambajav
-Author-email: batkhuu10@gmail.com
-License: MIT
-Keywords: beans_logging,loguru,logging,logger,logs,log,print,custom-logging
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Developers
-Classifier: Topic :: Software Development :: Build Tools
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Requires-Python: >=3.8
-Description-Content-Type: text/markdown
-License-File: LICENSE.txt
-Requires-Dist: PyYAML <7.0,>=6.0
-Requires-Dist: pydantic !=2.0.0,!=2.0.1,!=2.1.0,<3.0.0,>=1.10.0
-Requires-Dist: loguru <1.0.0,>=0.7.2
-Provides-Extra: fastapi
-Requires-Dist: beans-logging-fastapi <2.0.0,>=1.0.0 ; extra == 'fastapi'
-
-# beans_logging
-
-[![MIT License](https://img.shields.io/badge/License-MIT-green.svg)](https://choosealicense.com/licenses/mit/)
-[![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/bybatkhuu/module.python-logging/2.build-publish.yml?logo=GitHub)](https://github.com/bybatkhuu/module.python-logging/actions/workflows/2.build-publish.yml)
-[![GitHub release (latest SemVer)](https://img.shields.io/github/v/release/bybatkhuu/module.python-logging?logo=GitHub)](https://github.com/bybatkhuu/module.python-logging/releases)
-[![PyPI](https://img.shields.io/pypi/v/beans-logging?logo=PyPi)](https://pypi.org/project/beans-logging)
-[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/beans-logging?logo=Python)](https://docs.conda.io/en/latest/miniconda.html)
-
-`beans_logging` is a python package for simple logger and easily managing logging modules.
-
-It is a `Loguru` based custom logging package for python projects.
-
-## Features
-
-- Main **logger** based on **Loguru** logging - <https://pypi.org/project/loguru>
-- Logging to **log files** (all, error, json)
-- **Pre-defined** logging configs and handlers
-- **Colorful** logging
-- Auto **intercepting** and **muting** modules
-- Load config from **YAML** or **JSON** file
-- Custom options as a **config**
-- Custom logging **formats**
-- **Multiprocess** compatibility (Linux, macOS - 'fork')
-- Add custom **handlers**
-- **Base** logging module
-- Support **Pydantic-v1** and **Pydantic-v2**
-
----
-
-## Installation
-
-### 1. Prerequisites
-
-- **Python (>= v3.8)**
-- **PyPi (>= v23)**
-
-### 2. Install beans-logging package
-
-Choose one of the following methods to install the package **[A ~ F]**:
-
-**A.** [**RECOMMENDED**] Install from **PyPi**
-
-```sh
-# Install or upgrade beans-logging package:
-pip install -U beans-logging
-```
-
-**B.** Install latest version from **GitHub**
-
-```sh
-# Install package by git:
-pip install git+https://github.com/bybatkhuu/module.python-logging.git
-```
-
-**C.** Install from **pre-built release** files
-
-1. Download **`.whl`** or **`.tar.gz`** file from **releases** - <https://github.com/bybatkhuu/module.python-logging/releases>
-2. Install with pip:
-
-```sh
-# Install from .whl file:
-pip install ./beans_logging-[VERSION]-py3-none-any.whl
-# Or install from .tar.gz file:
-pip install ./beans_logging-[VERSION].tar.gz
-```
-
-**D.** Install from **source code** by building package
-
-```sh
-# Clone repository by git:
-git clone https://github.com/bybatkhuu/module.python-logging.git beans_logging
-cd ./beans_logging
-
-# Install python build tool:
-pip install -U pip build
-
-# Build python package:
-python -m build
-
-_VERSION=$(./scripts/get-version.sh)
-
-# Install from .whl file:
-pip install ./dist/beans_logging-${_VERSION}-py3-none-any.whl
-# Or install from .tar.gz file:
-pip install ./dist/beans_logging-${_VERSION}.tar.gz
-```
-
-**E.** Install with pip editable **development mode** (from source code)
-
-```sh
-# Clone repository by git:
-git clone https://github.com/bybatkhuu/module.python-logging.git beans_logging
-cd ./beans_logging
-
-# Install with editable development mode:
-pip install -e .
-```
-
-**F.** Manually add to **PYTHONPATH** (not recommended)
-
-```sh
-# Clone repository by git:
-git clone https://github.com/bybatkhuu/module.python-logging.git beans_logging
-cd ./beans_logging
-
-# Install python dependencies:
-pip install -r ./requirements.txt
-
-# Add current path to PYTHONPATH:
-export PYTHONPATH="${PWD}:${PYTHONPATH}"
-```
-
-## Usage/Examples
-
-To use `beans_logging`, import the `logger` instance from the `beans_logging.auto` package:
-
-```python
-from beans_logging.auto import logger
-```
-
-You can call logging methods directly from the `logger` instance:
-
-```python
-logger.info("Logging info.")
-```
-
-### **Simple**
-
-[**`configs/logger.yml`**](https://github.com/bybatkhuu/module.python-logging/blob/main/examples/simple/configs/logger.yml):
-
-```yml
-logger:
-  app_name: "my-app"
-  level: "TRACE"
-  file:
-    log_handlers:
-      enabled: true
-    json_handlers:
-      enabled: true
-```
-
-[**`main.py`**](https://github.com/bybatkhuu/module.python-logging/blob/main/examples/simple/main.py):
-
-```python
-from beans_logging.auto import logger
-
-
-logger.trace("Tracing...")
-logger.debug("Debugging...")
-logger.info("Logging info.")
-logger.success("Success.")
-logger.warning("Warning something.")
-logger.error("Error occured.")
-logger.critical("CRITICAL ERROR.")
-
-def divide(a, b):
-    _result = a / b
-    return _result
-
-def nested(c):
-    try:
-        divide(5, c)
-    except ZeroDivisionError as err:
-        logger.error(err)
-        raise
-
-try:
-    nested(0)
-except Exception as err:
-    logger.exception("Show me, what value is wrong:")
-```
-
-Run the [**`examples/simple`**](https://github.com/bybatkhuu/module.python-logging/tree/main/examples/simple):
-
-```sh
-cd ./examples/simple
-
-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:
-Traceback (most recent call last):
-
-> File "/home/user/workspaces/projects/beans_logging/examples/simple/./main.py", line 30, in <module>
-    nested(0)
-    └ <function nested at 0x10802a4c0>
-
-  File "/home/user/workspaces/projects/beans_logging/examples/simple/./main.py", line 23, in nested
-    divide(5, c)
-    │         └ 0
-    └ <function divide at 0x1052f31f0>
-
-  File "/home/user/workspaces/projects/beans_logging/examples/simple/./main.py", line 17, in divide
-    _result = a / b
-              │   └ 0
-              └ 5
-
-ZeroDivisionError: division by zero
-```
-
-### **FastAPI**
-
-Checkout `beans_logging_fastapi` package: <https://github.com/bybatkhuu/module.fastapi-logging>
-
-- FastAPI HTTP access logging middleware
-- Install with pip: `pip install -U beans-logging[fastapi]` or `pip install -U beans-logging-fastapi`
-
----
-
-## Running Tests
-
-To run tests, run the following command:
-
-```sh
-# Install python test dependencies:
-pip install -r ./requirements.test.txt
-
-# Run tests:
-python -m pytest -v
-```
-
-## Environment Variables
-
-You can use the following environment variables inside [**`.env.example`**](https://github.com/bybatkhuu/module.python-logging/blob/main/.env.example) file:
-
-```sh
-ENV=development
-DEBUG=true
-
-BEANS_LOGGING_DISABLE_DEFAULT=false
-BEANS_LOGGING_CONFIG_PATH="./configs/logger.yml"
-BEANS_LOGGING_LOGS_DIR="./logs"
-```
-
-## Configuration
-
-You can use the following configuration template [**`logger.yml`**](https://github.com/bybatkhuu/module.python-logging/blob/main/templates/configs/logger.yml): file:
-
-```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"
-  intercept:
-    auto_load:
-      enabled: true
-      only_base: false
-      ignore_modules: []
-    include_modules: []
-    mute_modules: []
-  extra:
-```
-
-## Documentation
-
-- [docs](https://github.com/bybatkhuu/module.python-logging/blob/main/docs/README.md)
-- [scripts](https://github.com/bybatkhuu/module.python-logging/blob/main/docs/scripts/README.md)
-
----
-
-## References
-
-- <https://github.com/Delgan/loguru>
-- <https://loguru.readthedocs.io/en/stable/api/logger.html>
-- <https://loguru.readthedocs.io/en/stable/resources/recipes.html>
-- <https://github.com/bybatkhuu/module.fastapi-logging>

beans_logging-6.0.0.dist-info/RECORD

@@ -1,20 +0,0 @@
-beans_logging/__init__.py,sha256=TxuozMCLvGkG7sATP2uFCQws6TRqwp36yc08zUVGcb4,297
-beans_logging/__version__.py,sha256=Skn1HZtKosF7bkVFNvpnIh3dEl9kV9eFp7ZGRzT6uQI,47
-beans_logging/_base.py,sha256=HEf9Vyyj3oS0m5wuKd50LQDCVZNmsBEM1LntrYbnGjs,24571
-beans_logging/_consts.py,sha256=b_-uytryZFCxlD2aKXzdS0oQpAsaK6JLi-w5bUeG1yE,345
-beans_logging/_handlers.py,sha256=WQjr-dGAnjsegI2LHJl_Fubxb0reSCr8A6IvR7eN8dk,1133
-beans_logging/_utils.py,sha256=Smb0cxkTdVxA-IE-oqi3sGhpsQdtNquQSw2bQxN0pDM,2742
-beans_logging/auto.py,sha256=Wyi4w4qZ9PNW2dDF19E8qoKuZVfhyAEl_rVPzMscVCM,534
-beans_logging/filters.py,sha256=YNUF5_0hE0XoPfLCi5wQFe1Qi7eLV0UaJUtCDwlG5ec,3369
-beans_logging/formats.py,sha256=gxyJT9ZUWQvjrL4x6fU5bLKybGsFkCpFDG5OpndqDhc,1349
-beans_logging/rotation.py,sha256=GspZX7wff_igZjbGSysCboz8fUgDHofGRL10OaNlZ3I,2137
-beans_logging/schemas.py,sha256=syMsmwbDvDE1odnaIX18PEIEpWyItfDDnisZr1AsOPs,5641
-beans_logging/sinks.py,sha256=C_y53i_QJuNZs_zBitb87d_tfsLhin2D9DtImPV5OHg,356
-tests/__init__.py,sha256=iwhKnzeBJLKxpRVjvzwiRE63_zNpIBfaKLITauVph-0,24
-tests/conftest.py,sha256=ycEL83-UMU-fcXQUZWTCNEPcBOZ38pzhoCPpXpCjIEM,319
-tests/test_beans_logging.py,sha256=qyiM24QEAi7lVs-QBmjh_e48bCHk8nNYwMOlZIb6phw,1733
-beans_logging-6.0.0.dist-info/LICENSE.txt,sha256=8jrXqC7FZbke39LPGo_mUFR81CkoUCP_vyefZjlQDOg,1074
-beans_logging-6.0.0.dist-info/METADATA,sha256=jd6oaW9K3_v7vYmOt3RnGf3HODeTwkGrERzxwSCsMCM,9805
-beans_logging-6.0.0.dist-info/WHEEL,sha256=Xo9-1PvkuimrydujYJAjF7pCkriuXBpUPEjma1nZyJ0,92
-beans_logging-6.0.0.dist-info/top_level.txt,sha256=wSVo6vZwIqyOwwsbVBQceBQ_VJKuErw8OQvDiHcp8uU,20
-beans_logging-6.0.0.dist-info/RECORD,,

tests/__init__.py

@@ -1 +0,0 @@
-# -*- coding: utf-8 -*-

tests/conftest.py

@@ -1,16 +0,0 @@
-# -*- coding: utf-8 -*-
-
-import pytest
-
-from beans_logging import logger
-
-
-@pytest.fixture(scope="session", autouse=True)
-def setup_and_teardown():
-    # Equivalent of setUp
-    logger.info("Setting up...")
-
-    yield  # This is where the testing happens!
-
-    # Equivalent of tearDown
-    logger.info("Tearing down!")

tests/test_beans_logging.py

@@ -1,67 +0,0 @@
-# -*- coding: utf-8 -*-
-
-import pytest
-
-from beans_logging import Logger, LoggerConfigPM, LoggerLoader
-
-
-@pytest.fixture
-def logger_loader():
-    _logger_loader = LoggerLoader()
-
-    yield _logger_loader
-
-    del _logger_loader
-
-
-@pytest.fixture
-def logger():
-    from beans_logging import logger
-
-    yield logger
-
-    del logger
-
-
-def test_init(logger: Logger, logger_loader: LoggerLoader):
-    logger.info("Testing initialization of 'LoggerLoader'...")
-
-    assert isinstance(logger_loader, LoggerLoader)
-    assert logger_loader.handlers_map == {"default": 0}
-    assert logger_loader.config_file_path == LoggerLoader._CONFIG_FILE_PATH
-    assert isinstance(logger_loader.config, LoggerConfigPM)
-
-    logger.success("Done: Initialization of 'LoggerLoader'.\n")
-
-
-def test_load(logger: Logger, logger_loader: LoggerLoader):
-    logger.info("Testing 'load' method of 'LoggerLoader'...")
-
-    logger_loader.update_config(config={"level": "TRACE"})
-    _logger: Logger = logger_loader.load()
-
-    assert isinstance(_logger, Logger)
-    assert _logger == logger
-    _logger.trace("Tracing...")
-    _logger.debug("Debugging...")
-    _logger.info("Logging info.")
-    _logger.success("Success.")
-    _logger.warning("Warning something.")
-    _logger.error("Error occured.")
-    _logger.critical("CRITICAL ERROR.")
-
-    logger.success("Done: 'load' method.\n")
-
-
-def test_methods(logger: Logger):
-    logger.info("Testing 'logger' methods...")
-
-    logger.trace("Tracing...")
-    logger.debug("Debugging...")
-    logger.info("Logging info.")
-    logger.success("Success.")
-    logger.warning("Warning something.")
-    logger.error("Error occured.")
-    logger.critical("CRITICAL ERROR.")
-
-    logger.success("Done: 'logger' methods.\n")