"""
logger.py
SkyOS Sync Logger

Zentrales Logging für alle Synchronisationsprozesse.

Autor: Sky Meilin
Projekt: SkyOS
"""

from __future__ import annotations

import logging


LOGGER_NAME = "SkyOS.Sync"


def get_logger() -> logging.Logger:
    """
    Gibt den zentralen Sync-Logger zurück.
    """

    logger = logging.getLogger(LOGGER_NAME)

    if logger.handlers:
        return logger

    logger.setLevel(logging.INFO)

    handler = logging.StreamHandler()

    formatter = logging.Formatter(
        "[%(asctime)s] %(levelname)s | %(message)s",
        datefmt="%Y-%m-%d %H:%M:%S",
    )

    handler.setFormatter(formatter)

    logger.addHandler(handler)

    return logger


logger = get_logger()


def log_sync(source: str) -> None:
    """
    Protokolliert eine erfolgreiche Synchronisation.
    """

    logger.info("Synchronisiert: %s", source)


def log_error(source: str, error: Exception) -> None:
    """
    Protokolliert einen Synchronisationsfehler.
    """

    logger.error(
        "Fehler bei '%s': %s",
        source,
        error,
    )


def log_start() -> None:
    """
    Protokolliert den Start der Synchronisation.
    """

    logger.info("Synchronisation gestartet.")


def log_finish() -> None:
    """
    Protokolliert das Ende der Synchronisation.
    """

    logger.info("Synchronisation abgeschlossen.")