docs:已知輸出差異補 mine/pulls 欄位集差異(#26)
gitea.py 的 mine/pulls 輸出完整 API 物件是 _dump 直接傾倒的副作用, 欄位集隨 Gitea 版本浮動;teai 維持策展摘要欄位(機器可讀優先), 交叉驗證比對項目集合與判定語義,不逐欄位比對。判定 #26。
This commit is contained in:
@@ -276,6 +276,12 @@ teai whoami # 目前帳號(讀 tea 組態)
|
|||||||
- **空清單**:`gitea.py` 的 `_dump` 對空清單**不輸出任何內容**;teai 的清單類命令
|
- **空清單**:`gitea.py` 的 `_dump` 對空清單**不輸出任何內容**;teai 的清單類命令
|
||||||
(`mine`/`pulls`)空清單輸出 `[]`。對 JSON 消費者來說 `[]` 比「無輸出」更明確,
|
(`mine`/`pulls`)空清單輸出 `[]`。對 JSON 消費者來說 `[]` 比「無輸出」更明確,
|
||||||
交叉驗證時以此差異為準。`next` 兩者語義相同(無工作 → `null`/「沒有未完成的工作」)。
|
交叉驗證時以此差異為準。`next` 兩者語義相同(無工作 → `null`/「沒有未完成的工作」)。
|
||||||
|
- **清單欄位集(`mine`/`pulls`)**:`gitea.py` 直接傾倒完整 Gitea API 物件
|
||||||
|
(`_dump` 的副作用,欄位集隨 Gitea 版本浮動);teai 輸出策展摘要欄位
|
||||||
|
(`mine`:repo/number/title/url;`pulls`:number/title/state/author/
|
||||||
|
head/base/updated_at…依命令定義)。交叉驗證比對**項目集合**(列出哪些
|
||||||
|
issue/PR)與判定語義,不逐欄位比對;`next`/`stalled` 兩者為策展欄位且
|
||||||
|
鍵集鍵序全等,可逐欄位比對。判定 #26(維持摘要、文件化差異)。
|
||||||
- **全域選項位置**:teai 的全域選項(`--output` 等)可出現在命令之前或之後,
|
- **全域選項位置**:teai 的全域選項(`--output` 等)可出現在命令之前或之後,
|
||||||
且可與命令旗標交錯(`teai members --has-work --output table`);
|
且可與命令旗標交錯(`teai members --has-work --output table`);
|
||||||
gitea.py 的旗標剖析較寬鬆,兩者命令列介面以此行為對齊。
|
gitea.py 的旗標剖析較寬鬆,兩者命令列介面以此行為對齊。
|
||||||
|
|||||||
Reference in New Issue
Block a user