mkdocs-document-dates 1.9.9__tar.gz → 2.1.0__tar.gz

{mkdocs_document_dates-1.9.9 → mkdocs_document_dates-2.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: mkdocs-document-dates
-Version: 1.9.9
+Version: 2.1.0
 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
@@ -111,7 +111,7 @@ modified: 2023-12-31
   - macOS: Uses file creation time (birthtime)
   - Linux: Uses modification time as creation time due to system limitations, if you need the exact creation time, you can manually specify it in Front Matter
 - It still works when using CI/CD build systems (e.g. Github Actions)
-  - Used a cache file `dates_cache.json` to solve this problem
+  - Used a cache file `.dates_cache.json` to solve this problem
   - You can configure it like this: `pip install --upgrade mkdocs-document-dates`
     ```
     ...

{mkdocs_document_dates-1.9.9 → mkdocs_document_dates-2.1.0}/README.md

@@ -89,7 +89,7 @@ modified: 2023-12-31
   - macOS: Uses file creation time (birthtime)
   - Linux: Uses modification time as creation time due to system limitations, if you need the exact creation time, you can manually specify it in Front Matter
 - It still works when using CI/CD build systems (e.g. Github Actions)
-  - Used a cache file `dates_cache.json` to solve this problem
+  - Used a cache file `.dates_cache.json` to solve this problem
   - You can configure it like this: `pip install --upgrade mkdocs-document-dates`
     ```
     ...

mkdocs_document_dates-2.1.0/mkdocs_document_dates/__init__.py

@@ -0,0 +1,13 @@
+"""MkDocs Document Dates Plugin."""
+
+__version__ = '2.0.0'
+
+from .hooks_installer import install
+
+# 在包被导入时自动执行 hooks 安装
+try:
+    result = install()
+    if not result:
+        print("提示: Git hooks 安装被跳过（可能是因为未检测到 Git 或不在 Git 仓库中）")
+except Exception as e:
+    print(f"警告: Git hooks 安装失败: {e}")

{mkdocs_document_dates-1.9.9 → mkdocs_document_dates-2.1.0}/mkdocs_document_dates/hooks/pre-commit

@@ -13,16 +13,17 @@ def find_mkdocs_projects():
     try:
         git_root = Path(subprocess.check_output(
             ['git', 'rev-parse', '--show-toplevel'],
-            text=True
+            text=True, encoding='utf-8'
         ).strip())
         
         projects = []
         for config_file in git_root.rglob('mkdocs.y*ml'):
-            if config_file.name in ('mkdocs.yml', 'mkdocs.yaml'):
+            if config_file.name.lower() in ('mkdocs.yml', 'mkdocs.yaml'):
                 projects.append(config_file.parent)
+        
         return projects
     except subprocess.CalledProcessError as e:
-        print(f"Error finding git root: {e}")
+        print(f"查找 Git 仓库根目录失败: {e}", file=sys.stderr)
         return []
 
 def get_file_dates(file_path):
@@ -32,13 +33,13 @@ def get_file_dates(file_path):
         modified = datetime.fromtimestamp(stat.st_mtime)
 
         system = platform.system().lower()
-        if system == 'darwin':  # macOS
+        if system.startswith('win'):  # Windows
+            created = datetime.fromtimestamp(stat.st_ctime)
+        elif system == 'darwin':  # macOS
             try:
                 created = datetime.fromtimestamp(stat.st_birthtime)
             except AttributeError:
                 created = datetime.fromtimestamp(stat.st_ctime)
-        elif system == 'windows':  # Windows
-            created = datetime.fromtimestamp(stat.st_ctime)
         else:  # Linux 和其他系统
             created = modified
 
@@ -49,32 +50,44 @@ def get_file_dates(file_path):
 
 def update_dates_cache():
     """更新文档时间缓存"""
+    print("开始更新文档时间缓存...")
     for project_dir in find_mkdocs_projects():
         docs_dir = project_dir / 'docs'
         if not docs_dir.exists():
+            print(f"文档目录不存在: {docs_dir}")
             continue
 
         dates_cache = {}
-        for md_file in docs_dir.rglob("*.md"):
-            rel_path = str(md_file.relative_to(docs_dir))
-            created, modified = get_file_dates(md_file)
-            dates_cache[rel_path] = {
-                "created": created,
-                "modified": modified
-            }
+        md_files = list(docs_dir.rglob("*.md"))
+        
+        for md_file in md_files:
+            try:
+                rel_path = str(md_file.relative_to(docs_dir))
+                created, modified = get_file_dates(md_file)
+                dates_cache[rel_path] = {
+                    "created": created,
+                    "modified": modified
+                }
+            except Exception as e:
+                print(f"处理文件 {md_file} 时出错: {e}")
+
+        if not dates_cache:
+            continue
 
         cache_file = docs_dir / '.dates_cache.json'
+        print(f"正在写入缓存文件: {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)
+            print(f"缓存文件 {cache_file} 已更新.")
         except Exception as e:
-            print(f"Error handling cache file: {e}", file=sys.stderr)
+            print(f"写入缓存文件时出错: {e}", file=sys.stderr)
             raise
 
 if __name__ == "__main__":
     try:
         update_dates_cache()
     except Exception as e:
-        print(f"Hook error: {e}", file=sys.stderr)
+        print(f"Hook 执行出错: {e}", file=sys.stderr)
         sys.exit(1)

mkdocs_document_dates-2.1.0/mkdocs_document_dates/hooks_installer.py

@@ -0,0 +1,77 @@
+import os
+import sys
+import shutil
+import subprocess
+from pathlib import Path
+import platform
+
+def get_config_dir():
+    """获取用户配置目录"""
+    system = platform.system().lower()
+    if system.startswith('win'):
+        return Path(os.getenv('APPDATA', str(Path.home() / 'AppData' / 'Roaming')))
+    else:  # macOS 和 Linux 统一使用 ~/.config
+        return Path.home() / '.config'
+
+def install():
+    """安装 git hooks"""
+    try:
+        # 检查 git 是否可用
+        try:
+            subprocess.run(['git', '--version'], check=True, capture_output=True, encoding='utf-8')
+        except (subprocess.CalledProcessError, FileNotFoundError):
+            print("提示: 未检测到 Git，跳过 hooks 安装")
+            return False
+        
+        # 准备配置目录
+        config_dir = get_config_dir() / 'mkdocs-document-dates' / 'hooks'
+        try:
+            config_dir.mkdir(parents=True, exist_ok=True)
+        except PermissionError:
+            print(f"错误: 无权限创建目录: {config_dir}")
+            return False
+        except Exception as e:
+            print(f"错误: 创建目录失败: {config_dir}, 原因: {e}")
+            return False
+
+        hook_path = config_dir / 'pre-commit'
+
+        # 复制 hook 文件
+        source_hook = Path(__file__).parent / 'hooks' / 'pre-commit'
+        if not source_hook.exists():
+            print(f"错误: 源 hook 文件不存在: {source_hook}")
+            return False
+            
+        try:
+            shutil.copy2(source_hook, hook_path)
+        except PermissionError:
+            print(f"错误: 无权限复制文件到: {hook_path}")
+            return False
+        except Exception as e:
+            print(f"错误: 复制文件失败, 原因: {e}")
+            return False
+
+        # 设置文件权限（Unix-like 系统）
+        if not platform.system().lower().startswith('win'):
+            try:
+                os.chmod(config_dir, 0o755)
+                os.chmod(hook_path, 0o755)
+            except OSError as e:
+                print(f"警告: 设置权限时出错: {e}")
+
+        # 配置 git hooks 路径
+        try:
+            subprocess.run(['git', 'config', '--global', 'core.hooksPath', 
+                          str(config_dir)], check=True, encoding='utf-8')
+            print(f"Git hooks 已安装到: {config_dir}")
+            return True
+        except subprocess.CalledProcessError as e:
+            print(f"错误: 设置 git hooks 路径失败: {e}")
+            return False
+            
+    except Exception as e:
+        print(f"安装 hooks 时出错: {e}")
+        return False
+
+if __name__ == '__main__':
+    install()

{mkdocs_document_dates-1.9.9 → mkdocs_document_dates-2.1.0}/mkdocs_document_dates.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: mkdocs-document-dates
-Version: 1.9.9
+Version: 2.1.0
 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
@@ -111,7 +111,7 @@ modified: 2023-12-31
   - macOS: Uses file creation time (birthtime)
   - Linux: Uses modification time as creation time due to system limitations, if you need the exact creation time, you can manually specify it in Front Matter
 - It still works when using CI/CD build systems (e.g. Github Actions)
-  - Used a cache file `dates_cache.json` to solve this problem
+  - Used a cache file `.dates_cache.json` to solve this problem
   - You can configure it like this: `pip install --upgrade mkdocs-document-dates`
     ```
     ...

{mkdocs_document_dates-1.9.9 → mkdocs_document_dates-2.1.0}/mkdocs_document_dates.egg-info/entry_points.txt

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

mkdocs_document_dates-2.1.0/setup.py

@@ -0,0 +1,42 @@
+from setuptools import setup, find_packages
+import mkdocs_document_dates
+
+try:
+    with open("README.md", "r", encoding="utf-8") as fh:
+        long_description = fh.read()
+except FileNotFoundError:
+    long_description = "A MkDocs plugin for displaying accurate document creation and last modification dates."
+
+VERSION = '2.1.0'
+
+setup(
+    name="mkdocs-document-dates",
+    version=VERSION,
+    author="Aaron Wang",
+    description="A MkDocs plugin for displaying accurate document creation and last modification dates.",
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    url="https://github.com/jaywhj/mkdocs-document-dates",
+    packages=find_packages(),
+    install_requires=[
+        'mkdocs>=1.0.0',
+    ],
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+    ],
+    entry_points={
+        'mkdocs.plugins': [
+            'document-dates = mkdocs_document_dates.plugin:DocumentDatesPlugin',
+        ],
+        'console_scripts': [
+            # 提供命令行工具，允许用户手动执行 hooks 安装
+            'mkdocs-document-dates-hooks=mkdocs_document_dates.hooks_installer:install'
+        ],
+    },
+    package_data={
+        'mkdocs_document_dates': ['hooks/*'],
+    },
+    python_requires=">=3.6",
+)

mkdocs_document_dates-1.9.9/mkdocs_document_dates/__init__.py

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

mkdocs_document_dates-1.9.9/mkdocs_document_dates/hooks_installer.py

@@ -1,49 +0,0 @@
-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.9/setup.py

@@ -1,129 +0,0 @@
-from setuptools import setup, find_packages
-from setuptools.command.install_egg_info import install_egg_info
-from setuptools.command.develop import develop
-from setuptools.command.install import install
-from setuptools.command.build_py import build_py
-import os
-import sys
-import subprocess
-from pathlib import Path
-import site
-
-def install_git_hooks():
-    print("\n...Starting hooks installation...\n")
-    try:
-        # 先清除旧的配置
-        subprocess.run(['git', 'config', '--global', '--unset', 'core.hooksPath'], 
-                     check=False)
-        
-        # 使用 site-packages 路径
-        for site_dir in site.getsitepackages():
-            hooks_dir = Path(site_dir) / 'mkdocs_document_dates' / 'hooks'
-            print(f"Checking hooks in: {hooks_dir}")
-            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 installed at: {hooks_dir}")
-                    
-                    # 验证配置
-                    result = subprocess.run(['git', 'config', '--global', 'core.hooksPath'],
-                                         capture_output=True, text=True)
-                    print(f"Verified hooks path: {result.stdout.strip()}")
-                    return True
-        
-        # 如果在 site-packages 中没找到，尝试开发目录
-        dev_hooks_dir = Path(__file__).parent.resolve() / 'mkdocs_document_dates' / '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 installed at (dev mode): {dev_hooks_dir}")
-                return True
-                
-        print("Error: Hooks directory not found in any location")
-        return False
-    except Exception as e:
-        print(f"Error installing hooks: {e}")
-        return False
-
-class CustomInstallEggInfo(install_egg_info):
-
-    def run(self):
-        print("\n=== Starting CustomInstallEggInfo run ===\n")
-        print(f"Installation mode: {'Development' if '-e' in sys.argv else 'Production'}")
-        print(f"Current directory: {os.getcwd()}")
-        print(f"Setup file location: {__file__}")
-        print(f"Command line args: {sys.argv}")
-        
-        install_egg_info.run(self)
-        install_git_hooks()
-
-class CustomInstall(install):
-    def run(self):
-        print("\n=== Starting CustomInstall run ===\n")
-        print(f"Current directory: {os.getcwd()}")
-        install.run(self)
-        install_git_hooks()
-
-class CustomDevelop(develop):
-    def run(self):
-        print("\n=== Starting CustomDevelop run ===\n")
-        develop.run(self)
-        install_git_hooks()
-
-class CustomBuildPy(build_py):
-    def run(self):
-        print("\n=== Starting CustomBuildPy run ===\n")
-        print(f"Current directory: {os.getcwd()}")
-        print(f"Build lib dir: {self.build_lib}")
-        build_py.run(self)
-        install_git_hooks()
-
-try:
-    with open("README.md", "r", encoding="utf-8") as fh:
-        long_description = fh.read()
-except FileNotFoundError:
-    long_description = "A MkDocs plugin for displaying accurate document creation and last modification dates."
-
-VERSION = '1.9.9'
-
-setup(
-    name="mkdocs-document-dates",
-    version=VERSION,
-    author="Aaron Wang",
-    description="A MkDocs plugin for displaying accurate document creation and last modification dates.",
-    long_description=long_description,
-    long_description_content_type="text/markdown",
-    url="https://github.com/jaywhj/mkdocs-document-dates",
-    packages=find_packages(),
-    install_requires=[
-        'mkdocs>=1.0.0',
-    ],
-    classifiers=[
-        "Programming Language :: Python :: 3",
-        "License :: OSI Approved :: MIT License",
-        "Operating System :: OS Independent",
-    ],
-    entry_points={
-        'mkdocs.plugins': [
-            'document-dates = mkdocs_document_dates.plugin:DocumentDatesPlugin',
-        ],
-        'console_scripts': [
-            'install-mkdocs-hooks=mkdocs_document_dates.hooks_installer:install'
-        ]
-    },
-
-    package_data={
-        'mkdocs_document_dates': ['hooks/*'],
-    },
-    python_requires=">=3.6",
-)