simpler-logging 1.0.0__py3-none-any.whl

simpler_logging/__init__.py

@@ -0,0 +1,4 @@
+from .logger import LogLevel as LogLevel, Logger as Logger, Handler as Handler
+
+logger = Logger("Main")
+"""a global Logger instance for convenience."""

simpler_logging/logger.py

@@ -0,0 +1,161 @@
+from __future__ import annotations
+from enum import IntEnum
+from colorama import init, Fore, Style
+from datetime import datetime
+from typing import Protocol, Iterable
+
+init()
+
+class LogLevel(IntEnum):
+    """Log Levels. Includes DEBUG, INFO, WARN, ERROR, and FATAL in that severity order."""
+    DEBUG = 10
+    INFO = 20
+    WARN = 30
+    ERROR = 40
+    FATAL = 50
+
+
+class Handler(Protocol):
+    """
+    A Protocol definition for log Handlers.
+
+    Function following it is expected to be able to receive msg (str), logger_name (str), and do_color (bool).
+    """
+    def __call__(self, *, level: LogLevel, msg: str, logger_name: str, do_color: bool) -> None:
+        ...
+
+
+def main_handler(level: str, color: int | str, msg: str, logger_name: str):
+    print(f"{color}{Style.DIM}[{datetime.now().astimezone().isoformat(timespec='milliseconds')}]{color} {level} {Style.DIM}{logger_name}{color}: {msg}{Style.RESET_ALL}")
+
+def default_handler(*, level: LogLevel, msg: str, logger_name: str, do_color: bool):
+    if level == LogLevel.DEBUG:
+        main_handler("DEBUG", Fore.CYAN if do_color else "", msg, logger_name)
+    elif level == LogLevel.INFO:
+        main_handler("INFO", Fore.GREEN if do_color else "", msg, logger_name)
+    elif level == LogLevel.WARN:
+        main_handler("WARN", Fore.YELLOW if do_color else "", msg, logger_name)
+    elif level == LogLevel.ERROR:
+        main_handler("ERROR", Fore.RED if do_color else "", msg, logger_name)
+    elif level == LogLevel.FATAL:
+        main_handler("FATAL", Style.BRIGHT + Fore.LIGHTRED_EX if do_color else "", msg, logger_name)
+
+
+
+class Logger:
+    """
+    The Logger class. It comes preloaded with default Handlers for all Log Levels.
+    """
+    __slots__ = ("_name", "_enabled_levels", "_handlers", "_do_color")
+
+    def __init__(self, name: str):
+        """Create a new Logger instance."""
+        self._name = name
+        self._enabled_levels = {LogLevel.INFO, LogLevel.WARN, LogLevel.ERROR, LogLevel.FATAL}
+
+        self._handlers: dict[LogLevel, Handler] = {LogLevel.DEBUG: default_handler, LogLevel.INFO: default_handler,
+                          LogLevel.WARN: default_handler, LogLevel.ERROR: default_handler,
+                          LogLevel.FATAL: default_handler}
+        self._do_color = True
+
+    def log(self, level: LogLevel, msg: str, *args, **kwargs) -> None:
+        """Log a message taking into account the active levels. Generally you should use the dedicated per-level log methods instead."""
+        if level in self._enabled_levels:
+            self._handlers[level](
+                level=level,
+                msg=" ".join(
+                    [msg]
+                    + [str(x) for x in args]
+                    + [f"{k}={v}" for k, v in kwargs.items()]
+                ),
+                logger_name=self._name,
+                do_color=self._do_color,
+            )
+
+
+    @property
+    def name(self) -> str:
+        """Get the name of the Logger."""
+        return self._name
+
+
+    def debug(self, msg: str, *args, **kwargs) -> None:
+        """Log a debug message."""
+        self.log(LogLevel.DEBUG, msg, *args, **kwargs)
+
+
+    def info(self, msg: str, *args, **kwargs) -> None:
+        """Log an info message."""
+        self.log(LogLevel.INFO, msg, *args, **kwargs)
+
+
+    def warn(self, msg: str, *args, **kwargs) -> None:
+        """Log a warning message."""
+        self.log(LogLevel.WARN, msg, *args, **kwargs)
+
+
+    def error(self, msg: str, *args, **kwargs) -> None:
+        """Log an error message."""
+        self.log(LogLevel.ERROR, msg, *args, **kwargs)
+
+
+    def fatal(self, msg: str, *args, **kwargs) -> None:
+        """Log a fatal message."""
+        self.log(LogLevel.FATAL, msg, *args, **kwargs)
+
+
+    def set_color(self, state: bool):
+        """Change whether Handlers should use colors."""
+        self._do_color = state
+
+
+    def debug_handler(self, handler: Handler):
+        """Set the debug Handler"""
+        self._handlers[LogLevel.DEBUG] = handler
+
+
+    def info_handler(self, handler: Handler):
+        """Set the info Handler"""
+        self._handlers[LogLevel.INFO] = handler
+
+
+    def warn_handler(self, handler: Handler):
+        """Set the warn Handler"""
+        self._handlers[LogLevel.WARN] = handler
+
+
+    def error_handler(self, handler: Handler):
+        """Set the error Handler"""
+        self._handlers[LogLevel.ERROR] = handler
+
+
+    def fatal_handler(self, handler: Handler):
+        """Set the fatal Handler"""
+        self._handlers[LogLevel.FATAL] = handler
+
+
+    def enable_level(self, level: LogLevel|Iterable[LogLevel]):
+        """Enable the given Log Level or Set of Log Levels. Does nothing if the Level is already enabled."""
+        if isinstance(level, LogLevel):
+            self._enabled_levels.add(level)
+        else:
+            self._enabled_levels.update(level)
+
+
+    def disable_level(self, level: LogLevel|Iterable[LogLevel]):
+        """Disable the given Log Level or Set of Log Levels. Does nothing if the Level is already disabled."""
+        if isinstance(level, LogLevel):
+            self._enabled_levels.discard(level)
+        else:
+            self._enabled_levels.difference_update(level)
+
+
+    def toggle_level(self, level: LogLevel|Iterable[LogLevel]):
+        """Toggles the given Log Level or Set of Log Levels."""
+        lvl = {level} if isinstance(level, LogLevel) else level
+        self._enabled_levels.symmetric_difference_update(lvl)
+
+
+    def min_level(self, level: LogLevel):
+        """Set the minimum Log Level to use. Overwrites previous Log Level Configuration."""
+        self._enabled_levels = {x for x in LogLevel if x >= level}

simpler_logging-1.0.0.dist-info/METADATA

@@ -0,0 +1,25 @@
+Metadata-Version: 2.4
+Name: simpler-logging
+Version: 1.0.0
+Summary: Simple zero-setup logging.
+Keywords: logging,logger,simple,zero-setup
+Author: minoupower554
+Author-email: minoupower554 <minoupower554@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: System :: Logging
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Dist: colorama>=0.4.6
+Requires-Python: >=3.8
+Project-URL: Homepage, https://github.com/minoupower554/simpler-logging
+Project-URL: Issues, https://github.com/minoupower554/simpler-logging/issues
+Project-URL: Repository, https://github.com/minoupower554/simpler-logging
+Description-Content-Type: text/markdown
+
+This is just a simple zero-setup logging framework.

simpler_logging-1.0.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+simpler_logging/__init__.py,sha256=7ZkQgjgYiUVzuwQfhzG6l94PaiuUQ2Ri1DY15Ck2-Lg,152
+simpler_logging/logger.py,sha256=B_Gt95tchpV2vjqwSRdK6pmRsdb4DVfcwSNiknmpNZ8,5624
+simpler_logging/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+simpler_logging-1.0.0.dist-info/licenses/LICENSE,sha256=3GAyzUZsVt5GiefMrBTF6EM14mRer2plgOHeAt6kqys,1068
+simpler_logging-1.0.0.dist-info/WHEEL,sha256=eycQt0QpYmJMLKpE3X9iDk8R04v2ZF0x82ogq-zP6bQ,79
+simpler_logging-1.0.0.dist-info/METADATA,sha256=NSybLkwn3r_3_grNAEilcH0heQ0jol-drFfqHyxUeag,1025
+simpler_logging-1.0.0.dist-info/RECORD,,

simpler_logging-1.0.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: uv 0.9.24
+Root-Is-Purelib: true
+Tag: py3-none-any

simpler_logging-1.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,7 @@
+Copyright 2026 Minoupower554
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.