labull-framework 0.1.28__tar.gz → 0.1.30__tar.gz

{labull_framework-0.1.28/labull_framework.egg-info → labull_framework-0.1.30}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: labull-framework
-Version: 0.1.28
+Version: 0.1.30
 Summary: Labull Framework: a pluggable Django app with Authing OIDC login and magic blocks
 Author: Labull Framework
 License-Expression: MIT

{labull_framework-0.1.28 → labull_framework-0.1.30}/labull_framework/canvas/gitinfo.py

@@ -53,8 +53,10 @@ _DERIVED_CACHE: dict[tuple[str, str, str], list[dict[str, Any]] | None] = {}
 #:    而一份基线要问三次（仓库根、HEAD、HEAD~1）⇒ 光"问路"就 120ms。
 #:    缓存了"算出来的表"却没缓存"问路"的话，第二次请求照样要起三个进程 ——
 #:    那正是"缓存最没用的写法"（真量过：冷 92ms / 热 96ms，等于没缓存）。
-#: ⚠️ 失效靠 `_sources_state()`（项目 `settings.py` + 本模块与 `shape_ast.py` 的 mtime）：
-#:    换了仓库 / 新提交 / 改了这一层的代码都会当场重算，见 `_memo()`。
+#: ⚠️ 失效靠 `_sources_state()`（项目 `settings.py` + **项目那个 `.git` 的元数据** +
+#:    本模块与 `shape_ast.py` 的 mtime）：换了仓库 / 新提交 / 改了这一层的代码都会当场重算，
+#:    见 `_memo()` 与 `_git_state()`。🔴 后面那两项**一样都不能省** —— 少了 `.git` 那一项，
+#:    "刚提交完"与"刚把项目纳入版本控制"这两件事在这一层是**看不见**的（真踩过，见 `_sources_state()`)。
 _MEMO: dict[str, Any] = {'state': None, 'values': {}}
 
 
@@ -313,12 +315,18 @@ def _revision_tables() -> list[dict[str, Any]] | None:
 def _sources_state() -> float:
     """这一层的输入**现在的**状态（拿不到任何文件时回 `0.0`）。
 
-    🔴 **三个东西都要算进来**，缺一个就有一类"改了没生效"：
+    🔴 **四个东西都要算进来**，缺一个就有一类"改了没生效"：
        · 项目那份 `settings.py`（`INSTALLED_APPS` / `AUTH_USER_MODEL` 从它来）—— 换了它就换了输入；
        · **本模块和 `shape_ast.py` 自己**的 mtime —— 改了"怎么算基线"的代码而缓存不失效，
          症状是"代码明明改了、量到的还是旧结果"（开发这一层时必踩；真踩过，
-         为了一个已经修掉的假差异查了半小时，而进程里的缓存还捧着旧的那份）。
-    ⚠️ 基线里的**源码**不用管：它在 git 里，由提交号管。
+         为了一个已经修掉的假差异查了半小时，而进程里的缓存还捧着旧的那份）；
+       · 🔴 **项目那个 `.git` 的元数据**（见 `_git_state()`）—— `git init` / `git commit` /
+         切分支**一个字都不动上面那几份文件**，而它们恰好把"仓库根 / 基线那一版"整个换掉。
+         少了这一项的症状：**提交完（或者刚把项目纳入版本控制）画布还捧着旧那一版，
+         而且同一个进程里永远不会自己好**。真踩过：`tools/sdk-check-py.mjs` 里那条
+         "实例属性引用了已删字段"的夹具先问了一次 `shape()`（那时项目还不是仓库）、
+         再 `git init` + 提交契约 ⇒ 基线被记忆成 `None`，5 条断言全红。
+    ⚠️ 基线里的**源码**不用管：它在 git 里，由提交号管 —— 这里看的是 `.git` 自己的元数据。
     """
     base = _root()
     newest = 0.0
@@ -330,6 +338,7 @@ def _sources_state() -> float:
                     newest = max(newest, path.stat().st_mtime)
             except OSError:
                 continue
+    newest = max(newest, _git_state(base))
     here = Path(__file__).resolve().parent
     for name in ('gitinfo.py', 'shape_ast.py'):
         try:
@@ -339,6 +348,65 @@ def _sources_state() -> float:
     return newest
 
 
+def _newest_mtime(path: Path) -> float:
+    """这个路径（文件就自己，目录就**递归**）里最新的 mtime（拿不到回 `0.0`）。
+
+    ⚠️ 只对**小的那几棵**目录树用它（`refs` / `logs`，一个仓库几十个文件）。
+       **不要拿它去递归 `.git` 自己**：那底下有 `objects/`，一个仓库几千上万个对象 ——
+       真踩过：这一层是每次访问缓存都要走的，递归一遍 `.git` 让"热"的那次从 1ms 涨到 340ms，
+       `tools/baseline-cases.py` 里那条"第二次走缓存"的判据当场就红了。
+    """
+    try:
+        newest = path.stat().st_mtime
+    except OSError:
+        return 0.0
+    if path.is_dir():
+        for child in path.rglob('*'):
+            try:
+                newest = max(newest, child.stat().st_mtime)
+            except OSError:
+                continue
+    return newest
+
+
+def _git_state(base: Path | None) -> float:
+    """项目**最近那个** `.git` 里，"一变就该重算"的东西的最新 mtime（没有 git 回 `0.0`）。
+
+    🔴 为什么是 `stat` 而不是 `git rev-parse`：`_sources_state()` 每次访问缓存都要问一遍 ——
+       起进程就等于把这一层"记忆化"的意义抹掉（那正是它存在的理由，见 `_MEMO` 那段）。
+    🔴 走法照 git 自己：从项目根往上找**第一个** `.git`（目录，或 worktree / submodule 那种
+       文件）。一个都没有 ⇒ `0.0`（"这个项目不受版本控制"也是**一种状态**，一样要能变）。
+    🔴 要看的几样各有分工，少一样就有一类"做了那个动作而画布不动"：
+       · `.git` 自己 + `HEAD` —— `git init` / 切分支 / detach / 换仓库根；
+       · `index` —— `git add`；
+       · `refs/**` 与 `logs` —— **提交**（⚠️ 只看 `refs` 目录的 mtime **不够**：
+         改一个已经存在的 ref 文件不会让目录的 mtime 变），所以这两棵小树递归；
+       · `packed-refs` —— 打包过的仓库（`git gc` / 服务器上克隆下来的）。
+    ⚠️ 只看**最近那个** `.git`（不把上层的也叠进来）：git 自己就是这么判"这个目录属于哪个仓库"的，
+       叠上来会让"在外层仓库里新 init 一个"这种变化被别的仓库的活动搅浑。
+    """
+    if base is None:
+        return 0.0
+    here = Path(base).resolve()
+    while True:
+        git = here / '.git'
+        if git.exists():
+            newest = 0.0
+            # ⚠️ 这几个**只 stat 自己**（`git` 只 stat 目录本身，别递归 —— 见 `_newest_mtime()`）。
+            for path in (git, git / 'HEAD', git / 'index', git / 'packed-refs'):
+                try:
+                    newest = max(newest, path.stat().st_mtime)
+                except OSError:
+                    continue
+            for path in (git / 'refs', git / 'logs'):
+                newest = max(newest, _newest_mtime(path))
+            return newest
+        parent = here.parent
+        if parent == here:  # 到盘符根了，还没找到仓库
+            return 0.0
+        here = parent
+
+
 def _group_apps(files: list[tuple[str, str, str]]) -> dict[str, dict[str, str]]:
     """把"仓库里的文件"归到各个 app 名下（`shape_ast.derive()` 的入参形态）。
 

{labull_framework-0.1.28 → labull_framework-0.1.30/labull_framework.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: labull-framework
-Version: 0.1.28
+Version: 0.1.30
 Summary: Labull Framework: a pluggable Django app with Authing OIDC login and magic blocks
 Author: Labull Framework
 License-Expression: MIT

{labull_framework-0.1.28 → labull_framework-0.1.30}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "labull-framework"
-version = "0.1.28"
+version = "0.1.30"
 description = "Labull Framework: a pluggable Django app with Authing OIDC login and magic blocks"
 readme = "README-pypi.md"
 requires-python = ">=3.10"