beans-logging 5.0.0__py3-none-any.whl → 6.0.1__py3-none-any.whl

beans_logging-5.0.0.dist-info/METADATA

@@ -1,469 +0,0 @@
-Metadata-Version: 2.1
-Name: beans-logging
-Version: 5.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/v5.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
-
-# 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**
-- **FastAPI** HTTP access logging **middleware**
-- **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
-```
-
-### **Advanced (FastAPI)**
-
-[**`configs/logger.yml`**](https://github.com/bybatkhuu/module.python-logging/blob/main/examples/advanced/configs/logger.yml):
-
-```yaml
-logger:
-  app_name: "fastapi-app"
-  level: "TRACE"
-  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: true
-      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: true
-      use_custom: false
-      log_path: "json/{app_name}.json.all.log"
-      err_path: "json/{app_name}.json.err.log"
-  intercept:
-    auto_load:
-      enabled: true
-      only_base: false
-      ignore_modules: []
-    include_modules: []
-    mute_modules: ["uvicorn.access", "uvicorn.error"]
-  extra:
-    http_std_debug_format: '<n>[{request_id}]</n> {client_host} {user_id} "<u>{method} {url_path}</u> HTTP/{http_version}"'
-    http_std_msg_format: '<n><w>[{request_id}]</w></n> {client_host} {user_id} "<u>{method} {url_path}</u> HTTP/{http_version}" {status_code} {content_length}B {response_time}ms'
-    http_file_enabled: true
-    http_log_path: "http/{app_name}.http.access.log"
-    http_err_path: "http/{app_name}.http.err.log"
-    http_json_enabled: true
-    http_json_path: "json.http/{app_name}.json.http.access.log"
-    http_json_err_path: "json.http/{app_name}.json.http.err.log"
-```
-
-[**`.env`**](https://github.com/bybatkhuu/module.python-logging/blob/main/examples/advanced/.env):
-
-```sh
-ENV=development
-DEBUG=true
-```
-
-[**`logger.py`**](https://github.com/bybatkhuu/module.python-logging/blob/main/examples/advanced/logger.py):
-
-```python
-from beans_logging import Logger, LoggerLoader
-from beans_logging.fastapi import add_http_file_handler, add_http_file_json_handler
-
-
-logger_loader = LoggerLoader()
-logger: Logger = logger_loader.load()
-
-if logger_loader.config.extra.http_file_enabled:
-    add_http_file_handler(
-        logger_loader=logger_loader,
-        log_path=logger_loader.config.extra.http_log_path,
-        err_path=logger_loader.config.extra.http_err_path,
-    )
-
-if logger_loader.config.extra.http_json_enabled:
-    add_http_file_json_handler(
-        logger_loader=logger_loader,
-        log_path=logger_loader.config.extra.http_json_path,
-        err_path=logger_loader.config.extra.http_json_err_path,
-    )
-```
-
-[**`main.py`**](https://github.com/bybatkhuu/module.python-logging/blob/main/examples/advanced/main.py):
-
-```python
-from typing import Union
-from contextlib import asynccontextmanager
-
-from dotenv import load_dotenv
-from fastapi import FastAPI, HTTPException
-from fastapi.responses import RedirectResponse
-
-load_dotenv()
-
-from beans_logging.fastapi import HttpAccessLogMiddleware
-
-from logger import logger, logger_loader
-from __version__ import __version__
-
-
-@asynccontextmanager
-async def lifespan(app: FastAPI):
-    logger.info("Preparing to startup...")
-    logger.success("Finished preparation to startup.")
-    logger.info(f"API version: {__version__}")
-
-    yield
-    logger.info("Praparing to shutdown...")
-    logger.success("Finished preparation to shutdown.")
-
-app = FastAPI(lifespan=lifespan, version=__version__)
-app.add_middleware(
-    HttpAccessLogMiddleware,
-    has_proxy_headers=True,
-    debug_format=logger_loader.config.extra.http_std_debug_format,
-    msg_format=logger_loader.config.extra.http_std_msg_format,
-)
-
-@app.get("/")
-def root():
-    return {"Hello": "World"}
-```
-
-Run the [**`examples/advanced`**](https://github.com/bybatkhuu/module.python-logging/tree/main/examples/advanced):
-
-```sh
-cd ./examples/advanced
-# Install python dependencies for examples:
-pip install -r ./requirements.txt
-
-uvicorn main:app --host=0.0.0.0 --port=8000
-```
-
-**Output**:
-
-```txt
-[2023-09-01 00:00:00.000 +09:00 | TRACE | beans_logging._base:576]: Intercepted modules: ['watchfiles.watcher', 'dotenv', 'asyncio', 'dotenv.main', 'watchfiles.main', 'concurrent.futures', 'uvicorn', 'fastapi', 'concurrent', 'watchfiles']; Muted modules: ['uvicorn.access', 'uvicorn.error'];
-[2023-09-01 00:00:00.000 +09:00 | INFO  | uvicorn.server:76]: Started server process [17146]
-[2023-09-01 00:00:00.000 +09:00 | INFO  | uvicorn.lifespan.on:46]: Waiting for application startup.
-[2023-09-01 00:00:00.000 +09:00 | INFO  | main:21]: Preparing to startup...
-[2023-09-01 00:00:00.000 +09:00 | OK    | main:22]: Finished preparation to startup.
-[2023-09-01 00:00:00.000 +09:00 | INFO  | main:23]: API version: 0.0.1-000000
-[2023-09-01 00:00:00.000 +09:00 | INFO  | uvicorn.lifespan.on:60]: Application startup complete.
-[2023-09-01 00:00:00.000 +09:00 | INFO  | uvicorn.server:218]: Uvicorn running on http://0.0.0.0:9000 (Press CTRL+C to quit)
-[2023-09-01 00:00:00.000 +09:00 | DEBUG | anyio._backends._asyncio:833]: [f635ebbc3f2348db9dcff681be1bd52a] 127.0.0.1 - "GET / HTTP/1.1"
-[2023-09-01 00:00:00.000 +09:00 | OK    | anyio._backends._asyncio:833]: [f635ebbc3f2348db9dcff681be1bd52a] 127.0.0.1 - "GET / HTTP/1.1" 200 17B 0.7ms
-^C[2023-09-01 00:00:00.000 +09:00 | INFO  | uvicorn.server:264]: Shutting down
-[2023-09-01 00:00:00.000 +09:00 | INFO  | uvicorn.lifespan.on:65]: Waiting for application shutdown.
-[2023-09-01 00:00:00.000 +09:00 | INFO  | main:26]: Praparing to shutdown...
-[2023-09-01 00:00:00.000 +09:00 | OK    | main:27]: Finished preparation to shutdown.
-[2023-09-01 00:00:00.000 +09:00 | INFO  | uvicorn.lifespan.on:76]: Application shutdown complete.
-[2023-09-01 00:00:00.000 +09:00 | INFO  | uvicorn.server:86]: Finished server process [17146]
-```
-
----
-
-## 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>

beans_logging-5.0.0.dist-info/RECORD

@@ -1,25 +0,0 @@
-beans_logging/__init__.py,sha256=TxuozMCLvGkG7sATP2uFCQws6TRqwp36yc08zUVGcb4,297
-beans_logging/__version__.py,sha256=K0fs4J5NJ5WU4JVVBd7HB1kDa9KbSFtg4q_yyI8M-pg,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
-beans_logging/fastapi/__init__.py,sha256=rK10G__Ery8lTujJLkRjLO_OTJX8o0QLAf5xNRKrXhw,248
-beans_logging/fastapi/_filters.py,sha256=BNkIxCW1_GkmrpZdIH7SsP69_p989_ru0kjjBB7LKzg,509
-beans_logging/fastapi/_formats.py,sha256=xyz8fiultiB4SVOnvxt-6kW3nb3LsIv-3YeKbJj-xmg,1727
-beans_logging/fastapi/_handlers.py,sha256=eoV-fDKgmZHBV3IfcV01rirH29Devd8DqnvTgzZCZpc,2726
-beans_logging/fastapi/_middlewares.py,sha256=UkFrpKP8XbtXE2lJU7F3N0XuJF48awkL7CCdNtf657I,11315
-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-5.0.0.dist-info/LICENSE.txt,sha256=8jrXqC7FZbke39LPGo_mUFR81CkoUCP_vyefZjlQDOg,1074
-beans_logging-5.0.0.dist-info/METADATA,sha256=PWKVVgAIsDcWto2ntWhC_2tRZDtisu6bUD2pnIxk0UU,15296
-beans_logging-5.0.0.dist-info/WHEEL,sha256=Xo9-1PvkuimrydujYJAjF7pCkriuXBpUPEjma1nZyJ0,92
-beans_logging-5.0.0.dist-info/top_level.txt,sha256=wSVo6vZwIqyOwwsbVBQceBQ_VJKuErw8OQvDiHcp8uU,20
-beans_logging-5.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")