miu-logger 0.1.0__py3-none-any.whl

miu_logger/__init__.py

@@ -0,0 +1,5 @@
+from .repository import LoggingRepository
+from .config import LogConfig
+from .listener import clear_logs
+
+__all__ = ["LoggingRepository", "LogConfig", "clear_logs"]

miu_logger/conditional.py

@@ -0,0 +1,23 @@
+import logging
+from typing import Callable
+
+
+class ConditionalLogger:
+    def __init__(self, logger: logging.Logger, enabled_predicate: Callable[[], bool]):
+        self._logger = logger
+        self._enabled = enabled_predicate
+
+    def __getattr__(self, item):
+        attr = getattr(self._logger, item)
+
+        if not callable(attr):
+            return attr
+
+        def wrapper(*a, **kw):
+            if self._enabled():
+                return attr(*a, **kw)
+
+        return wrapper
+
+    def get_real_logger(self) -> logging.Logger:
+        return self._logger

miu_logger/config.py

@@ -0,0 +1,11 @@
+# config.py
+
+from dataclasses import dataclass
+from typing import List
+
+@dataclass
+class LogConfig:
+    log_dir: str
+    debug_enabled: bool
+    domains: List[str]
+    file_prefix: str = "logfile"

miu_logger/filters.py

@@ -0,0 +1,18 @@
+import logging
+
+
+class LoggerNameFilter(logging.Filter):
+    def __init__(self, name: str):
+        super().__init__()
+        self.name = name
+
+    def filter(self, record: logging.LogRecord) -> bool:
+        return record.name == self.name
+
+class ExactLevelFilter(logging.Filter):
+    def __init__(self, level: int):
+        super().__init__()
+        self.level = level
+
+    def filter(self, record: logging.LogRecord) -> bool:
+        return record.levelno == self.level

miu_logger/formatters.py

@@ -0,0 +1,26 @@
+import logging
+import colorama
+from colorama import Fore, Style
+from copy import copy
+
+colorama.init(autoreset=True)
+
+
+class ColoredFormatter(logging.Formatter):
+    LEVEL_COLORS = {
+        logging.DEBUG: Fore.BLUE,
+        logging.INFO: Fore.GREEN,
+        logging.WARNING: Fore.YELLOW,
+        logging.ERROR: Fore.RED,
+        logging.CRITICAL: Fore.MAGENTA,
+    }
+
+    def format(self, record: logging.LogRecord) -> str:
+        record_copy = copy(record)
+
+        color = self.LEVEL_COLORS.get(record_copy.levelno, "")
+        record_copy.levelname = (
+            f"{color}{record_copy.levelname}{Style.RESET_ALL}"
+        )
+
+        return super().format(record_copy)

miu_logger/listener.py

@@ -0,0 +1,106 @@
+import logging
+import os
+import sys
+import traceback
+from multiprocessing import Queue
+from logging.handlers import RotatingFileHandler, QueueListener
+
+from .formatters import ColoredFormatter
+from .filters import LoggerNameFilter, ExactLevelFilter
+from .config import LogConfig
+
+
+DEFAULT_FORMATTER = logging.Formatter(
+    fmt="%(asctime)s - %(processName)s - %(threadName)s - %(name)s - %(levelname)s - %(message)s",
+    datefmt="%Y-%m-%d %H:%M:%S",
+)
+
+FILE_MAX_BYTES = 10 * 1024 * 1024
+FILE_BACKUP_COUNT = 5
+
+
+def _make_file_handler(path: str, level: int) -> logging.Handler:
+    handler = RotatingFileHandler(
+        path,
+        maxBytes=FILE_MAX_BYTES,
+        backupCount=FILE_BACKUP_COUNT,
+        encoding="utf-8",
+    )
+    handler.setLevel(level)
+    handler.setFormatter(DEFAULT_FORMATTER)
+    return handler
+
+
+def _make_stream_handler(level: int) -> logging.Handler:
+    handler = logging.StreamHandler(sys.stdout)
+    handler.setLevel(level)
+    handler.setFormatter(
+        ColoredFormatter(DEFAULT_FORMATTER._fmt, DEFAULT_FORMATTER.datefmt)
+    )
+    return handler
+
+
+class SafeQueueListener(QueueListener):
+    def _monitor(self):
+        try:
+            super()._monitor()
+        except (EOFError, OSError):
+            return
+        except Exception:
+            traceback.print_exc()
+            raise
+
+
+def setup_main_listener(config: LogConfig):
+    os.makedirs(config.log_dir, exist_ok=True)
+
+    queue = Queue(-1)
+    handlers: list[logging.Handler] = []
+
+    # ─────────────────────────────
+    # Domain log files
+    # ─────────────────────────────
+    for domain in config.domains:
+        filename = (
+            f"{config.file_prefix}.{domain}.log"
+            if config.file_prefix
+            else f"{domain}.log"
+        )
+
+        path = os.path.join(config.log_dir, filename)
+        fh = _make_file_handler(path, logging.DEBUG)
+        fh.addFilter(LoggerNameFilter(domain))
+        handlers.append(fh)
+
+    # ─────────────────────────────
+    # Level log files
+    # ─────────────────────────────
+    for lvl in (logging.DEBUG, logging.INFO, logging.WARNING, logging.ERROR):
+        level_name = logging.getLevelName(lvl).lower()
+
+        filename = (
+            f"{config.file_prefix}.{level_name}.log"
+            if config.file_prefix
+            else f"{level_name}.log"
+        )
+
+        path = os.path.join(config.log_dir, filename)
+        fh = _make_file_handler(path, lvl)
+        fh.addFilter(ExactLevelFilter(lvl))
+        handlers.append(fh)
+
+    # ─────────────────────────────
+    # Console
+    # ─────────────────────────────
+    handlers.append(_make_stream_handler(logging.DEBUG))
+
+    listener = SafeQueueListener(queue, *handlers, respect_handler_level=True)
+    listener.start()
+
+    return queue, listener
+
+
+def clear_logs(config: LogConfig):
+    for file in os.listdir(config.log_dir):
+        if file.endswith(".log"):
+            open(os.path.join(config.log_dir, file), "w").close()

miu_logger/logger_factory.py

@@ -0,0 +1,14 @@
+import logging
+from logging.handlers import QueueHandler
+
+
+def get_logger(name: str, level: int, queue) -> logging.Logger:
+    logger = logging.getLogger(name)
+    logger.setLevel(level)
+    logger.handlers.clear()
+    logger.propagate = False
+
+    qh = QueueHandler(queue)
+    logger.addHandler(qh)
+
+    return logger

miu_logger/repository.py

@@ -0,0 +1,76 @@
+import atexit
+from typing import Dict
+import logging
+
+from .config import LogConfig
+from .listener import setup_main_listener
+from .logger_factory import get_logger
+from .conditional import ConditionalLogger
+
+
+class LoggingRepository:
+    def __init__(self, config: LogConfig, *, use_listener: bool = True, queue=None):
+        self._is_shutdown = False
+        self.config = config
+        self.listener = None
+
+        self._domains = set(config.domains)
+        self._loggers: Dict[str, ConditionalLogger] = {}
+
+        if use_listener:
+            self.queue, self.listener = setup_main_listener(config)
+        else:
+            if queue is None:
+                raise ValueError("queue required when use_listener=False")
+            self.queue = queue
+
+        atexit.register(self.shutdown)
+
+    # ---------- domain access ----------
+
+    def _create_domain_logger(self, domain: str) -> ConditionalLogger:
+        if domain in self._loggers:
+            return self._loggers[domain]
+
+        base = get_logger(domain, logging.DEBUG, self.queue)
+        wrapped = ConditionalLogger(base, lambda: self.config.debug_enabled)
+
+        self._loggers[domain] = wrapped
+        return wrapped
+
+    def __getattr__(self, item: str) -> ConditionalLogger:
+        if item in self._domains:
+            logger = self._create_domain_logger(item)
+            setattr(self, item, logger)
+            return logger
+        raise AttributeError(item)
+
+    def get(self, domain: str) -> ConditionalLogger:
+        if domain not in self._domains:
+            raise ValueError(f"Unknown log domain: {domain}")
+        return self._create_domain_logger(domain)
+
+    # ---------- infra ----------
+
+    def get_queue(self):
+        return self.queue
+
+    def shutdown(self):
+        if getattr(self, "_is_shutdown", False):
+            return
+
+        self._is_shutdown = True
+
+        if self.listener and getattr(self.listener, "_thread", None):
+            try:
+                self.listener.stop()
+            except Exception:
+                pass
+
+    # ---------- pickle support ----------
+
+    def __getstate__(self):
+        return {"config": self.config, "queue": self.queue}
+
+    def __setstate__(self, state):
+        self.__init__(state["config"], use_listener=False, queue=state["queue"])

miu_logger-0.1.0.dist-info/METADATA

@@ -0,0 +1,10 @@
+Metadata-Version: 2.4
+Name: miu-logger
+Version: 0.1.0
+Summary: Multiprocessing-safe structured logging framework
+Author: Bruno Miura
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: colorama
+Dynamic: license-file

miu_logger-0.1.0.dist-info/RECORD

@@ -0,0 +1,13 @@
+miu_logger/__init__.py,sha256=QdFaE_rX7MdtjGuBI6nTvBoDpgcl4W4iRWkxMDbtUJg,165
+miu_logger/conditional.py,sha256=j0XnxF7diXCvovhJlRMf7gKGtP1UOK72J5WXVYe6L7M,566
+miu_logger/config.py,sha256=JyBDoSHMA4-BZT2ZnB2-978IoIPsn495OU6QsxUjlyA,197
+miu_logger/filters.py,sha256=CPPjDzlrB07Ku4QxsuYl87RetzppwJTcVml657O6y68,475
+miu_logger/formatters.py,sha256=JshOwo4B0mT241ElCAs6nN-_IF_SgcZwmDt7k7tibuo,675
+miu_logger/listener.py,sha256=ZBw8i-f-pouPdnuw-DXEKS4ZvWIHoUtiAPMzsIomj4g,3301
+miu_logger/logger_factory.py,sha256=MhNaP73J9RbhmmVR6simqkZRCel2g6rPImRlijYAQXI,319
+miu_logger/repository.py,sha256=XQPkJjuYzUKNiNUmPSxRd2CygdKThB_PHIyq0WTFkic,2288
+miu_logger-0.1.0.dist-info/licenses/LICENSE,sha256=jLLem0QFpsFv7Lkgp7I7FeN4DIdgCKIxzklfdkkesWg,1075
+miu_logger-0.1.0.dist-info/METADATA,sha256=QlWdb9LomoTwTDmsy3EG4OUrpMyNFeV11nVD0ArB9yE,265
+miu_logger-0.1.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+miu_logger-0.1.0.dist-info/top_level.txt,sha256=70Nuj1YRYLMkqiRZv1pPZPhi_VystPGqm1nC3s-uHz4,11
+miu_logger-0.1.0.dist-info/RECORD,,

miu_logger-0.1.0.dist-info/WHEEL

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

miu_logger-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2026 Bruno Miura
+
+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.

miu_logger-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+miu_logger