dlz-logger 0.1.0__tar.gz

dlz_logger-0.1.0/LICENSE

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

dlz_logger-0.1.0/PKG-INFO

@@ -0,0 +1,100 @@
+Metadata-Version: 2.4
+Name: dlz-logger
+Version: 0.1.0
+Summary: A lightweight colorful logger with optional daily rotating file output.
+Author: daliangzai
+License-Expression: MIT
+Project-URL: Homepage, https://pypi.org/project/dlz-logger/
+Keywords: logging,logger,color,console,pypi
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Logging
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# dlz-logger
+
+`dlz-logger` 是一个轻量级彩色日志库，支持控制台着色输出，以及按天切分的文件日志。
+
+## 安装
+
+```bash
+pip install dlz-logger
+```
+
+## 推荐调用方式
+
+现在可以直接省略 `__name__`：
+
+```python
+from datetime import datetime
+from colors_logger import get_logger
+
+LOG_LEVEL = 10
+
+logger = get_logger(
+    log_level=LOG_LEVEL,
+    save=True,
+    file_name=f"收费单识别-{datetime.now():%Y%m%d_%H%M%S}",
+)
+
+logger.info("开始识别")
+```
+
+## 兼容旧写法
+
+```python
+from colors_logger import LOGGER
+
+logger = LOGGER(
+    log_level=10,
+    save=True,
+    file_name="demo"
+).get_logger()
+
+logger.info("hello")
+```
+
+如果你仍然想显式传入模块名，也一样支持：
+
+```python
+logger = LOGGER(__name__, log_level=10).get_logger()
+```
+
+## 功能特性
+
+- 控制台彩色输出
+- 按天轮转文件日志
+- 自动推断调用方模块名
+- 兼容类式和函数式两种调用方式
+
+## 本地构建
+
+```bash
+python -m build
+```
+
+## 发布到 PyPI
+
+先配置 PyPI Token：
+
+```bash
+set TWINE_USERNAME=__token__
+set TWINE_PASSWORD=pypi-xxxxxxxxxxxxxxxxxxxx
+```
+
+然后执行：
+
+```bash
+python -m twine upload dist/*
+```

dlz_logger-0.1.0/README.md

@@ -0,0 +1,76 @@
+# dlz-logger
+
+`dlz-logger` 是一个轻量级彩色日志库，支持控制台着色输出，以及按天切分的文件日志。
+
+## 安装
+
+```bash
+pip install dlz-logger
+```
+
+## 推荐调用方式
+
+现在可以直接省略 `__name__`：
+
+```python
+from datetime import datetime
+from colors_logger import get_logger
+
+LOG_LEVEL = 10
+
+logger = get_logger(
+    log_level=LOG_LEVEL,
+    save=True,
+    file_name=f"收费单识别-{datetime.now():%Y%m%d_%H%M%S}",
+)
+
+logger.info("开始识别")
+```
+
+## 兼容旧写法
+
+```python
+from colors_logger import LOGGER
+
+logger = LOGGER(
+    log_level=10,
+    save=True,
+    file_name="demo"
+).get_logger()
+
+logger.info("hello")
+```
+
+如果你仍然想显式传入模块名，也一样支持：
+
+```python
+logger = LOGGER(__name__, log_level=10).get_logger()
+```
+
+## 功能特性
+
+- 控制台彩色输出
+- 按天轮转文件日志
+- 自动推断调用方模块名
+- 兼容类式和函数式两种调用方式
+
+## 本地构建
+
+```bash
+python -m build
+```
+
+## 发布到 PyPI
+
+先配置 PyPI Token：
+
+```bash
+set TWINE_USERNAME=__token__
+set TWINE_PASSWORD=pypi-xxxxxxxxxxxxxxxxxxxx
+```
+
+然后执行：
+
+```bash
+python -m twine upload dist/*
+```

dlz_logger-0.1.0/pyproject.toml

@@ -0,0 +1,37 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "dlz-logger"
+version = "0.1.0"
+description = "A lightweight colorful logger with optional daily rotating file output."
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+authors = [
+    { name = "daliangzai" }
+]
+keywords = ["logging", "logger", "color", "console", "pypi"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: System :: Logging",
+]
+
+[project.urls]
+Homepage = "https://pypi.org/project/dlz-logger/"
+
+[tool.setuptools]
+package-dir = { "" = "src" }
+
+[tool.setuptools.packages.find]
+where = ["src"]

dlz_logger-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

dlz_logger-0.1.0/src/colors_logger/__init__.py

@@ -0,0 +1,3 @@
+from .logger import LOGGER, get_logger
+
+__all__ = ["LOGGER", "get_logger"]

dlz_logger-0.1.0/src/colors_logger/logger.py

@@ -0,0 +1,207 @@
+from __future__ import annotations
+
+import logging
+import os
+import sys
+from logging.handlers import TimedRotatingFileHandler
+from pathlib import Path
+from typing import Mapping
+
+DEFAULT_COLORS = {
+    "DEBUG": "\033[94m",
+    "INFO": "\033[90m",
+    "WARNING": "\033[93m",
+    "ERROR": "\033[1;91m",
+    "CRITICAL": "\033[38;5;196m",
+}
+RESET_COLOR = "\033[0m"
+DEFAULT_FORMAT = "%(asctime)s - %(levelname)s - %(message)s"
+DEFAULT_DATE_FORMAT = "%Y-%m-%d %H:%M:%S"
+
+
+def _resolve_logger_name(name: str | None, stacklevel: int = 2) -> str:
+    """自动推断调用方模块名，允许外部省略 __name__。"""
+    if name:
+        return name
+
+    try:
+        frame = sys._getframe(stacklevel)
+    except ValueError:
+        return "__main__"
+
+    return frame.f_globals.get("__name__", "__main__")
+
+
+class ColoredFormatter(logging.Formatter):
+    """给控制台日志添加 ANSI 颜色。"""
+
+    def __init__(
+        self,
+        colors: Mapping[str, str],
+        fmt: str | None = None,
+        datefmt: str | None = None,
+    ) -> None:
+        super().__init__(fmt=fmt, datefmt=datefmt)
+        self.colors = dict(colors)
+
+    def format(self, record: logging.LogRecord) -> str:
+        log_message = super().format(record)
+        color = self.colors.get(record.levelname, "")
+        return f"{color}{log_message}{RESET_COLOR}" if color else log_message
+
+
+class LOGGER:
+    """彩色日志封装，支持控制台输出和按天切分文件日志。"""
+
+    def __init__(
+        self,
+        name: str | None = None,
+        log_level: int = logging.DEBUG,
+        save: bool = False,
+        file_name: str | None = None,
+        colors: Mapping[str, str] | None = None,
+        log_dir: str | os.PathLike[str] | None = None,
+        fmt: str = DEFAULT_FORMAT,
+        datefmt: str = DEFAULT_DATE_FORMAT,
+    ) -> None:
+        """初始化日志器。
+
+        参数:
+            name: 日志器名称；不传时自动使用调用方模块名。
+            log_level: 日志级别。
+            save: 是否写入文件。
+            file_name: 日志文件名，不含扩展名。
+            colors: 自定义颜色映射。
+            log_dir: 日志目录，默认当前目录下的 logs。
+            fmt: 日志格式。
+            datefmt: 时间格式。
+        """
+        self.colors = dict(DEFAULT_COLORS)
+        if colors:
+            self.colors.update(colors)
+
+        resolved_name = _resolve_logger_name(name=name, stacklevel=2)
+        self.logger = logging.getLogger(resolved_name)
+        self.logger.setLevel(log_level)
+        self.logger.propagate = False
+
+        self._setup_console_handler(log_level=log_level, fmt=fmt, datefmt=datefmt)
+
+        if save:
+            self._setup_file_handler(
+                log_level=log_level,
+                file_name=file_name,
+                log_dir=log_dir,
+                fmt=fmt,
+                datefmt=datefmt,
+            )
+
+    def _find_handler(self, handler_type: str) -> logging.Handler | None:
+        """查找当前 logger 上由本库创建的 handler。"""
+        for handler in self.logger.handlers:
+            if getattr(handler, "_colors_logger_handler_type", None) == handler_type:
+                return handler
+        return None
+
+    def _setup_console_handler(self, log_level: int, fmt: str, datefmt: str) -> None:
+        """配置或复用控制台 handler，避免重复输出。"""
+        console_handler = self._find_handler("console")
+        formatter = ColoredFormatter(self.colors, fmt=fmt, datefmt=datefmt)
+
+        if console_handler is None:
+            console_handler = logging.StreamHandler()
+            console_handler._colors_logger_handler_type = "console"  # type: ignore[attr-defined]
+            self.logger.addHandler(console_handler)
+
+        console_handler.setLevel(log_level)
+        console_handler.setFormatter(formatter)
+
+    def _setup_file_handler(
+        self,
+        log_level: int,
+        file_name: str | None,
+        log_dir: str | os.PathLike[str] | None,
+        fmt: str,
+        datefmt: str,
+    ) -> None:
+        """配置按天轮转的文件日志。"""
+        target_path = self._build_log_path(file_name=file_name, log_dir=log_dir)
+        file_handler = self._find_handler("file")
+
+        if (
+            file_handler is not None
+            and getattr(file_handler, "baseFilename", None) != str(target_path)
+        ):
+            # 同一个 logger 只保留一个文件 handler，后一次配置覆盖前一次。
+            self.logger.removeHandler(file_handler)
+            file_handler.close()
+            file_handler = None
+
+        if file_handler is None:
+            file_handler = TimedRotatingFileHandler(
+                filename=target_path,
+                when="midnight",
+                interval=1,
+                backupCount=0,
+                encoding="utf-8",
+            )
+            file_handler._colors_logger_handler_type = "file"  # type: ignore[attr-defined]
+            file_handler.suffix = "%Y-%m-%d.log"
+            self.logger.addHandler(file_handler)
+
+        file_handler.setLevel(log_level)
+        file_handler.setFormatter(logging.Formatter(fmt=fmt, datefmt=datefmt))
+
+    @staticmethod
+    def _build_log_path(
+        file_name: str | None,
+        log_dir: str | os.PathLike[str] | None,
+    ) -> Path:
+        """生成日志文件完整路径。"""
+        resolved_file_name = file_name or "main"
+        resolved_log_dir = Path(log_dir) if log_dir else Path.cwd() / "logs"
+        resolved_log_dir.mkdir(parents=True, exist_ok=True)
+        return resolved_log_dir / f"{resolved_file_name}.log"
+
+    def debug(self, msg: object, *args: object, **kwargs: object) -> None:
+        self.logger.debug(msg, *args, **kwargs)
+
+    def info(self, msg: object, *args: object, **kwargs: object) -> None:
+        self.logger.info(msg, *args, **kwargs)
+
+    def warning(self, msg: object, *args: object, **kwargs: object) -> None:
+        self.logger.warning(msg, *args, **kwargs)
+
+    def error(self, msg: object, *args: object, **kwargs: object) -> None:
+        self.logger.error(msg, *args, **kwargs)
+
+    def critical(self, msg: object, *args: object, **kwargs: object) -> None:
+        self.logger.critical(msg, *args, **kwargs)
+
+    def get_logger(self) -> logging.Logger:
+        """返回原生 logging.Logger，方便无缝接入现有代码。"""
+        return self.logger
+
+
+def get_logger(
+    name: str | None = None,
+    log_level: int = logging.DEBUG,
+    save: bool = False,
+    file_name: str | None = None,
+    colors: Mapping[str, str] | None = None,
+    log_dir: str | os.PathLike[str] | None = None,
+    fmt: str = DEFAULT_FORMAT,
+    datefmt: str = DEFAULT_DATE_FORMAT,
+) -> logging.Logger:
+    """函数式入口，推荐直接使用这个接口。"""
+    resolved_name = _resolve_logger_name(name=name, stacklevel=2)
+    return LOGGER(
+        name=resolved_name,
+        log_level=log_level,
+        save=save,
+        file_name=file_name,
+        colors=colors,
+        log_dir=log_dir,
+        fmt=fmt,
+        datefmt=datefmt,
+    ).get_logger()

dlz_logger-0.1.0/src/dlz_logger.egg-info/PKG-INFO

@@ -0,0 +1,100 @@
+Metadata-Version: 2.4
+Name: dlz-logger
+Version: 0.1.0
+Summary: A lightweight colorful logger with optional daily rotating file output.
+Author: daliangzai
+License-Expression: MIT
+Project-URL: Homepage, https://pypi.org/project/dlz-logger/
+Keywords: logging,logger,color,console,pypi
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Logging
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# dlz-logger
+
+`dlz-logger` 是一个轻量级彩色日志库，支持控制台着色输出，以及按天切分的文件日志。
+
+## 安装
+
+```bash
+pip install dlz-logger
+```
+
+## 推荐调用方式
+
+现在可以直接省略 `__name__`：
+
+```python
+from datetime import datetime
+from colors_logger import get_logger
+
+LOG_LEVEL = 10
+
+logger = get_logger(
+    log_level=LOG_LEVEL,
+    save=True,
+    file_name=f"收费单识别-{datetime.now():%Y%m%d_%H%M%S}",
+)
+
+logger.info("开始识别")
+```
+
+## 兼容旧写法
+
+```python
+from colors_logger import LOGGER
+
+logger = LOGGER(
+    log_level=10,
+    save=True,
+    file_name="demo"
+).get_logger()
+
+logger.info("hello")
+```
+
+如果你仍然想显式传入模块名，也一样支持：
+
+```python
+logger = LOGGER(__name__, log_level=10).get_logger()
+```
+
+## 功能特性
+
+- 控制台彩色输出
+- 按天轮转文件日志
+- 自动推断调用方模块名
+- 兼容类式和函数式两种调用方式
+
+## 本地构建
+
+```bash
+python -m build
+```
+
+## 发布到 PyPI
+
+先配置 PyPI Token：
+
+```bash
+set TWINE_USERNAME=__token__
+set TWINE_PASSWORD=pypi-xxxxxxxxxxxxxxxxxxxx
+```
+
+然后执行：
+
+```bash
+python -m twine upload dist/*
+```

dlz_logger-0.1.0/src/dlz_logger.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+LICENSE
+README.md
+pyproject.toml
+src/colors_logger/__init__.py
+src/colors_logger/logger.py
+src/dlz_logger.egg-info/PKG-INFO
+src/dlz_logger.egg-info/SOURCES.txt
+src/dlz_logger.egg-info/dependency_links.txt
+src/dlz_logger.egg-info/top_level.txt
+tests/test_colors_logger.py

dlz_logger-0.1.0/src/dlz_logger.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

dlz_logger-0.1.0/src/dlz_logger.egg-info/top_level.txt

@@ -0,0 +1 @@
+colors_logger

dlz_logger-0.1.0/tests/test_colors_logger.py

@@ -0,0 +1,52 @@
+import logging
+import tempfile
+import unittest
+from pathlib import Path
+
+from colors_logger import LOGGER, get_logger
+
+
+class TestColorsLogger(unittest.TestCase):
+    def test_logger_class_can_infer_module_name(self) -> None:
+        logger = LOGGER().get_logger()
+        self.assertEqual(logger.name, __name__)
+
+    def test_function_api_can_infer_module_name(self) -> None:
+        logger = get_logger()
+        self.assertEqual(logger.name, __name__)
+
+    def test_file_handler_can_be_created(self) -> None:
+        with tempfile.TemporaryDirectory() as temp_dir:
+            logger = get_logger(
+                name="test.file",
+                log_level=logging.INFO,
+                save=True,
+                file_name="sample",
+                log_dir=temp_dir,
+            )
+            logger.info("hello file logger")
+
+            for handler in logger.handlers:
+                handler.flush()
+
+            self.assertTrue((Path(temp_dir) / "sample.log").exists())
+
+            for handler in list(logger.handlers):
+                if getattr(handler, "_colors_logger_handler_type", None) == "file":
+                    logger.removeHandler(handler)
+                    handler.close()
+
+    def test_console_handler_will_not_duplicate(self) -> None:
+        logger = get_logger(name="test.console")
+        logger = get_logger(name="test.console")
+
+        console_handlers = [
+            handler
+            for handler in logger.handlers
+            if getattr(handler, "_colors_logger_handler_type", None) == "console"
+        ]
+        self.assertEqual(len(console_handlers), 1)
+
+
+if __name__ == "__main__":
+    unittest.main()