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

exonware/xwsystem/config/defaults.py

@@ -1,8 +1,9 @@
+#exonware/xwsystem/src/exonware/xwsystem/config/defaults.py
 """
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.1.0.1
+Version: 0.1.0.3
 Generation Date: September 04, 2025
 
 Default configuration constants for XSystem framework.
@@ -166,7 +167,7 @@ class DefaultConfig(AConfigBase):
     
     def validate(self) -> bool:
         """Validate configuration."""
-        # Basic validation - all values should be non-None
+        # Basic validation - all values are non-None
         return all(value is not None for value in self._config.values())
     
     def get_default(self, key: str) -> Any:

exonware/xwsystem/config/defs.py

@@ -1,10 +1,11 @@
 #!/usr/bin/env python3
+#exonware/xwsystem/src/exonware/xwsystem/config/defs.py
 #exonware/xwsystem/config/types.py
 """
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.1.0.1
+Version: 0.1.0.3
 Generation Date: 07-Sep-2025
 
 Config types and enums for XWSystem.
@@ -78,4 +79,4 @@ class AdvancedPerformanceMode(Enum):
     OPTIMIZED = "optimized"  # Prioritize memory efficiency
     MANUAL = "manual"  # Use specific custom settings
     ADAPTIVE = "adaptive"  # Runtime adaptation based on performance monitoring
-    DUAL_ADAPTIVE = "dual_adaptive"  # Smart dual-phase: fast cruise + intelligent deep-dive
+    DUAL_ADAPTIVE = "dual_adaptive"  # Dual-phase: fast cruise + deep-dive

exonware/xwsystem/config/errors.py

@@ -1,9 +1,10 @@
+#exonware/xwsystem/src/exonware/xwsystem/config/errors.py
 #exonware/xwsystem/config/errors.py
 """
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.1.0.1
+Version: 0.1.0.3
 Generation Date: September 04, 2025
 
 Configuration module errors - exception classes for configuration functionality.
@@ -74,7 +75,3 @@ class PerformanceConfigError(ConfigError):
     """Raised when performance configuration fails."""
     pass
 
-
-# Aliases for backward compatibility
-PerformanceError = PerformanceConfigError
-LoggingError = LoggingConfigError

exonware/xwsystem/config/logging.py

@@ -1,8 +1,9 @@
+#exonware/xwsystem/src/exonware/xwsystem/config/logging.py
 """
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.1.0.1
+Version: 0.1.0.3
 Generation Date: September 04, 2025
 
 Logging configuration for XSystem.
@@ -12,7 +13,6 @@ Provides simple logging control functions and configuration management.
 
 import logging
 import os
-from typing import Union
 
 from .defaults import LOGGING_ENABLED, LOGGING_LEVEL
 
@@ -39,13 +39,17 @@ class LoggingConfig:
 
     def set_level(self, level: str) -> None:
         """Set logging level (DEBUG, INFO, WARNING, ERROR, CRITICAL)."""
-        self._level = level.upper()
+        level_upper = level.upper()
+        # Validate level by trying to get it from logging module
+        # This will raise AttributeError for invalid levels
+        try:
+            logging_level = getattr(logging, level_upper)
+        except AttributeError:
+            raise AttributeError(f"Invalid logging level: {level}. Valid levels are: DEBUG, INFO, WARNING, ERROR, CRITICAL")
+        
+        self._level = level_upper
         if self._enabled:
-            try:
-                logging.getLogger().setLevel(getattr(logging, self._level))
-            except (AttributeError, TypeError):
-                # Handle cases where logging level comparison might fail
-                pass
+            logging.getLogger().setLevel(logging_level)
 
     @property
     def enabled(self) -> bool:

exonware/xwsystem/config/logging_setup.py

@@ -1,8 +1,9 @@
+#exonware/xwsystem/src/exonware/xwsystem/config/logging_setup.py
 """
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.1.0.1
+Version: 0.1.0.3
 Generation Date: September 05, 2025
 
 Logging configuration setup for XSystem.
@@ -41,7 +42,7 @@ def setup_logging(
         return
 
     # Try to check XSystem config if available
-    # Import is explicit - internal package import should always be available
+    # Import is explicit - internal package import
     from .logging import logging_config
 
     if not logging_config.enabled:

exonware/xwsystem/config/performance.py

@@ -1,3 +1,4 @@
+#exonware/xwsystem/src/exonware/xwsystem/config/performance.py
 """Performance optimization configuration for xwsystem I/O operations.
 
 This module provides configuration options to enable/disable performance
@@ -80,54 +81,8 @@ def set_performance_config(config: PerformanceConfig) -> None:
     _config = config
 
 
-# Placeholder classes for backward compatibility with existing config system
-# These are not used by the new optimization system but are required by __init__.py
-@dataclass
-class PerformanceLimits:
-    """Placeholder for backward compatibility."""
-    pass
-
-@dataclass
-class SerializationLimits:
-    """Placeholder for backward compatibility."""
-    pass
-
-@dataclass
-class NetworkLimits:
-    """Placeholder for backward compatibility."""
-    pass
-
-@dataclass
-class SecurityLimits:
-    """Placeholder for backward compatibility."""
-    pass
-
-def configure_performance(**kwargs):
-    """Placeholder for backward compatibility."""
-    pass
-
-def get_serialization_limits():
-    """Placeholder for backward compatibility."""
-    return SerializationLimits()
-
-def get_network_limits():
-    """Placeholder for backward compatibility."""
-    return NetworkLimits()
-
-def get_security_limits():
-    """Placeholder for backward compatibility."""
-    return SecurityLimits()
-
 __all__ = [
     "PerformanceConfig",
-    "PerformanceLimits",
-    "SerializationLimits",
-    "NetworkLimits",
-    "SecurityLimits",
     "get_performance_config",
     "set_performance_config",
-    "configure_performance",
-    "get_serialization_limits",
-    "get_network_limits",
-    "get_security_limits",
 ]

exonware/xwsystem/config/performance_modes.py

@@ -1,3 +1,4 @@
+#exonware/xwsystem/src/exonware/xwsystem/config/performance_modes.py
 """
 Performance mode definitions for XWSystem framework.
 
@@ -10,18 +11,18 @@ import statistics
 import threading
 import time
 from dataclasses import dataclass, field
-from typing import Any, Optional, Union
+from typing import Any, Optional
 from .defs import AdvancedPerformanceMode
 
 import psutil
 
 
-# Use AdvancedPerformanceMode directly as PerformanceMode for backward compatibility
+# Use AdvancedPerformanceMode directly as PerformanceMode
 PerformanceMode = AdvancedPerformanceMode
 
 
 class PerformanceModes:
-    """Performance mode constants for backward compatibility and simple usage."""
+    """Performance mode constants."""
     
     FAST = "fast"
     BALANCED = "balanced"
@@ -54,7 +55,7 @@ class PerformanceProfile:
     enable_thread_safety: bool
     lock_timeout: float
 
-    # Security limits (always enforced)
+    # Security limits (enforced)
     max_depth: int
     max_nodes: int
     max_path_length: int
@@ -127,7 +128,7 @@ class DualAdaptiveProfile(PerformanceProfile):
     deep_dive_sample_rate: int = 1  # Sample every operation in deep-dive
     deep_dive_history_size: int = 1000  # Keep detailed history during deep-dive
 
-    # Smart triggers
+    # Adaptive triggers
     memory_pressure_threshold: float = 0.8  # 80% memory usage triggers deep-dive
     cpu_pressure_threshold: float = 0.7  # 70% CPU usage triggers deep-dive
     performance_degradation_threshold: float = 0.2  # 20% degradation triggers deep-dive
@@ -343,7 +344,7 @@ class AdaptiveLearningEngine:
         if not mode_scores:
             return PerformanceMode.AUTO
 
-        # Return the best performing mode
+        # Return the highest performing mode
         best_mode_name = max(mode_scores.items(), key=lambda x: x[1])[0]
         return PerformanceMode.from_string(best_mode_name)
 
@@ -590,7 +591,7 @@ class DualPhaseAdaptiveEngine:
         if not mode_scores:
             return PerformanceMode.OPTIMIZED
 
-        # Return the best performing mode
+        # Return the highest performing mode
         best_mode_name = max(mode_scores.items(), key=lambda x: x[1])[0]
         return PerformanceMode.from_string(best_mode_name)
 
@@ -759,7 +760,7 @@ class PerformanceProfiles:
                 deep_dive_duration=200,  # Deep-dive for 200 operations (was 500)
                 deep_dive_sample_rate=5,  # Sample every 5th operation (was 1)
                 deep_dive_history_size=500,  # Keep detailed history (was 1000)
-                # Smart triggers
+                # Adaptive triggers
                 memory_pressure_threshold=0.9,  # 90% memory usage triggers deep-dive (was 0.8)
                 cpu_pressure_threshold=0.8,  # 80% CPU usage triggers deep-dive (was 0.7)
                 performance_degradation_threshold=0.3,  # 30% degradation triggers deep-dive (was 0.2)

exonware/xwsystem/config/version_manager.py

@@ -1,3 +1,4 @@
+#exonware/xwsystem/src/exonware/xwsystem/config/version_manager.py
 """
 Centralized version management for eXonware projects.
 

exonware/xwsystem/config.py

@@ -0,0 +1,27 @@
+"""
+#exonware/xwsystem/src/exonware/xwsystem/config.py
+
+Package-level configuration entry points for xwsystem.
+
+Company: eXonware.com
+Author: Eng. Muhammad AlShehri
+Email: connect@exonware.com
+Version: 0.1.0.3
+Last Updated: 29-Jan-2026
+
+This module exists to satisfy the canonical structure in GUIDE_31_DEV.md:
+- `config.py` at package root for configuration surfaces.
+
+The concrete configuration system lives under `exonware.xwsystem.config`.
+"""
+
+from __future__ import annotations
+
+from .config.logging_setup import get_logger, setup_logging
+
+
+__all__ = [
+    "get_logger",
+    "setup_logging",
+]
+

exonware/xwsystem/console/__init__.py

@@ -0,0 +1,53 @@
+#!/usr/bin/env python3
+#exonware/xwsystem/src/exonware/xwsystem/console/__init__.py
+#exonware/xwsystem/console/__init__.py
+"""
+Company: eXonware.com
+Author: Eng. Muhammad AlShehri
+Email: connect@exonware.com
+Version: 0.1.0.3
+Generation Date: 2025-01-27
+
+Console module for structured logging and user interaction.
+"""
+
+from .defs import (
+    LogLevel,
+    ConsoleEventType,
+    ConsoleEvent,
+)
+from .contracts import (
+    IEventLogger,
+    IConsoleWriter,
+)
+from .base import (
+    AEventLogger,
+    AConsoleWriter,
+)
+from .event_logger import ConsoleEventLogger
+from .writer import ConsoleWriter
+from .errors import (
+    ConsoleError,
+    EventLoggerError,
+    ConsoleWriterError,
+)
+
+__all__ = [
+    # Type definitions
+    'LogLevel',
+    'ConsoleEventType',
+    'ConsoleEvent',
+    # Interfaces
+    'IEventLogger',
+    'IConsoleWriter',
+    # Abstract base classes
+    'AEventLogger',
+    'AConsoleWriter',
+    # Implementations
+    'ConsoleEventLogger',
+    'ConsoleWriter',
+    # Errors
+    'ConsoleError',
+    'EventLoggerError',
+    'ConsoleWriterError',
+]

exonware/xwsystem/console/base.py

@@ -0,0 +1,133 @@
+#!/usr/bin/env python3
+#exonware/xwsystem/src/exonware/xwsystem/console/base.py
+#exonware/xwsystem/console/base.py
+"""
+Company: eXonware.com
+Author: Eng. Muhammad AlShehri
+Email: connect@exonware.com
+Version: 0.1.0.3
+Generation Date: 2025-01-27
+
+Console module base classes - abstract base classes for console functionality.
+"""
+
+from abc import ABC, abstractmethod
+from typing import Optional, Any
+from .contracts import IEventLogger, IConsoleWriter
+from .defs import LogLevel, ConsoleEventType, ConsoleEvent
+
+
+class AEventLogger(ABC, IEventLogger):
+    """
+    Abstract base class for event logging.
+    
+    All event loggers should extend this class.
+    """
+    
+    @abstractmethod
+    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."""
+        pass
+    
+    @abstractmethod
+    def info(
+        self,
+        msg: str,
+        source: Optional[str] = None,
+        data: Optional[Any] = None
+    ) -> ConsoleEvent:
+        """Log an info message."""
+        pass
+    
+    @abstractmethod
+    def warn(
+        self,
+        msg: str,
+        source: Optional[str] = None,
+        data: Optional[Any] = None
+    ) -> ConsoleEvent:
+        """Log a warning message."""
+        pass
+    
+    @abstractmethod
+    def error(
+        self,
+        msg: str,
+        source: Optional[str] = None,
+        data: Optional[Any] = None,
+        stack: Optional[str] = None
+    ) -> ConsoleEvent:
+        """Log an error message."""
+        pass
+    
+    @abstractmethod
+    def debug(
+        self,
+        msg: str,
+        source: Optional[str] = None,
+        data: Optional[Any] = None
+    ) -> ConsoleEvent:
+        """Log a debug message."""
+        pass
+    
+    @abstractmethod
+    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."""
+        pass
+    
+    @abstractmethod
+    def clear(self) -> None:
+        """Clear all logged events."""
+        pass
+    
+    @abstractmethod
+    def count(self) -> int:
+        """Get the number of logged events."""
+        pass
+
+
+class AConsoleWriter(ABC, IConsoleWriter):
+    """
+    Abstract base class for console writing (user interaction, not logging).
+    
+    Can be used as a base class for bots and other user interaction systems.
+    """
+    
+    @abstractmethod
+    def write(self, text: str, **kwargs) -> None:
+        """Write text to console."""
+        pass
+    
+    @abstractmethod
+    def write_line(self, text: str = "", **kwargs) -> None:
+        """Write a line to console."""
+        pass
+    
+    @abstractmethod
+    def read(self, prompt: str = "") -> str:
+        """Read input from console."""
+        pass
+    
+    @abstractmethod
+    def clear(self) -> None:
+        """Clear console screen."""
+        pass
+
+
+__all__ = [
+    'AEventLogger',
+    'AConsoleWriter',
+]

exonware/xwsystem/console/cli/__init__.py

@@ -0,0 +1,61 @@
+#exonware/xwsystem/src/exonware/xwsystem/console/cli/__init__.py
+"""
+Command Line Interface (CLI) Utilities
+======================================
+
+Production-grade CLI utilities for XSystem.
+
+Company: eXonware.com
+Author: Eng. Muhammad AlShehri
+Email: connect@exonware.com
+Version: 0.1.0.3
+Generated: 2025-01-27
+"""
+
+# Import general console enums from console level (priority)
+from ..defs import Colors, Style, Alignment, BorderStyle
+from .colors import colorize, CliColoredOutput
+from .args import CliArgumentParser, CliArgument, CliCommand, ArgumentType
+from .progress import CliProgressBar, CliSpinnerProgress, CliMultiProgress, CliProgressConfig
+from .tables import CliTable, CliTableFormatter, CliColumn
+from .console import CliConsole
+from .event_logger import CliEventLogger
+from .encoding import ensure_utf8_console
+
+__all__ = [
+    # General console enums (from console level)
+    'Colors', 
+    'Style',
+    'Alignment',
+    'BorderStyle',
+    
+    # Colors
+    'colorize',
+    'CliColoredOutput',
+    
+    # Arguments
+    'CliArgumentParser',
+    'CliArgument',
+    'CliCommand',
+    'ArgumentType',
+    
+    # Progress
+    'CliProgressBar',
+    'CliSpinnerProgress', 
+    'CliMultiProgress',
+    'CliProgressConfig',
+    
+    # Tables
+    'CliTable',
+    'CliTableFormatter',
+    'CliColumn',
+    
+    # Console (extends ConsoleWriter from console level)
+    'CliConsole',
+    
+    # Event Logger (extends logging.Logger)
+    'CliEventLogger',
+
+    # Encoding
+    'ensure_utf8_console',
+]