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

webscout/Litlogger/styles/colors.py

@@ -0,0 +1,231 @@
+# Terminal Color Management System
+# Provides extensive ANSI color support with themes, gradients, and animations
+
+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
+    """
+    # Basic foreground 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"
+    RESET = "\033[0m"
+
+    # Basic 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 foreground 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"
+
+    # Text 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"
+    DOUBLE_UNDERLINE = "\033[21m"
+
+    # Special effects
+    FRAME = "\033[51m"
+    ENCIRCLE = "\033[52m"
+    OVERLINE = "\033[53m"
+
+    # Extended color combinations
+    FIRE = "\033[38;2;255;100;0m"
+    ICE = "\033[38;2;150;230;255m"
+    GRASS = "\033[38;2;0;200;0m"
+    PURPLE = "\033[38;2;160;32;240m"
+    GOLD = "\033[38;2;255;215;0m"
+    SILVER = "\033[38;2;192;192;192m"
+    BRONZE = "\033[38;2;205;127;50m"
+    PINK = "\033[38;2;255;192;203m"
+    TEAL = "\033[38;2;0;128;128m"
+    ORANGE = "\033[38;2;255;165;0m"
+    BROWN = "\033[38;2;165;42;42m"
+    MAROON = "\033[38;2;128;0;0m"
+    NAVY = "\033[38;2;0;0;128m"
+    OLIVE = "\033[38;2;128;128;0m"
+
+    # Gradient colors
+    SUNSET_START = "\033[38;2;255;128;0m"
+    SUNSET_END = "\033[38;2;255;0;128m"
+    OCEAN_START = "\033[38;2;0;255;255m"
+    OCEAN_END = "\033[38;2;0;0;255m"
+    FOREST_START = "\033[38;2;34;139;34m"
+    FOREST_END = "\033[38;2;0;100;0m"
+
+    # Special background combinations
+    BG_FIRE = "\033[48;2;255;100;0m"
+    BG_ICE = "\033[48;2;150;230;255m"
+    BG_GRASS = "\033[48;2;0;200;0m"
+    BG_PURPLE = "\033[48;2;160;32;240m"
+    BG_GOLD = "\033[48;2;255;215;0m"
+    BG_SILVER = "\033[48;2;192;192;192m"
+    BG_BRONZE = "\033[48;2;205;127;50m"
+    BG_PINK = "\033[48;2;255;192;203m"
+    BG_TEAL = "\033[48;2;0;128;128m"
+    BG_ORANGE = "\033[48;2;255;165;0m"
+    BG_BROWN = "\033[48;2;165;42;42m"
+    BG_MAROON = "\033[48;2;128;0;0m"
+    BG_NAVY = "\033[48;2;0;0;128m"
+    BG_OLIVE = "\033[48;2;128;128;0m"
+
+    @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(*styles: str) -> str:
+        """Combine multiple color and style codes."""
+        return "".join(styles)
+
+    @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
+
+
+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,377 @@
+from enum import Enum
+from typing import Dict
+
+class LogFormat:
+    # Basic formats
+    MINIMAL = "[{time}] {level} {message}"
+    STANDARD = "[{time}] {level} {name}: {message}"
+    DETAILED = "[{time}] {level} {name} [{file}:{line}] >>> {message}"
+    SIMPLE = "{message}"
+    COMPACT = "{time} {level}: {message}"
+    
+    # Modern Styles
+    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}
+"""
+
+    # Error Formats
+    ERROR = "!!! {level} !!! [{time}] {name} - {message}"
+    ERROR_DETAILED = """
+ {level} ALERT 
+Time: {time}
+Component: {name}
+Location: {file}:{line}
+Message: {message}"""
+
+    ERROR_COMPACT = " [{time}] {level}: {message}"
+    ERROR_EMOJI = "❌ {time} | {level} | {message}"
+    ERROR_BLOCK = """
+█▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
+█  ERROR @ {time}
+█  {message}
+█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█"""
+
+    # Status & Progress
+    STATUS = """
+Status Update:
+ Time: {time}
+ Level: {level}
+ Component: {name}
+ Message: {message}"""
+
+    PROGRESS = """
+[{time}] Progress Report
+├─ 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 Call ──────────
+│ Time: {time}
+│ Method: {method}
+│ URL: {url}
+│ Status: {status_code}
+│ Response: {message}
+└────────────────────"""
+
+    # System & Metrics
+    SYSTEM = """
+ System Event
+ {time}
+ {level}
+ {name}
+ {message}"""
+
+    METRIC = """
+ Metric Report [{time}]
+Level: {level}
+Source: {name}
+Value: {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}
+Details: {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 = """{
+    "time": "{time}",
+    "level": "{level}",
+    "name": "{name}",
+    "message": "{message}"
+}"""
+    
+    XML = """<log>
+  <time>{time}</time>
+  <level>{level}</level>
+  <name>{name}</name>
+  <message>{message}</message>
+</log>"""
+
+    YAML = """---
+time: {time}
+level: {level}
+name: {name}
+message: {message}
+"""
+
+    # Documentation Formats
+    MARKDOWN = """
+## Log Entry
+- **Time:** {time}
+- **Level:** {level}
+- **Component:** {name}
+- **Message:** {message}
+"""
+
+    RST = """
+Log Entry
+=========
+:Time: {time}
+:Level: {level}
+:Component: {name}
+:Message: {message}
+"""
+
+    HTML = """<div class="log-entry">
+    <span class="time">{time}</span>
+    <span class="level">{level}</span>
+    <span class="name">{name}</span>
+    <span class="message">{message}</span>
+</div>"""
+
+    # 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,
+    }
+
+    @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

webscout/Litlogger/styles/text.py

@@ -0,0 +1,87 @@
+import textwrap
+from typing import Optional
+
+class TextStyle:
+    @staticmethod
+    def wrap(text: str, width: int = 80, indent: str = "") -> str:
+        """Wrap text to specified width with optional indentation."""
+        return textwrap.fill(text, width=width, initial_indent=indent, 
+                           subsequent_indent=indent)
+
+    @staticmethod
+    def truncate(text: str, max_length: int, suffix: str = "...") -> str:
+        """Truncate text to maximum length with suffix."""
+        if len(text) <= max_length:
+            return text
+        return text[:max_length - len(suffix)] + suffix
+
+    @staticmethod
+    def pad(text: str, width: int, align: str = "left", 
+           fill_char: str = " ") -> str:
+        """Pad text to specified width with alignment."""
+        if align == "left":
+            return text.ljust(width, fill_char)
+        elif align == "right":
+            return text.rjust(width, fill_char)
+        elif align == "center":
+            return text.center(width, fill_char)
+        raise ValueError(f"Invalid alignment: {align}")
+
+    @staticmethod
+    def indent(text: str, prefix: str = "  ", predicate: Optional[callable] = None) -> str:
+        """Indent text lines with prefix based on optional predicate."""
+        lines = text.splitlines(True)
+        if predicate is None:
+            predicate = bool
+        
+        def should_indent(line):
+            return predicate(line)
+
+        return "".join(prefix + line if should_indent(line) else line
+                      for line in lines)
+
+    @staticmethod
+    def highlight(text: str, substring: str, color: str) -> str:
+        """Highlight substring within text using ANSI color codes."""
+        from ..styles.colors import LogColors
+        if not substring:
+            return text
+        
+        parts = text.split(substring)
+        highlighted = f"{color}{substring}{LogColors.RESET}"
+        return highlighted.join(parts)
+
+    @staticmethod
+    def table(headers: list, rows: list, padding: int = 1) -> str:
+        """Create a formatted table with headers and rows."""
+        if not rows:
+            return ""
+            
+        # Calculate column widths
+        widths = [max(len(str(row[i])) for row in [headers] + rows)
+                 for i in range(len(headers))]
+        
+        # Create separator line
+        separator = "+" + "+".join("-" * (w + 2 * padding) for w in widths) + "+"
+        
+        # Format header
+        header = "|" + "|".join(
+            str(h).center(w + 2 * padding) for h, w in zip(headers, widths)
+        ) + "|"
+        
+        # Format rows
+        formatted_rows = []
+        for row in rows:
+            formatted_row = "|" + "|".join(
+                str(cell).ljust(w + 2 * padding) for cell, w in zip(row, widths)
+            ) + "|"
+            formatted_rows.append(formatted_row)
+        
+        # Combine all parts
+        return "\n".join([
+            separator,
+            header,
+            separator,
+            *formatted_rows,
+            separator
+        ])

webscout/Litlogger/utils/__init__.py

@@ -0,0 +1,6 @@
+"""Utility functions for log level detection and message formatting."""
+
+from .detectors import LevelDetector
+from .formatters import MessageFormatter
+
+__all__ = ["LevelDetector", "MessageFormatter"]