mkdocs-document-dates 1.9.7__py3-none-any.whl → 1.9.9__py3-none-any.whl

mkdocs_document_dates/__init__.py

@@ -1,3 +1,11 @@
 """MkDocs Document Dates Plugin."""
 
-__version__ = '1.0.0'
+__version__ = '1.0.0'
+
+from .hooks_installer import install
+
+# 当包被导入时自动安装 hooks
+try:
+    install()
+except Exception as e:
+    print(f"自动安装 git hooks 失败: {e}")

mkdocs_document_dates/hooks/pre-commit

@@ -8,80 +8,6 @@ import subprocess
 from datetime import datetime
 from pathlib import Path
 
-# 添加调试日志到项目的 docs 目录
-def log_debug(message):
-    try:
-        git_root = Path(subprocess.check_output(
-            ['git', 'rev-parse', '--show-toplevel'],
-            text=True
-        ).strip())
-        
-        docs_dir = git_root / 'docs'
-        if docs_dir.exists():
-            with open(docs_dir / '.hook_debug.log', 'a') as f:
-                f.write(f"{datetime.now()}: {message}\n")
-    except:
-        pass  # 静默失败，不影响主流程
-
-# 配置日志
-def setup_logging():
-    """设置日志"""
-    try:
-        # 获取当前 git 仓库根目录
-        git_root = Path(subprocess.check_output(
-            ['git', 'rev-parse', '--show-toplevel'],
-            text=True
-        ).strip())
-        
-        # 在 git 仓库根目录下创建日志目录
-        log_dir = git_root / '.mkdocs_dates'
-        log_dir.mkdir(exist_ok=True)
-        log_file = log_dir / 'hook.log'
-        
-        logging.basicConfig(
-            level=logging.INFO,
-            format='%(asctime)s - %(levelname)s - %(message)s',
-            handlers=[
-                logging.FileHandler(log_file),
-                logging.StreamHandler(sys.stderr)
-            ]
-        )
-        return True
-    except Exception as e:
-        print(f"Failed to setup logging: {e}", file=sys.stderr)
-        return False
-
-# 添加调试函数
-def debug_info():
-    info = {
-        'cwd': os.getcwd(),
-        'python_path': sys.executable,
-        'env_path': os.environ.get('PATH', ''),
-        'script_path': __file__,
-        'timestamp': datetime.now().isoformat()
-    }
-    
-    # 保存调试信息到固定位置
-    debug_file = Path('/tmp/mkdocs_hook_debug.json')
-    try:
-        with open(debug_file, 'w') as f:
-            json.dump(info, f, indent=2)
-        
-        # 同时输出到 stderr（git 会显示这些信息）
-        print("Hook debug info:", file=sys.stderr)
-        for k, v in info.items():
-            print(f"{k}: {v}", file=sys.stderr)
-    except Exception as e:
-        print(f"Debug error: {e}", file=sys.stderr)
-
-if __name__ == "__main__":
-    try:
-        debug_info()  # 添加调试信息
-        update_dates_cache()
-    except Exception as e:
-        print(f"Hook error: {e}", file=sys.stderr)
-        sys.exit(1)
-
 def find_mkdocs_projects():
     """查找当前 git 仓库中的所有 MkDocs 项目"""
     try:
@@ -121,7 +47,6 @@ def get_file_dates(file_path):
         current_time = datetime.now()
         return current_time.isoformat(), current_time.isoformat()
 
-
 def update_dates_cache():
     """更新文档时间缓存"""
     for project_dir in find_mkdocs_projects():
@@ -129,9 +54,6 @@ def update_dates_cache():
         if not docs_dir.exists():
             continue
 
-        logging.info(f"Processing MkDocs project: {project_dir}")
-        logging.info(f"Docs directory: {docs_dir}")
-
         dates_cache = {}
         for md_file in docs_dir.rglob("*.md"):
             rel_path = str(md_file.relative_to(docs_dir))
@@ -140,16 +62,19 @@ def update_dates_cache():
                 "created": created,
                 "modified": modified
             }
-            logging.info(f"Processing file: {rel_path}")
 
         cache_file = docs_dir / '.dates_cache.json'
-        logging.info(f"Saving cache to: {cache_file}")
-        
         try:
             with open(cache_file, "w") as f:
                 json.dump(dates_cache, f, indent=2, ensure_ascii=False)
             subprocess.run(["git", "add", str(cache_file)], check=True)
-            logging.info(f"Added cache file to git: {cache_file}")
         except Exception as e:
-            logging.error(f"Error handling cache file: {e}")
+            print(f"Error handling cache file: {e}", file=sys.stderr)
             raise
+
+if __name__ == "__main__":
+    try:
+        update_dates_cache()
+    except Exception as e:
+        print(f"Hook error: {e}", file=sys.stderr)
+        sys.exit(1)

mkdocs_document_dates/hooks_installer.py

@@ -0,0 +1,49 @@
+import os
+import sys
+import subprocess
+from pathlib import Path
+import site
+
+def install():
+    """安装 git hooks 的入口点函数"""
+    print("\n正在安装 git hooks...\n")
+    try:
+        # 先清除旧的配置
+        subprocess.run(['git', 'config', '--global', '--unset', 'core.hooksPath'], 
+                     check=False)
+        
+        # 优先使用开发目录
+        dev_hooks_dir = Path(__file__).parent.resolve() / 'hooks'
+        if dev_hooks_dir.exists():
+            hook_path = dev_hooks_dir / 'pre-commit'
+            if hook_path.exists():
+                if os.name != 'nt':
+                    os.chmod(dev_hooks_dir, 0o755)
+                    os.chmod(hook_path, 0o755)
+                subprocess.run(['git', 'config', '--global', 'core.hooksPath', str(dev_hooks_dir)],
+                            check=True)
+                print(f"Hooks 已安装到 (开发模式): {dev_hooks_dir}")
+                return True
+        
+        # 如果开发目录不存在，再尝试 site-packages
+        for site_dir in site.getsitepackages():
+            hooks_dir = Path(site_dir) / 'mkdocs_document_dates' / 'hooks'
+            if hooks_dir.exists():
+                hook_path = hooks_dir / 'pre-commit'
+                if hook_path.exists():
+                    if os.name != 'nt':
+                        os.chmod(hooks_dir, 0o755)
+                        os.chmod(hook_path, 0o755)
+                    subprocess.run(['git', 'config', '--global', 'core.hooksPath', str(hooks_dir)],
+                                check=True)
+                    print(f"Hooks 已安装到: {hooks_dir}")
+                    return True
+        
+        print("错误: 未找到 hooks 目录")
+        return False
+    except Exception as e:
+        print(f"安装 hooks 时出错: {e}")
+        return False
+
+if __name__ == '__main__':
+    install()

{mkdocs_document_dates-1.9.7.dist-info → mkdocs_document_dates-1.9.9.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: mkdocs-document-dates
-Version: 1.9.7
+Version: 1.9.9
 Summary: A MkDocs plugin for displaying accurate document creation and last modification dates.
 Home-page: https://github.com/jaywhj/mkdocs-document-dates
 Author: Aaron Wang

{mkdocs_document_dates-1.9.7.dist-info → mkdocs_document_dates-1.9.9.dist-info}/RECORD

@@ -1,7 +1,8 @@
-mkdocs_document_dates/__init__.py,sha256=CZ37u8DC6kbkupKFk-VKyfKZZFAJ4rOD0aPzOzVoATc,58
+mkdocs_document_dates/__init__.py,sha256=21uV4d5z91W4O-aAPrwosujLGgsR7Mh5rQUCKDoGsT8,227
+mkdocs_document_dates/hooks_installer.py,sha256=dJcFQxohWnLI7gp-bxkB3Vz6E0rFw63o0xXiFEcjOw0,1868
 mkdocs_document_dates/plugin.py,sha256=zgZ9QrbfsMDAv80P11I_99urSvFolJq93Ow7P-pfS_A,9753
 mkdocs_document_dates/styles.py,sha256=ujhlKgDWsOo5sHiYtf3XekuGg4C5Yjol8RzP3W9Wzjo,578
-mkdocs_document_dates/hooks/pre-commit,sha256=k9HOjyfAsywkc4CugqzssLe6l9KyBn1VLk4ckCalEPg,5004
+mkdocs_document_dates/hooks/pre-commit,sha256=YoNwuoT2NxMbpzwxMctH4EFB5ex_LdzG5xDxKjl93LQ,2601
 mkdocs_document_dates/lang/__init__.py,sha256=M1BLjCOA3HHKeAitk45YAgzxxNpnxFUvVAk6-FO_QSA,690
 mkdocs_document_dates/lang/ar.py,sha256=BsZlxz54U_spOZ5SBiKt73ywoLKbR54cZNkKAs86OxM,632
 mkdocs_document_dates/lang/de.py,sha256=B0Ffrn4lVSvcxFpGho7SiMm16GXYEmpjcVAR-k4UgSI,585
@@ -13,9 +14,9 @@ mkdocs_document_dates/lang/ko.py,sha256=GwY6yrKYAOj6S6feq9yqNxr2XpyGHC0XeenO541v
 mkdocs_document_dates/lang/ru.py,sha256=fK5s4mQKCoP6KI3jf6eqqmqB3YVn39q81U7Cw1QWNNg,721
 mkdocs_document_dates/lang/zh.py,sha256=OrLElrSTZhHSwxBzuUtUj7NpQb7wm0s83viimpk2ynM,519
 mkdocs_document_dates/lang/zh_tw.py,sha256=t3qu-a7UOzgcmYDkLFiosJZCcpfMU4xiKTJfu1ZHoHA,519
-mkdocs_document_dates-1.9.7.dist-info/LICENSE,sha256=1YKfCs5WKSk-bON8a68WZE5to1B2klCrHBYiuaVCThM,514
-mkdocs_document_dates-1.9.7.dist-info/METADATA,sha256=H6taAMRA5v1jAW-XDcuyx0mnsMghb1tHW_vYBO8LuA4,3908
-mkdocs_document_dates-1.9.7.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
-mkdocs_document_dates-1.9.7.dist-info/entry_points.txt,sha256=gI-OFLGjDG6-oLEfyevl3Gwwj2GcqVFQeX3bvL1IF8o,83
-mkdocs_document_dates-1.9.7.dist-info/top_level.txt,sha256=yWkKQdNuAJJVqUQ9uLa5xD4x_Gux4IfOUpy8Ryagdwc,22
-mkdocs_document_dates-1.9.7.dist-info/RECORD,,
+mkdocs_document_dates-1.9.9.dist-info/LICENSE,sha256=1YKfCs5WKSk-bON8a68WZE5to1B2klCrHBYiuaVCThM,514
+mkdocs_document_dates-1.9.9.dist-info/METADATA,sha256=Q8Oqd5iOcL1-r7v993WwCf9HoZnV2TH5a-XMp8rSZA8,3908
+mkdocs_document_dates-1.9.9.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
+mkdocs_document_dates-1.9.9.dist-info/entry_points.txt,sha256=4JFXqAAay470D6qgPzAAhDC-lwXVSF7THDBRFJE0yYQ,171
+mkdocs_document_dates-1.9.9.dist-info/top_level.txt,sha256=yWkKQdNuAJJVqUQ9uLa5xD4x_Gux4IfOUpy8Ryagdwc,22
+mkdocs_document_dates-1.9.9.dist-info/RECORD,,

mkdocs_document_dates-1.9.9.dist-info/entry_points.txt

@@ -0,0 +1,5 @@
+[console_scripts]
+install-mkdocs-hooks = mkdocs_document_dates.hooks_installer:install
+
+[mkdocs.plugins]
+document-dates = mkdocs_document_dates.plugin:DocumentDatesPlugin

mkdocs_document_dates-1.9.7.dist-info/entry_points.txt

@@ -1,2 +0,0 @@
-[mkdocs.plugins]
-document-dates = mkdocs_document_dates.plugin:DocumentDatesPlugin