log21 2.7.1__tar.gz → 2.8.1__tar.gz

{log21-2.7.1 → log21-2.8.1}/LICENSE.txt

@@ -186,7 +186,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright [2021-2023] [CodeWriter21]
+   Copyright [2021-2024] [CodeWriter21]
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

{log21-2.7.1 → log21-2.8.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: log21
-Version: 2.7.1
+Version: 2.8.1
 Summary: A simple logging package that helps you log colorized messages in Windows console.
 Author-email: "CodeWriter21(Mehrad Pooryoussof)" <CodeWriter21@gmail.com>
 License: Apache License 2.0
@@ -16,7 +16,7 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Operating System :: Unix
 Classifier: Operating System :: Microsoft :: Windows
 Classifier: Operating System :: MacOS :: MacOS X
-Requires-Python: >=3.7
+Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE.txt
 Requires-Dist: webcolors
@@ -49,7 +49,7 @@ Features
   modifications. It can also decolorize the output if you want to log into a file.
 + Pretty printing : Have you ever wanted to colorize the output of the pprint module? log21's pretty printer can do
   that.
-+ Tree printing : You can pass a dict or list to log21.tree_print function and it will print it in a tree-like
++ Tree printing : You can pass a dict or list to `log21.tree_print` function and it will print it in a tree-like
   structure. It's also colorized XD.
 + ProgressBar : log21's progress bar can be used to show progress of a process in a beautiful way.
 + LoggingWindow : Helps you to log messages and debug your code in a window other than the console.
@@ -92,9 +92,12 @@ pip install git+https://github.com/MPCodeWriter21/log21
 Changes
 -------
 
-### 2.7.1
+### 2.8.1
 
-+ Improved compatibility
++ Fixed Carriage Return Handling.
++ Fixed setting level using `log21.basic_config`
++ Added more configuration for developer tools to the `pyproject.toml` file.
++ Added pre-commit.
 
 [Full CHANGELOG](https://github.com/MPCodeWriter21/log21/blob/master/CHANGELOG.md)
 
@@ -233,7 +236,7 @@ for character in text:
 
 window.error(colored_text)
 
-# See more examples in 
+# See more examples in
 # https://github.com/MPCodeWriter21/log21/blob/066efc1e72542531012d36974bbf6cd4c5941378/log21/LoggingWindow.py#L155
 # and
 # https://github.com/MPCodeWriter21/log21/blob/066efc1e72542531012d36974bbf6cd4c5941378/log21/__init__.py#L144

{log21-2.7.1 → log21-2.8.1}/README.md

@@ -18,7 +18,7 @@ Features
   modifications. It can also decolorize the output if you want to log into a file.
 + Pretty printing : Have you ever wanted to colorize the output of the pprint module? log21's pretty printer can do
   that.
-+ Tree printing : You can pass a dict or list to log21.tree_print function and it will print it in a tree-like
++ Tree printing : You can pass a dict or list to `log21.tree_print` function and it will print it in a tree-like
   structure. It's also colorized XD.
 + ProgressBar : log21's progress bar can be used to show progress of a process in a beautiful way.
 + LoggingWindow : Helps you to log messages and debug your code in a window other than the console.
@@ -61,9 +61,12 @@ pip install git+https://github.com/MPCodeWriter21/log21
 Changes
 -------
 
-### 2.7.1
+### 2.8.1
 
-+ Improved compatibility
++ Fixed Carriage Return Handling.
++ Fixed setting level using `log21.basic_config`
++ Added more configuration for developer tools to the `pyproject.toml` file.
++ Added pre-commit.
 
 [Full CHANGELOG](https://github.com/MPCodeWriter21/log21/blob/master/CHANGELOG.md)
 
@@ -202,7 +205,7 @@ for character in text:
 
 window.error(colored_text)
 
-# See more examples in 
+# See more examples in
 # https://github.com/MPCodeWriter21/log21/blob/066efc1e72542531012d36974bbf6cd4c5941378/log21/LoggingWindow.py#L155
 # and
 # https://github.com/MPCodeWriter21/log21/blob/066efc1e72542531012d36974bbf6cd4c5941378/log21/__init__.py#L144

{log21-2.7.1 → log21-2.8.1}/pyproject.toml

@@ -9,7 +9,7 @@ authors = [
 ]
 description = "A simple logging package that helps you log colorized messages in Windows console."
 readme = {file = "README.md", content-type = "text/markdown"}
-requires-python = ">=3.7"
+requires-python = ">=3.8"
 keywords = ['python', 'log', 'colorize', 'color', 'logging', 'Python3', 'CodeWriter21']
 license = {text = "Apache License 2.0"}
 classifiers = [
@@ -26,7 +26,7 @@ dependencies = [
   "webcolors",
   "docstring-parser"
 ]
-version = "2.7.1"
+version = "2.8.1"
 
 [tool.setuptools.packages.find]
 where = ["src"]
@@ -43,9 +43,9 @@ dev = ["yapf", "isort", "docformatter", "pylint", "json5", "pytest"]
 max-line-length = 88
 
 disable = [
-  "protected-access",
   "too-few-public-methods",
   "too-many-arguments",
+  "protected-access",
   "too-many-locals",
   "fixme",
 ]
@@ -62,4 +62,10 @@ dedent_closing_brackets = true
 [tool.isort]
 line_length = 88
 combine_as_imports = true
+length_sort = true
 order_by_type = true
+
+[tool.docformatter]
+recursive = true
+wrap-summaries = 88
+wrap-descriptions = 88

{log21-2.7.1 → log21-2.8.1}/src/log21/Argparse.py

@@ -572,7 +572,8 @@ class _ActionsContainer(_argparse._ActionsContainer):
         # Handle `Required` as a type (e.g. `Required[int]`)
         elif (hasattr(_typing, 'Required') and hasattr(_typing, '_GenericAlias')
               and isinstance(func_type, _typing._GenericAlias)  # type: ignore
-              and func_type.__origin__ is _typing.Required):
+              and func_type.__origin__ is _typing.Required
+              ):
             func_type = func_type.__args__[0]
             action.required = True
 
@@ -754,7 +755,8 @@ class ColorizingArgumentParser(_argparse.ArgumentParser, _ActionsContainer):
             return self.formatter_class(prog=self.prog)
 
     def _get_value(self, action, arg_string):
-        """Override _get_value to add support for types such as Union and Literal."""
+        """Override _get_value to add support for types such as Union and
+        Literal."""
 
         func_type = self._registry_get('type', action.type, action.type)
         if not callable(func_type) and not isinstance(func_type, tuple):

{log21-2.7.1 → log21-2.8.1}/src/log21/Logger.py

@@ -1,9 +1,11 @@
 # log21.Logger.py
 # CodeWriter21
 
+import re as _re
 import logging as _logging
-from typing import (Union as _Union, Callable as _Callable, Optional as _Optional,
-                    Sequence as _Sequence)
+from types import MethodType as _MethodType
+from typing import (Union as _Union, Literal as _Literal, Mapping,
+                    Callable as _Callable, Optional as _Optional, Sequence as _Sequence)
 from getpass import getpass as _getpass
 from logging import raiseExceptions as _raiseExceptions
 
@@ -51,11 +53,10 @@ class Logger(_logging.Logger):
     def log(self, level: int, *msg, args: tuple = (), end='\n', **kwargs):
         """Log 'msg % args' with the integer severity 'level'.
 
-        To pass exception information, use the keyword argument exc_info
-        with a true value, e.g.
+        To pass exception information, use the keyword argument exc_info with a true
+        value, e.g.
 
-        logger.log(level, "We have a %s", args=("mysterious problem",),
-        exc_info=1)
+        logger.log(level, "We have a %s", args=("mysterious problem",), exc_info=1)
         """
         msg = ' '.join([str(m) for m in msg]) + end
         if not isinstance(level, int):
@@ -68,11 +69,10 @@ class Logger(_logging.Logger):
     def debug(self, *msg, args: tuple = (), end='\n', **kwargs):
         """Log 'msg % args' with severity 'DEBUG'.
 
-        To pass exception information, use the keyword argument exc_info
-        with a true value, e.g.
+        To pass exception information, use the keyword argument exc_info with a true
+        value, e.g.
 
-        logger.debug("Houston, we have a %s", args=("thorny problem",),
-        exc_info=1)
+        logger.debug("Houston, we have a %s", args=("thorny problem",), exc_info=1)
         """
         if self.isEnabledFor(DEBUG):
             msg = ' '.join([str(m) for m in msg]) + end
@@ -81,11 +81,10 @@ class Logger(_logging.Logger):
     def info(self, *msg, args: tuple = (), end='\n', **kwargs):
         """Log 'msg % args' with severity 'INFO'.
 
-        To pass exception information, use the keyword argument exc_info
-        with a true value, e.g.
+        To pass exception information, use the keyword argument exc_info with a true
+        value, e.g.
 
-        logger.info("Houston, we have an %s", args=("interesting
-        problem",), exc_info=1)
+        logger.info("Houston, we have an %s", args=("interesting problem",), exc_info=1)
         """
         if self.isEnabledFor(INFO):
             msg = ' '.join([str(m) for m in msg]) + end
@@ -94,11 +93,10 @@ class Logger(_logging.Logger):
     def warning(self, *msg, args: tuple = (), end='\n', **kwargs):
         """Log 'msg % args' with severity 'WARNING'.
 
-        To pass exception information, use the keyword argument exc_info
-        with a true value, e.g.
+        To pass exception information, use the keyword argument exc_info with a true
+        value, e.g.
 
-        logger.warning("Houston, we have a %s", args=("bit of a
-        problem",), exc_info=1)
+        logger.warning("Houston, we have a %s", args=("bit of a problem",), exc_info=1)
         """
         if self.isEnabledFor(WARNING):
             msg = ' '.join([str(m) for m in msg]) + end
@@ -109,11 +107,10 @@ class Logger(_logging.Logger):
     def write(self, *msg, args: tuple = (), end='', **kwargs):
         """Log 'msg % args' with severity 'WARNING'.
 
-        To pass exception information, use the keyword argument exc_info
-        with a true value, e.g.
+        To pass exception information, use the keyword argument exc_info with a true
+        value, e.g.
 
-        logger.write("Houston, we have a %s", args=("bit of a
-        problem",), exc_info=1)
+        logger.write("Houston, we have a %s", args=("bit of a problem",), exc_info=1)
         """
         if self.isEnabledFor(WARNING):
             msg = ' '.join([str(m) for m in msg]) + end
@@ -122,29 +119,26 @@ class Logger(_logging.Logger):
     def error(self, *msg, args: tuple = (), end='\n', **kwargs):
         """Log 'msg % args' with severity 'ERROR'.
 
-        To pass exception information, use the keyword argument exc_info
-        with a true value, e.g.
+        To pass exception information, use the keyword argument exc_info with a true
+        value, e.g.
 
-        logger.error("Houston, we have a %s", args=("major problem",),
-        exc_info=1)
+        logger.error("Houston, we have a %s", args=("major problem",), exc_info=1)
         """
         if self.isEnabledFor(ERROR):
             msg = ' '.join([str(m) for m in msg]) + end
             self._log(ERROR, msg, args, **kwargs)
 
     def exception(self, *msg, args: tuple = (), exc_info=True, **kwargs):
-        """Convenience method for logging an ERROR with exception
-        information."""
+        """Convenience method for logging an ERROR with exception information."""
         self.error(*msg, args=args, exc_info=exc_info, **kwargs)
 
     def critical(self, *msg, args: tuple = (), end='\n', **kwargs):
         """Log 'msg % args' with severity 'CRITICAL'.
 
-        To pass exception information, use the keyword argument exc_info
-        with a true value, e.g.
+        To pass exception information, use the keyword argument exc_info with a true
+        value, e.g.
 
-        logger.critical("Houston, we have a %s", args=("major
-        disaster",), exc_info=1)
+        logger.critical("Houston, we have a %s", args=("major disaster",), exc_info=1)
         """
         if self.isEnabledFor(CRITICAL):
             msg = ' '.join([str(m) for m in msg]) + end
@@ -155,11 +149,10 @@ class Logger(_logging.Logger):
     def print(self, *msg, args: tuple = (), end='\n', **kwargs):
         """Log 'msg % args'.
 
-        To pass exception information, use the keyword argument exc_info
-        with a true value, e.g.
+        To pass exception information, use the keyword argument exc_info with a true
+        value, e.g.
 
-        logger.print("Houston, we have a %s", args=("major disaster",),
-        exc_info=1)
+        logger.print("Houston, we have a %s", args=("major disaster",), exc_info=1)
         """
         msg = ' '.join([str(m) for m in msg]) + end
         self._log(PRINT, msg, args, **kwargs)
@@ -167,8 +160,8 @@ class Logger(_logging.Logger):
     def input(self, *msg, args: tuple = (), end='', **kwargs):
         """Log 'msg % args'.
 
-        To pass exception information, use the keyword argument exc_info
-        with a true value, e.g.
+        To pass exception information, use the keyword argument exc_info with a true
+        value, e.g.
 
         age = logger.input("Enter your age: ")
         """
@@ -192,7 +185,10 @@ class Logger(_logging.Logger):
 
     @property
     def progress_bar(self):
-        """Return a progress bar instance. If not exists, create a new one."""
+        """Return a progress bar instance.
+
+        If not exists, create a new one.
+        """
         if not self._progress_bar:
             # avoid circular import; pylint: disable=import-outside-toplevel
             from log21.ProgressBar import ProgressBar
@@ -211,4 +207,94 @@ class Logger(_logging.Logger):
         """
         for handler in self.handlers:
             if isinstance(getattr(handler, 'clear_line', None), _Callable):
-                handler.clear_line(length)
+                handler.clear_line(length)  # type: ignore
+
+    def add_level(
+        self,
+        level: int,
+        name: str,
+        errors: _Literal["raise", "ignore", "handle", "force"] = "raise"
+    ) -> str:
+        """Adds a new method to the logger with a specific level and name.
+
+        :param level: The level of the new method.
+        :param name: The name of the new method.
+        :param errors: The action to take if the level already exists.
+            + ``raise`` (default): Raise an exception if anything goes wrong.
+            + ``ignore``: Do nothing.
+            + ``handle``: Handle the situation if a method with the same ``name``
+              already exists. Adds a number to the name to avoid the conflict.
+            + ``force``: Add the new level with the specified level even if a
+              method with the same ``name`` already exists.
+        :raises TypeError: If ``level`` is not an integer.
+        :raises TypeError: If ``name`` is not a string.
+        :raises ValueError: If ``errors`` is not one of "raise", "ignore", "handle",
+            or "force".
+        :raises ValueError: If ``name`` starts with a number.
+        :raises ValueError: If ``name`` is not a valid identifier.
+        :raises AttributeError: If ``errors`` is "raise" and a method with the
+            same ``name`` already exists.
+        :return: The name of the new method.
+        """
+
+        def raise_(error: BaseException):
+            if errors == 'ignore':
+                return
+            raise error
+
+        if not isinstance(level, int):
+            raise_(TypeError('level must be an integer'))
+        if not isinstance(name, str):
+            raise_(TypeError('name must be a string'))
+        if errors not in ('raise', 'ignore', 'handle', 'force'):
+            raise_(
+                ValueError(
+                    'errors must be one of "raise", "ignore", "handle", "force"'
+                )
+            )
+
+        name = _re.sub(r'\s', '_', name)
+        if _re.match(r'[0-9].*', name):
+            raise_(ValueError(f'level name cannot start with a number: "{name}"'))
+        if not _re.fullmatch(r'[a-zA-Z_][a-zA-Z0-9_]*', name):
+            raise_(ValueError(f'level name must be a valid identifier: "{name}"'))
+
+        if hasattr(self, name):
+            if errors == 'raise':
+                raise AttributeError(f'level "{name}" already exists')
+            if errors == 'ignore':
+                return name
+            if errors == 'handle':
+                return self.add_level(level, _add_one(name), errors)
+
+        def log_for_level(self, *msg, args: tuple = (), end='\n', **kwargs):
+            self.log(level, *msg, args=args, end=end, **kwargs)
+
+        setattr(self, name, _MethodType(log_for_level, self))
+        return name
+
+    def add_levels(
+        self,
+        level_names: Mapping[int, str],
+        errors: _Literal["raise", "ignore", "handle", "force"] = "raise"
+    ) -> None:
+        """Adds new methods to the logger with specific levels and names.
+
+        :param level_names: A mapping of levels to names.
+        :param errors: The action to take if the level already exists
+        :return:
+        """
+        for level, name in level_names.items():
+            self.add_level(level, name, errors)
+
+
+def _add_one(name: str) -> str:
+    """Add one to the end of a string.
+
+    :param name: The string to add one to.
+    :return: The string with one added to the end.
+    """
+    match = _re.match(r'([\S]+)_([0-9]+)', name)
+    if not match:
+        return name + '_1'
+    return f'{match.group(1)}{int(match.group(2)) + 1}'

{log21-2.7.1 → log21-2.8.1}/src/log21/StreamHandler.py

@@ -53,7 +53,7 @@ class StreamHandler(_StreamHandler):
             msg = _hex_escape.sub(
                 '', _ansi_escape.sub('', record.msg.strip(' \t\n\x0b\x0c'))
             )
-            if '\r' in msg[1:-1]:
+            if '\r' == msg[:1]:
                 file_descriptor = getattr(self.stream, 'fileno', None)
                 if file_descriptor:
                     file_descriptor = file_descriptor()

{log21-2.7.1 → log21-2.8.1}/src/log21/__init__.py

@@ -1,7 +1,6 @@
 # log21.__init__.py
 # CodeWriter21
 
-import io as _io
 import os as _os
 import logging as _logging
 from typing import (Type as _Type, Tuple as _Tuple, Union as _Union,
@@ -24,18 +23,17 @@ from log21.ProgressBar import ProgressBar
 from log21.LoggingWindow import LoggingWindow, LoggingWindowHandler
 from log21.StreamHandler import StreamHandler, ColorizingStreamHandler
 
-__version__ = "2.7.1"
-__author__ = "CodeWriter21 (Mehrad Pooryoussof)"
-__github__ = "Https://GitHub.com/MPCodeWriter21/log21"
+__author__ =         'CodeWriter21 (Mehrad Pooryoussof)'
+__github__ = 'Https://GitHub.com/MPCodeWriter21/log21'
 __all__ = [
     'ColorizingStreamHandler', 'DecolorizingFileHandler', 'ColorizingFormatter',
     'DecolorizingFormatter', 'get_logger', 'Logger', 'Colors', 'get_color',
     'get_colors', 'CRITICAL', 'FATAL', 'ERROR', 'WARNING', 'WARN', 'INFO', 'DEBUG',
     'NOTSET', 'INPUT', 'StreamHandler', 'ColorizingArgumentParser', 'PrettyPrinter',
     'pformat', 'pprint', 'pretty_print', 'tree_format', 'TreePrint', 'Manager',
-    'get_color_name', 'closest_color', 'ansi_escape', '__version__', '__author__',
-    '__github__', 'debug', 'info', 'warning', 'warn', 'error', 'critical', 'fatal',
-    'exception', 'log', 'basic_config', 'basicConfig', 'ProgressBar', 'progress_bar',
+    'get_color_name', 'closest_color', 'ansi_escape', '__author__', '__github__',
+    'debug', 'info', 'warning', 'warn', 'error', 'critical', 'fatal', 'exception',
+    'log', 'basic_config', 'basicConfig', 'ProgressBar', 'progress_bar',
     'LoggingWindow', 'LoggingWindowHandler', 'get_logging_window', 'CrashReporter',
     'console_reporter', 'file_reporter', 'argumentify'
 ]
@@ -47,7 +45,7 @@ _logging.setLoggerClass(Logger)
 def _prepare_formatter(
     fmt: _Optional[str] = None,
     style: str = '%',
-    datefmt: str = "%H:%M:%S",
+    datefmt: str = '%H:%M:%S',
     show_level: bool = True,
     show_time: bool = True,
     colorize_time_and_level: bool = True,
@@ -58,11 +56,11 @@ def _prepare_formatter(
     # Prepares a formatting if the fmt was None
     if not fmt:
         style = '%'
-        fmt = "%(message)s"
+        fmt = '%(message)s'
         if show_level:
-            fmt = "[%(levelname)s] " + fmt
+            fmt = '[%(levelname)s] ' + fmt
         if show_time:
-            fmt = "[%(asctime)s] " + fmt
+            fmt = '[%(asctime)s] ' + fmt
         fmt = '\r' + fmt
 
     if level_colors and not issubclass(formatter_class, ColorizingFormatter):
@@ -102,7 +100,7 @@ def get_logger(
     show_level: bool = True,
     colorize_time_and_level: bool = True,
     fmt: _Optional[str] = None,
-    datefmt: str = "%H:%M:%S",
+    datefmt: str = '%H:%M:%S',
     style: str = '%',
     handle_carriage_return: bool = True,
     handle_new_line: bool = True,
@@ -181,6 +179,8 @@ def get_logger(
         )
         handler.setFormatter(formatter)
         logger.addHandler(handler)
+        if level_names:
+            logger.add_levels(level_names, errors='ignore')
         _manager.addLogger(name, logger)
 
         if file:
@@ -208,7 +208,7 @@ def get_logging_window(
     show_level: bool = True,
     colorize_time_and_level: bool = True,
     fmt: _Optional[str] = None,
-    datefmt: str = "%H:%M:%S",
+    datefmt: str = '%H:%M:%S',
     style: str = '%',
     handle_carriage_return: bool = True,
     handle_new_line: bool = True,
@@ -420,7 +420,7 @@ def basic_config(
     stream=None,
     filename=None,
     filemode: str = 'a',
-    date_format: str = "%H:%M:%S",
+    date_format: str = '%H:%M:%S',
     style: str = '%',
     format_: _Optional[str] = None,
     level: _Optional[_Union[int, str]] = None
@@ -516,8 +516,8 @@ def basic_config(
             if handler.formatter is None:
                 handler.setFormatter(formatter)
             root.addHandler(handler)
-        if level is not None:
-            root.setLevel(level)
+    if level is not None:
+        root.setLevel(level)
 
 
 basicConfig = basic_config
@@ -628,4 +628,4 @@ def progress_bar(
 
 console_reporter = CrashReporter.ConsoleReporter()
 
-file_reporter = CrashReporter.FileReporter(file='crash_report.log')
+file_reporter = CrashReporter.FileReporter(file='.crash_report.log')

{log21-2.7.1 → log21-2.8.1}/src/log21.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: log21
-Version: 2.7.1
+Version: 2.8.1
 Summary: A simple logging package that helps you log colorized messages in Windows console.
 Author-email: "CodeWriter21(Mehrad Pooryoussof)" <CodeWriter21@gmail.com>
 License: Apache License 2.0
@@ -16,7 +16,7 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Operating System :: Unix
 Classifier: Operating System :: Microsoft :: Windows
 Classifier: Operating System :: MacOS :: MacOS X
-Requires-Python: >=3.7
+Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE.txt
 Requires-Dist: webcolors
@@ -49,7 +49,7 @@ Features
   modifications. It can also decolorize the output if you want to log into a file.
 + Pretty printing : Have you ever wanted to colorize the output of the pprint module? log21's pretty printer can do
   that.
-+ Tree printing : You can pass a dict or list to log21.tree_print function and it will print it in a tree-like
++ Tree printing : You can pass a dict or list to `log21.tree_print` function and it will print it in a tree-like
   structure. It's also colorized XD.
 + ProgressBar : log21's progress bar can be used to show progress of a process in a beautiful way.
 + LoggingWindow : Helps you to log messages and debug your code in a window other than the console.
@@ -92,9 +92,12 @@ pip install git+https://github.com/MPCodeWriter21/log21
 Changes
 -------
 
-### 2.7.1
+### 2.8.1
 
-+ Improved compatibility
++ Fixed Carriage Return Handling.
++ Fixed setting level using `log21.basic_config`
++ Added more configuration for developer tools to the `pyproject.toml` file.
++ Added pre-commit.
 
 [Full CHANGELOG](https://github.com/MPCodeWriter21/log21/blob/master/CHANGELOG.md)
 
@@ -233,7 +236,7 @@ for character in text:
 
 window.error(colored_text)
 
-# See more examples in 
+# See more examples in
 # https://github.com/MPCodeWriter21/log21/blob/066efc1e72542531012d36974bbf6cd4c5941378/log21/LoggingWindow.py#L155
 # and
 # https://github.com/MPCodeWriter21/log21/blob/066efc1e72542531012d36974bbf6cd4c5941378/log21/__init__.py#L144