pyrasite
將程式碼注入到執行中的 Python 程序
pyrasite 是什麼?
將程式碼注入到正在執行的 Python 程序中方面工具。屬於監控類別,採用 GPL-3.0 授權。
pyrasite 概覽
這是什麼
pyrasite 是一套工具,用於將任意程式碼注入到正在執行的 Python 程序中。它透過 gdb(7.3 或更新版本)附加到目標程序,並在該程序的直譯器中執行 Python 程式碼。此專案託管於 GitHub,採用 GPL-3.0 授權。
主要功能
- 將任意 Python 程式碼注入到正在執行的 CPython 程序,無需重新啟動。
- 支援跨 Python 版本注入(CPython 3.9 至 3.15)。
- 可選安裝記憶體檢視器(
pip install pyrasite[memory-viewer])。 - 提供兩種注入方式:預設的佇列方式(使用
Py_AddPendingCall)適用於多執行緒程序,以及直接方式(--inject-method direct)適用於卡在 C 層的程序。 - 僅在 Linux 系統上運作,需適當的 ptrace 設定。
使用情境
在生產環境中即時除錯,檢查或修改正在執行的 Python 程序狀態。為長時間運行的伺服器動態加入日誌或診斷功能,無需重啟。即時修補正在運行的應用程式以修正錯誤或改變行為。從無法停止的程序中提取資料。
快速開始
使用 pipx 或 pip 安裝 pyrasite:pipx install pyrasite若要安裝記憶體檢視器:pip install pyrasite[memory-viewer]基本用法:pyrasite 詳細的 ptrace 設定與注入方式說明請參閱儲存庫的 README。
授權與價格
pyrasite 是開源軟體,採用 GPL-3.0 授權。未提供價格資訊,可免費使用。
內容整理自該專案公開的 README 與儲存庫資訊。