Trixy7/trixy_core/utils/__init__.py

# -*- coding: utf-8 -*-
"""
Trixy Core Utils - Hilfsfunktionen und Konstanten.

Erweitert um:
- logging: Strukturiertes Logging mit JSON-Output
- decorators: Timing, Caching, Retry, Deprecation
- validation: Schema-basierte Validierung
- ratelimit: Token-Bucket und Sliding-Window Rate-Limiting
- download: Asynchrone Downloads von verschiedenen Quellen
"""

from trixy_core.utils.debug import pinfo, pdebug, perror, pwarn, pprogress, set_debug_mode
from trixy_core.utils.version import VERSION, VERSION_STRING, PROTOCOL_VERSION

# Logging-Submodul
from trixy_core.utils.logging import (
    StructuredLogger,
    get_logger,
    LogContext,
    get_correlation_id,
    set_correlation_id,
    JSONFormatter,
    TextFormatter,
)

# Decorators-Submodul
from trixy_core.utils.decorators import (
    timed,
    profile,
    cached,
    retry,
    deprecated,
    validate,
)

# Rate-Limit aus dem ratelimit-Modul
from trixy_core.utils.ratelimit import rate_limit

# Download-Utilities
from trixy_core.utils.download import (
    download_file,
    download_from_huggingface,
    download_from_github,
    download_and_extract,
    format_size,
    DownloadProgress,
)

__all__ = [
    # Debug
    "pinfo",
    "pdebug",
    "perror",
    "pwarn",
    "pprogress",
    "set_debug_mode",
    # Version
    "VERSION",
    "VERSION_STRING",
    "PROTOCOL_VERSION",
    # Logging
    "StructuredLogger",
    "get_logger",
    "LogContext",
    "get_correlation_id",
    "set_correlation_id",
    "JSONFormatter",
    "TextFormatter",
    # Decorators
    "timed",
    "profile",
    "cached",
    "retry",
    "deprecated",
    "validate",
    "rate_limit",
    # Download
    "download_file",
    "download_from_huggingface",
    "download_from_github",
    "download_and_extract",
    "format_size",
    "DownloadProgress",
]