exonware-xwsystem 0.0.1.411__py3-none-any.whl → 0.1.0.3__py3-none-any.whl

exonware/xwsystem/{cli → console/cli}/colors.py

@@ -1,8 +1,9 @@
+#exonware/xwsystem/src/exonware/xwsystem/console/cli/colors.py
 """
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.411
+Version: 0.1.0.3
 Generation Date: September 05, 2025
 
 Colored terminal output utilities with cross-platform support.
@@ -10,8 +11,9 @@ Colored terminal output utilities with cross-platform support.
 
 import os
 import sys
-from typing import Optional, Union
-from .defs import Colors, Style
+from typing import Optional
+# Import general console enums from console level (priority)
+from ..defs import Colors, Style
 
 # Explicit import - colorama is a required dependency for CLI functionality
 # This ensures consistent cross-platform colored output
@@ -19,12 +21,12 @@ from .defs import Colors, Style
 import colorama
 colorama.init(autoreset=True)
 
-from ..config.logging_setup import get_logger
+from ...config.logging_setup import get_logger
 
 logger = get_logger("xwsystem.cli.colors")
 
 
-class ColoredOutput:
+class CliColoredOutput:
     """
     Cross-platform colored terminal output.
     
@@ -73,7 +75,7 @@ class ColoredOutput:
         if 'color' in term or term in ('xterm', 'xterm-256color', 'screen', 'tmux'):
             return True
         
-        # Lazy installation ensures colorama is always available
+        # Lazy installation provides colorama when available
         # Works on all platforms
         return True
     
@@ -81,7 +83,7 @@ class ColoredOutput:
         """Check if colored output is supported."""
         return self._supports_color
     
-    def colorize(self, text: str, color: Union[Colors, str], style: Optional[Union[Style, str]] = None) -> str:
+    def colorize(self, text: str, color: Colors | str, style: Optional[Style | str] = None) -> str:
         """
         Apply color and style to text.
         
@@ -114,8 +116,8 @@ class ColoredOutput:
         else:
             return f"{color_str}{text}"
     
-    def print_colored(self, text: str, color: Union[Colors, str], 
-                     style: Optional[Union[Style, str]] = None, **kwargs) -> None:
+    def print_colored(self, text: str, color: Colors | str, 
+                     style: Optional[Style | str] = None, **kwargs) -> None:
         """
         Print colored text.
         
@@ -228,15 +230,15 @@ class ColoredOutput:
 
 
 # Global colored output instance
-_colored_output = ColoredOutput()
+_colored_output = CliColoredOutput()
 
 # Convenience functions
-def colorize(text: str, color: Union[Colors, str], style: Optional[Union[Style, str]] = None) -> str:
+def colorize(text: str, color: Colors | str, style: Optional[Style | str] = None) -> str:
     """Colorize text using global instance."""
     return _colored_output.colorize(text, color, style)
 
-def print_colored(text: str, color: Union[Colors, str], 
-                 style: Optional[Union[Style, str]] = None, **kwargs) -> None:
+def print_colored(text: str, color: Colors | str, 
+                 style: Optional[Style | str] = None, **kwargs) -> None:
     """Print colored text using global instance."""
     _colored_output.print_colored(text, color, style, **kwargs)
 

exonware/xwsystem/console/cli/console.py

@@ -0,0 +1,98 @@
+#exonware/xwsystem/src/exonware/xwsystem/console/cli/console.py
+"""
+Company: eXonware.com
+Author: Eng. Muhammad AlShehri
+Email: connect@exonware.com
+Version: 0.1.0.3
+Generation Date: September 04, 2025
+
+Console utilities for CLI operations.
+"""
+
+import os
+from typing import Optional
+from .contracts import IConsole, ColorType
+from .errors import ConsoleError
+# Import ConsoleWriter from console level (priority)
+from ..writer import ConsoleWriter
+
+
+class CliConsole(ConsoleWriter, IConsole):
+    """
+    Console implementation for CLI operations.
+    
+    Extends ConsoleWriter from console level and adds CLI-specific features
+    like color support and IConsole interface compliance.
+    """
+    
+    def print(self, text: str, color: Optional[ColorType] = None, **kwargs) -> None:
+        """
+        Print text to console with optional color.
+        
+        Args:
+            text: Text to print
+            color: Optional color type to apply
+            **kwargs: Additional arguments passed to print()
+        """
+        try:
+            if color and self.supports_color():
+                text = self._apply_color(text, color)
+            
+            # Use parent's write_line method
+            self.write_line(text, **kwargs)
+        except Exception as e:
+            raise ConsoleError(f"Failed to print to console: {e}")
+    
+    def input(self, prompt: str, **kwargs) -> str:
+        """
+        Get input from user.
+        
+        Args:
+            prompt: Prompt text
+            **kwargs: Additional arguments (for compatibility)
+            
+        Returns:
+            User input string
+        """
+        try:
+            # Use parent's read method
+            return self.read(prompt)
+        except Exception as e:
+            raise ConsoleError(f"Failed to get input: {e}")
+    
+    def _apply_color(self, text: str, color: ColorType) -> str:
+        """Apply color to text."""
+        color_codes = {
+            ColorType.RESET: '\033[0m',
+            ColorType.BOLD: '\033[1m',
+            ColorType.DIM: '\033[2m',
+            ColorType.UNDERLINE: '\033[4m',
+            ColorType.RED: '\033[31m',
+            ColorType.GREEN: '\033[32m',
+            ColorType.YELLOW: '\033[33m',
+            ColorType.BLUE: '\033[34m',
+            ColorType.MAGENTA: '\033[35m',
+            ColorType.CYAN: '\033[36m',
+            ColorType.WHITE: '\033[37m',
+            ColorType.GRAY: '\033[90m',
+        }
+        
+        code = color_codes.get(color, '')
+        return f"{code}{text}\033[0m" if code else text
+    
+    def get_size(self) -> tuple[int, int]:
+        """
+        Get console size.
+        
+        Returns:
+            Tuple of (columns, lines)
+        """
+        try:
+            if hasattr(os, 'get_terminal_size'):
+                size = os.get_terminal_size()
+                return (size.columns, size.lines)
+            else:
+                return (80, 24)  # Default size
+        except (OSError, AttributeError, RuntimeError):
+            # Catch specific exceptions - terminal size may not be available
+            return (80, 24)

exonware/xwsystem/{cli → console/cli}/contracts.py

@@ -1,193 +1,175 @@
+#exonware/xwsystem/src/exonware/xwsystem/console/cli/contracts.py
 """
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.411
+Version: 0.1.0.3
 Generation Date: September 04, 2025
 
 CLI module contracts - interfaces and enums for command-line interface functionality.
 """
 
-from abc import ABC, abstractmethod
-from typing import Any, Optional, Union
+from typing import Protocol, runtime_checkable
+from typing import Any, Optional
 
-# Import enums from types module
+# Import general console enums from console level (priority)
+from ..defs import Alignment, BorderStyle, Colors, Style
+# Import CLI-specific enums from defs
 from .defs import (
     ColorType,
     ProgressStyle,
     TableStyle,
     PromptType,
-    Alignment,
-    BorderStyle,
-    Colors,
-    Style,
     ArgumentType
 )
 
 
-class IConsole(ABC):
+@runtime_checkable
+class IConsole(Protocol):
     """Interface for console operations."""
     
-    @abstractmethod
     def print(self, text: str, color: Optional[ColorType] = None, **kwargs) -> None:
         """Print text to console."""
-        pass
+        ...
     
-    @abstractmethod
     def input(self, prompt: str, **kwargs) -> str:
         """Get input from user."""
-        pass
+        ...
     
-    @abstractmethod
     def clear(self) -> None:
         """Clear console screen."""
-        pass
+        ...
 
 
-class IProgressBar(ABC):
+@runtime_checkable
+class IProgressBar(Protocol):
     """Interface for progress bar operations."""
     
-    @abstractmethod
     def start(self, total: int, description: str = "") -> None:
         """Start progress bar."""
-        pass
+        ...
     
-    @abstractmethod
     def update(self, increment: int = 1) -> None:
         """Update progress."""
-        pass
+        ...
     
-    @abstractmethod
     def finish(self) -> None:
         """Finish progress bar."""
-        pass
+        ...
 
 
-class ITable(ABC):
+@runtime_checkable
+class ITable(Protocol):
     """Interface for table operations."""
     
-    @abstractmethod
     def add_row(self, *values: Any) -> None:
         """Add row to table."""
-        pass
+        ...
     
-    @abstractmethod
     def render(self) -> str:
         """Render table as string."""
-        pass
+        ...
 
 
-class IPrompt(ABC):
+@runtime_checkable
+class IPrompt(Protocol):
     """Interface for user prompts."""
     
-    @abstractmethod
     def ask(self, question: str, **kwargs) -> Any:
         """Ask user a question."""
-        pass
+        ...
 
 
-class IArgumentParser(ABC):
+@runtime_checkable
+class IArgumentParser(Protocol):
     """Interface for argument parsing."""
     
-    @abstractmethod
     def add_argument(self, *args, **kwargs) -> None:
         """Add argument to parser."""
-        pass
+        ...
     
-    @abstractmethod
     def parse_args(self, args: Optional[list[str]] = None) -> Any:
         """Parse command line arguments."""
-        pass
+        ...
 
 
-class ICLI(ABC):
+@runtime_checkable
+class ICLI(Protocol):
     """Interface for CLI operations."""
     
     @property
-    @abstractmethod
     def name(self) -> str:
         """Get CLI name."""
-        pass
+        ...
     
     @property
-    @abstractmethod
     def version(self) -> str:
         """Get CLI version."""
-        pass
+        ...
     
-    @abstractmethod
     def add_command(self, name: str, command: Any) -> None:
         """Add a command to the CLI."""
-        pass
+        ...
     
-    @abstractmethod
     def add_option(self, name: str, option: Any) -> None:
         """Add an option to the CLI."""
-        pass
+        ...
     
-    @abstractmethod
     def run(self, args: Optional[list[str]] = None) -> int:
         """Run the CLI."""
-        pass
+        ...
     
-    @abstractmethod
     def get_help(self) -> str:
         """Get help text."""
-        pass
+        ...
 
 
-class IProgress(ABC):
+@runtime_checkable
+class IProgress(Protocol):
     """Interface for progress operations."""
     
-    @abstractmethod
     def start(self, total: int, description: str = "") -> None:
         """Start progress tracking."""
-        pass
+        ...
     
-    @abstractmethod
     def update(self, increment: int = 1) -> None:
         """Update progress."""
-        pass
+        ...
     
-    @abstractmethod
     def finish(self) -> None:
         """Finish progress tracking."""
-        pass
+        ...
 
 
-class IPrompts(ABC):
+@runtime_checkable
+class IPrompts(Protocol):
     """Interface for user prompts."""
     
-    @abstractmethod
     def ask(self, question: str, **kwargs) -> Any:
         """Ask user a question."""
-        pass
+        ...
     
-    @abstractmethod
     def confirm(self, message: str, default: bool = False) -> bool:
         """Ask for confirmation."""
-        pass
+        ...
     
-    @abstractmethod
     def select(self, message: str, choices: list[str], default: Optional[str] = None) -> str:
         """Ask user to select from choices."""
-        pass
+        ...
 
 
-class ITableFormatter(ABC):
+@runtime_checkable
+class ITableFormatter(Protocol):
     """Interface for table formatting."""
     
-    @abstractmethod
     def add_row(self, *values: Any) -> None:
         """Add row to table."""
-        pass
+        ...
     
-    @abstractmethod
     def render(self) -> str:
         """Render table as string."""
-        pass
+        ...
     
-    @abstractmethod
     def clear(self) -> None:
         """Clear all rows."""
-        pass
+        ...

exonware/xwsystem/console/cli/defs.py

@@ -0,0 +1,87 @@
+#!/usr/bin/env python3
+#exonware/xwsystem/src/exonware/xwsystem/console/cli/defs.py
+#exonware/xwsystem/console/cli/cli_defs.py
+"""
+Company: eXonware.com
+Author: Eng. Muhammad AlShehri
+Email: connect@exonware.com
+Version: 0.1.0.3
+Generation Date: 07-Sep-2025
+
+CLI-specific types and enums for XWSystem.
+"""
+
+from enum import Enum
+# Import general console enums from console level (priority)
+from ..defs import Alignment, BorderStyle, Colors, Style
+
+
+# ============================================================================
+# CLI-SPECIFIC ENUMS
+# ============================================================================
+
+class ColorType(Enum):
+    """Color types for CLI output."""
+    RESET = "reset"
+    BOLD = "bold"
+    DIM = "dim"
+    UNDERLINE = "underline"
+    RED = "red"
+    GREEN = "green"
+    YELLOW = "yellow"
+    BLUE = "blue"
+    MAGENTA = "magenta"
+    CYAN = "cyan"
+    WHITE = "white"
+    GRAY = "gray"
+
+
+class ProgressStyle(Enum):
+    """Progress bar styles."""
+    BAR = "bar"
+    SPINNER = "spinner"
+    PERCENTAGE = "percentage"
+    COUNTER = "counter"
+
+
+class TableStyle(Enum):
+    """Table display styles."""
+    SIMPLE = "simple"
+    GRID = "grid"
+    FANCY = "fancy"
+    MINIMAL = "minimal"
+
+
+class PromptType(Enum):
+    """Prompt input types."""
+    TEXT = "text"
+    PASSWORD = "password"
+    CONFIRM = "confirm"
+    SELECT = "select"
+    MULTISELECT = "multiselect"
+
+
+class ArgumentType(Enum):
+    """Types of command-line arguments."""
+    STRING = "string"
+    INTEGER = "int"
+    FLOAT = "float"
+    BOOLEAN = "bool"
+    FILE = "file"
+    DIRECTORY = "dir"
+    CHOICE = "choice"
+
+
+__all__ = [
+    # Re-export general console enums
+    'Alignment',
+    'BorderStyle',
+    'Colors',
+    'Style',
+    # CLI-specific enums
+    'ColorType',
+    'ProgressStyle',
+    'TableStyle',
+    'PromptType',
+    'ArgumentType',
+]

exonware/xwsystem/console/cli/encoding.py

@@ -0,0 +1,69 @@
+#!/usr/bin/env python3
+#exonware/xwsystem/src/exonware/xwsystem/console/cli/encoding.py
+"""
+Console encoding utilities.
+
+Best-effort UTF-8 configuration for Windows consoles (safe for uvicorn logging).
+No-op on non-Windows platforms.
+"""
+
+from __future__ import annotations
+
+import io
+import sys
+
+
+def ensure_utf8_console() -> None:
+    """
+    Configure UTF-8 encoding for Windows console output streams.
+
+    - No-op on non-Windows platforms.
+    - Best-effort: never raises.
+    """
+    if sys.platform != "win32":
+        return
+
+    try:
+        # Prefer reconfigure when available (Python 3.7+)
+        if hasattr(sys.stdout, "reconfigure"):
+            try:
+                sys.stdout.reconfigure(encoding="utf-8", errors="replace")
+                sys.stderr.reconfigure(encoding="utf-8", errors="replace")
+                return
+            except (AttributeError, OSError):
+                # Fall back to wrapper below
+                pass
+
+        class _UTF8Wrapper(io.TextIOWrapper):
+            """Wrapper that delegates key methods to the original stream."""
+
+            def __init__(self, buffer, **kwargs):
+                super().__init__(buffer, **kwargs)
+                self._original = buffer
+
+            def isatty(self):
+                return getattr(self._original, "isatty", lambda: False)()
+
+            def fileno(self):
+                return getattr(self._original, "fileno", lambda: -1)()
+
+        sys.stdout = _UTF8Wrapper(
+            sys.stdout.buffer,
+            encoding="utf-8",
+            errors="replace",
+            line_buffering=True,
+        )
+        sys.stderr = _UTF8Wrapper(
+            sys.stderr.buffer,
+            encoding="utf-8",
+            errors="replace",
+            line_buffering=True,
+        )
+    except Exception:
+        # Fallback on error
+        pass
+
+
+__all__ = [
+    "ensure_utf8_console",
+]

exonware/xwsystem/{cli → console/cli}/errors.py

@@ -1,13 +1,17 @@
+#exonware/xwsystem/src/exonware/xwsystem/console/cli/errors.py
 """
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.411
+Version: 0.1.0.3
 Generation Date: September 04, 2025
 
 CLI module errors - exception classes for command-line interface functionality.
 """
 
+# Import base console errors from console level (priority)
+from ..errors import ConsoleError as BaseConsoleError
+
 
 class CLIError(Exception):
     """Base exception for CLI errors."""
@@ -24,8 +28,9 @@ class CommandError(CLIError):
     pass
 
 
-class ConsoleError(CLIError):
-    """Raised when console operation fails."""
+# ConsoleError extends base ConsoleError from console level
+class ConsoleError(BaseConsoleError):
+    """Raised when console operation fails (CLI-specific)."""
     pass