zlogger-mp 0.1.0__tar.gz

zlogger_mp-0.1.0/LICENSE

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

zlogger_mp-0.1.0/PKG-INFO

@@ -0,0 +1,59 @@
+Metadata-Version: 2.4
+Name: zlogger-mp
+Version: 0.1.0
+Summary: 多进程安全的时间轮转日志封装：多进程共享同一日志文件时轮转不丢历史日志
+Author: wzy-777
+License: MIT
+Project-URL: Homepage, https://github.com/wzy-777/zlogger
+Keywords: logging,rotating,multiprocess,TimedRotatingFileHandler
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: System :: Logging
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# zlogger
+
+多进程安全的时间轮转日志记录器，基于标准库 `logging` 封装。
+
+## 特点
+
+- `SafeTimedRotatingFileHandler`：原子 rename 轮转，多个进程共享同一日志文件时不丢历史日志，已有备份绝不删除/覆盖
+- 控制台 + 文件双输出，文件按天（午夜）轮转，默认保留 7 天
+- 开箱即用，无需配置
+
+## 安装
+
+```bash
+pip install zlogger-mp
+```
+
+## 使用
+
+```python
+from zlogger import Logger
+
+log = Logger(name="test", log_file="test.log", log_dir="log").get_logger()
+log.debug("调试信息（仅控制台输出）")
+log.info("普通信息（控制台 + 文件）")
+log.warning("警告信息（控制台 + 文件）")
+log.error("错误信息（控制台 + 文件）")
+```
+
+单例方式（全局共享一个 logger）：
+
+```python
+from zlogger import LoggerSingleton
+
+log = LoggerSingleton.get_logger(name="myapp", log_file="myapp.log")
+log.info("hello")
+```
+
+## License
+
+MIT

zlogger_mp-0.1.0/README.md

@@ -0,0 +1,40 @@
+# zlogger
+
+多进程安全的时间轮转日志记录器，基于标准库 `logging` 封装。
+
+## 特点
+
+- `SafeTimedRotatingFileHandler`：原子 rename 轮转，多个进程共享同一日志文件时不丢历史日志，已有备份绝不删除/覆盖
+- 控制台 + 文件双输出，文件按天（午夜）轮转，默认保留 7 天
+- 开箱即用，无需配置
+
+## 安装
+
+```bash
+pip install zlogger-mp
+```
+
+## 使用
+
+```python
+from zlogger import Logger
+
+log = Logger(name="test", log_file="test.log", log_dir="log").get_logger()
+log.debug("调试信息（仅控制台输出）")
+log.info("普通信息（控制台 + 文件）")
+log.warning("警告信息（控制台 + 文件）")
+log.error("错误信息（控制台 + 文件）")
+```
+
+单例方式（全局共享一个 logger）：
+
+```python
+from zlogger import LoggerSingleton
+
+log = LoggerSingleton.get_logger(name="myapp", log_file="myapp.log")
+log.info("hello")
+```
+
+## License
+
+MIT

zlogger_mp-0.1.0/pyproject.toml

@@ -0,0 +1,27 @@
+[build-system]
+requires = ["setuptools>=61"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "zlogger-mp"
+version = "0.1.0"
+description = "多进程安全的时间轮转日志封装：多进程共享同一日志文件时轮转不丢历史日志"
+readme = "README.md"
+requires-python = ">=3.8"
+license = { text = "MIT" }
+authors = [{ name = "wzy-777" }]
+keywords = ["logging", "rotating", "multiprocess", "TimedRotatingFileHandler"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Topic :: System :: Logging",
+]
+
+[project.urls]
+Homepage = "https://github.com/wzy-777/zlogger"
+
+[tool.setuptools]
+py-modules = ["zlogger"]

zlogger_mp-0.1.0/setup.cfg

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

zlogger_mp-0.1.0/zlogger.py

@@ -0,0 +1,150 @@
+import logging
+from logging.handlers import TimedRotatingFileHandler
+import os
+import time
+
+
+class SafeTimedRotatingFileHandler(TimedRotatingFileHandler):
+    """
+    多进程安全的时间轮转文件处理器：
+    原子 rename 轮转 + 已有备份绝不删除/覆盖，多个进程共享同一日志文件时不丢历史日志
+    """
+
+    def doRollover(self):
+        """
+        重写doRollover方法，处理Windows文件权限问题
+        """
+        if self.stream:
+            self.stream.close()
+            self.stream = None
+
+        # 获取当前时间
+        currentTime = int(time.time())
+        dstNow = time.localtime(currentTime)[-1]
+        t = self.rolloverAt - self.interval
+        if self.utc:
+            timeTuple = time.gmtime(t)
+        else:
+            timeTuple = time.localtime(t)
+            dstThen = timeTuple[-1]
+            if dstNow != dstThen:
+                if dstNow:
+                    addend = 3600
+                else:
+                    addend = -3600
+                timeTuple = time.localtime(t + addend)
+
+        dfn = self.rotation_filename(self.baseFilename + "." + time.strftime(self.suffix, timeTuple))
+
+        # 原子 rename 备份，不用 copy+truncate：
+        # 多进程/多 handler 共享同一日志文件时，由第一个轮转的进程完成备份；
+        # 备份已存在说明其他进程已轮转过，直接跳过 —— 任何情况下都不删除、不覆盖已有备份
+        if os.path.exists(dfn):
+            pass
+        elif os.path.exists(self.baseFilename):
+            try:
+                os.rename(self.baseFilename, dfn)
+            except FileNotFoundError:
+                # base 刚被其他进程轮转走，无需再处理
+                pass
+            except OSError as e:
+                # 轮转失败仅告警，不影响后续写日志
+                print(f"日志轮转失败: {e}")
+
+        # 删除旧的备份文件
+        if self.backupCount > 0:
+            for s in self.getFilesToDelete():
+                try:
+                    os.remove(s)
+                except Exception:
+                    pass
+
+        # 重新计算下次轮转时间
+        if not self.delay:
+            self.stream = self._open()
+
+        newRolloverAt = self.computeRollover(currentTime)
+        while newRolloverAt <= currentTime:
+            newRolloverAt = newRolloverAt + self.interval
+
+        if (self.when == 'MIDNIGHT' or self.when.startswith('W')) and not self.utc:
+            dstAtRollover = time.localtime(newRolloverAt)[-1]
+            if dstNow != dstAtRollover:
+                if not dstNow:
+                    addend = -3600
+                else:
+                    addend = 3600
+                newRolloverAt += addend
+        self.rolloverAt = newRolloverAt
+
+
+class Logger:
+    def __init__(self, name: str, log_file: str = "app.log", log_dir: str = "log"):
+        """
+        创建一个日志记录器
+        :param name: 记录器名称
+        :param log_file: 日志文件名
+        :param log_dir: 日志文件保存目录
+        """
+        self.logger = logging.getLogger(name)
+        self.logger.setLevel(logging.DEBUG)
+        self.logger.propagate = False
+        # 确保日志目录存在
+        if not os.path.exists(log_dir):
+            os.makedirs(log_dir)
+
+        log_path = os.path.join(log_dir, log_file)
+
+        # 日志格式
+        formatter = logging.Formatter(
+            fmt="%(asctime)s [%(name)s] [%(filename)s:%(lineno)d] [%(levelname)s] %(message)s",
+            datefmt="%Y-%m-%d %H:%M:%S"
+        )
+
+        # 控制台 Handler
+        console_handler = logging.StreamHandler()
+        console_handler.setLevel(logging.DEBUG)
+        console_handler.setFormatter(formatter)
+
+        # 文件 Handler（使用改进的TimedRotatingFileHandler）
+        file_handler = SafeTimedRotatingFileHandler(
+            filename=log_path,
+            when="midnight",
+            interval=1,
+            backupCount=7,
+            encoding="utf-8",
+            delay=True
+        )
+        file_handler.setLevel(logging.INFO)
+        file_handler.setFormatter(formatter)
+
+        # 先清空已存在的handlers
+        if self.logger.hasHandlers():
+            self.logger.handlers.clear()
+
+        # 绑定 Handler
+        self.logger.addHandler(console_handler)
+        self.logger.addHandler(file_handler)
+
+    def get_logger(self) -> logging.Logger:
+        """返回 logger 对象"""
+        return self.logger
+
+
+class LoggerSingleton:
+    _logger = None
+
+    @classmethod
+    def get_logger(cls, name="websocket", log_file="websocket.log", log_dir="log"):
+        if cls._logger is None:
+            cls._logger = Logger(name, log_file, log_dir).get_logger()
+        return cls._logger
+
+# 使用示例
+if __name__ == "__main__":
+    log = Logger(name="test", log_file="test.log", log_dir="log").get_logger()
+    log.debug("调试信息（仅控制台输出）")
+    log.info("普通信息（控制台 + 文件）")
+    log.warning("警告信息（控制台 + 文件）")
+    log.error("错误信息（控制台 + 文件）")
+    log.critical("严重错误（控制台 + 文件）")

zlogger_mp-0.1.0/zlogger_mp.egg-info/PKG-INFO

@@ -0,0 +1,59 @@
+Metadata-Version: 2.4
+Name: zlogger-mp
+Version: 0.1.0
+Summary: 多进程安全的时间轮转日志封装：多进程共享同一日志文件时轮转不丢历史日志
+Author: wzy-777
+License: MIT
+Project-URL: Homepage, https://github.com/wzy-777/zlogger
+Keywords: logging,rotating,multiprocess,TimedRotatingFileHandler
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: System :: Logging
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# zlogger
+
+多进程安全的时间轮转日志记录器，基于标准库 `logging` 封装。
+
+## 特点
+
+- `SafeTimedRotatingFileHandler`：原子 rename 轮转，多个进程共享同一日志文件时不丢历史日志，已有备份绝不删除/覆盖
+- 控制台 + 文件双输出，文件按天（午夜）轮转，默认保留 7 天
+- 开箱即用，无需配置
+
+## 安装
+
+```bash
+pip install zlogger-mp
+```
+
+## 使用
+
+```python
+from zlogger import Logger
+
+log = Logger(name="test", log_file="test.log", log_dir="log").get_logger()
+log.debug("调试信息（仅控制台输出）")
+log.info("普通信息（控制台 + 文件）")
+log.warning("警告信息（控制台 + 文件）")
+log.error("错误信息（控制台 + 文件）")
+```
+
+单例方式（全局共享一个 logger）：
+
+```python
+from zlogger import LoggerSingleton
+
+log = LoggerSingleton.get_logger(name="myapp", log_file="myapp.log")
+log.info("hello")
+```
+
+## License
+
+MIT

zlogger_mp-0.1.0/zlogger_mp.egg-info/SOURCES.txt

@@ -0,0 +1,8 @@
+LICENSE
+README.md
+pyproject.toml
+zlogger.py
+zlogger_mp.egg-info/PKG-INFO
+zlogger_mp.egg-info/SOURCES.txt
+zlogger_mp.egg-info/dependency_links.txt
+zlogger_mp.egg-info/top_level.txt

zlogger_mp-0.1.0/zlogger_mp.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

zlogger_mp-0.1.0/zlogger_mp.egg-info/top_level.txt

@@ -0,0 +1 @@
+zlogger