Textualize / rich · 原始碼導讀

這份指南用幾個依序排列的站點引導你閱讀：定位、一條執行追蹤、函式庫的核心程式碼，以及對修改敏感的區塊。每一個行號範圍都直接指向版本 9d8f9a372cc5916fd4781fec207ced7ddac2f08f 裡被分析的檔案。在這份導讀中，區塊是分析器可依行定位的語意單位，每一段區塊描述代表的都是分析器的靜態推論，而不是執行時的執行追蹤。

在檢視函式庫的實作之前，先從頂層的地標和範例腳本開始，建立方向感：

• setup.py:1-8：module setup.py。分析器指出，這個檔案層級的區塊代表被分析的原始碼檔案 setup.py，並提供它的檔案層級容器。
• examples/attrs.py:1-53：module examples/attrs.py。分析器把這個區塊認定為 examples/attrs.py 的檔案層級容器。
• examples/cp_progress.py:1-19：module examples/cp_progress.py。分析器把這個區塊記錄為 examples/cp_progress.py 的檔案層級容器。
• examples/downloader.py:1-81：module examples/downloader.py。分析器把這個區塊記錄為 examples/downloader.py 的檔案層級容器。
• examples/print_calendar.py:1-70：module examples/print_calendar.py。分析器把這個區塊記錄為 examples/print_calendar.py 的檔案層級容器。
• examples/suppress.py:1-23：module examples/suppress.py。分析器把這個區塊記錄為 examples/suppress.py 的檔案層級容器。

分析器以一支範例腳本為中心重建執行的故事，追蹤直接呼叫的路徑，一路進入本地類別和外部呼叫：

• examples/attrs.py:31-53：main_guard __main__。分析器指出，這個區塊控制 examples/attrs.py 被直接執行時應該跑的程式碼。
• examples/attrs.py:1-53：module examples/attrs.py。分析器把這個區塊記錄為 examples/attrs.py 的檔案層級容器。
• examples/attrs.py:26-28：class Model。分析器推論 Model 把相關的行為歸在同一個類別邊界裡。

分析器核心程式碼課程的 8 個區塊，沒有一個位在函式庫程式碼裡。

• 那堂課程裡不在函式庫的區塊包括 examples/attrs.py:31-53（main_guard __main__）、examples/attrs.py:26-28（class Model），以及 benchmarks/benchmarks.py 裡的 benchmark 區塊：benchmarks/benchmarks.py:14-61（class TextSuite）、benchmarks/benchmarks.py:15-20（function TextSuite.setup）、benchmarks/benchmarks.py:22-23（function TextSuite.time_wrapping）、benchmarks/benchmarks.py:25-26（function TextSuite.time_indent_guides）、benchmarks/benchmarks.py:28-29（function TextSuite.time_fit）和 benchmarks/benchmarks.py:31-32（function TextSuite.time_split）。

函式庫閱讀集是 AI Frontier 實驗室依靜態呼叫次數確定性地挑選的，不是來自分析器的課程。這些模組和它們主要的區塊包括：

模組 rich/text.py 被推論為 entry/orchestration 候選，有 707 個呼入和 44 個呼出：

• rich/text.py:118-1335：class Text。分析器指出，這個類別區塊把相關的行為歸在同一個類別邊界裡。
• rich/text.py:1106-1183：function Text.divide。分析器指出，Text.divide 封裝一個操作，連到 13 條下游呼叫或 import 關係。

模組 rich/style.py 被推論為 service/core 候選，有 474 個呼入和 26 個呼出：

• rich/style.py:40-759：class Style。分析器指出，這個類別區塊把相關的行為歸在同一個類別邊界裡。
• rich/style.py:131-205：function Style.__init__。分析器指出，Style.__init__ 封裝一個操作，連到 7 條下游呼叫或 import 關係。

模組 rich/console.py 被推論為 entry/orchestration 候選，有 416 個呼入和 78 個呼出：

• rich/console.py:581-2642：class Console。分析器指出，這個類別區塊把相關的行為歸在同一個類別邊界裡。
• rich/console.py:2352-2604：function Console.export_svg。分析器指出，Console.export_svg 封裝一個操作，連到 37 條下游呼叫或 import 關係。

模組 rich/segment.py 被推論為 entry/orchestration 候選，有 337 個呼入和 7 個呼出：

• rich/segment.py:61-696：class Segment。分析器指出，這個類別區塊把相關的行為歸在同一個類別邊界裡。
• rich/segment.py:630-696：function Segment.divide。分析器指出，Segment.divide 封裝一個操作，連到 16 條下游呼叫或 import 關係。

修改指南課程標出靜態圖中耦合較強的函式庫區塊：

• rich/console.py:581-2642：class Console。分析器認為 Console 把相關的行為歸在同一個類別邊界裡。
• rich/style.py:40-759：class Style。分析器認為 Style 把相關的行為歸在同一個類別邊界裡。
• rich/text.py:47-115：class Span。分析器認為 Span 把相關的行為歸在同一個類別邊界裡。
• rich/text.py:118-1335：class Text。分析器認為 Text 把相關的行為歸在同一個類別邊界裡。
• rich/segment.py:61-696：class Segment。分析器認為 Segment 把相關的行為歸在同一個類別邊界裡。
• rich/style.py:498-561：function Style.parse。分析器指出，Style.parse 封裝一個操作，連到 17 條下游呼叫或 import 關係。

這份導讀只反映有界的靜態分析。動態分派、反射、monkey-patching、執行期依賴注入、動態 import 和框架在執行期的接線都仍未解析。安裝、執行與建置的推論並不完整，安裝指令也沒有驗證。此外，在被分析的資料集中，有 6,703 條靜態關係仍是外部或未解析，區塊註解則是附帶信心值的靜態推論。