webscout 7.1__py3-none-any.whl → 7.3__py3-none-any.whl

webscout/Litlogger/styles/colors.py

@@ -0,0 +1,249 @@
+# Terminal Color Management System
+# Provides extensive ANSI color support with themes, gradients, and animations
+
+from typing import Optional
+from ..core.level import LogLevel
+
+
+class LogColors:
+    """
+    Comprehensive terminal color and styling system with support for:
+    - Basic and bright colors (foreground/background)
+    - RGB and 256-color modes
+    - Text styles (bold, italic, etc.)
+    - Gradients and animations
+    - Predefined themes
+    """
+    # Reset
+    RESET = "\033[0m"
+    
+    # Regular colors
+    BLACK = "\033[30m"
+    RED = "\033[31m"
+    GREEN = "\033[32m"
+    YELLOW = "\033[33m"
+    BLUE = "\033[34m"
+    MAGENTA = "\033[35m"
+    CYAN = "\033[36m"
+    WHITE = "\033[37m"
+    
+    # Background colors
+    BG_BLACK = "\033[40m"
+    BG_RED = "\033[41m"
+    BG_GREEN = "\033[42m"
+    BG_YELLOW = "\033[43m"
+    BG_BLUE = "\033[44m"
+    BG_MAGENTA = "\033[45m"
+    BG_CYAN = "\033[46m"
+    BG_WHITE = "\033[47m"
+    
+    # Bright colors
+    BRIGHT_BLACK = "\033[90m"
+    BRIGHT_RED = "\033[91m"
+    BRIGHT_GREEN = "\033[92m"
+    BRIGHT_YELLOW = "\033[93m"
+    BRIGHT_BLUE = "\033[94m"
+    BRIGHT_MAGENTA = "\033[95m"
+    BRIGHT_CYAN = "\033[96m"
+    BRIGHT_WHITE = "\033[97m"
+    
+    # Bright background colors
+    BG_BRIGHT_BLACK = "\033[100m"
+    BG_BRIGHT_RED = "\033[101m"
+    BG_BRIGHT_GREEN = "\033[102m"
+    BG_BRIGHT_YELLOW = "\033[103m"
+    BG_BRIGHT_BLUE = "\033[104m"
+    BG_BRIGHT_MAGENTA = "\033[105m"
+    BG_BRIGHT_CYAN = "\033[106m"
+    BG_BRIGHT_WHITE = "\033[107m"
+    
+    # Custom theme colors using RGB
+    FIRE = "\033[38;2;255;100;0m"  # Orange-red
+    ICE = "\033[38;2;150;230;255m"  # Light blue
+    GRASS = "\033[38;2;120;200;80m"  # Light green
+    PURPLE = "\033[38;2;147;112;219m"  # Medium purple
+    GOLD = "\033[38;2;255;215;0m"  # Golden
+    
+    # Gradient colors
+    SUNSET_START = "\033[38;2;255;128;0m"  # Orange
+    SUNSET_END = "\033[38;2;255;51;153m"  # Pink
+    
+    OCEAN_START = "\033[38;2;0;204;255m"  # Light blue
+    OCEAN_END = "\033[38;2;0;51;102m"  # Dark blue
+    
+    FOREST_START = "\033[38;2;34;139;34m"  # Forest green
+    FOREST_END = "\033[38;2;0;100;0m"  # Dark green
+    
+    # Bold
+    BOLD = "\033[1m"
+    
+    # Styles
+    DIM = "\033[2m"
+    ITALIC = "\033[3m"
+    UNDERLINE = "\033[4m"
+    
+    # Level color mapping
+    LEVEL_COLORS = {
+        LogLevel.DEBUG: BRIGHT_BLACK,
+        LogLevel.INFO: BRIGHT_BLUE,
+        LogLevel.WARNING: BRIGHT_YELLOW,
+        LogLevel.ERROR: BRIGHT_RED,
+        LogLevel.CRITICAL: BRIGHT_RED + BOLD,
+        LogLevel.NOTSET: WHITE
+    }
+
+    # Add style combinations
+    STYLES = {
+        "bold": "\033[1m",
+        "dim": "\033[2m",
+        "italic": "\033[3m",
+        "underline": "\033[4m",
+        "blink": "\033[5m",
+        "reverse": "\033[7m",
+        "hidden": "\033[8m",
+        "strike": "\033[9m",
+    }
+
+    @staticmethod
+    def rgb(r: int, g: int, b: int, background: bool = False) -> str:
+        """Create RGB color code."""
+        if background:
+            return f"\033[48;2;{r};{g};{b}m"
+        return f"\033[38;2;{r};{g};{b}m"
+
+    @staticmethod
+    def color_256(code: int, background: bool = False) -> str:
+        """Create 256-color code."""
+        if background:
+            return f"\033[48;5;{code}m"
+        return f"\033[38;5;{code}m"
+
+    @staticmethod
+    def combine(*colors):
+        return "".join(colors)
+
+    @staticmethod
+    def gradient(text: str, start_rgb: tuple, end_rgb: tuple) -> str:
+        """Create a gradient effect across text."""
+        if len(text) < 2:
+            return LogColors.rgb(*start_rgb) + text
+            
+        result = []
+        for i, char in enumerate(text):
+            r = int(start_rgb[0] + (end_rgb[0] - start_rgb[0]) * i / (len(text) - 1))
+            g = int(start_rgb[1] + (end_rgb[1] - start_rgb[1]) * i / (len(text) - 1))
+            b = int(start_rgb[2] + (end_rgb[2] - start_rgb[2]) * i / (len(text) - 1))
+            result.append(f"{LogColors.rgb(r, g, b)}{char}")
+            
+        return "".join(result) + LogColors.RESET
+
+    @staticmethod
+    def rainbow(text: str) -> str:
+        """Apply rainbow colors to text."""
+        colors = [
+            (255, 0, 0),    # Red
+            (255, 127, 0),  # Orange
+            (255, 255, 0),  # Yellow
+            (0, 255, 0),    # Green
+            (0, 0, 255),    # Blue
+            (75, 0, 130),   # Indigo
+            (148, 0, 211)   # Violet
+        ]
+        
+        result = []
+        for i, char in enumerate(text):
+            color = colors[i % len(colors)]
+            result.append(f"{LogColors.rgb(*color)}{char}")
+            
+        return "".join(result) + LogColors.RESET
+
+    @staticmethod
+    def animate(text: str, effect: str = "blink") -> str:
+        """Apply animation effects to text."""
+        effects = {
+            "blink": LogColors.BLINK,
+            "reverse": LogColors.REVERSE,
+            "bold_blink": LogColors.combine(LogColors.BOLD, LogColors.BLINK),
+            "frame_blink": LogColors.combine(LogColors.FRAME, LogColors.BLINK),
+            "encircle_blink": LogColors.combine(LogColors.ENCIRCLE, LogColors.BLINK)
+        }
+        return effects.get(effect, LogColors.BLINK) + text + LogColors.RESET
+
+    @staticmethod
+    def style_text(text: str, *styles: str, color: Optional[str] = None) -> str:
+        """Apply multiple styles and color to text."""
+        style_codes = "".join(LogColors.STYLES.get(style, "") for style in styles)
+        color_code = color if color else ""
+        return f"{style_codes}{color_code}{text}{LogColors.RESET}"
+
+    @staticmethod
+    def level_style(level: LogLevel, text: str) -> str:
+        """Style text according to log level with enhanced formatting."""
+        color = LogColors.LEVEL_COLORS.get(level, LogColors.RESET)
+        
+        # Apply appropriate styling based on level
+        if level == LogLevel.CRITICAL:
+            return f"{color}{LogColors.STYLES['bold']}{text}{LogColors.RESET}"
+        elif level == LogLevel.ERROR:
+            return f"{color}{text}{LogColors.RESET}"
+        elif level == LogLevel.WARNING:
+            return f"{color}{text}{LogColors.RESET}"
+        else:
+            return f"{color}{text}{LogColors.RESET}"
+
+
+class LogTheme:
+    """Pre-defined color themes and combinations."""
+    
+    @staticmethod
+    def get_theme(name: str) -> str:
+        themes = {
+            # Status themes
+            "success": LogColors.combine(LogColors.BRIGHT_GREEN, LogColors.BOLD),
+            "error": LogColors.combine(LogColors.BRIGHT_RED, LogColors.BOLD),
+            "warning": LogColors.combine(LogColors.BRIGHT_YELLOW, LogColors.BOLD),
+            "info": LogColors.combine(LogColors.BRIGHT_BLUE, LogColors.BOLD),
+            "debug": LogColors.combine(LogColors.DIM, LogColors.WHITE),
+            "critical": LogColors.combine(LogColors.BG_RED, LogColors.WHITE, LogColors.BOLD),
+            
+            # Special themes
+            "header": LogColors.combine(LogColors.BRIGHT_WHITE, LogColors.BOLD, LogColors.UNDERLINE),
+            "highlight": LogColors.combine(LogColors.BLACK, LogColors.BG_BRIGHT_YELLOW),
+            "important": LogColors.combine(LogColors.BRIGHT_RED, LogColors.BOLD, LogColors.UNDERLINE),
+            "subtle": LogColors.combine(LogColors.DIM, LogColors.BRIGHT_BLACK),
+            
+            # UI themes
+            "title": LogColors.combine(LogColors.BRIGHT_WHITE, LogColors.BOLD, LogColors.UNDERLINE),
+            "subtitle": LogColors.combine(LogColors.BRIGHT_WHITE, LogColors.DIM),
+            "link": LogColors.combine(LogColors.BLUE, LogColors.UNDERLINE),
+            "code": LogColors.combine(LogColors.BRIGHT_BLACK, LogColors.BG_WHITE),
+            
+            # Data themes
+            "number": LogColors.combine(LogColors.BRIGHT_CYAN, LogColors.BOLD),
+            "string": LogColors.combine(LogColors.BRIGHT_GREEN),
+            "boolean": LogColors.combine(LogColors.BRIGHT_YELLOW, LogColors.BOLD),
+            "null": LogColors.combine(LogColors.DIM, LogColors.ITALIC),
+            
+            # Custom themes
+            "fire": LogColors.combine(LogColors.FIRE, LogColors.BOLD),
+            "ice": LogColors.combine(LogColors.ICE, LogColors.BOLD),
+            "nature": LogColors.combine(LogColors.GRASS, LogColors.BOLD),
+            "royal": LogColors.combine(LogColors.PURPLE, LogColors.BOLD),
+            "precious": LogColors.combine(LogColors.GOLD, LogColors.BOLD),
+            
+            # Gradient themes
+            "sunset": LogColors.combine(LogColors.SUNSET_START, LogColors.SUNSET_END),
+            "ocean": LogColors.combine(LogColors.OCEAN_START, LogColors.OCEAN_END),
+            "forest": LogColors.combine(LogColors.FOREST_START, LogColors.FOREST_END),
+        }
+        return themes.get(name, LogColors.RESET)
+
+
+# Define level colors after both classes are defined
+LogColors.LEVEL_COLORS = {
+    "DEBUG": LogTheme.get_theme("debug"),
+    "INFO": LogTheme.get_theme("info"),
+    "WARNING": LogTheme.get_theme("warning"),
+    "ERROR": LogTheme.get_theme("error"),
+    "CRITICAL": LogTheme.get_theme("critical")
+}

webscout/Litlogger/styles/formats.py

@@ -0,0 +1,460 @@
+from enum import Enum
+from typing import Dict
+
+class LogFormat:
+    # Basic formats with improved styling
+    MINIMAL = "│ {time} │ {level} │ {message}"
+    STANDARD = "┌─ {time} ─┐\n│ {level} │ {name}: {message}"
+    DETAILED = """╭──────────────────────╮
+│ {time}
+│ {level} • {name}
+│ {file}:{line}
+├──────────────────────┤
+│ {message}
+╰──────────────────────╯"""
+    SIMPLE = "• {message}"
+    COMPACT = "⟦{time}⟧ {level} ⟫ {message}"
+    
+    # Modern Styles with Unicode
+    MODERN = """┌────────────────────┐
+│ {time}
+├────────────────────┤
+│ {level} • {name}
+│ {message}
+└────────────────────┘"""
+    
+    MODERN_EMOJI = """╭─ {emoji} {time} ─╮
+│ {level}
+├───────────────────
+│ {message}
+╰───────────────────"""
+    
+    MODERN_CLEAN = """• {time} •
+┌─ {level}
+└→ {message}"""
+    
+    MODERN_BRACKET = """【{time}】
+「{level}」{message}"""
+    
+    MODERN_PLUS = """⊕ {time}
+├─ {level}
+└─ {message}"""
+    
+    MODERN_DOT = """● {time}
+├● {level}
+└● {message}"""
+    
+    MODERN_ARROW = """➤ {time}
+├➤ {level}
+└➤ {message}"""
+    
+    # Boxed Styles
+    BOXED = """
+╭─────────────────────╮
+│ [{time}]
+│ {level} - {name}
+│ {message}
+╰─────────────────────╯"""
+
+    DOUBLE_BOX = """
+╔══════════════════════╗
+║ {level} @ {time}
+║ {name}
+║ {message}
+╚══════════════════════╝"""
+
+    ROUNDED_BOX = """
+╭──────────────────────╮
+│ {time} • {level}
+├──────────────────────┤
+│ {message}
+╰──────────────────────╯"""
+
+    RAINBOW_BOX = """
+ {level} - {time}
+  {name}: {message}
+"""
+
+    HEAVY_BOX = """
+┏━━━━━━━━━━━━━━━━━━━━┓
+┃ {time}
+┃ {level} | {name}
+┃ {message}
+┗━━━━━━━━━━━━━━━━━━━━┛"""
+
+    DOTTED_BOX = """
+╭┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈╮
+┊ {time} | {level}
+┊ {message}
+╰┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈╯"""
+
+    # Debug & Development
+    DEBUG = "[{time}] {level} {name} ({file}:{line}) {message}"
+    DEBUG_FULL = """
+┌─ Debug Info ─┐
+│ Time: {time}
+│ Level: {level}
+│ Name: {name}
+│ File: {file}:{line}
+│ Message: {message}
+└──────────────┘"""
+
+    TRACE = """
+ Trace Details:
+   Time: {time}
+   Level: {level}
+   Location: {file}:{line}
+   Message: {message}"""
+
+    DEBUG_COMPACT = "[DBG][{time}] {message} @{file}:{line}"
+    DEBUG_EXTENDED = """
+🔍 Debug Information 🔍
+⏰ Time: {time}
+📊 Level: {level}
+📂 File: {file}
+📍 Line: {line}
+💬 Message: {message}
+"""
+
+    # Enhanced Error Formats
+    ERROR = """╔══ ERROR ══╗
+║ Time: {time}
+║ Level: {level}
+║ Component: {name}
+╟──────────────
+║ {message}
+╚════════════╝"""
+
+    ERROR_DETAILED = """┏━━ ALERT ━━┓
+┃ Time: {time}
+┃ Level: {level}
+┃ Component: {name}
+┃ Location: {file}:{line}
+┣━━━━━━━━━━━
+┃ {message}
+┗━━━━━━━━━━━┛"""
+
+    ERROR_COMPACT = "‼ [{time}] {level}: {message}"
+    
+    ERROR_EMOJI = """❌ ERROR REPORT
+⏰ {time}
+⚠️ {level}
+📝 {message}"""
+
+    ERROR_BLOCK = """█▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
+█  ERROR @ {time}
+█  {level}
+█  {message}
+█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█"""
+
+    # Status & Progress with Better Visual Hierarchy
+    STATUS = """┌─── Status Update ───┐
+│ Time: {time}
+│ Level: {level}
+│ Component: {name}
+├───────────────────┤
+│ {message}
+└───────────────────┘"""
+
+    PROGRESS = """╭── Progress Report ──╮
+│ Time: {time}
+│ Level: {level}
+├────────────────────
+│ Component: {name}
+│ Status: {message}
+╰────────────────────"""
+
+    PROGRESS_SIMPLE = "► {time} | {level} | {message}"
+    PROGRESS_BAR = "[{progress_bar}] {percentage}% - {message}"
+    
+    # Network & API
+    HTTP = """
+API {level} [{time}]
+Endpoint: {name}
+Response: {message}"""
+
+    REQUEST = """
+→ Incoming Request
+  Time: {time}
+  Level: {level}
+  API: {name}
+  Details: {message}"""
+
+    RESPONSE = """
+← Outgoing Response
+  Time: {time}
+  Level: {level}
+  API: {name}
+  Details: {message}"""
+
+    API_COMPACT = "{method} {url} - {status_code} ({time})"
+    API_DETAILED = """┌── API Request ──┐
+│ Time: {time}
+│ Method: {method}
+│ URL: {url}
+├─────────────────
+│ Status: {status_code}
+│ {message}
+└─────────────────"""
+
+    # System & Metrics
+    SYSTEM = """┌─── System Status ───┐
+│ {time}
+├───────────────────────
+│ Component: {name}
+│ Status: {level}
+│ Message: {message}
+└───────────────────────"""
+
+    METRIC = """┌── Metrics ──┐
+│ Time: {time}
+│ Value: {value}{units}
+│ {message}
+└─────────────"""
+
+    METRIC_COMPACT = "[METRIC] {name}={value} {units}"
+    METRIC_JSON = '{{"metric":"{name}","value":{value},"time":"{time}"}}'
+    
+    # Security & Audit
+    SECURITY = """
+ Security Event 
+Time: {time}
+Level: {level}
+Source: {name}
+Event: {message}"""
+
+    AUDIT = """
+ Audit Log Entry
+Time: {time}
+Level: {level}
+Component: {name}
+Action: {message}"""
+
+    SECURITY_ALERT = """╔═══ SECURITY ALERT ═══╗
+║ Time: {time}
+║ Level: {level}
+║ Component: {name}
+╟───────────────────────
+║ {message}
+╚═══════════════════════"""
+
+    # Special Formats
+    RAINBOW = " {time}  {level}  {message}"
+    MINIMAL_EMOJI = "{emoji} {message}"
+    TIMESTAMP = "{time} {message}"
+    COMPONENT = "[{name}] {message}"
+    HASH = "#{hash} | {time} | {message}"
+    TAG = "@{tag} | {time} | {message}"
+
+    # Data Formats
+    JSON = '{{"time":"{time}","level":"{level}","name":"{name}","message":"{message}"}}'
+    JSON_PRETTY = """{
+    "timestamp": "{time}",
+    "level": "{level}",
+    "component": "{name}",
+    "message": "{message}"
+}"""
+    
+    XML = """<log>
+  <time>{time}</time>
+  <level>{level}</level>
+  <name>{name}</name>
+  <message>{message}</message>
+</log>"""
+
+    YAML = """---
+timestamp: {time}
+level: {level}
+component: {name}
+details:
+  message: {message}
+"""
+
+    # Modern Documentation Formats
+    MARKDOWN = """## Log Entry
+**Time:** `{time}`
+**Level:** `{level}`
+**Component:** `{name}`
+
+> {message}
+---"""
+
+    RST = """
+Log Entry
+=========
+:Time: {time}
+:Level: {level}
+:Component: {name}
+:Message: {message}
+"""
+
+    HTML = """<div class="log-entry">
+    <div class="log-header">
+        <span class="time">{time}</span>
+        <span class="level">{level}</span>
+    </div>
+    <div class="log-body">
+        <span class="name">{name}</span>
+        <span class="message">{message}</span>
+    </div>
+</div>"""
+
+    # Rich Console Formats
+    RICH = """╭── {name} ──╮
+│ {time} │ {level_colored}
+├──────────┴───────────
+│ {message}
+│ {context}{exception}
+╰────────────────────"""
+    
+    RICH_DETAILED = """╔══════════════════════════╗
+║ {name}                    
+╟──────────────────────────
+║ Time: {time}
+║ Level: {level_colored}
+║ Thread: {thread_info}
+╟──────────────────────────
+║ {message}
+║ {context}{exception}
+╚══════════════════════════╝"""
+
+    RICH_MINIMAL = "│ {time} │ {level_colored} │ {message}"
+    
+    RICH_COMPACT = "⟦{time}⟧ {level_colored} [{name}] ⟫ {message}"
+
+    # Template registry
+    TEMPLATES = {
+        # Basic formats
+        "minimal": MINIMAL,
+        "standard": STANDARD,
+        "detailed": DETAILED,
+        "simple": SIMPLE,
+        "compact": COMPACT,
+
+        # Modern styles
+        "modern": MODERN,
+        "modern_emoji": MODERN_EMOJI,
+        "modern_clean": MODERN_CLEAN,
+        "modern_bracket": MODERN_BRACKET,
+        "modern_plus": MODERN_PLUS,
+        "modern_dot": MODERN_DOT,
+        "modern_arrow": MODERN_ARROW,
+
+        # Boxed styles
+        "boxed": BOXED,
+        "double_box": DOUBLE_BOX,
+        "rounded_box": ROUNDED_BOX,
+        "rainbow_box": RAINBOW_BOX,
+        "heavy_box": HEAVY_BOX,
+        "dotted_box": DOTTED_BOX,
+
+        # Debug formats
+        "debug": DEBUG,
+        "debug_full": DEBUG_FULL,
+        "trace": TRACE,
+        "debug_compact": DEBUG_COMPACT,
+        "debug_extended": DEBUG_EXTENDED,
+
+        # Error formats
+        "error": ERROR,
+        "error_detailed": ERROR_DETAILED,
+        "error_compact": ERROR_COMPACT,
+        "error_emoji": ERROR_EMOJI,
+        "error_block": ERROR_BLOCK,
+
+        # Status formats
+        "status": STATUS,
+        "progress": PROGRESS,
+        "progress_simple": PROGRESS_SIMPLE,
+        "progress_bar": PROGRESS_BAR,
+
+        # Network formats
+        "http": HTTP,
+        "request": REQUEST,
+        "response": RESPONSE,
+        "api_compact": API_COMPACT,
+        "api_detailed": API_DETAILED,
+
+        # System formats
+        "system": SYSTEM,
+        "metric": METRIC,
+        "metric_compact": METRIC_COMPACT,
+        "metric_json": METRIC_JSON,
+
+        # Security formats
+        "security": SECURITY,
+        "audit": AUDIT,
+        "security_alert": SECURITY_ALERT,
+
+        # Special formats
+        "rainbow": RAINBOW,
+        "minimal_emoji": MINIMAL_EMOJI,
+        "timestamp": TIMESTAMP,
+        "component": COMPONENT,
+        "hash": HASH,
+        "tag": TAG,
+
+        # Data formats
+        "json": JSON,
+        "json_pretty": JSON_PRETTY,
+        "xml": XML,
+        "yaml": YAML,
+
+        # Documentation formats
+        "markdown": MARKDOWN,
+        "rst": RST,
+        "html": HTML,
+
+        # Rich-like formats
+        "rich": RICH,
+        "rich_detailed": RICH_DETAILED,
+        "rich_minimal": RICH_MINIMAL,
+        "rich_compact": RICH_COMPACT,
+    }
+
+    @staticmethod
+    def create_custom(template: str) -> str:
+        """Create a custom log format template."""
+        try:
+            # Test if the template is valid by formatting with dummy data
+            dummy_data = {
+                "time": "2024-01-01 00:00:00",
+                "level": "INFO",
+                "name": "test",
+                "message": "test message",
+                "file": "test.py",
+                "line": 1,
+                "emoji": "✨",
+                "progress_bar": "==========",
+                "percentage": 100,
+                "method": "GET",
+                "url": "/test",
+                "status_code": 200,
+                "value": 42,
+                "units": "ms",
+                "hash": "abc123",
+                "tag": "test"
+            }
+            template.format(**dummy_data)
+            return template
+        except KeyError as e:
+            raise ValueError(f"Invalid format template. Missing key: {e}")
+        except Exception as e:
+            raise ValueError(f"Invalid format template: {e}")
+
+    @staticmethod
+    def get_format(format_name: str) -> str:
+        """Get a predefined format template by name."""
+        if format_name in LogFormat.TEMPLATES:
+            return LogFormat.TEMPLATES[format_name]
+        raise ValueError(f"Unknown format: {format_name}")
+
+    @staticmethod
+    def register_template(name: str, template: str):
+        """Register a new format template."""
+        if name in LogFormat.TEMPLATES:
+            raise ValueError(f"Format template '{name}' already exists")
+        
+        # Validate template before registering
+        LogFormat.create_custom(template)
+        LogFormat.TEMPLATES[name] = template