simonw / datasette · 原始碼導讀

這份導讀依據分析器的課程和可依行定位的區塊，提供一條有先後次序的 repository 閱讀順序。導讀裡的行號範圍，來自分析器在有界靜態分析下，為被分析版本記錄的區塊。在這次分析中，區塊是分析器可依行定位的單位，它的說明反映的是靜態推論，而不是動態執行的證明。

先檢視頂層的容器，它們勾勒出橫跨應用程式核心和測試 fixture 的程式碼庫輪廓。

• datasette/__main__.py:1-4：module datasette/__main__.py，datasette/__main__.py 裡被分析程式碼的檔案層級容器。
• tests/build_small_spatialite_db.py:1-23：module tests/build_small_spatialite_db.py，tests/build_small_spatialite_db.py 裡被分析程式碼的檔案層級容器。
• tests/fixtures.py:1-492：module tests/fixtures.py，tests/fixtures.py 裡被分析程式碼的檔案層級容器。
• datasette/app.py:1-3552：module datasette/app.py，datasette/app.py 裡被分析程式碼的檔案層級容器。
• datasette/cli.py:1-918：module datasette/cli.py，datasette/cli.py 裡被分析程式碼的檔案層級容器。

順著靜態重建的執行順序，從 main 的呼叫走到命令列的處理。

• datasette/__main__.py:3-4：main_guard __main__，控制在直接執行（而不是被 import）時才會跑的程式碼。
• datasette/cli.py:127-134：function cli，封裝一個具名的操作，沒有任何已解析的下游關係。
• datasette/app.py:1-3552：module datasette/app.py，datasette/app.py 裡被分析程式碼的檔案層級容器。

靜態執行路徑從 datasette/__main__.py:__main__ 直接追進 datasette/cli.py:cli。

分析器核心程式碼課程的八個區塊，全都直接位在函式庫程式碼裡。請注意，接下來的函式庫閱讀集是 AI Frontier 實驗室依呼叫次數挑選的，不是分析器的課程。

在 datasette/utils/__init__.py（service 候選，519 個呼入、53 個呼出）裡：

• datasette/utils/__init__.py:576-655：function make_dockerfile，連到 24 條下游關係。
• datasette/utils/__init__.py:659-736：function temporary_docker_directory，連到 31 條下游關係。

在 datasette/app.py（entry 候選，356 個呼入、197 個呼出）裡：

• datasette/app.py:394-3037：class Datasette，把相關的行為歸在同一個類別邊界裡。
• datasette/app.py:3040-3314：class DatasetteRouter，把相關的行為歸在同一個類別邊界裡。

在 datasette/utils/asgi.py（service 候選，369 個呼入、21 個呼出）裡：

• datasette/utils/asgi.py:86-284：class Request，把相關的行為歸在同一個類別邊界裡。
• datasette/utils/asgi.py:506-610：class Response，把相關的行為歸在同一個類別邊界裡。

在 datasette/views/table.py（service 候選，46 個呼入、283 個呼出）裡：

• datasette/views/table.py:1956-2436：function table_view_data，連到 142 條下游關係。
• datasette/views/table.py:923-1236：class TableInsertView，把相關的行為歸在同一個類別邊界裡。

修改程式時，請先檢查這些區塊，因為靜態圖顯示它們在 Python 和用戶端 JavaScript 兩邊都有集中的耦合和下游依賴。

• datasette/app.py:394-3037：class Datasette，把相關的行為歸在同一個類別邊界裡。
• datasette/static/edit-tools.js:2761-3137：function createTableAlterColumnRow，連到 158 條下游關係。
• datasette/views/table.py:1956-2436：function table_view_data，連到 142 條下游關係。
• datasette/static/edit-tools.js:969-1280：function createTableColumnRow，連到 142 條下游關係。
• datasette/resources.py:23-41：class TableResource，把相關的行為歸在同一個類別邊界裡。
• datasette/app.py:2684-2954：function Datasette._routes，連到 131 條下游關係。

這份導讀嚴格建立在靜態分析上。它無法解析反射、動態 import、執行期依賴注入、monkey-patching 或動態分派這類動態行為。指令和執行流程都沒有驗證，壓縮過的素材在解析時被略過，不確定性課程裡信心值較低的區塊，只能當作有限度的參考。