simonw / sqlite-utils · 原始碼導讀

這份導讀安排了一連串走過 repository 程式碼的閱讀站點。每一個行號範圍都直接指向被分析版本的檔案。在這次分析中，區塊是靜態分析找出的可依行定位單位，它的摘要或理由反映的是分析器的推論，而不是執行時的驗證。

在檢視細部實作之前，先從定位課程找出的 repository 地標和檔案層級容器區塊開始。

• sqlite_utils/__main__.py:1-4：module sqlite_utils/__main__.py 提供 sqlite_utils/__main__.py 裡被分析程式碼的檔案層級容器。
• sqlite_utils/cli.py:1-3813：module sqlite_utils/cli.py 提供 sqlite_utils/cli.py 裡被分析程式碼的檔案層級容器。

從找到的進入點開始追蹤執行路徑，跟著本地呼叫走，並留意未解析的外部邊界。

• sqlite_utils/__main__.py:3-4：main_guard __main__ 控制 sqlite_utils/__main__.py 被直接執行時才會跑的程式碼。
• sqlite_utils/cli.py:180-181：function cli 封裝一個簽名為 def cli(): 的操作，這個區塊不需要任何已解析的下游關係。
• sqlite_utils/cli.py:1-3813：module sqlite_utils/cli.py 是涵蓋第 1-3813 行的檔案層級容器。
• sqlite_utils/utils.py:87-99：function maximize_csv_field_size_limit 封裝一個簽名為 def maximize_csv_field_size_limit() -> None: 的操作，連到 2 條下游呼叫或 import 關係。

靜態執行路徑把 sqlite_utils/__main__.py:__main__ 連到 sqlite_utils/cli.py:cli，而從 sqlite_utils/cli.py 出發的進入點呼叫，會先到達 sqlite_utils/utils.py:maximize_csv_field_size_limit，再碰上外部邊界。

核心程式碼課程的八個區塊中，有六個位在函式庫程式碼裡。在函式庫程式碼之外，文件區塊 docs/conf.py:47-51（_linkcode_git_ref）和 docs/conf.py:54-93（linkcode_resolve）連到下游關係。函式庫程式碼裡的其他核心程式碼區塊包括 sqlite_utils/cli.py:59-67（_register_db_for_cleanup）、sqlite_utils/cli.py:70-76（_close_databases）和 sqlite_utils/cli.py:96-101（CaseInsensitiveChoice）。

函式庫閱讀集是依靜態呼叫次數確定性地挑選的，不是分析器的課程：

sqlite_utils/db.py 是 service/core 候選，有 381 個呼入和 317 個呼出：

• sqlite_utils/db.py:2253-5475：class Table 把相關的行為歸在同一個類別邊界裡。
• sqlite_utils/db.py:538-2094：class Database 把相關的行為歸在同一個類別邊界裡。

sqlite_utils/cli.py 是 entry/orchestration 候選，有 127 個呼入和 194 個呼出：

• sqlite_utils/cli.py:1061-1323：function insert_upsert_implementation 封裝一個操作，連到 56 條下游呼叫或 import 關係。
• sqlite_utils/cli.py:2105-2260：function memory 封裝一個操作，連到 39 條下游呼叫或 import 關係。

sqlite_utils/create_table_parser.py 是 service/core 候選，有 165 個呼入和 122 個呼出：

• sqlite_utils/create_table_parser.py:664-725：function _column_uniques 封裝一個操作，連到 18 條下游呼叫或 import 關係。
• sqlite_utils/create_table_parser.py:233-293：function _lex 封裝一個操作，連到 31 條下游呼叫或 import 關係。

sqlite_utils/utils.py 是 service/core 候選，有 91 個呼入和 16 個呼出：

• sqlite_utils/utils.py:288-405：function rows_from_file 封裝一個操作，連到 31 條下游呼叫或 import 關係。
• sqlite_utils/utils.py:454-500：class ValueTracker 把相關的行為歸在同一個類別邊界裡。

規劃修改時，請優先考慮這些區塊，因為靜態關係圖顯示它們的下游耦合很強。

• sqlite_utils/db.py:2773-3254：function Table.transform_sql 封裝一個操作，連到 156 條下游呼叫或 import 關係。
• sqlite_utils/db.py:93-99：function quote_identifier 封裝一個操作，連到 2 條下游呼叫或 import 關係。
• sqlite_utils/db.py:99-99：straight_line quote_identifier 把 quote_identifier 裡相鄰的循序陳述式歸在一起。
• sqlite_utils/db.py:4673-5029：function Table.insert_all 封裝一個操作，連到 121 條下游呼叫或 import 關係。
• sqlite_utils/db.py:1429-1698：function Database.create_table_sql 封裝一個操作，連到 109 條下游呼叫或 import 關係。
• sqlite_utils/db.py:4305-4518：function Table.build_insert_queries_and_params 封裝一個操作，連到 70 條下游呼叫或 import 關係。

這份導讀嚴格來自靜態分析。反射、執行期依賴注入、動態 import、monkey-patching、產生的程式碼、框架在執行期的接線和動態分派都沒有解析。此外，在被分析的版本中，有 7360 條靜態關係仍是外部或未解析，區塊註解也仍是附帶信心值的推論。像 docs/_static/js/custom.js:1-23 這樣的非函式庫檔案，靜態上的確定性較弱。