provide-foundation 0.0.0.dev0__py3-none-any.whl → 0.0.0.dev2__py3-none-any.whl

provide/foundation/logger/emoji/__init__.py

@@ -1,44 +0,0 @@
-"""
-Emoji configuration and mapping for Foundation logger.
-
-This module provides emoji sets and mappings for visual enhancement
-of structured logs in various domains (HTTP, LLM, Database, etc.).
-"""
-
-from provide.foundation.logger.emoji.matrix import (
-    PRIMARY_EMOJI,
-    SECONDARY_EMOJI,
-    TERTIARY_EMOJI,
-    show_emoji_matrix,
-)
-from provide.foundation.logger.emoji.sets import (
-    DATABASE_EMOJI_SET,
-    HTTP_EMOJI_SET,
-    LEGACY_DAS_EMOJI_SETS,
-    LEGACY_DAS_FIELD_DEFINITIONS,
-    LLM_EMOJI_SET,
-)
-from provide.foundation.logger.emoji.types import (
-    EmojiSet,
-    EmojiSetConfig,
-    FieldToEmojiMapping,
-)
-
-__all__ = [
-    # Core emoji dictionaries
-    "PRIMARY_EMOJI",
-    "SECONDARY_EMOJI",
-    "TERTIARY_EMOJI",
-    # Emoji sets
-    "DATABASE_EMOJI_SET",
-    "HTTP_EMOJI_SET",
-    "LLM_EMOJI_SET",
-    "LEGACY_DAS_EMOJI_SETS",
-    "LEGACY_DAS_FIELD_DEFINITIONS",
-    # Types
-    "EmojiSet",
-    "EmojiSetConfig",
-    "FieldToEmojiMapping",
-    # Utilities
-    "show_emoji_matrix",
-]

provide/foundation/logger/emoji/matrix.py

@@ -1,209 +0,0 @@
-#
-# emoji_matrix.py
-#
-"""
-Foundation Telemetry Emoji Matrix and Display Utilities.
-Defines the core DAS emoji mappings and provides utilities to display
-active emoji configurations (DAS or emoji set-based).
-"""
-
-from provide.foundation.logger import (
-    base as foundation_logger_base,  # For accessing the global logger instance
-)
-
-# Import types for resolved config structure
-from provide.foundation.logger.emoji.types import EmojiSet, FieldToEmojiMapping
-
-PRIMARY_EMOJI: dict[str, str] = {
-    "system": "⚙️",
-    "server": "🛎️",
-    "client": "🙋",
-    "network": "🌐",
-    "security": "🔐",
-    "config": "🔩",
-    "database": "🗄️",
-    "cache": "💾",
-    "task": "🔄",
-    "plugin": "🔌",
-    "telemetry": "🛰️",
-    "di": "💉",
-    "protocol": "📡",
-    "file": "📄",
-    "user": "👤",
-    "test": "🧪",
-    "utils": "🧰",
-    "core": "🌟",
-    "auth": "🔑",
-    "entity": "🦎",
-    "report": "📈",
-    "payment": "💳",
-    "default": "❓",
-}
-
-SECONDARY_EMOJI: dict[str, str] = {
-    "init": "🌱",
-    "start": "🚀",
-    "stop": "🛑",
-    "connect": "🔗",
-    "disconnect": "💔",
-    "listen": "👂",
-    "send": "📤",
-    "receive": "📥",
-    "read": "📖",
-    "write": "📝",
-    "process": "⚙️",
-    "validate": "🛡️",
-    "execute": "▶️",
-    "query": "🔍",
-    "update": "🔄",
-    "delete": "🗑️",
-    "login": "➡️",
-    "logout": "⬅️",
-    "auth": "🔑",
-    "error": "🔥",
-    "encrypt": "🛡️",
-    "decrypt": "🔓",
-    "parse": "🧩",
-    "transmit": "📡",
-    "build": "🏗️",
-    "schedule": "📅",
-    "emit": "📢",
-    "load": "💡",
-    "observe": "🧐",
-    "request": "🗣️",
-    "interrupt": "🚦",
-    "register": "⚙️",
-    "default": "❓",
-}
-
-TERTIARY_EMOJI: dict[str, str] = {
-    "success": "✅",
-    "failure": "❌",
-    "error": "🔥",
-    "warning": "⚠️",
-    "info": "ℹ️",
-    "debug": "🐞",
-    "trace": "👣",
-    "attempt": "⏳",
-    "retry": "🔁",
-    "skip": "⏭️",
-    "complete": "🏁",
-    "timeout": "⏱️",
-    "notfound": "❓",
-    "unauthorized": "🚫",
-    "invalid": "💢",
-    "cached": "🎯",
-    "ongoing": "🏃",
-    "idle": "💤",
-    "ready": "👍",
-    "default": "➡️",
-}
-
-
-def _format_emoji_set_for_display(emoji_set: EmojiSet) -> list[str]:
-    lines = [
-        f"  Emoji Set: '{emoji_set.name}' (Default Key: '{emoji_set.default_emoji_key}')"
-    ]
-    for key, emoji in sorted(emoji_set.emojis.items()):
-        lines.append(f"    {emoji}  -> {key.capitalize()}")
-    return lines
-
-
-def _format_field_definition_for_display(field_def: FieldToEmojiMapping) -> str:
-    parts = [f"  Log Key: '{field_def.log_key}'"]
-    if field_def.description:
-        parts.append(f"    Desc: {field_def.description}")
-    if field_def.value_type:
-        parts.append(f"    Type: {field_def.value_type}")
-    if field_def.emoji_set_name:
-        parts.append(f"    Emoji Set: '{field_def.emoji_set_name}'")
-        if field_def.default_emoji_override_key:
-            parts.append(
-                f"    Default Emoji Key (Override): '{field_def.default_emoji_override_key}'"
-            )
-    return "\n".join(parts)
-
-
-def show_emoji_matrix() -> None:  # pragma: no cover
-    """
-    Prints the active Foundation emoji logging contract to the console.
-    If emoji sets are active, it displays their configuration.
-    Otherwise, it displays the core DAS emoji mappings.
-    Activated by `PROVIDE_SHOW_EMOJI_MATRIX` environment variable.
-    """
-    # Ensure the logger is configured to access the config
-    foundation_logger_base.logger._ensure_configured()
-
-    # Get the show_emoji_matrix flag from the logging config
-    telemetry_config = getattr(foundation_logger_base.logger, "_active_config", None)
-    if not telemetry_config or not telemetry_config.logging.show_emoji_matrix:
-        return
-
-    matrix_logger = foundation_logger_base.logger.get_logger(
-        "provide.foundation.emoji_matrix_display"
-    )
-
-    # Access the resolved emoji config from the global logger instance
-    # This assumes the logger has been configured (explicitly or lazily)
-    foundation_logger_base.logger._ensure_configured()  # Ensure config is loaded
-    resolved_config_tuple = getattr(
-        foundation_logger_base.logger, "_active_resolved_emoji_config", None
-    )
-
-    lines: list[str] = []
-
-    if resolved_config_tuple:
-        resolved_field_definitions, resolved_emoji_sets_lookup = resolved_config_tuple
-
-        if resolved_field_definitions:  # New emoji sets are active
-            lines.append("Foundation Telemetry: Active Emoji Set Contract")
-            lines.append("=" * 70)
-            lines.append(
-                "Active Field-to-Emoji Mappings (Order determines prefix sequence):"
-            )
-            if not resolved_field_definitions:
-                lines.append("  (No field-to-emoji mappings are active)")
-            for i, field_def in enumerate(resolved_field_definitions):
-                lines.append(f"\nField {i + 1}:")
-                lines.append(_format_field_definition_for_display(field_def))
-
-            lines.append("\n" + "=" * 70)
-            lines.append(
-                "Available Emoji Sets (Referenced by Field-to-Emoji Mappings):"
-            )
-            if not resolved_emoji_sets_lookup:
-                lines.append("  (No emoji sets are defined/active)")
-            for set_name in sorted(resolved_emoji_sets_lookup.keys()):
-                emoji_set = resolved_emoji_sets_lookup[set_name]
-                lines.extend(_format_emoji_set_for_display(emoji_set))
-                lines.append("")  # Spacer
-
-        else:  # No custom fields resolved, means core DAS is active
-            lines.append("Foundation Telemetry: Core DAS Emoji Contract")
-            lines.append("=" * 70)
-            lines.append("Primary Emojis ('domain' key):")
-            lines.extend(
-                f"  {e}  -> {k.capitalize()}" for k, e in PRIMARY_EMOJI.items()
-            )
-            lines.append("\nSecondary Emojis ('action' key):")
-            lines.extend(
-                f"  {e}  -> {k.capitalize()}" for k, e in SECONDARY_EMOJI.items()
-            )
-            lines.append("\nTertiary Emojis ('status' key):")
-            lines.extend(
-                f"  {e}  -> {k.capitalize()}" for k, e in TERTIARY_EMOJI.items()
-            )
-    else:
-        lines.append(
-            "Foundation Telemetry: Emoji configuration not yet resolved or available."
-        )
-
-    if lines:
-        matrix_logger.info("\n".join(lines))
-    else:  # Should not happen if _ensure_configured works
-        matrix_logger.warning(
-            "Could not determine active emoji configuration to display."
-        )
-
-
-# 💡🧱