SessionSmith 0.1.2__tar.gz → 0.1.4__tar.gz

{sessionsmith-0.1.2 → sessionsmith-0.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: SessionSmith
-Version: 0.1.2
+Version: 0.1.4
 Summary: Simple session save/load utility for Jupyter notebooks using pickle
 Home-page: https://github.com/yut0takagi/SessionSmith
 Author: YutoTAKAGI
@@ -59,6 +59,7 @@ Dynamic: summary
 - 🏷️ **バージョン管理**: Git風のコミット・チェックアウト機能
 - 📈 **アルゴリズムトレーサー**: 1行ごとの変数状態記録・可視化
 - 🎨 **可視化**: アルゴリズムの実行をアニメーションで表示
+- 🚀 **拡張機能対応**: Cursor/VSCode拡張機能でコードを書かずに実行可能
 
 ## インストール
 
@@ -219,6 +220,55 @@ visualize_algorithm_trace(
 )
 ```
 
+## Cursor/VSCode拡張機能
+
+SessionSmithには、Cursor/VSCode用の拡張機能が用意されています。コードを書かずに、GUIからセッションの保存・復元が可能です。
+
+### インストール
+
+**Open VSX Registryから:**
+1. Cursor/VSCodeでコマンドパレット（Cmd+Shift+P / Ctrl+Shift+P）を開く
+2. `Extensions: Install Extension` を選択
+3. `SessionSmith` を検索してインストール
+
+または、以下のURLから直接インストール:
+- https://open-vsx.org/extension/yut0takagi/sessionsmith
+
+### 使い方
+
+#### Notebookでの使用
+
+1. Jupyter Notebookを開く
+2. 変数を定義:
+   ```python
+   x = 42
+   y = "Hello"
+   z = [1, 2, 3]
+   ```
+3. コマンドパレットから `SessionSmith: Save Session` を選択
+4. ファイル名を入力して保存
+
+#### セッションの読み込み
+
+1. コマンドパレットから `SessionSmith: Load Session` を選択
+2. セッションファイル（.pkl, .json, .msgpack, .h5）を選択
+3. 変数が自動的に復元されます
+
+#### セッション情報の表示
+
+- エクスプローラーでセッションファイルを右クリック
+- 「Show Session Info」を選択
+
+### 機能
+
+- ✅ **Save Session**: 現在のPythonセッション（変数）を保存
+- ✅ **Load Session**: セッションファイルを選択して変数を復元
+- ✅ **Show Session Info**: セッションファイルの情報を表示
+- ✅ **Notebook対応**: Jupyter Notebookでセルを追加せずに実行
+- ✅ **自動検出**: Pythonインタープリターを自動検出（仮想環境対応）
+
+詳細は [extension/README.md](extension/README.md) を参照してください。
+
 ## ライセンス
 
 MIT

{sessionsmith-0.1.2 → sessionsmith-0.1.4}/SessionSmith/__init__.py

@@ -14,7 +14,7 @@ from .serializers import CustomSerializer
 from .tracer import AlgorithmTracer
 from .visualizer import visualize_algorithm_trace, print_trace_summary
 
-__version__ = "0.1.2"
+__version__ = "0.1.4"
 
 __all__ = [
     "save_session",

{sessionsmith-0.1.2 → sessionsmith-0.1.4}/SessionSmith/core.py

@@ -101,12 +101,14 @@ def _validate_on_error_option(on_error: str) -> str:
     return on_error
 
 
-def _get_globals_dict(globals_dict: Optional[Dict[str, Any]]) -> Dict[str, Any]:
+def _get_globals_dict(globals_dict: Optional[Dict[str, Any]], depth: int = 2, copy: bool = True) -> Dict[str, Any]:
     """
     グローバル変数辞書を取得します
     
     Args:
         globals_dict: グローバル変数辞書（Noneの場合は自動取得）
+        depth: 呼び出し元からのフレーム深度（デフォルトは2：_get_globals_dict -> save/load_session -> ユーザーコード）
+        copy: Trueの場合はコピーを返す（save_session用）、Falseの場合は参照を返す（load_session用）
         
     Returns:
         dict: グローバル変数辞書
@@ -118,10 +120,18 @@ def _get_globals_dict(globals_dict: Optional[Dict[str, Any]]) -> Dict[str, Any]:
     
     try:
         frame = inspect.currentframe()
-        if frame is None or frame.f_back is None:
+        if frame is None:
             raise RuntimeError("Cannot access calling frame")
-        caller_frame = frame.f_back
-        result = caller_frame.f_globals.copy()
+        
+        # 指定された深度までフレームを遡る
+        caller_frame = frame
+        for _ in range(depth):
+            if caller_frame.f_back is None:
+                raise RuntimeError("Cannot access calling frame at specified depth")
+            caller_frame = caller_frame.f_back
+        
+        # save_sessionはコピー（安全な読み取り）、load_sessionは参照（変更を反映）
+        result = caller_frame.f_globals.copy() if copy else caller_frame.f_globals
         del frame
         return result
     except Exception as e:
@@ -326,7 +336,8 @@ def load_session(
     if not file_path.is_file():
         raise ValueError(f"'{file_path}' is not a file.")
     
-    globals_dict = _get_globals_dict(globals_dict)
+    # load_sessionでは元のグローバル変数を変更する必要があるため、copy=False
+    globals_dict = _get_globals_dict(globals_dict, copy=False)
     
     if include is not None and not isinstance(include, list):
         raise TypeError(f"include must be a list, got {type(include).__name__}")

{sessionsmith-0.1.2 → sessionsmith-0.1.4}/SessionSmith/manager.py

@@ -50,15 +50,16 @@ class SessionManager:
         if enable_version_control and vc_base_path:
             self._init_version_control()
 
-    def _get_globals_dict(self, globals_dict: Optional[Dict[str, Any]]) -> Dict[str, Any]:
+    def _get_globals_dict(self, globals_dict: Optional[Dict[str, Any]], depth: int = 2) -> Dict[str, Any]:
         """
         グローバル変数辞書を取得します
         
         Args:
             globals_dict: グローバル変数辞書（Noneの場合は自動取得）
+            depth: 呼び出し元からのフレーム深度（デフォルトは2：_get_globals_dict -> __init__ -> ユーザーコード）
             
         Returns:
-            dict: グローバル変数辞書
+            dict: グローバル変数辞書（参照、コピーではない）
         """
         if globals_dict is not None:
             if not isinstance(globals_dict, dict):
@@ -67,10 +68,18 @@ class SessionManager:
         
         try:
             frame = inspect.currentframe()
-            if frame is None or frame.f_back is None:
+            if frame is None:
                 raise RuntimeError("Cannot access calling frame")
-            caller_frame = frame.f_back
-            result = caller_frame.f_globals.copy()
+            
+            # 指定された深度までフレームを遡る
+            caller_frame = frame
+            for _ in range(depth):
+                if caller_frame.f_back is None:
+                    raise RuntimeError("Cannot access calling frame at specified depth")
+                caller_frame = caller_frame.f_back
+            
+            # SessionManagerは変数を変更する必要があるため、参照を返す（コピーではない）
+            result = caller_frame.f_globals
             del frame
             return result
         except Exception as e:

{sessionsmith-0.1.2 → sessionsmith-0.1.4}/SessionSmith.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: SessionSmith
-Version: 0.1.2
+Version: 0.1.4
 Summary: Simple session save/load utility for Jupyter notebooks using pickle
 Home-page: https://github.com/yut0takagi/SessionSmith
 Author: YutoTAKAGI
@@ -59,6 +59,7 @@ Dynamic: summary
 - 🏷️ **バージョン管理**: Git風のコミット・チェックアウト機能
 - 📈 **アルゴリズムトレーサー**: 1行ごとの変数状態記録・可視化
 - 🎨 **可視化**: アルゴリズムの実行をアニメーションで表示
+- 🚀 **拡張機能対応**: Cursor/VSCode拡張機能でコードを書かずに実行可能
 
 ## インストール
 
@@ -219,6 +220,55 @@ visualize_algorithm_trace(
 )
 ```
 
+## Cursor/VSCode拡張機能
+
+SessionSmithには、Cursor/VSCode用の拡張機能が用意されています。コードを書かずに、GUIからセッションの保存・復元が可能です。
+
+### インストール
+
+**Open VSX Registryから:**
+1. Cursor/VSCodeでコマンドパレット（Cmd+Shift+P / Ctrl+Shift+P）を開く
+2. `Extensions: Install Extension` を選択
+3. `SessionSmith` を検索してインストール
+
+または、以下のURLから直接インストール:
+- https://open-vsx.org/extension/yut0takagi/sessionsmith
+
+### 使い方
+
+#### Notebookでの使用
+
+1. Jupyter Notebookを開く
+2. 変数を定義:
+   ```python
+   x = 42
+   y = "Hello"
+   z = [1, 2, 3]
+   ```
+3. コマンドパレットから `SessionSmith: Save Session` を選択
+4. ファイル名を入力して保存
+
+#### セッションの読み込み
+
+1. コマンドパレットから `SessionSmith: Load Session` を選択
+2. セッションファイル（.pkl, .json, .msgpack, .h5）を選択
+3. 変数が自動的に復元されます
+
+#### セッション情報の表示
+
+- エクスプローラーでセッションファイルを右クリック
+- 「Show Session Info」を選択
+
+### 機能
+
+- ✅ **Save Session**: 現在のPythonセッション（変数）を保存
+- ✅ **Load Session**: セッションファイルを選択して変数を復元
+- ✅ **Show Session Info**: セッションファイルの情報を表示
+- ✅ **Notebook対応**: Jupyter Notebookでセルを追加せずに実行
+- ✅ **自動検出**: Pythonインタープリターを自動検出（仮想環境対応）
+
+詳細は [extension/README.md](extension/README.md) を参照してください。
+
 ## ライセンス
 
 MIT