SessionSmith 2.0.0__tar.gz → 2.2.0__tar.gz

{sessionsmith-2.0.0 → sessionsmith-2.2.0}/PKG-INFO

@@ -1,9 +1,7 @@
 Metadata-Version: 2.4
 Name: SessionSmith
-Version: 2.0.0
+Version: 2.2.0
 Summary: Git-style session management for Python. Save, restore, and track your variables with ease.
-Home-page: https://github.com/yut0takagi/SessionSmith
-Author: YutoTAKAGI
 Author-email: YutoTAKAGI <yutotkg.1040@gmail.com>
 License: MIT
 Project-URL: Homepage, https://github.com/yut0takagi/SessionSmith
@@ -33,6 +31,15 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Provides-Extra: visualization
 Requires-Dist: matplotlib>=3.5.0; extra == "visualization"
+Provides-Extra: crypto
+Requires-Dist: cryptography>=3.4; extra == "crypto"
+Provides-Extra: s3
+Requires-Dist: boto3>=1.26; extra == "s3"
+Provides-Extra: gcs
+Requires-Dist: google-cloud-storage>=2.0; extra == "gcs"
+Provides-Extra: cloud
+Requires-Dist: boto3>=1.26; extra == "cloud"
+Requires-Dist: google-cloud-storage>=2.0; extra == "cloud"
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0.0; extra == "dev"
 Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
@@ -41,12 +48,13 @@ Requires-Dist: black>=23.0.0; extra == "dev"
 Requires-Dist: isort>=5.12.0; extra == "dev"
 Requires-Dist: mypy>=1.0.0; extra == "dev"
 Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: cryptography>=3.4; extra == "dev"
 Provides-Extra: all
 Requires-Dist: matplotlib>=3.5.0; extra == "all"
-Dynamic: author
-Dynamic: home-page
+Requires-Dist: cryptography>=3.4; extra == "all"
+Requires-Dist: boto3>=1.26; extra == "all"
+Requires-Dist: google-cloud-storage>=2.0; extra == "all"
 Dynamic: license-file
-Dynamic: requires-python
 
 # SessionSmith
 
@@ -78,6 +86,9 @@ Dynamic: requires-python
 - 🚀 **拡張機能対応**: Cursor/VSCode拡張機能でコードを書かずに実行可能
 - 🌐 **多言語対応**: 日本語・英語のエラーメッセージに対応
 - 🛡️ **堅牢なエラーハンドリング**: リトライ、詳細なエラー情報、コンテキスト管理
+- ☁️ **クラウドリモート**（v2.1.0）: S3 / GCS / HTTP へ `push` / `pull`
+- 🔐 **暗号化・改ざん検出**（v2.1.0）: 認証付き暗号でのエクスポート、HMAC 署名による検証
+- 📝 **構造化ロギング**（v2.1.0）: ログレベル・ファイル出力・JSON ログ
 
 ## インストール
 
@@ -105,6 +116,18 @@ pip install SessionSmith[visualization]
 pip install matplotlib
 ```
 
+オプション機能（v2.1.0）:
+
+```bash
+pip install SessionSmith[crypto]   # 暗号化（cryptography）
+pip install SessionSmith[s3]       # S3 リモート（boto3）
+pip install SessionSmith[gcs]      # GCS リモート（google-cloud-storage）
+pip install SessionSmith[cloud]    # S3 + GCS
+pip install SessionSmith[all]      # すべて
+```
+
+> 署名（HMAC）・構造化ロギングは追加依存なしで利用できます。
+
 ## クイックスタート
 
 ### SSM - Git風セッション管理（推奨）
@@ -228,6 +251,61 @@ lang = get_language()  # 'ja' または 'en'
 エラーメッセージや情報メッセージが設定した言語で表示されます。
 SSMが初期化されている場合、言語設定は自動的に `.ssm/config` に保存されます。
 
+### クラウド / URL リモート（v2.1.0）
+
+```python
+from SessionSmith import ssm
+
+ssm.init()
+ssm.commit("experiment v1")
+
+# クラウドリモートを登録して push / pull
+ssm.remote_add("cloud", "s3://my-bucket/experiments")      # S3
+# ssm.remote_add("cloud", "gs://my-bucket/experiments")    # GCS
+# ssm.remote_add("cloud", "file:///shared/ssm-remote")     # 共有ディレクトリ
+ssm.push("cloud", "main")
+
+# 別マシン / 別リポジトリから取得
+ssm.pull("cloud", "main")
+
+# HTTP(S) 越しの読み取り（pull のみ）
+ssm.remote_add("mirror", "https://example.com/ssm-repo")
+ssm.pull("mirror", "main")
+```
+
+### 暗号化・改ざん検出（v2.1.0）
+
+```python
+from SessionSmith import ssm
+
+# --- 暗号化（要 pip install SessionSmith[crypto]）---
+ssm.export("backup.pkl", password="my-secret")          # 暗号化してエクスポート
+ssm.import_session("backup.pkl", password="my-secret")  # 復号してインポート
+ssm.push("cloud", "main", password="my-secret")         # リモート上のデータを暗号化
+
+# --- 改ざん検出（HMAC 署名・追加依存なし）---
+ssm.config("sign_key", "team-secret")  # 署名鍵を設定（環境変数 SESSIONSMITH_SIGN_KEY でも可）
+ssm.commit("signed snapshot")          # 以降のコミットに署名が付与される
+
+result = ssm.verify()  # 整合性（再ハッシュ）と署名を検証
+# {'integrity_ok': True, 'signed': True, 'signature_ok': True, 'issues': []}
+```
+
+### 構造化ロギング（v2.1.0）
+
+```python
+from SessionSmith import setup_logging, enable_debug, set_log_level
+
+setup_logging(level="INFO", log_file="ssm.log")  # ファイル出力（ローテーション付き）
+setup_logging(level="INFO", json_format=True)    # JSON 構造化ログ
+enable_debug()                                   # デバッグモード
+
+# 環境変数でも設定可能:
+#   SESSIONSMITH_LOG_LEVEL=DEBUG
+#   SESSIONSMITH_LOG_FILE=ssm.log
+#   SESSIONSMITH_LOG_JSON=1
+```
+
 ### レガシーAPI（後方互換性）
 
 > ⚠️ 以下のAPIは後方互換性のために残されています。新規開発では `ssm` の使用を推奨します。
@@ -341,6 +419,7 @@ Python notebookで複数のファイルからインポートしたり、複数
 - 📈 [アルゴリズムトレーサー](docs/algorithm-tracer.md) - トレース・可視化機能
 - 🌐 [国際化（i18n）ガイド](docs/i18n-guide.md) - 多言語対応（日本語・英語）
 - 📚 [APIリファレンス](docs/api-reference.md) - 全APIの詳細
+- ⏱️ [ベンチマーク](benchmarks/README.md) - 大規模セッション・チェックポイント・メモリ計測（issue #31）
 
 ## 使用例
 
@@ -407,6 +486,10 @@ SessionSmithには、Cursor/VSCode用の拡張機能が用意されています
 
 ### 機能
 
+- 🌳 **Session Graph（v0.2.0〜）**: `.ssm/` のコミット履歴を gitgraph 風に可視化。
+  ブランチのレーン色分け、マージの分岐・合流、ブランチ/タグ/HEADバッジ、コミット詳細
+  （変数一覧・署名状態）、GUI からの Checkout / Branch / Tag / Commit に対応
+- 🗂 **Sessions ビュー（v0.2.0〜）**: アクティビティバーにブランチ・タグ・コミットのツリー表示
 - ✅ **Save Session**: 現在のPythonセッション（変数）を保存
 - ✅ **Load Session**: セッションファイルを選択して変数を復元
 - ✅ **Show Session Info**: セッションファイルの情報を表示

{sessionsmith-2.0.0 → sessionsmith-2.2.0}/SessionSmith/__init__.py

@@ -39,6 +39,16 @@ from .compare import compare_sessions, print_comparison
 
 # 後方互換性のためのAPI（非推奨）
 from .core import load_session, save_session
+
+# セキュリティ（暗号化・署名）
+from .crypto import (
+    HAS_CRYPTOGRAPHY,
+    CryptoError,
+    decrypt_data,
+    encrypt_data,
+    sign_data,
+    verify_signature,
+)
 from .error_handling import (
     ErrorHandler,
     error_context,
@@ -76,6 +86,17 @@ from .exceptions import (
 )
 from .i18n import Language, get_language, set_language, t, translate
 from .info import get_session_info, list_session_variables, print_session_info
+
+# ロギング設定
+from .logging_config import (
+    configure_from_env as _configure_logging_from_env,
+)
+from .logging_config import (
+    enable_debug,
+    get_log_level,
+    set_log_level,
+    setup_logging,
+)
 from .manager import SessionManager
 from .serializers import CustomSerializer
 from .ssm import (
@@ -97,7 +118,13 @@ from .tracer import AlgorithmTracer
 from .utils import verify_session
 from .visualizer import print_trace_summary, visualize_algorithm_trace
 
-__version__ = "2.0.0"
+__version__ = "2.2.0"
+
+# 環境変数からロギングを自動設定（SESSIONSMITH_LOG_LEVEL / SESSIONSMITH_LOG_FILE）
+try:
+    _configure_logging_from_env()
+except Exception:  # pragma: no cover - ロギング設定失敗で import を妨げない
+    pass
 
 __all__ = [
     # 主要API（推奨）
@@ -134,6 +161,18 @@ __all__ = [
     "ErrorHandler",
     "set_default_error_handler",
     "get_default_error_handler",
+    # ロギング
+    "setup_logging",
+    "set_log_level",
+    "get_log_level",
+    "enable_debug",
+    # セキュリティ（暗号化・署名）
+    "encrypt_data",
+    "decrypt_data",
+    "sign_data",
+    "verify_signature",
+    "CryptoError",
+    "HAS_CRYPTOGRAPHY",
     # ブランチ・マージ・タグ・リモート機能
     "branch",
     "checkout_branch",

{sessionsmith-2.0.0 → sessionsmith-2.2.0}/SessionSmith/core.py

@@ -46,9 +46,14 @@ def _validate_file_path(file_path: Union[str, Path]) -> Path:
     if not isinstance(file_path, (str, Path)):
         raise TypeError(f"file_path must be str or Path, got {type(file_path).__name__}")
 
-    if not str(file_path).strip():
+    path_str = str(file_path)
+
+    if not path_str.strip():
         raise ValueError("file_path cannot be empty")
 
+    if any(ord(ch) < 0x20 or ord(ch) == 0x7F for ch in path_str):
+        raise ValueError("file_path must not contain control characters")
+
     return Path(file_path)
 
 
@@ -540,11 +545,11 @@ def load_session(
         session = {k: v for k, v in session.items() if k not in exclude}
 
     # グローバル変数に更新
-    loaded_vars: list[str] = []
+    loaded_names: list[str] = []
     for k, v in session.items():
         try:
             globals_dict[k] = v
-            loaded_vars.append(k)
+            loaded_names.append(k)
             if verbose:
                 print(f"Loaded variable: {k} ({type(v).__name__})")
         except Exception as e:
@@ -552,6 +557,6 @@ def load_session(
                 warnings.warn(f"Failed to load variable '{k}': {str(e)}", UserWarning, stacklevel=2)
 
     if verbose:
-        print(f"Loaded {len(loaded_vars)} variables")
+        print(f"Loaded {len(loaded_names)} variables")
 
     return session

sessionsmith-2.2.0/SessionSmith/crypto.py

@@ -0,0 +1,205 @@
+"""
+暗号化・署名モジュール（セキュリティ機能）
+
+このモジュールは2つの独立した機能を提供します:
+
+1. **整合性・改ざん検出（署名）**: HMAC-SHA256 を使用。Python標準ライブラリ
+   のみで動作し、追加の依存関係は不要です。コミットやエクスポートしたデータの
+   改ざんを検出できます。
+
+2. **暗号化**: 認証付き暗号（Fernet / AES-128-CBC + HMAC）を使用。`cryptography`
+   パッケージが必要です（``pip install SessionSmith[crypto]``）。パスワードから
+   PBKDF2-HMAC-SHA256 で鍵を導出します。
+
+Note:
+    暗号化はエクスポート／インポートやリモートとの同期など、データが SessionSmith
+    の管理下を離れる「境界」での利用を想定しています。pickle ファイルを平文のまま
+    共有・バックアップするリスクを軽減します。
+"""
+
+import base64
+import hashlib
+import hmac
+import os
+import struct
+from typing import Optional
+
+# 暗号化用のオプショナル依存
+# ImportError だけでなく、ネイティブ拡張（cffi/rust）の読み込み失敗など
+# 環境依存の例外も握りつぶし、暗号化機能を無効化して degrade させる。
+try:
+    from cryptography.fernet import Fernet, InvalidToken
+
+    HAS_CRYPTOGRAPHY = True
+except BaseException:  # noqa: BLE001  # pragma: no cover - 依存がない/壊れている環境向け
+    # ImportError に加え、ネイティブ拡張（cffi/pyo3）の読み込み失敗による
+    # PanicException（BaseException 派生）等もここで握りつぶし degrade させる。
+    HAS_CRYPTOGRAPHY = False
+    Fernet = None  # type: ignore
+    InvalidToken = Exception  # type: ignore
+
+
+# 暗号化済みデータを識別するためのマジックヘッダー
+MAGIC = b"SSMENC01"
+# 鍵導出のデフォルト反復回数（PBKDF2）
+DEFAULT_ITERATIONS = 200_000
+# ソルト長（バイト）
+SALT_SIZE = 16
+
+
+class CryptoError(Exception):
+    """暗号化・復号・署名検証に関するエラー"""
+
+
+class CryptoDependencyError(CryptoError):
+    """暗号化に必要な依存パッケージが不足している場合のエラー"""
+
+    def __init__(self) -> None:
+        super().__init__(
+            "Encryption requires the 'cryptography' package. "
+            "Install it with: pip install SessionSmith[crypto]"
+        )
+
+
+# ========== 署名（HMAC-SHA256, 標準ライブラリのみ） ==========
+
+
+def sign_data(data: bytes, key: str) -> str:
+    """
+    データに HMAC-SHA256 署名を付与します（改ざん検出用）。
+
+    Args:
+        data: 署名対象のバイト列
+        key: 署名鍵（秘密鍵）
+
+    Returns:
+        str: 16進数の署名文字列
+    """
+    if not isinstance(data, bytes):
+        raise TypeError("data must be bytes")
+    return hmac.new(key.encode("utf-8"), data, hashlib.sha256).hexdigest()
+
+
+def verify_signature(data: bytes, signature: str, key: str) -> bool:
+    """
+    HMAC-SHA256 署名を検証します（タイミング攻撃に耐性のある比較）。
+
+    Args:
+        data: 検証対象のバイト列
+        signature: 期待される署名（16進数文字列）
+        key: 署名鍵
+
+    Returns:
+        bool: 署名が一致すれば True
+    """
+    if not signature:
+        return False
+    expected = sign_data(data, key)
+    return hmac.compare_digest(expected, signature)
+
+
+# ========== 暗号化（Fernet, オプショナル） ==========
+
+
+def _derive_fernet_key(password: str, salt: bytes, iterations: int = DEFAULT_ITERATIONS) -> bytes:
+    """
+    パスワードから Fernet 用の鍵（url-safe base64 でエンコードされた32バイト）を導出します。
+
+    PBKDF2-HMAC-SHA256 を標準ライブラリで実行するため、cryptography の鍵導出機能には
+    依存しません。
+    """
+    dk = hashlib.pbkdf2_hmac("sha256", password.encode("utf-8"), salt, iterations, dklen=32)
+    return base64.urlsafe_b64encode(dk)
+
+
+def is_encrypted(blob: bytes) -> bool:
+    """データが SessionSmith により暗号化されたものか判定します。"""
+    return isinstance(blob, bytes) and blob[: len(MAGIC)] == MAGIC
+
+
+def encrypt_data(data: bytes, password: str, iterations: int = DEFAULT_ITERATIONS) -> bytes:
+    """
+    データを暗号化します（認証付き暗号）。
+
+    出力フォーマット::
+
+        MAGIC(8) | iterations(uint32 BE) | salt(16) | Fernet token(...)
+
+    Args:
+        data: 平文のバイト列
+        password: 暗号化パスワード
+        iterations: PBKDF2 の反復回数
+
+    Returns:
+        bytes: 暗号化されたバイト列（``is_encrypted`` が True を返す形式）
+
+    Raises:
+        CryptoDependencyError: cryptography パッケージが無い場合
+    """
+    if not HAS_CRYPTOGRAPHY:
+        raise CryptoDependencyError()
+    if not password:
+        raise CryptoError("Password must not be empty")
+    if not isinstance(data, bytes):
+        raise TypeError("data must be bytes")
+
+    salt = os.urandom(SALT_SIZE)
+    key = _derive_fernet_key(password, salt, iterations)
+    token = Fernet(key).encrypt(data)
+    header = MAGIC + struct.pack(">I", iterations) + salt
+    return header + token
+
+
+def decrypt_data(blob: bytes, password: str) -> bytes:
+    """
+    ``encrypt_data`` で暗号化されたデータを復号します。
+
+    Args:
+        blob: 暗号化されたバイト列
+        password: 復号パスワード
+
+    Returns:
+        bytes: 復号された平文
+
+    Raises:
+        CryptoDependencyError: cryptography パッケージが無い場合
+        CryptoError: フォーマット不正・パスワード誤り・改ざんを検出した場合
+    """
+    if not HAS_CRYPTOGRAPHY:
+        raise CryptoDependencyError()
+    if not is_encrypted(blob):
+        raise CryptoError("Data is not in SessionSmith encrypted format")
+
+    header_len = len(MAGIC) + 4 + SALT_SIZE
+    if len(blob) < header_len:
+        raise CryptoError("Encrypted data is truncated or corrupted")
+
+    iterations = struct.unpack(">I", blob[len(MAGIC) : len(MAGIC) + 4])[0]
+    salt = blob[len(MAGIC) + 4 : header_len]
+    token = blob[header_len:]
+
+    key = _derive_fernet_key(password, salt, iterations)
+    try:
+        return Fernet(key).decrypt(token)
+    except InvalidToken as e:
+        raise CryptoError(
+            "Failed to decrypt: wrong password or the data has been tampered with"
+        ) from e
+
+
+def maybe_decrypt(blob: bytes, password: Optional[str]) -> bytes:
+    """
+    暗号化されていれば復号し、そうでなければそのまま返します。
+
+    Args:
+        blob: 読み込んだバイト列
+        password: パスワード（None で暗号化されていない場合はそのまま）
+
+    Returns:
+        bytes: 平文のバイト列
+    """
+    if is_encrypted(blob):
+        if not password:
+            raise CryptoError("Data is encrypted but no password was provided")
+        return decrypt_data(blob, password)
+    return blob

{sessionsmith-2.0.0 → sessionsmith-2.2.0}/SessionSmith/error_handling.py

@@ -118,7 +118,7 @@ def safe_execute(
     func: Callable[..., T],
     *args: Any,
     default: Optional[T] = None,
-    on_error: Callable[[Exception], Optional[T]] = None,
+    on_error: Optional[Callable[[Exception], Optional[T]]] = None,
     **kwargs: Any
 ) -> Optional[T]:
     """

{sessionsmith-2.0.0 → sessionsmith-2.2.0}/SessionSmith/exceptions.py

@@ -9,7 +9,8 @@ SessionSmith カスタム例外クラス
     │   ├── SSMNotInitializedError
     │   ├── SSMCommitNotFoundError
     │   ├── SSMNoCommitsError
-    │   └── SSMConfigError
+    │   ├── SSMConfigError
+    │   └── SSMLockError
     ├── SessionError (セッション操作関連)
     │   ├── SessionSaveError
     │   ├── SessionLoadError
@@ -134,6 +135,40 @@ class SSMRemoteNotFoundError(SSMError):
         super().__init__(message, details={"remote_name": remote_name})
 
 
+class SSMLockError(SSMError):
+    """`.ssm` リポジトリのプロセス間ロック取得がタイムアウトした場合の例外"""
+
+    def __init__(
+        self,
+        ssm_path: str,
+        holder_pid: Optional[int] = None,
+        timeout: Optional[float] = None,
+    ):
+        self.ssm_path = ssm_path
+        self.holder_pid = holder_pid
+        self.timeout = timeout
+
+        if holder_pid:
+            holder_desc = f"currently held by PID {holder_pid}"
+        else:
+            holder_desc = "holder could not be determined"
+        timeout_desc = f"{timeout:.1f}s" if timeout is not None else "the configured timeout"
+
+        message = (
+            f"Timed out after {timeout_desc} waiting for the lock on '{ssm_path}' "
+            f"({holder_desc}). Another process or thread is likely writing to this "
+            f".ssm repository. If no other process is actually using it, the lock "
+            f"file ('.lock') may be stale from a crashed process; SessionSmith "
+            f"automatically reclaims stale locks once the holder process is "
+            f"confirmed dead or the lock exceeds its max age, so retrying shortly "
+            f"usually resolves this."
+        )
+        super().__init__(
+            message,
+            details={"ssm_path": ssm_path, "holder_pid": holder_pid, "timeout": timeout},
+        )
+
+
 class SSMMergeConflictError(SSMError):
     """マージコンフリクトが発生した場合の例外"""
 
@@ -141,7 +176,14 @@ class SSMMergeConflictError(SSMError):
         self.branch_name = branch_name
         self.conflicts = conflicts
         i18n = _get_i18n()
-        message = i18n.translate("error.merge_conflict", branch_name=branch_name, count=len(conflicts))
+        # コンフリクトした変数名をメッセージ本文にも含める（呼び出し側が
+        # str(exc) だけを見ても、どの変数が衝突したか分かるようにするため）
+        message = i18n.translate(
+            "error.merge_conflict",
+            branch_name=branch_name,
+            count=len(conflicts),
+            vars=", ".join(conflicts),
+        )
         super().__init__(message, details={"branch_name": branch_name, "conflicts": conflicts})
 
 

{sessionsmith-2.0.0 → sessionsmith-2.2.0}/SessionSmith/i18n.py

@@ -53,7 +53,7 @@ _TRANSLATIONS: dict[str, dict[str, str]] = {
         "error.remote_no_url": "リモート '{remote_name}' にURLが設定されていません",
         "error.remote_repository_not_found": "リモートリポジトリが見つかりません: {remote_url}",
         "error.tag_no_commit": "タグ '{tag_name}' にコミットが設定されていません",
-        "error.merge_conflict": "マージコンフリクトが発生しました: ブランチ '{branch_name}' で {count} 個のコンフリクト",
+        "error.merge_conflict": "マージコンフリクトが発生しました: ブランチ '{branch_name}' で {count} 個のコンフリクト ({vars})",
 
         # 警告メッセージ
         "warn.large_variable": "大きな変数が検出されました: '{name}' ({size_mb:.1f}MB)",
@@ -62,6 +62,7 @@ _TRANSLATIONS: dict[str, dict[str, str]] = {
         "warn.checkpoint_failed": "チェックポイントの保存に失敗しました: {reason}",
         "warn.continuous_mode_unavailable": "常時記録モードはJupyter/IPython環境でのみ利用可能です",
         "warn.variable_conflict": "変数名の衝突が検出されました: ファイル '{previous_file}' と '{current_file}' で同じ変数名 ({vars}) が使用されています。複数のファイルから同じ変数名を使用する場合は注意してください。",
+        "warn.merge_conflict": "マージコンフリクトを検出しました: ブランチ '{branch_name}' で変数 {vars} が共通祖先から両側で異なる値に変更されています。マージ呼び出し時点でセッションに存在する値が採用されます（last-writer-wins）。",
 
         # 情報メッセージ
         "info.session_saved": "セッションを保存しました: {file_path} ({size:,} bytes, 形式: {format})",
@@ -122,7 +123,7 @@ _TRANSLATIONS: dict[str, dict[str, str]] = {
         "error.remote_no_url": "Remote '{remote_name}' has no URL",
         "error.remote_repository_not_found": "Remote repository not found: {remote_url}",
         "error.tag_no_commit": "Tag '{tag_name}' has no commit",
-        "error.merge_conflict": "Merge conflict: {count} conflicts in branch '{branch_name}'",
+        "error.merge_conflict": "Merge conflict: {count} conflicts in branch '{branch_name}' ({vars})",
 
         # Warning messages
         "warn.large_variable": "Large variable detected: '{name}' ({size_mb:.1f}MB)",
@@ -131,6 +132,7 @@ _TRANSLATIONS: dict[str, dict[str, str]] = {
         "warn.checkpoint_failed": "Checkpoint save failed: {reason}",
         "warn.continuous_mode_unavailable": "Continuous mode is only available in Jupyter/IPython environment",
         "warn.variable_conflict": "Variable name conflict detected: same variable names ({vars}) used in '{previous_file}' and '{current_file}'. Be careful when using the same variable names from multiple files.",
+        "warn.merge_conflict": "Merge conflict detected: variables {vars} were changed differently on both sides since the common ancestor in branch '{branch_name}'. The value currently in the session at merge time will be used (last-writer-wins).",
         "warn.disk_warning": "Disk space warning: {usage_percent:.1f}% used ({free_mb:.1f}MB free)",
         "warn.disk_critical": "Disk space critical: {usage_percent:.1f}% used ({free_mb:.1f}MB free)",
         "warn.memory_warning": "Memory usage warning: {usage_percent:.1f}% used ({used_mb:.1f}MB used, {available_mb:.1f}MB available)",
@@ -210,7 +212,7 @@ def get_language() -> str:
     if _current_language == Language.AUTO:
         return detect_language()
     else:
-        return _current_language.value
+        return str(_current_language.value)
 
 
 def set_language(lang: Union[str, Language], save_to_ssm: bool = True) -> None:

{sessionsmith-2.0.0 → sessionsmith-2.2.0}/SessionSmith/info.py

@@ -31,7 +31,6 @@ def _load_session_file(file_path: Union[str, Path], format: Optional[str] = None
     if not file_path.is_file():
         raise ValueError(f"'{file_path}' is not a file.")
 
-    compression: Optional[str] = None
     from .formats import detect_format, load_hdf5, load_json, load_msgpack, load_pickle
 
     session: dict[str, Any] = {}