# General Server Utilities # # Copyright (C) 2020 Eric Callahan # # This file may be distributed under the terms of the GNU GPLv3 license from __future__ import annotations import logging import logging.handlers import os import sys import subprocess import asyncio from queue import SimpleQueue as Queue # Annotation imports from typing import ( Optional, ClassVar, Tuple, Dict ) class ServerError(Exception): def __init__(self, message: str, status_code: int = 400) -> None: Exception.__init__(self, message) self.status_code = status_code class SentinelClass: _instance: ClassVar[Optional[SentinelClass]] = None @staticmethod def get_instance() -> SentinelClass: if SentinelClass._instance is None: SentinelClass._instance = SentinelClass() return SentinelClass._instance # Coroutine friendly QueueHandler courtesy of Martjin Pieters: # https://www.zopatista.com/python/2019/05/11/asyncio-logging/ class LocalQueueHandler(logging.handlers.QueueHandler): def emit(self, record: logging.LogRecord) -> None: # Removed the call to self.prepare(), handle task cancellation try: self.enqueue(record) except asyncio.CancelledError: raise except Exception: self.handleError(record) # Timed Rotating File Handler, based on Klipper's implementation class MoonrakerLoggingHandler(logging.handlers.TimedRotatingFileHandler): def __init__(self, software_version: str, filename: str, **kwargs) -> None: super(MoonrakerLoggingHandler, self).__init__(filename, **kwargs) self.rollover_info: Dict[str, str] = { 'header': f"{'-'*20}Moonraker Log Start{'-'*20}", 'version': f"Git Version: {software_version}", } lines = [line for line in self.rollover_info.values() if line] if self.stream is not None: self.stream.write("\n".join(lines) + "\n") def set_rollover_info(self, name: str, item: str) -> None: self.rollover_info[name] = item def doRollover(self) -> None: super(MoonrakerLoggingHandler, self).doRollover() lines = [line for line in self.rollover_info.values() if line] if self.stream is not None: self.stream.write("\n".join(lines) + "\n") # Parse the git version from the command line. This code # is borrowed from Klipper. def get_software_version() -> str: moonraker_path = os.path.join( os.path.dirname(__file__), '..') # Obtain version info from "git" program prog = ('git', '-C', moonraker_path, 'describe', '--always', '--tags', '--long', '--dirty') try: process = subprocess.Popen(prog, stdout=subprocess.PIPE, stderr=subprocess.PIPE) ver, err = process.communicate() retcode = process.wait() if retcode == 0: return ver.strip().decode() else: logging.debug(f"Error getting git version: {err.decode()}") except OSError: logging.exception("Error runing git describe") return "?" def setup_logging(log_file: str, software_version: str ) -> Tuple[logging.handlers.QueueListener, Optional[MoonrakerLoggingHandler]]: root_logger = logging.getLogger() queue: Queue = Queue() queue_handler = LocalQueueHandler(queue) root_logger.addHandler(queue_handler) root_logger.setLevel(logging.INFO) stdout_hdlr = logging.StreamHandler(sys.stdout) stdout_fmt = logging.Formatter( '[%(filename)s:%(funcName)s()] - %(message)s') stdout_hdlr.setFormatter(stdout_fmt) file_hdlr = None if log_file: file_hdlr = MoonrakerLoggingHandler( software_version, log_file, when='midnight', backupCount=2) formatter = logging.Formatter( '%(asctime)s [%(filename)s:%(funcName)s()] - %(message)s') file_hdlr.setFormatter(formatter) listener = logging.handlers.QueueListener( queue, file_hdlr, stdout_hdlr) else: listener = logging.handlers.QueueListener( queue, stdout_hdlr) listener.start() return listener, file_hdlr