TimeTravelDebugger 🕐
実行状態記録を用いた革命的なPythonタイムトラベルデバッグライブラリ
🚀 特徴
- 完全実行記録: すべての変数変更、関数呼び出し、実行ステップをキャプチャ
- タイムトラベルインターフェース: プログラムの実行タイムラインをナビゲート
- 多様な使用パターン: デコレータ、コンテキストマネージャー、グローバルデバッグ
- リッチ可視化: 美しいターミナルベースのタイムラインと変数検査
- EphemeralDB統合: パフォーマンス向上のための効率的なスコープベース状態ストレージ
- セッション管理: デバッグセッションの保存、読み込み、共有
- CLIツール: スクリプトデバッグ用のコマンドラインインターフェース
- インタラクティブエクスプローラー: 実行状態をインタラクティブにナビゲート
📦 インストール
pip install Travel-Debugger
必要要件
- Python 3.8+
- ephemeraldb>=1.0.0
- rich>=13.0.0 (拡張可視化用)
- click>=8.0.0 (CLI用)
🎯 クイックスタート
1. デコレータ使用法
from Travel_Debugger import time_travel_debug
@time_travel_debug
def fibonacci(n):
if n <= 1:
return n
return fibonacci(n-1) + fibonacci(n-2)
result = fibonacci(5)
# デバッグデータにアクセス
session = fibonacci.get_last_session()
timeline = session.get_timeline()
variables = session.get_variables_at_time(0.5)
2. コンテキストマネージャー使用法
from Travel_Debugger import TimeTravelContext
with TimeTravelContext() as debugger:
# あなたのコードをここに
result = complex_calculation(10)
# デバッグデータに即座にアクセス
timeline = debugger.get_timeline()
state = debugger.get_state_at_time(0.5)
3. グローバルデバッグ
from Travel_Debugger import start_global_debugging, stop_global_debugging
start_global_debugging()
# あなたのコードをここに
result = my_function()
stop_global_debugging()
timeline = get_global_timeline()
🔍 可視化
タイムライン可視化
from Travel_Debugger import print_timeline
print_timeline(debugger.get_timeline())
変数検査
from Travel_Debugger import print_variables_at_time
print_variables_at_time(debugger, timestamp=0.5)
インタラクティブタイムラインエクスプローラー
from Travel_Debugger import interactive_timeline_explorer
interactive_timeline_explorer(debugger)
🖥️ コマンドラインインターフェース
デバッグ付きでスクリプトを実行
ttdbg run my_script.py --timeline --summary
インタラクティブにコードをデバッグ
ttdbg debug --code "print('Hello, World!')" --interactive
保存されたセッションを読み込んで分析
ttdbg load debug_session.json --interactive
保存されたセッション一覧
ttdbg list-sessions
📊 高度な機能
カスタムフィルタリング
def my_filter(frame):
# 私のモジュール内の関数のみをトレース
return 'my_module' in frame.f_code.co_filename
@time_travel_debug(filter_func=my_filter)
def my_function():
# この関数とmy_module内の呼び出しのみがトレースされます
pass
セッション管理
# セッションを保存
debugger.export_session().export_to_file("my_debug_session.json")
# セッションを読み込み
from Travel_Debugger import load_session
session = load_session("my_debug_session.json")
検索と分析
# 特定の値を持つ変数のすべての状態を検索
states = debugger.search_variables('result', value=42)
# すべての関数呼び出しを取得
call_states = debugger.get_states_by_event('call')
# 特定の関数のすべての状態を取得
func_states = debugger.get_states_by_function('fibonacci')
🏗️ アーキテクチャ
TimeTravelDebuggerは、Pythonのsys.settrace()メカニズムを使用してプログラム実行にフックし、効率的なスコープベース状態ストレージにEphemeralDBを使用します:
- 実行トレース: すべての行実行、関数呼び出し、リターンをキャプチャ
- 状態記録: 変数状態とコールスタックを安全にシリアライズ
- スコープベースストレージ: 関数コンテキスト用にEphemeralDBの階層スコープを使用
- タイムライン管理: 時系列実行履歴を維持
- インタラクティブ分析: キャプチャしたデータを探索するためのツールを提供
📈 パフォーマンスの考慮事項
- メモリ使用量: メモリオーバーフローを防ぐためタイムラインサイズが制限されています
- フィルタリング: 関連するコードのみをトレースするためにカスタムフィルターを使用
- セッション管理: 古いセッションは自動的にクリーンアップされます
- 安全なシリアライゼーション: シリアライズ不可能なオブジェクトは適切に処理されます
🔧 設定
環境変数
TTDBG_MAX_TIMELINE_SIZE: キャプチャする状態の最大数 (デフォルト: 10000)TTDBG_USE_RICH: リッチターミナルフォーマットの有効/無効 (デフォルト: true)
プログラマティック設定
debugger = TimeTravelDebugger()
debugger.max_timeline_size = 5000 # タイムラインサイズを制限
📝 使用例
包括的な使用例については examples/ ディレクトリを参照してください:
basic_example.py: シンプルな関数デバッグfibonacci_example.py: 再帰関数分析recursive_example.py: 高度な再帰アルゴリズム
🤝 コントリビューション
- リポジトリをフォーク
- 機能ブランチを作成 (
git checkout -b feature/amazing-feature) - 変更をコミット (
git commit -m 'Add amazing feature') - ブランチにプッシュ (
git push origin feature/amazing-feature) - プルリクエストを開く
📄 ライセンス
このプロジェクトはMITライセンスの下でライセンスされています - 詳細はLICENSEファイルを参照してください。
🙏 謝辞
- 効率的な状態ストレージのために EphemeralDB を使用
- 可視化は Rich によって実装
- CLIインターフェースは Click で構築
🔗 リンク
ハッピータイムトラベリング! 🕐✨
Metadata
Release files for Travel-Debugger 1.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| travel_debugger-1.1.0.tar.gz | 9.5 kB | Without provenance | Details for travel_debugger-1.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| travel_debugger-1.1.0-py3-none-any.whl | Python 3 | none | any | Details for travel_debugger-1.1.0-py3-none-any.whl |
Total release size: 19.8 kB
Release files / travel_debugger-1.1.0.tar.gz
| Download URL | travel_debugger-1.1.0.tar.gz |
|---|---|
| Size | 9.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4f10fa34f0d17f0c7091a7297bd6ac8a8d80ba2a2e14dedbcb83908b90b97a80
|
|
BLAKE2b-256 checksum How to use checksums |
bd714fed1afca866bdb64b3d8f02a0243d31f5ad1c9cba2dacd349dfca37ac6a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.3
|
Release files / travel_debugger-1.1.0-py3-none-any.whl
| Download URL | travel_debugger-1.1.0-py3-none-any.whl |
|---|---|
| Size | 10.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
2b58d26f840b30246b116c3dfb3da4240825ae01e75ce1afea61c8e5d00c2a57
|
|
BLAKE2b-256 checksum How to use checksums |
098370aaf920f1acd670876ff267e3513b9924b52b8b47d780d8a39801180870
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.3
|
Security for Travel-Debugger 1.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.