psf / black

GitHub metadata 把這個 repository 描述為「The uncompromising Python code formatter」（毫不妥協的 Python 程式碼格式化工具），並列出文件首頁 https://black.readthedocs.io/en/stable/ 。它的 topic 標籤包括 python、formatter、codeformatter 和 pre-commit-hook。平台 metadata 回報的主要語言是 Python，在記錄到的語言分布中有 5,440,093 個 Python 位元組。分析處理了 482 個檔案，並指出 action/main.py 是偵測到的起點。記錄到的授權是 MIT。計數器記錄到 41,844 個 star（截至 2026-09-14），最新 release 是 2026-05-18 發布的 26.5.1。描述和首頁是來自 GitHub API 的作者自述值；topic、語言、授權、star 和 release 欄位則是觀察到的平台記錄。

分析器依檔名啟發式規則，把 action/main.py 標為可能的可執行進入點。從它追出的有界執行路徑到達 os.getenv 和 Path，然後就停在未解析的外部邊界，所以從這個檔案能靜態看到的流程很淺。主要的套件各自帶有 __main__ 守衛：

• src/black/__init__.py 以 if __name__ == "__main__": patched_main() 結尾
• src/blackd/__init__.py 用的是同樣的 patched_main() 模式
• src/blib2to3/pgen2/driver.py 在守衛底下透過 sys.exit(int(not main())) 結束
• scripts/generate_schema.py 呼叫 main()；scripts/release.py 呼叫 sys.exit(main())

分析總共記錄了 18 個進入點和 176 條有界執行路徑。

有四個頂層目錄被標為可能的子系統：docs、scripts、src 和 tests。記錄到的關係圖有 9,339 條邊：8,219 個呼叫和 1,120 個 import，其中 8,487 條是外部或未解析，852 條在本地解析。角色候選是依已靜態解析的呼叫次數計算的：

• src/black/linegen.py（79 個呼入／79 個呼出）和 src/black/trans.py（66／66）是 service/core 候選，符合樞紐式格式化邏輯的樣貌。
• 在列出的角色中，tests/util.py 的呼入次數最高（118 入／18 出）；tests/test_black.py 的呼出次數最高（104 入／177 出）。
• src/black/__init__.py 是 entry/orchestration 候選（42／42）；comments.py、nodes.py 和 files.py 是中等連結度的 service/core 候選。

因為大部分關係都未解析，這些次數只描述已在本地解析的那一部分。

這個 repository 有 7 個建置／依賴清單檔。這次分析的依賴解析只讀 requirements 形式的清單檔，略過 pyproject.toml 的依賴表，所以這份分析資料沒有逐項列出任何具體的依賴記錄。tests 目錄提供了 326 個類測試檔案。

測試面：

• tests/test_black.py 定義了 BlackTestCase（第 171-2283 行），以及 TestCaching、TestFileCollection、TestDeFactoAPI 和 TestASTSafety 類別。
• tests/util.py 定義了共用的輔助函式：assert_format、all_data_cases 和 read_data。
• scripts/fuzz.py 在它的 __main__ 守衛底下執行 test_idempotent_any_syntactically_valid_python，註解裡說明在有 Atheris 時可選擇進行 coverage-guided fuzzing。

1. README.md 和 pyproject.toml：分析器把兩者都歸為專案層級的重要檔案。因為擷取是逐行進行的，來自 README 的陳述請當作作者自述。
2. LICENSE：記錄到的授權是 MIT。
3. src/black/__init__.py：先讀 main()（第 554-776 行），再讀 get_sources()（779-874）和 reformat_code()（877-904）。
4. src/black/linegen.py：LineGenerator（110-735）和 transform_line（750-885）都在這裡；依呼叫次數，它是核心候選。src/black/trans.py 也是。
5. action/main.py：分析器標記的起始進入點，所以是合理的第一站。

• 記錄到的 9,339 條靜態關係中有 8,487 條是外部或未解析。
• 反射、執行期依賴注入、動態 import、monkey-patching、產生的程式碼、框架在執行期的接線和動態分派都沒有解析，所以透過這些機制進行的外掛式載入，這次分析沒有追蹤。
• 安裝、執行與建置的推論並不完整，安裝指令也沒有確認。
• 依賴解析只涵蓋 requirements 形式的清單檔，所以這裡沒有逐項列出宣告的依賴。
• 分析資料裡從 action/main.py 出發的每一條有界執行路徑，都以 unresolved_boundary 為由結束；沒有一條被實際執行。
• manifest 的能力欄位描述的是分析器本身，不是被分析的 repository，因此不算在 repository 的證據裡。
• 分析資料的目錄清單裡有一個頂層的 plugin 目錄，但資料中沒有任何內容能確定它怎麼被發現或載入；這一點仍未解決。