glaip-sdk 0.1.2__py3-none-any.whl → 0.7.17__py3-none-any.whl

glaip_sdk/branding.py

@@ -17,6 +17,7 @@ import platform
 import sys
 
 from rich.console import Console
+from rich.text import Text
 
 from glaip_sdk._version import __version__ as SDK_VERSION
 from glaip_sdk.rich_components import AIPPanel
@@ -90,6 +91,14 @@ GDP Labs AI Agents Package
     # ---- small helpers --------------------------------------------------------
     @staticmethod
     def _auto_version(package_name: str | None) -> str:
+        """Auto-detect version from environment, package metadata, or fallback.
+
+        Args:
+            package_name: Optional package name to read version from installed metadata.
+
+        Returns:
+            Version string from AIP_VERSION env var, package metadata, or SDK_VERSION fallback.
+        """
         # Priority: env → package metadata → fallback
         env_version = os.getenv("AIP_VERSION")
         if env_version:
@@ -102,7 +111,16 @@ GDP Labs AI Agents Package
         return SDK_VERSION
 
     @staticmethod
-    def _make_console() -> Console:
+    def _make_console(force_terminal: bool | None = None, *, soft_wrap: bool = True) -> Console:
+        """Create a Rich Console instance respecting NO_COLOR environment variables.
+
+        Args:
+            force_terminal: Override terminal detection when True/False.
+            soft_wrap: Whether to enable soft wrapping in the console.
+
+        Returns:
+            Console instance with color system configured based on environment.
+        """
         # Respect NO_COLOR/AIP_NO_COLOR environment variables
         no_color_env = os.getenv("NO_COLOR") is not None or os.getenv("AIP_NO_COLOR") is not None
         if no_color_env:
@@ -111,7 +129,12 @@ GDP Labs AI Agents Package
         else:
             color_system = "auto"
             no_color = False
-        return Console(color_system=color_system, no_color=no_color, soft_wrap=True)
+        return Console(
+            color_system=color_system,
+            no_color=no_color,
+            soft_wrap=soft_wrap,
+            force_terminal=force_terminal,
+        )
 
     # ---- public API -----------------------------------------------------------
     def get_welcome_banner(self) -> str:
@@ -196,3 +219,104 @@ GDP Labs AI Agents Package
             AIPBranding instance
         """
         return cls(version=sdk_version, package_name=package_name)
+
+
+class LogoAnimator:
+    """Animated logo with pulse effect for CLI startup.
+
+    Provides a "Knight Rider" style light pulse animation that sweeps across
+    the GL AIP logo during initialization tasks. Respects NO_COLOR and non-TTY
+    environments with graceful degradation.
+    """
+
+    # Animation colors from GDP Labs brand palette
+    BASE_BLUE = SECONDARY_MEDIUM  # "#005CB8" - Medium Blue
+    HIGHLIGHT = SECONDARY_LIGHT  # "#40B4E5" - Light Blue
+    WHITE = "#FFFFFF"  # Bright white center
+
+    def __init__(self, console: Console | None = None) -> None:
+        """Initialize LogoAnimator.
+
+        Args:
+            console: Optional console instance. If None, creates a default console.
+        """
+        self.console = console or AIPBranding._make_console()
+        self.logo = AIPBranding.AIP_LOGO
+        self.lines = self.logo.split("\n")
+        self.max_width = max(len(line) for line in self.lines) if self.lines else 0
+
+    def generate_frame(self, step: int, status_text: str = "") -> Text:
+        """Generate a single animation frame with logo pulse and status.
+
+        Args:
+            step: Current animation step (position of the pulse).
+            status_text: Optional status text to display below the logo.
+
+        Returns:
+            Text object with styled logo and status.
+        """
+        text = Text()
+
+        for line in self.lines:
+            for x, char in enumerate(line):
+                distance = abs(x - step)
+
+                if distance == 0:
+                    style = f"bold {self.WHITE}"  # Bright white center
+                elif distance <= 3:
+                    style = f"bold {self.HIGHLIGHT}"  # Light blue glow
+                else:
+                    style = self.BASE_BLUE  # Base blue
+
+                text.append(char, style=style)
+            text.append("\n")
+
+        # Add status area below the logo
+        if status_text:
+            text.append(f"\n{status_text}\n")
+
+        return text
+
+    def should_animate(self) -> bool:
+        """Check if animation should be used.
+
+        Returns:
+            True if animation should be used (interactive TTY with colors),
+            False otherwise (NO_COLOR set or non-TTY).
+        """
+        # Check for NO_COLOR environment variables
+        no_color = os.getenv("NO_COLOR") is not None or os.getenv("AIP_NO_COLOR") is not None
+        if no_color:
+            return False
+
+        # Check if console is a TTY
+        if not self.console.is_terminal:
+            return False
+
+        # Check if console explicitly disables colors
+        if self.console.no_color:
+            return False
+
+        # If we get here, we have a TTY without NO_COLOR set
+        # Rich will handle color detection, so we can animate
+        return True
+
+    def display_static_logo(self, status_text: str = "") -> None:
+        """Display static logo without animation (for non-TTY or NO_COLOR).
+
+        Args:
+            status_text: Optional status text to display below the logo.
+        """
+        self.console.print(self.static_frame(status_text))
+
+    def static_frame(self, status_text: str = "") -> Text:
+        """Return a static logo frame for use in non-animated renders.
+
+        Args:
+            status_text: Optional status text to display below the logo.
+        """
+        logo_text = Text(self.logo, style=self.BASE_BLUE)
+        if status_text:
+            logo_text.append("\n")
+            logo_text.append(status_text)
+        return logo_text