labull-framework 1.0.0__tar.gz → 1.0.1__tar.gz

{labull_framework-1.0.0/labull_framework.egg-info → labull_framework-1.0.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: labull-framework
-Version: 1.0.0
+Version: 1.0.1
 Summary: Labull Framework: a pluggable Django app with Authing OIDC login and magic blocks
 Author: Labull Framework
 License-Expression: MIT
@@ -95,7 +95,7 @@ CORS_ORIGIN=http://localhost:5173
 |---|---|
 | **谁是管理员** | 配 `BOOTSTRAP_ADMIN_WORK_IDS=工号,工号` —— 它是**声明式**的名单：启动时名单里的人补上 `is_staff`，**名单之外的一律清掉**（没配就是"一个管理员都没有"）。它不碰 `is_superuser`，所以别拿超管当后门 |
 | **看数据模型那一页** | 设 `LABULL_SCHEMA_CANVAS=on`，浏览器打开 `/` |
-| **让块的依赖声明拦住保存** | 设 `LABULL_REQUIRES=error`（默认 `warn`：判据照跑、**只提示不拦保存**；`off` 整段不跑） |
+| **块的依赖声明不许"用了却没声明"** | 它是**默认**行为（`LABULL_REQUIRES=error`，1.0.1 起）：代码里用了没声明的东西 ⇒ 拦住保存。⚠️ 升级前先在项目里跑一遍 `python manage.py labull_requires --write` 把存量块扫得到的声明补进库；`warn`（只提示不拦）与 `off`（整段不跑）都要**显式**写 |
 | **导出一份模型形状** | `python manage.py labull_contract --out .labull/contract.json` |
 
 ## magic block
@@ -107,7 +107,8 @@ CORS_ORIGIN=http://localhost:5173
 ├─ index.open.html        入口（必备）
 ├─ magic-block.open.yaml  清单（必备）：`id` / `module` / `name` / `brief` 四个键必填
 │                         + `requires`（依赖声明：用了哪些模型 / pip 包 / settings 键 / `BLOCK_*`）可选
-├─ README.open.md         **业务功能说明**（Markdown，可选）：这一段的家就是这份文件，不在清单里
+├─ README.open.md         **业务功能说明**（Markdown）：这一段的家就是这份文件，不在清单里
+│                         （**每个块都会有一份** —— 导出时无条件铺，没写就是空文件）
 ├─ requires.open.yaml     依赖声明的**草稿**（导出铺下来的：正文进清单的 `requires`，注释是扫代码的建议）
 ├─ 任意 js / css
 ├─ excluded/_*            你自己的地盘（测试 / 草稿）：**照样进库，执行时忽略**

{labull_framework-1.0.0 → labull_framework-1.0.1}/README-pypi.md

@@ -67,7 +67,7 @@ CORS_ORIGIN=http://localhost:5173
 |---|---|
 | **谁是管理员** | 配 `BOOTSTRAP_ADMIN_WORK_IDS=工号,工号` —— 它是**声明式**的名单：启动时名单里的人补上 `is_staff`，**名单之外的一律清掉**（没配就是"一个管理员都没有"）。它不碰 `is_superuser`，所以别拿超管当后门 |
 | **看数据模型那一页** | 设 `LABULL_SCHEMA_CANVAS=on`，浏览器打开 `/` |
-| **让块的依赖声明拦住保存** | 设 `LABULL_REQUIRES=error`（默认 `warn`：判据照跑、**只提示不拦保存**；`off` 整段不跑） |
+| **块的依赖声明不许"用了却没声明"** | 它是**默认**行为（`LABULL_REQUIRES=error`，1.0.1 起）：代码里用了没声明的东西 ⇒ 拦住保存。⚠️ 升级前先在项目里跑一遍 `python manage.py labull_requires --write` 把存量块扫得到的声明补进库；`warn`（只提示不拦）与 `off`（整段不跑）都要**显式**写 |
 | **导出一份模型形状** | `python manage.py labull_contract --out .labull/contract.json` |
 
 ## magic block
@@ -79,7 +79,8 @@ CORS_ORIGIN=http://localhost:5173
 ├─ index.open.html        入口（必备）
 ├─ magic-block.open.yaml  清单（必备）：`id` / `module` / `name` / `brief` 四个键必填
 │                         + `requires`（依赖声明：用了哪些模型 / pip 包 / settings 键 / `BLOCK_*`）可选
-├─ README.open.md         **业务功能说明**（Markdown，可选）：这一段的家就是这份文件，不在清单里
+├─ README.open.md         **业务功能说明**（Markdown）：这一段的家就是这份文件，不在清单里
+│                         （**每个块都会有一份** —— 导出时无条件铺，没写就是空文件）
 ├─ requires.open.yaml     依赖声明的**草稿**（导出铺下来的：正文进清单的 `requires`，注释是扫代码的建议）
 ├─ 任意 js / css
 ├─ excluded/_*            你自己的地盘（测试 / 草稿）：**照样进库，执行时忽略**

{labull_framework-1.0.0 → labull_framework-1.0.1}/labull_framework/env.py

@@ -201,11 +201,14 @@ ENV_ITEMS: tuple[EnvItem, ...] = (
         group='平台开关',
     ),
     # 🔴 依赖声明（`requires`）那一层的开关（名字的真源在 `magic_block/sdk.py`）：
-    #    默认 `warn` —— 存量块的清单里一个声明都没有，一上线就硬报错等于让每个块集体停用。
+    #    默认 `error`（1.0.1 起）—— "先警告、后强制"里的**后强制**已经落地了。
+    #    ⚠️ 代价如实说：库里那些**还没声明**的存量块会集体判不合格（全部停用），
+    #       所以升级前先用 `manage.py labull_requires --write` 把扫得到的声明批量补进库
+    #       （那条命令就是为这个默认值而存在的：它是这条路上唯一的恢复口）。
     EnvItem(
         name=BLOCK_REQUIRES,
-        brief='块「依赖声明」（requires）那一层的开关：off 整段不跑 / warn（默认）只提示不拦 / error 变成硬判据',
-        hint=f'{BLOCK_REQUIRES}=error',
+        brief='块「依赖声明」（requires）那一层的开关：off 整段不跑 / warn 只提示不拦（要显式写）/ error（默认）变成硬判据',
+        hint=f'{BLOCK_REQUIRES}=warn',
         group='平台开关',
     ),
     # 🔴 体检那条链一次开几个口子（名字的真源在 `magic_block/parallel.py` 的 `ENV_WORKERS`）。

{labull_framework-1.0.0 → labull_framework-1.0.1}/labull_framework/magic_block/deepcheck.py

@@ -509,6 +509,9 @@ def _any_probe_note():
 #    走，所以不额外起进程；`LABULL_REQUIRES=off` 时父进程根本不递（整段不跑）。
 # 🔴 **"代码用了却没声明"不在这里**（那一半是纯 `ast`，落在 `validate.check_requires`）：
 #    两半分开放，是因为这一半要运行环境、那一半不要 —— 混在一起会让"没 Django 时连静态判据都没跑"。
+# 🔴 **分档不在这里**（`warn` / `error` 是父进程的事，而 `LABULL_REQUIRES` 的默认档
+#    1.0.1 起是 `error`；`warn` 要显式写）：这一层只报"事实"，落位由 `_requires_check()` 按
+#    父进程递进来的 `mode` 做 —— 分档只有一处判据（`validate.requires_mode()`），两处各判一次迟早漂。
 
 _REQUIRES = _GIVEN.get('requires') if isinstance(_GIVEN.get('requires'), dict) else None
 
@@ -589,8 +592,8 @@ def _model_of(path):
 def _requires_hard():
     """"声明了但它不存在"的逐条报文（**确定**的那一档）。
 
-    ⚠️ 这里**不分档**（`warn` / `error` 是父进程的事）：这一层只报"事实"，
-       分档只有一处判据（`validate.requires_mode()`），两处各判一次迟早漂。
+    ⚠️ 这里**不分档**（`warn` / `error` 是父进程的事，默认档见 `validate.requires_mode()`）：
+       这一层只报"事实"，而分档只有一处判据，两处各判一次迟早漂。
     """
     import importlib
     from importlib import metadata
@@ -659,9 +662,11 @@ def _requires_hard():
 
 
 def _requires_check():
-    """跑一遍依赖声明的"存不存在"，并按开关落位（`warn` ⇒ 只进备注）。
+    """跑一遍依赖声明的"存不存在"，并按开关落位（`error` ⇒ 硬判据；`warn` ⇒ 只进备注）。
 
     ⚠️ 判据自己崩了**不算这个块的错**（软失败口径见文件头）：只记一句说明。
+    ⚠️ 兜底值与 `validate.requires_mode()` 的默认档**必须同一个**（1.0.1 起是 `error`）：
+       写 `warn` 的话，一份没有 `mode` 键的 payload 会悄悄退回 1.0.0 的旧行为。
     """
     if not _REQUIRES:
         return
@@ -673,7 +678,7 @@ def _requires_check():
         return
     if not hard:
         return
-    if str(_REQUIRES.get('mode') or 'warn') == 'error':
+    if str(_REQUIRES.get('mode') or 'error') == 'error':
         for message in hard:
             _STATIC.append(_issue('requires', message))
         return
@@ -809,6 +814,11 @@ def _value_model(node, imports):
         model = _manager_of(func.value)
         if model is None and isinstance(func.value, ast.Call):
             model = _value_model(func.value, imports)  # 链子的里层必须自己也是"查这批 / 查一行"
+            # 🔴 这一行与 `validate._manager_model()` 是**同一个口径**（那一份也是"一个循环同时剥
+            #    `Call` 与 `Attribute`、中间夹着 Call 也照样往左走"）。两处**必须一起改** ——
+            #    一份真源做不到：那边是 `%` 拼出来的子进程模板字符串，这边是普通函数。
+            #    只改一边的症状：`surface` 草稿与深检对同一个模型各说一套（用户截图报的漏建议
+            #    `StockTransaction.log_event` 就是 `_manager_model` 那一侧停了、这一侧没停）。
         if model is None:
             return None
         # 🔴 "查一批"也算（`for row in OrderRow.objects.all()` 里的 iter 就是这一句）：