empathy-framework 3.5.6__py3-none-any.whl → 3.7.0__py3-none-any.whl

empathy_os/platform_utils.py

@@ -1,5 +1,4 @@
-"""
-Cross-Platform Utilities for Empathy Framework
+"""Cross-Platform Utilities for Empathy Framework
 
 Provides platform-independent utilities for:
 - File paths and directories
@@ -34,93 +33,93 @@ def is_linux() -> bool:
 
 
 def get_default_log_dir() -> Path:
-    """
-    Get the default log directory for the current platform.
+    """Get the default log directory for the current platform.
 
     Returns:
         Path: Platform-appropriate log directory
         - Windows: %APPDATA%/empathy/logs
         - macOS: ~/Library/Logs/empathy
         - Linux: /var/log/empathy (if writable) or ~/.local/share/empathy/logs
+
     """
     if is_windows():
         appdata = os.environ.get("APPDATA", os.path.expanduser("~"))
         return Path(appdata) / "empathy" / "logs"
-    elif is_macos():
+    if is_macos():
         return Path.home() / "Library" / "Logs" / "empathy"
-    else:  # Linux and other Unix
-        var_log = Path("/var/log/empathy")
-        if var_log.exists() or (var_log.parent.exists() and os.access(var_log.parent, os.W_OK)):
-            return var_log
-        # Fallback to user directory
-        return Path.home() / ".local" / "share" / "empathy" / "logs"
+    # Linux and other Unix
+    var_log = Path("/var/log/empathy")
+    if var_log.exists() or (var_log.parent.exists() and os.access(var_log.parent, os.W_OK)):
+        return var_log
+    # Fallback to user directory
+    return Path.home() / ".local" / "share" / "empathy" / "logs"
 
 
 def get_default_data_dir() -> Path:
-    """
-    Get the default data directory for the current platform.
+    """Get the default data directory for the current platform.
 
     Returns:
         Path: Platform-appropriate data directory
         - Windows: %APPDATA%/empathy
         - macOS: ~/Library/Application Support/empathy
         - Linux: ~/.local/share/empathy
+
     """
     if is_windows():
         appdata = os.environ.get("APPDATA", os.path.expanduser("~"))
         return Path(appdata) / "empathy"
-    elif is_macos():
+    if is_macos():
         return Path.home() / "Library" / "Application Support" / "empathy"
-    else:  # Linux and other Unix
-        xdg_data = os.environ.get("XDG_DATA_HOME", str(Path.home() / ".local" / "share"))
-        return Path(xdg_data) / "empathy"
+    # Linux and other Unix
+    xdg_data = os.environ.get("XDG_DATA_HOME", str(Path.home() / ".local" / "share"))
+    return Path(xdg_data) / "empathy"
 
 
 def get_default_config_dir() -> Path:
-    """
-    Get the default configuration directory for the current platform.
+    """Get the default configuration directory for the current platform.
 
     Returns:
         Path: Platform-appropriate config directory
         - Windows: %APPDATA%/empathy
         - macOS: ~/Library/Preferences/empathy
         - Linux: ~/.config/empathy
+
     """
     if is_windows():
         appdata = os.environ.get("APPDATA", os.path.expanduser("~"))
         return Path(appdata) / "empathy"
-    elif is_macos():
+    if is_macos():
         return Path.home() / "Library" / "Preferences" / "empathy"
-    else:  # Linux and other Unix
-        xdg_config = os.environ.get("XDG_CONFIG_HOME", str(Path.home() / ".config"))
-        return Path(xdg_config) / "empathy"
+    # Linux and other Unix
+    xdg_config = os.environ.get("XDG_CONFIG_HOME", str(Path.home() / ".config"))
+    return Path(xdg_config) / "empathy"
 
 
 def get_default_cache_dir() -> Path:
-    """
-    Get the default cache directory for the current platform.
+    """Get the default cache directory for the current platform.
 
     Returns:
         Path: Platform-appropriate cache directory
         - Windows: %LOCALAPPDATA%/empathy/cache
         - macOS: ~/Library/Caches/empathy
         - Linux: ~/.cache/empathy
+
     """
     if is_windows():
         localappdata = os.environ.get(
-            "LOCALAPPDATA", os.environ.get("APPDATA", os.path.expanduser("~"))
+            "LOCALAPPDATA",
+            os.environ.get("APPDATA", os.path.expanduser("~")),
         )
         return Path(localappdata) / "empathy" / "cache"
-    elif is_macos():
+    if is_macos():
         return Path.home() / "Library" / "Caches" / "empathy"
-    else:  # Linux and other Unix
-        xdg_cache = os.environ.get("XDG_CACHE_HOME", str(Path.home() / ".cache"))
-        return Path(xdg_cache) / "empathy"
+    # Linux and other Unix
+    xdg_cache = os.environ.get("XDG_CACHE_HOME", str(Path.home() / ".cache"))
+    return Path(xdg_cache) / "empathy"
 
 
 def setup_asyncio_policy() -> None:
-    """
-    Configure asyncio event loop policy for the current platform.
+    """Configure asyncio event loop policy for the current platform.
 
     On Windows, this uses WindowsSelectorEventLoopPolicy to avoid issues
     with the default ProactorEventLoop, particularly with subprocesses
@@ -132,12 +131,11 @@ def setup_asyncio_policy() -> None:
     if is_windows():
         # Windows requires WindowsSelectorEventLoopPolicy for compatibility
         # with many libraries and subprocess operations
-        asyncio.set_event_loop_policy(asyncio.WindowsSelectorEventLoopPolicy())
+        asyncio.set_event_loop_policy(asyncio.WindowsSelectorEventLoopPolicy())  # type: ignore[attr-defined]
 
 
 def safe_run_async(coro: Any, debug: bool = False) -> Any:
-    """
-    Run an async coroutine with platform-appropriate event loop handling.
+    """Run an async coroutine with platform-appropriate event loop handling.
 
     This is a cross-platform wrapper for asyncio.run() that handles
     Windows-specific event loop requirements.
@@ -148,14 +146,14 @@ def safe_run_async(coro: Any, debug: bool = False) -> Any:
 
     Returns:
         Result of the coroutine
+
     """
     setup_asyncio_policy()
     return asyncio.run(coro, debug=debug)
 
 
 def open_text_file(path: str | Path, mode: str = "r", **kwargs: Any):
-    """
-    Open a text file with UTF-8 encoding by default.
+    """Open a text file with UTF-8 encoding by default.
 
     This ensures consistent encoding across platforms, as Windows
     defaults to cp1252 while Unix defaults to UTF-8.
@@ -167,14 +165,14 @@ def open_text_file(path: str | Path, mode: str = "r", **kwargs: Any):
 
     Returns:
         File object
+
     """
     kwargs.setdefault("encoding", "utf-8")
     return open(path, mode, **kwargs)
 
 
 def read_text_file(path: str | Path, encoding: str = "utf-8") -> str:
-    """
-    Read a text file with UTF-8 encoding by default.
+    """Read a text file with UTF-8 encoding by default.
 
     Args:
         path: File path to read
@@ -182,13 +180,13 @@ def read_text_file(path: str | Path, encoding: str = "utf-8") -> str:
 
     Returns:
         File contents as string
+
     """
     return Path(path).read_text(encoding=encoding)
 
 
 def write_text_file(path: str | Path, content: str, encoding: str = "utf-8") -> int:
-    """
-    Write content to a text file with UTF-8 encoding by default.
+    """Write content to a text file with UTF-8 encoding by default.
 
     Args:
         path: File path to write
@@ -197,13 +195,13 @@ def write_text_file(path: str | Path, content: str, encoding: str = "utf-8") ->
 
     Returns:
         Number of characters written
+
     """
     return Path(path).write_text(content, encoding=encoding)
 
 
 def normalize_path(path: str | Path) -> Path:
-    """
-    Normalize a path for the current platform.
+    """Normalize a path for the current platform.
 
     Converts forward slashes to backslashes on Windows and
     resolves any relative path components.
@@ -213,16 +211,17 @@ def normalize_path(path: str | Path) -> Path:
 
     Returns:
         Normalized Path object
+
     """
     return Path(path).resolve()
 
 
 def get_temp_dir() -> Path:
-    """
-    Get the system temporary directory.
+    """Get the system temporary directory.
 
     Returns:
         Path to the system temp directory
+
     """
     import tempfile
 
@@ -230,14 +229,14 @@ def get_temp_dir() -> Path:
 
 
 def ensure_dir(path: str | Path) -> Path:
-    """
-    Ensure a directory exists, creating it if necessary.
+    """Ensure a directory exists, creating it if necessary.
 
     Args:
         path: Directory path to ensure
 
     Returns:
         Path object for the directory
+
     """
     dir_path = Path(path)
     dir_path.mkdir(parents=True, exist_ok=True)

empathy_os/redis_config.py

@@ -1,5 +1,4 @@
-"""
-Redis Configuration for Empathy Framework
+"""Redis Configuration for Empathy Framework
 
 Handles connection to Redis from environment variables.
 Supports Railway, redis.com, local Docker, managed Redis, or mock mode.
@@ -61,8 +60,7 @@ from .memory.short_term import RedisConfig, RedisShortTermMemory
 
 
 def parse_redis_url(url: str) -> dict:
-    """
-    Parse Redis URL into connection parameters.
+    """Parse Redis URL into connection parameters.
 
     Supports:
     - redis://user:pass@host:port/db (standard)
@@ -73,6 +71,7 @@ def parse_redis_url(url: str) -> dict:
 
     Returns:
         Dict with host, port, password, db, ssl
+
     """
     parsed = urlparse(url)
 
@@ -89,8 +88,7 @@ def parse_redis_url(url: str) -> dict:
 
 
 def get_redis_config() -> RedisConfig:
-    """
-    Get Redis configuration from environment variables.
+    """Get Redis configuration from environment variables.
 
     Priority:
     1. REDIS_URL (full URL, used by Railway/Heroku/managed services)
@@ -99,6 +97,7 @@ def get_redis_config() -> RedisConfig:
 
     Returns:
         RedisConfig with all connection parameters
+
     """
     # Check for mock mode
     if os.getenv("EMPATHY_REDIS_MOCK", "").lower() == "true":
@@ -149,11 +148,11 @@ def get_redis_config() -> RedisConfig:
 
 
 def get_redis_config_dict() -> dict:
-    """
-    Get Redis configuration as a dictionary (legacy compatibility).
+    """Get Redis configuration as a dictionary (legacy compatibility).
 
     Returns:
         Dict with connection parameters
+
     """
     config = get_redis_config()
     return {
@@ -171,8 +170,7 @@ def get_redis_memory(
     use_mock: bool | None = None,
     config: RedisConfig | None = None,
 ) -> RedisShortTermMemory:
-    """
-    Create a RedisShortTermMemory instance with environment-based config.
+    """Create a RedisShortTermMemory instance with environment-based config.
 
     Args:
         url: Optional explicit Redis URL (overrides env vars)
@@ -201,6 +199,7 @@ def get_redis_memory(
             retry_max_attempts=5,
         )
         memory = get_redis_memory(config=config)
+
     """
     # Explicit config takes highest priority
     if config is not None:
@@ -229,8 +228,7 @@ def get_redis_memory(
 
 
 def check_redis_connection() -> dict:
-    """
-    Check Redis connection and return status.
+    """Check Redis connection and return status.
 
     Returns:
         Dict with connection status and info
@@ -239,6 +237,7 @@ def check_redis_connection() -> dict:
         >>> status = check_redis_connection()
         >>> if status["connected"]:
         ...     print(f"Connected to {status['host']}:{status['port']}")
+
     """
     config = get_redis_config()
 
@@ -281,8 +280,7 @@ def check_redis_connection() -> dict:
 
 # Convenience function for Railway deployments
 def get_railway_redis() -> RedisShortTermMemory:
-    """
-    Get Redis configured for Railway deployment.
+    """Get Redis configured for Railway deployment.
 
     Railway automatically sets REDIS_URL when you add a Redis service.
 
@@ -291,13 +289,14 @@ def get_railway_redis() -> RedisShortTermMemory:
 
     Raises:
         EnvironmentError: If REDIS_URL is not set
+
     """
     redis_url = os.getenv("REDIS_URL") or os.getenv("REDIS_PRIVATE_URL")
 
     if not redis_url:
         raise OSError(
             "REDIS_URL not found. Make sure Redis is added to your Railway project.\n"
-            "Run: railway add --database redis"
+            "Run: railway add --database redis",
         )
 
     return get_redis_memory(url=redis_url)