Gitingest 可以把本機目錄整理成摘要、目錄樹與檔案內容三個結果。這次 0.3.1 的 Python API 在斷網容器讀取合成專案,摘要列出兩個檔案,且指定文字和程式碼都還在。這是本機整理資料的測試,沒有測試 GitHub 網站服務或私人儲存庫登入。
需要更細的打包範圍時,可比較 Repomix 的檔案篩選;少量本機文字檔可另看 files-to-prompt 的輸出格式。
準備能知道答案的專案
project/ 放 README.md 與 sum.py。README 的驗收句是 Dispatch NOTE-31 leaves at 08:30.,程式碼要包含 return a + b。再放 private.txt 與 debug.log 作為排除對照。不要直接拿正在工作的資料夾做第一次測試。
取得三個回傳值
在 Python 3.12 的虛擬環境安裝固定版本,再執行以下程式。include_patterns 限定檔案類型,exclude_patterns 明列本次不需要的內容。先讀 summary 和 tree,確定範圍,再決定是否使用 content。
以下為 POSIX shell 指令;本次在 Linux 容器測試,未測 Windows shell。
python -m pip install "gitingest==0.3.1"
python - <<'PY'
from gitingest import ingest
summary, tree, content = ingest("./project", include_patterns={"*.md", "*.py"}, exclude_patterns={"private.txt", "*.log"})
print(summary)
print(tree)
print(content)
PY
本次輸出與錯誤
summary 顯示 Files analyzed: 2;tree 只有 README.md 與 sum.py。content 保留驗收句與加法函式,沒有兩份排除記錄,來源雜湊前後相同。不存在的目錄引發 ValueError,不是成功的空結果。自動化時要把例外和正常輸出分開處理,不能只看有沒有產生字串。
適用範圍與選擇
本機 API 的三段結果適合你自行組合提示或做檔案覆蓋檢查。網站版、遠端 clone 與私人儲存庫依官方文件 v0.3.1 及保存的上游快照整理,未本地實測。沒有測過大型專案速度或 LLM 回答品質;需要單一帶說明的打包文件時,可比較 Repomix 的輸出結構。
官方來源與測試範圍
本次為 Codex 在無發布憑證、非 root、斷網容器執行的合成資料測試,不代表站長親測。套件版本為 0.3.1;文件快照為 4e259a02fe72。