xenoslib 0.3.2__py3-none-any.whl → 0.4.1__py3-none-any.whl

xenoslib/__init__.py

@@ -10,3 +10,4 @@ elif sys.platform == "linux":
 elif sys.platform == "darwin":
     from .linux import *  # noqa
 from .base import *  # noqa
+from .time_utils import *  # noqa

xenoslib/about.py

@@ -4,4 +4,4 @@ __url__ = "https://github.com/XenosLu/xenoslib.git"
 __author__ = "Xenocider"
 __author_email__ = "xenos.lu@gmail.com"
 __license__ = "MIT License"
-__version__ = "0.3.2"
+__version__ = "0.4.1"

xenoslib/time_utils.py

@@ -0,0 +1,99 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+# @Author  : Xenos Lu
+# @Created : 2023-01
+# @Updated : 2025-08-14
+import os
+import logging
+import inspect
+from datetime import datetime
+
+logger = logging.getLogger(__name__)
+
+
+# 添加多语言支持
+def get_system_language():
+    """获取系统语言环境"""
+    lang = os.getenv("LANG", "").split(".")[0]
+    return lang if lang and "_" in lang else "en_US"
+
+
+# 创建翻译字典
+TRANSLATIONS = {
+    "zh_CN": {
+        "days": ("天", "天"),
+        "hours": ("小时", "小时"),
+        "minutes": ("分钟", "分钟"),
+        "seconds": ("秒", "秒"),
+        "updated": "最近更新",
+        "ago": "前",
+        "file_error": "获取文件信息失败",
+    },
+    "en_US": {
+        "days": ("day", "days"),
+        "hours": ("hour", "hours"),
+        "minutes": ("minute", "minutes"),
+        "seconds": ("second", "seconds"),
+        "updated": "last updated",
+        "ago": "ago",
+        "file_error": "Failed to get file info",
+    },
+}
+
+
+def timedelta_to_human_readable(delta, lang=None):
+    """将时间差转换为人类可读格式（支持中英双语）"""
+    if lang is None:
+        lang = get_system_language()
+
+    trans = TRANSLATIONS.get(lang, TRANSLATIONS["en_US"])
+    days = delta.days
+    hours, remainder = divmod(delta.seconds, 3600)
+    minutes, seconds = divmod(remainder, 60)
+
+    time_units = {
+        "days": (days, trans["days"]),
+        "hours": (hours, trans["hours"]),
+        "minutes": (minutes, trans["minutes"]),
+        "seconds": (seconds, trans["seconds"]),
+    }
+
+    for unit, (value, labels) in time_units.items():
+        if value > 0:
+            # 处理英文单复数
+            if lang.startswith("en_") and value > 1:
+                return f"{value} {labels[1]}"
+            return f"{value}{labels[0]}" if lang.startswith("zh_") else f"{value} {labels[0]}"
+
+    # 默认返回0秒
+    zero_label = "0" + trans["seconds"][0] if lang.startswith("zh_") else f"0 {trans['seconds'][1]}"
+    return zero_label
+
+
+def log_file_update_time(lang=None):
+    """显示调用文件最近更新时间（支持中英双语）"""
+    if lang is None:
+        lang = get_system_language()
+    trans = TRANSLATIONS.get(lang, TRANSLATIONS["en_US"])
+
+    try:
+        stack = inspect.stack()
+        for frame_info in stack:
+            if frame_info.filename != __file__:
+                file_path = frame_info.filename
+                break
+        else:
+            file_path = __file__
+
+        mtime = datetime.fromtimestamp(os.path.getmtime(file_path))
+        delta_str = timedelta_to_human_readable(datetime.now() - mtime, lang)
+        filename = os.path.basename(file_path)
+
+        # 双语日志输出
+        log_msg = (
+            f"{filename} {trans['updated']}: "
+            f"{mtime:%Y-%m-%d %H:%M} ({delta_str} {trans['ago']})"
+        )
+        logger.info(log_msg)
+    except Exception as e:
+        logger.error(f"{trans['file_error']}: {e}")

xenoslib/tools/config_loader.py

@@ -244,7 +244,13 @@ class SectionProxy:
 
     def __repr__(self):
         """String representation of the section's configuration."""
-        return yaml.dump(self._loader._raw_config[self._section])
+        return yaml.dump(self.to_dict())
+
+    def __contains__(self, key):
+        return key in self.self.to_dict()
+
+    def to_dict(self):
+        return self._loader._raw_config[self._section]
 
 
 if __name__ == "__main__":

{xenoslib-0.3.2.dist-info → xenoslib-0.4.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: xenoslib
-Version: 0.3.2
+Version: 0.4.1
 Summary: Xenos' common lib
 Home-page: https://github.com/XenosLu/xenoslib.git
 Author: Xenocider

{xenoslib-0.3.2.dist-info → xenoslib-0.4.1.dist-info}/RECORD

@@ -1,6 +1,6 @@
-xenoslib/__init__.py,sha256=vlMWwdD2gTb9ztpm_orYAm_Y0Be0Es64ifvMQwrE1jU,310
+xenoslib/__init__.py,sha256=GbqgKQY6EksVq0kDvxEPbbhQ42L3__NI-fk-IdArIrE,344
 xenoslib/__main__.py,sha256=UpD3pl4l5ZUFxK6FzNMWRb1AZpEnwerulSFoPb_Pdgw,307
-xenoslib/about.py,sha256=WhSt9ExSk_XSML8eWGmrJD5XtZiiSDr5G-FJe9mLunI,228
+xenoslib/about.py,sha256=P_xpQN8vwIUZvYZ8MII7R_SGiWpSNtIf7zz1P4G1lPM,228
 xenoslib/base.py,sha256=KVJ1n1jzdsDZ4PX5bGxmal9eKmiUy5MS0xqNhGGwoRk,13767
 xenoslib/dev.py,sha256=R6iwKuu-xvaYiBOUyP2gpePyvXss17TOZaCmQEihPCw,1236
 xenoslib/extend.py,sha256=Vl5d8carSGy6ERE2EjTmB9lOo2uIBWs1iz-fKm_TX-M,5947
@@ -8,12 +8,13 @@ xenoslib/linux.py,sha256=EFCQBq_JsmNJc3wGlJlzH9W0tjOA7sSwx0u62R5Ut2k,1318
 xenoslib/mail.py,sha256=pkC4gpMSxKbuvNR-0CdwbJQEJNbBCp5oEYAJS-uxq9s,7286
 xenoslib/mock.py,sha256=iNIplO7clejqLWfpY4r0WQH5BULy9dCoolDenZEci0c,3572
 xenoslib/onedrive.py,sha256=-bJJ8Cd_RjJSlDynYqKoZlFKE1HHM34l6NXOQrWOwtg,7783
+xenoslib/time_utils.py,sha256=98YOD5u3T3JJkmkYkez7pLEmZHfO9qvlAbDKuOmFyjk,2969
 xenoslib/win_trayicon.py,sha256=7GJwX3c2CS1XWQjsyDK5EfM-MmEHdzPJCTX2sGpWmuU,13115
 xenoslib/windows.py,sha256=lUTD7TowaPqYHgIL6b-GM9PLd-VyJNNGzkzC3K9vOxo,4080
 xenoslib/tools/__init__.py,sha256=D1qP5tD2ZukXHgjKUh0fFl8jUipM3KaPBZBi0vGPypQ,48
-xenoslib/tools/config_loader.py,sha256=dHGqeRX-RvtBCdERsOYTYRIBD8nfYx04XRpps25ob_c,10947
-xenoslib-0.3.2.dist-info/licenses/LICENSE,sha256=lF6hjufhiR-xAje_Wo7ogxV5phz2d5TgkfL5SGshujg,1066
-xenoslib-0.3.2.dist-info/METADATA,sha256=Rdg2TRxxFq_LjuV2-41RVL-kRNXVCVnFliSUNwqMN7k,910
-xenoslib-0.3.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-xenoslib-0.3.2.dist-info/top_level.txt,sha256=Rfm4GdW0NyA2AHDNUF2wFQOfAo53mAPibddSHGd3X60,9
-xenoslib-0.3.2.dist-info/RECORD,,
+xenoslib/tools/config_loader.py,sha256=GWEcgdgYQyaq9rt1txYO5qaFOvqxB4i3kv5AIazquYk,11077
+xenoslib-0.4.1.dist-info/licenses/LICENSE,sha256=lF6hjufhiR-xAje_Wo7ogxV5phz2d5TgkfL5SGshujg,1066
+xenoslib-0.4.1.dist-info/METADATA,sha256=LlKcXFAKASonMaUPn5Df6Kqs29Kf38mlbM2u9t8BTDk,910
+xenoslib-0.4.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+xenoslib-0.4.1.dist-info/top_level.txt,sha256=Rfm4GdW0NyA2AHDNUF2wFQOfAo53mAPibddSHGd3X60,9
+xenoslib-0.4.1.dist-info/RECORD,,