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

exonware/xwsystem/console/cli/event_logger.py

@@ -0,0 +1,166 @@
+#exonware/xwsystem/src/exonware/xwsystem/console/cli/event_logger.py
+"""
+Company: eXonware.com
+Author: Eng. Muhammad AlShehri
+Email: connect@exonware.com
+Version: 0.1.0.3
+Generation Date: January 2025
+
+CLI Event Logger - Extends Python's logging.Logger with event logging capabilities.
+"""
+
+import logging
+from typing import Optional, Any
+from ..event_logger import ConsoleEventLogger
+from ..contracts import IEventLogger
+from ..defs import LogLevel, ConsoleEventType, ConsoleEvent
+
+
+class CliEventLogger(logging.Logger):
+    """
+    CLI Event Logger that extends Python's logging.Logger.
+    
+    Combines Python's standard logging.Logger with structured event logging
+    from ConsoleEventLogger. All standard logging.Logger methods work as expected,
+    and additional event logging methods are available.
+    """
+    
+    def __init__(self, name: str, level: int = logging.NOTSET):
+        """
+        Initialize CLI Event Logger.
+        
+        Args:
+            name: Logger name
+            level: Logging level
+        """
+        # Initialize Python's Logger
+        super().__init__(name, level)
+        
+        # Initialize internal event logger for structured logging
+        self._event_logger = ConsoleEventLogger(
+            max_entries=1000,
+            use_milliseconds=True,
+            default_source=name
+        )
+    
+    # Event logging methods (from IEventLogger)
+    
+    def log_event(
+        self,
+        msg: str,
+        source: Optional[str] = None,
+        data: Optional[Any] = None,
+        color: Optional[str] = None,
+        label: Optional[str] = None
+    ) -> ConsoleEvent:
+        """Log a general event message."""
+        event = self._event_logger.log(msg, source=source, data=data, color=color, label=label)
+        # Also log using standard logger
+        super().info(msg)
+        return event
+    
+    def info_event(
+        self,
+        msg: str,
+        source: Optional[str] = None,
+        data: Optional[Any] = None
+    ) -> ConsoleEvent:
+        """Log an info event."""
+        event = self._event_logger.info(msg, source=source, data=data)
+        super().info(msg)
+        return event
+    
+    def warn_event(
+        self,
+        msg: str,
+        source: Optional[str] = None,
+        data: Optional[Any] = None
+    ) -> ConsoleEvent:
+        """Log a warning event."""
+        event = self._event_logger.warn(msg, source=source, data=data)
+        super().warning(msg)
+        return event
+    
+    def error_event(
+        self,
+        msg: str,
+        source: Optional[str] = None,
+        data: Optional[Any] = None,
+        stack: Optional[str] = None
+    ) -> ConsoleEvent:
+        """Log an error event."""
+        event = self._event_logger.error(msg, source=source, data=data, stack=stack)
+        super().error(msg, exc_info=stack is not None)
+        return event
+    
+    def debug_event(
+        self,
+        msg: str,
+        source: Optional[str] = None,
+        data: Optional[Any] = None
+    ) -> ConsoleEvent:
+        """Log a debug event."""
+        event = self._event_logger.debug(msg, source=source, data=data)
+        super().debug(msg)
+        return event
+    
+    # Override standard logging methods to also log events
+    def info(self, msg: object, *args, **kwargs) -> None:
+        """Log info message (standard logger + event logger)."""
+        msg_str = str(msg) % args if args else str(msg)
+        self._event_logger.info(msg_str, source=self.name)
+        super().info(msg, *args, **kwargs)
+    
+    def warning(self, msg: object, *args, **kwargs) -> None:
+        """Log warning message (standard logger + event logger)."""
+        msg_str = str(msg) % args if args else str(msg)
+        self._event_logger.warn(msg_str, source=self.name)
+        super().warning(msg, *args, **kwargs)
+    
+    def error(self, msg: object, *args, **kwargs) -> None:
+        """Log error message (standard logger + event logger)."""
+        msg_str = str(msg) % args if args else str(msg)
+        self._event_logger.error(msg_str, source=self.name)
+        super().error(msg, *args, **kwargs)
+    
+    def debug(self, msg: object, *args, **kwargs) -> None:
+        """Log debug message (standard logger + event logger)."""
+        msg_str = str(msg) % args if args else str(msg)
+        self._event_logger.debug(msg_str, source=self.name)
+        super().debug(msg, *args, **kwargs)
+    
+    def critical(self, msg: object, *args, **kwargs) -> None:
+        """Log critical message (standard logger + event logger)."""
+        msg_str = str(msg) % args if args else str(msg)
+        self._event_logger.error(msg_str, source=self.name)
+        super().critical(msg, *args, **kwargs)
+    
+    # Event logger methods (delegate to internal event logger)
+    
+    def get_events(
+        self,
+        event_type: Optional[ConsoleEventType] = None,
+        level: Optional[LogLevel] = None,
+        source: Optional[str] = None,
+        limit: Optional[int] = None
+    ) -> list[dict]:
+        """Get logged events as dictionaries."""
+        return self._event_logger.get_events(event_type=event_type, level=level, source=source, limit=limit)
+    
+    def clear_events(self) -> None:
+        """Clear all logged events."""
+        self._event_logger.clear()
+    
+    def count_events(self) -> int:
+        """Get the number of logged events."""
+        return self._event_logger.count()
+    
+    @property
+    def event_logger(self) -> ConsoleEventLogger:
+        """Get the internal event logger instance."""
+        return self._event_logger
+
+
+__all__ = [
+    'CliEventLogger',
+]

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

@@ -1,3 +1,4 @@
+#exonware/xwsystem/src/exonware/xwsystem/console/cli/progress.py
 """
 Progress Bar Utilities
 =====================
@@ -7,24 +8,27 @@ Production-grade progress indicators for XSystem.
 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
 """
 
+from __future__ import annotations
+
 import sys
 import time
 import threading
-from typing import Optional, TextIO, Union
+from typing import Optional, TextIO
 from dataclasses import dataclass
 import math
 
-# Import colors from our existing color module
-# Explicit import - colors module is part of the same package
-from .colors import colorize, Colors, Style
+# Import general console enums from console level (priority)
+from ..defs import Colors, Style
+# Import CLI-specific color utilities
+from .colors import colorize
 
 
 @dataclass
-class ProgressConfig:
+class CliProgressConfig:
     """Configuration for progress indicators."""
     width: int = 50
     show_percentage: bool = True
@@ -36,7 +40,7 @@ class ProgressConfig:
     style: str = Style.BOLD
 
 
-class ProgressBar:
+class CliProgressBar:
     """
     Production-grade progress bar with ETA and rate calculation.
     
@@ -52,7 +56,7 @@ class ProgressBar:
     def __init__(self, 
                  total: int,
                  description: str = "",
-                 config: ProgressConfig = None,
+                 config: CliProgressConfig = None,
                  file: TextIO = None):
         """
         Initialize progress bar.
@@ -65,7 +69,7 @@ class ProgressBar:
         """
         self.total = total
         self.description = description
-        self.config = config or ProgressConfig()
+        self.config = config or CliProgressConfig()
         self.file = file or sys.stderr
         
         # Progress tracking
@@ -100,7 +104,7 @@ class ProgressBar:
                 self._update_rate(current_time)
                 self._last_rate_update = current_time
             
-            # Check if we should refresh display
+            # Check if to refresh display
             if (current_time - self.last_update >= self.config.refresh_rate or 
                 self.current >= self.total):
                 self._refresh_display()
@@ -240,7 +244,7 @@ class ProgressBar:
         self.close()
 
 
-class SpinnerProgress:
+class CliSpinnerProgress:
     """
     Spinning progress indicator for indeterminate tasks.
     
@@ -283,7 +287,7 @@ class SpinnerProgress:
         self._frame_index = 0
         self._lock = threading.Lock()
     
-    def start(self) -> 'SpinnerProgress':
+    def start(self) -> CliSpinnerProgress:
         """Start the spinner animation."""
         with self._lock:
             if not self._running:
@@ -330,7 +334,7 @@ class SpinnerProgress:
         self.stop()
 
 
-class MultiProgress:
+class CliMultiProgress:
     """
     Multiple progress bars manager.
     
@@ -357,7 +361,7 @@ class MultiProgress:
                 bar_id: str, 
                 total: int, 
                 description: str = "",
-                config: ProgressConfig = None) -> ProgressBar:
+                config: CliProgressConfig = None) -> CliProgressBar:
         """
         Add a new progress bar.
         
@@ -375,7 +379,7 @@ class MultiProgress:
                 raise ValueError(f"Progress bar '{bar_id}' already exists")
             
             # Create progress bar with custom file to prevent direct output
-            bar = ProgressBar(total, description, config, file=self)
+            bar = CliProgressBar(total, description, config, file=self)
             self._bars[bar_id] = bar
             self._active = True
             return bar
@@ -436,14 +440,14 @@ class MultiProgress:
 
 
 # Utility functions
-def create_progress_bar(total: int, description: str = "") -> ProgressBar:
+def create_progress_bar(total: int, description: str = "") -> CliProgressBar:
     """Create a simple progress bar."""
-    return ProgressBar(total, description)
+    return CliProgressBar(total, description)
 
 
-def create_spinner(message: str = "Processing...") -> SpinnerProgress:
+def create_spinner(message: str = "Processing...") -> CliSpinnerProgress:
     """Create a simple spinner."""
-    return SpinnerProgress(message)
+    return CliSpinnerProgress(message)
 
 
 def progress_range(iterable, description: str = ""):
@@ -451,12 +455,12 @@ def progress_range(iterable, description: str = ""):
     total = len(iterable) if hasattr(iterable, '__len__') else None
     
     if total is not None:
-        with ProgressBar(total, description) as pbar:
+        with CliProgressBar(total, description) as pbar:
             for item in iterable:
                 yield item
                 pbar.update(1)
     else:
         # Use spinner for unknown length iterables
-        with SpinnerProgress(description) as spinner:
+        with CliSpinnerProgress(description) as spinner:
             for item in iterable:
                 yield item

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

@@ -1,8 +1,9 @@
+#exonware/xwsystem/src/exonware/xwsystem/console/cli/prompts.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
 
 Interactive prompts - Placeholder.
@@ -21,7 +22,7 @@ def multiselect(message, choices):
     return choices
 
 
-class Prompts:
+class CliPrompts:
     """Interactive prompts manager for CLI operations."""
     
     def __init__(self):

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

@@ -1,3 +1,4 @@
+#exonware/xwsystem/src/exonware/xwsystem/console/cli/tables.py
 """
 Table Formatting Utilities
 ==========================
@@ -7,21 +8,23 @@ Production-grade table formatting for XWSystem.
 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
 """
 
+from __future__ import annotations
+
 import sys
-from typing import Any, Optional, Union, TextIO, Callable
+from typing import Any, Optional, TextIO, Callable
 from dataclasses import dataclass
-# Import colors from our existing color module
-# Explicit import - colors module is part of the same package
-from .colors import colorize, Colors, Style
-from .defs import Alignment, BorderStyle
+# Import general console enums from console level (priority)
+from ..defs import Alignment, BorderStyle, Colors, Style
+# Import CLI-specific color utilities
+from .colors import colorize
 
 
 @dataclass
-class Column:
+class CliColumn:
     """
     Table column definition.
     
@@ -51,7 +54,7 @@ class Column:
                 self.width = min(self.width, self.max_width)
 
 
-class TableFormatter:
+class CliTableFormatter:
     """
     Production-grade table formatter.
     
@@ -90,7 +93,7 @@ class TableFormatter:
         self.padding = padding
         self.border_chars = self.BORDER_CHARS.get(border_style, self.BORDER_CHARS[BorderStyle.ROUNDED])
     
-    def format_cell(self, value: Any, column: Column, width: int) -> str:
+    def format_cell(self, value: Any, column: CliColumn, width: int) -> str:
         """Format a cell value according to column specifications."""
         # Apply custom formatter if provided
         if column.formatter:
@@ -116,7 +119,7 @@ class TableFormatter:
         
         return text
     
-    def calculate_widths(self, columns: list[Column], data: list[list[Any]]) -> list[int]:
+    def calculate_widths(self, columns: list[CliColumn], data: list[list[Any]]) -> list[int]:
         """Calculate optimal column widths."""
         widths = []
         
@@ -138,7 +141,7 @@ class TableFormatter:
         return widths
 
 
-class Table:
+class CliTable:
     """
     Production-grade table with advanced formatting capabilities.
     
@@ -150,39 +153,39 @@ class Table:
     """
     
     def __init__(self, 
-                 columns: list[Union[str, Column]] = None,
-                 formatter: TableFormatter = None,
+                 columns: list[str | CliColumn] = None,
+                 formatter: CliTableFormatter = None,
                  title: str = ""):
         """Initialize table."""
         self.title = title
-        self.formatter = formatter or TableFormatter()
+        self.formatter = formatter or CliTableFormatter()
         
         # Process columns
         self.columns = []
         if columns:
             for col in columns:
                 if isinstance(col, str):
-                    self.columns.append(Column(header=col))
+                    self.columns.append(CliColumn(header=col))
                 else:
                     self.columns.append(col)
         
         # Data storage
         self.rows = []
     
-    def add_column(self, column: Union[str, Column]) -> 'Table':
+    def add_column(self, column: str | CliColumn) -> CliTable:
         """Add a column to the table."""
         if isinstance(column, str):
-            self.columns.append(Column(header=column))
+            self.columns.append(CliColumn(header=column))
         else:
             self.columns.append(column)
         return self
     
-    def add_row(self, *values) -> 'Table':
+    def add_row(self, *values) -> CliTable:
         """Add a row to the table."""
         self.rows.append(list(values))
         return self
     
-    def add_rows(self, rows: list[list[Any]]) -> 'Table':
+    def add_rows(self, rows: list[list[Any]]) -> CliTable:
         """Add multiple rows to the table."""
         self.rows.extend(rows)
         return self
@@ -236,18 +239,18 @@ class Table:
 
 
 # Utility functions
-def create_simple_table(headers: list[str], rows: list[list[Any]]) -> Table:
+def create_simple_table(headers: list[str], rows: list[list[Any]]) -> CliTable:
     """Create a simple table with basic formatting."""
-    table = Table(headers)
+    table = CliTable(headers)
     table.add_rows(rows)
     return table
 
 
 def print_key_value_table(data: dict[str, Any], title: str = ""):
     """Print a key-value table."""
-    table = Table([
-        Column("Property", header_color=Colors.BLUE, header_style=Style.BOLD),
-        Column("Value", header_color=Colors.GREEN, header_style=Style.BOLD)
+    table = CliTable([
+        CliColumn("Property", header_color=Colors.BLUE, header_style=Style.BOLD),
+        CliColumn("Value", header_color=Colors.GREEN, header_style=Style.BOLD)
     ], title=title)
     
     for key, value in data.items():

exonware/xwsystem/console/contracts.py

@@ -0,0 +1,113 @@
+#!/usr/bin/env python3
+#exonware/xwsystem/src/exonware/xwsystem/console/contracts.py
+#exonware/xwsystem/console/contracts.py
+"""
+Company: eXonware.com
+Author: Eng. Muhammad AlShehri
+Email: connect@exonware.com
+Version: 0.1.0.3
+Generation Date: 2025-01-27
+
+Console module contracts - interfaces for console functionality.
+"""
+
+from typing import Protocol, runtime_checkable, Optional, Any
+from .defs import LogLevel, ConsoleEventType, ConsoleEvent
+
+
+@runtime_checkable
+class IEventLogger(Protocol):
+    """Interface for event logging operations."""
+    
+    def log(
+        self,
+        msg: str,
+        source: Optional[str] = None,
+        data: Optional[Any] = None,
+        color: Optional[str] = None,
+        label: Optional[str] = None
+    ) -> ConsoleEvent:
+        """Log a general message."""
+        ...
+    
+    def info(
+        self,
+        msg: str,
+        source: Optional[str] = None,
+        data: Optional[Any] = None
+    ) -> ConsoleEvent:
+        """Log an info message."""
+        ...
+    
+    def warn(
+        self,
+        msg: str,
+        source: Optional[str] = None,
+        data: Optional[Any] = None
+    ) -> ConsoleEvent:
+        """Log a warning message."""
+        ...
+    
+    def error(
+        self,
+        msg: str,
+        source: Optional[str] = None,
+        data: Optional[Any] = None,
+        stack: Optional[str] = None
+    ) -> ConsoleEvent:
+        """Log an error message."""
+        ...
+    
+    def debug(
+        self,
+        msg: str,
+        source: Optional[str] = None,
+        data: Optional[Any] = None
+    ) -> ConsoleEvent:
+        """Log a debug message."""
+        ...
+    
+    def get_events(
+        self,
+        event_type: Optional[ConsoleEventType] = None,
+        level: Optional[LogLevel] = None,
+        source: Optional[str] = None,
+        limit: Optional[int] = None
+    ) -> list[dict]:
+        """Get logged events as dictionaries."""
+        ...
+    
+    def clear(self) -> None:
+        """Clear all logged events."""
+        ...
+    
+    def count(self) -> int:
+        """Get the number of logged events."""
+        ...
+
+
+@runtime_checkable
+class IConsoleWriter(Protocol):
+    """Interface for console writing operations (user interaction, not logging)."""
+    
+    def write(self, text: str, **kwargs) -> None:
+        """Write text to console."""
+        ...
+    
+    def write_line(self, text: str = "", **kwargs) -> None:
+        """Write a line to console."""
+        ...
+    
+    def read(self, prompt: str = "") -> str:
+        """Read input from console."""
+        ...
+    
+    def clear(self) -> None:
+        """Clear console screen."""
+        ...
+
+
+__all__ = [
+    'IEventLogger',
+    'IConsoleWriter',
+]