Textualize / rich

這個 repository 是名為 rich 的 Python 發行套件的原始碼：在 setup.py 裡，一個 __main__ 守衛會呼叫 setuptools.setup(name="rich")。

• GitHub 的描述把這個專案介紹為在終端機裡呈現豐富文字與排版的 Python 函式庫，列出的首頁是 https://rich.readthedocs.io/en/latest/ 。
• 它幾乎完全以 Python 撰寫（1,701,402 個語言位元組，Batchfile 和 Makefile 只占一小部分），GitHub topics 包括 terminal、tables、markdown、syntax-highlighting、progress-bar、emoji、traceback 和 tui。
• 授權 metadata 寫的是 MIT，也有 LICENSE 檔案。
• metadata 記錄了 2026-04-12 發布的 v15.0.0 release，以及截至 2026-09-14 的 57,362 個 star。
• 分析器清點了 553 個檔案和 3 個建置／依賴清單檔；它的摘要說這個專案是圍繞 assets、benchmarks、docs 和 examples 組織的，並把 rich/（連同 tests/、benchmarks/ 和 docs/）標為子系統。

• setup.py 的 __main__ 守衛會呼叫 setuptools.setup(name="rich")；這是打包用的入口。
• 分析器的 repository 摘要指出，這個專案沒有確定出明確的可執行起點。
• 它偵測到 63 個進入點，追出 612 條有界執行路徑。
• examples/attrs.py 在一個 __main__ 守衛底下建立 Point3D、Triangle 和 Model 物件。
• 從這個守衛出發的有界追蹤，在本地到達 Model 和 Triangle，然後停在 print、SystemExit 和 attr.Factory 這類未解析的外部邊界。
• examples/cp_progress.py 只接受剛好三個 argv 項目，並透過 progress.open 把檔案 argv[1] 複製到 argv[2]；examples/downloader.py 把參數傳給一個 download() 呼叫；examples/print_calendar.py 用 argparse 解析年份，然後呼叫 print_calendar。
• 許多 rich/*.py 模組都帶有 __main__ 示範區塊，常標著 # pragma: no cover（例如 rich/console.py、rich/markdown.py、rich/syntax.py），這暗示這個套件本身也充當自己的示範展示集。

• 四個頂層目錄被標為子系統：rich/（可以 import 的套件）、tests/、benchmarks/ 和 docs/。
• 分析器記錄了 11,248 條靜態關係：9,630 個呼叫和 1,618 個 import，其中 4,545 條在本地解析，6,703 條仍是外部或未解析。
• 依靜態呼入次數，被引用最多的模組是 rich/text.py（707）、rich/style.py（474）、rich/console.py（416）和 rich/segment.py（337）；rich/console.py 另有 78 個呼出，分析器把這些模組標為 core/orchestration 候選。
• 測試模組的形狀正好相反：tests/test_text.py 有 329 個呼出、沒有呼入，tests/test_highlighter.py 有 231 個，tests/test_segment.py 有 221 個；是測試在驅動函式庫程式碼，而不是反過來。
• rich/pretty.py（149 個呼入）和 rich/progress.py（133）也被大量引用；rich/default_styles.py 則只有 1 個呼入、154 個呼出，這和「提供預設樣式」的角色一致。

• 分析資料裡的依賴記錄只來自一個清單檔 docs/requirements.txt：alabaster 1.0.0、Sphinx 8.2.3、sphinx-rtd-theme 3.0.2 和 sphinx-copybutton 0.5.2，全都固定了版本。
• 這個樣貌並不完整：分析器只解析 requirements 形式的依賴清單，不讀 pyproject.toml 的依賴表，雖然這個 repository 有 3 個建置／依賴清單檔。
• 測試套件有 68 個測試檔案，包括 tests/conftest.py。
• 看得到的測試函式涵蓋文字操作（tests/test_text.py 裡的 test_span、test_add、test_eq）、segment 處理（tests/test_segment.py 裡的 test_split_lines、test_simplify）和語法標示（tests/test_highlighter.py 裡的 test_highlight_regex、test_highlight_json_with_indent）。
• 有幾個測試檔案也帶有 __main__ 區塊，會渲染 fixture 並印出結果，例如 tests/test_table.py 和 tests/test_card.py。
• 安裝、執行與建置的推論並不完整，安裝指令也沒有驗證，所以這份分析資料給不出可以照做的安裝步驟。

• 從 README.md 和 pyproject.toml 開始；分析器把兩者都歸為專案層級的重要檔案。
• 接著略讀 setup.py 看打包細節，看 LICENSE 了解條款。
• 程式碼方面，依這個順序讀連結次數最高的模組：rich/text.py（它的 Text 類別在第 118–1335 行），然後是 rich/style.py、rich/console.py 和 rich/segment.py。
• 最後看被標為可能進入點的可執行範例：examples/attrs.py、examples/cp_progress.py、examples/downloader.py 和 examples/print_calendar.py。
• 一個精簡的端到端範例是 rich/pager.py 的示範區塊：它從 rich/__main__.py import make_test_card，再透過 console.pager 顯示出來。

• 11,248 條靜態關係中有 6,703 條仍是外部或未解析，所以許多跨檔案的呼叫目標沒有對應到定義。
• 反射、執行期依賴注入、動態 import、monkey-patching、產生的程式碼、框架在執行期的接線和動態分派，這次靜態分析都沒有解析。
• 這裡沒有任何內容能確立執行時的行為：安裝、執行與建置的推論並不完整也沒有驗證；有界掃描不解析超過 400 kB 的檔案、壓縮打包檔或 vendored 目錄，關係擷取也有每個檔案和每個 repository 的上限。
• README 文字是逐行擷取的，可能抓到程式碼行，所以任何來自 README 的陳述都應視為作者自述。
• 有一條執行路徑含有偵測到的靜態呼叫循環；它是否反映真實執行時的循環，無法確定。
• 這 612 條有界執行路徑是分析器靜態建構出來的；為了這份指南，沒有執行任何程式碼。

• rich/text.py：Span（第 47–115 行）和大型的 Text 類別（118–1335）；rich/segment.py：Segment（61–696），另有 Segments 和 SegmentLines；rich/style.py：Style（40–759）和 StyleStack。
• rich/console.py：ConsoleOptions（113–243）、Capture（310–340）、PagerContext（364–400）和 ScreenContext（403–447）。
• rich/progress.py：track()、wrap_file()、ProgressColumn，以及欄位類別 SpinnerColumn、TextColumn 和 RenderableColumn；rich/pretty.py：install() 和 Pretty 類別。