py.lib.aw_log
2024-10-31
Parent:1e93862d5063
py.lib.aw_log/src/aw_log/__init__.py
. Исправлена ссылка на документацию. Сделал её прямой
| awgur@0 | 1 # coding: utf-8 |
| awgur@0 | 2 """ Реализация классов логирования |
| awgur@0 | 3 |
| awgur@0 | 4 Метки в журнале о уровне сообщения: |
| awgur@0 | 5 "`": Debug |
| awgur@0 | 6 ".": Info |
| awgur@0 | 7 "*": Warning |
| awgur@0 | 8 "!": Error |
| awgur@0 | 9 "#": Alert |
| awgur@0 | 10 |
| awgur@0 | 11 """ |
| awgur@0 | 12 |
| awgur@0 | 13 from time import monotonic |
| awgur@0 | 14 from datetime import timedelta |
| awgur@0 | 15 from traceback import extract_tb, extract_stack |
| awgur@0 | 16 from typing import Optional, Any, Iterable |
| awgur@0 | 17 from sys import exc_info |
| awgur@0 | 18 |
| awgur@0 | 19 |
| awgur@0 | 20 class Timing(object): |
| awgur@0 | 21 def __init__(self, name: Optional[str] = None): |
| awgur@0 | 22 if name is None: |
| awgur@0 | 23 self.prefix = '' |
| awgur@0 | 24 |
| awgur@0 | 25 else: |
| awgur@0 | 26 self.prefix = f'{name} :: ' |
| awgur@0 | 27 |
| awgur@0 | 28 self.tsAll = monotonic() |
| awgur@0 | 29 self.ts = self.tsAll |
| awgur@0 | 30 |
| awgur@0 | 31 def get_time(self): |
| awgur@0 | 32 return monotonic() - self.ts |
| awgur@0 | 33 |
| awgur@0 | 34 def reset(self): |
| awgur@0 | 35 self.ts = monotonic() |
| awgur@0 | 36 self.tsAll = self.ts |
| awgur@0 | 37 |
| awgur@0 | 38 def __str__(self): |
| awgur@0 | 39 ts = monotonic() |
| awgur@0 | 40 return self.prefix + '%s(%.4f)' % (timedelta(seconds=(ts - self.tsAll)), ts - self.ts) |
| awgur@0 | 41 |
| awgur@0 | 42 def __call__(self, msg): |
| awgur@0 | 43 _buf = f'{self} | {msg}' |
| awgur@0 | 44 self.ts = monotonic() |
| awgur@0 | 45 return _buf |
| awgur@0 | 46 |
| awgur@0 | 47 |
| awgur@0 | 48 class AbstractLogBase(object): |
| awgur@0 | 49 def __init__(self, prefix: str = 'main'): |
| awgur@0 | 50 self.prefix = prefix |
| awgur@0 | 51 |
| awgur@0 | 52 def _write_helper(self, mark: str, msg: Any) -> Iterable[str]: |
| awgur@0 | 53 for l in str(msg).splitlines(): |
| awgur@1 | 54 yield f'{mark} {self.prefix} | {l}\n' |
| awgur@0 | 55 |
| awgur@0 | 56 def _write(self, mark: str, msg: Any): |
| awgur@0 | 57 raise NotImplemented(f'Метод write не определён для класса "{type(self).__name__}"') |
| awgur@0 | 58 |
| awgur@0 | 59 def __call__(self, msg): |
| awgur@0 | 60 self._write('.', msg) |
| awgur@0 | 61 |
| awgur@0 | 62 def err(self, msg): |
| awgur@0 | 63 self._write('!', msg) |
| awgur@0 | 64 |
| awgur@0 | 65 def warn(self, msg): |
| awgur@0 | 66 self._write('*', msg) |
| awgur@0 | 67 |
| awgur@0 | 68 def alert(self, msg): |
| awgur@0 | 69 self._write('#', msg) |
| awgur@0 | 70 |
| awgur@0 | 71 def debug(self, msg): |
| awgur@0 | 72 self._write('`', msg) |
| awgur@0 | 73 |
| awgur@0 | 74 @staticmethod |
| awgur@0 | 75 def get_timing(name: Optional[str] = None): |
| awgur@0 | 76 return Timing(name) |
| awgur@0 | 77 |
| awgur@0 | 78 def sub_log(self, name: str): |
| awgur@0 | 79 return self.__class__(f'{self.prefix}/{name}') |
| awgur@0 | 80 |
| awgur@0 | 81 def excpt(self, msg, e_class=None, e_obj=None, e_tb=None, stack_skip=0): |
| awgur@0 | 82 if e_class is None: |
| awgur@0 | 83 e_class, e_obj, e_tb = exc_info() |
| awgur@0 | 84 |
| awgur@0 | 85 tb_data_tb = list(extract_tb(e_tb))[::-1] |
| awgur@0 | 86 tb_data_stack = list(extract_stack())[::-1][(2 + stack_skip):] |
| awgur@5 | 87 self.alert(msg) |
| awgur@5 | 88 self.alert('--- EXCEPTION ---') |
| awgur@5 | 89 self.alert(f' {e_class.__name__} ({e_obj})') |
| awgur@5 | 90 self.alert('--- TRACEBACK ---') |
| awgur@0 | 91 for _tb_file, _tb_line, _tb_func, _tb_text in tb_data_tb: |
| awgur@5 | 92 self.alert(f'File: {_tb_file}, line {_tb_line} in {_tb_func}') |
| awgur@5 | 93 self.alert(f' {_tb_text}') |
| awgur@0 | 94 |
| awgur@0 | 95 self.err('>>> Exception Handler <<<') |
| awgur@0 | 96 for _tb_file, _tb_line, _tb_func, _tb_text in tb_data_stack: |
| awgur@5 | 97 self.alert(f'File: {_tb_file}, line {_tb_line} in {_tb_func}') |
| awgur@5 | 98 self.alert(f' {_tb_text}') |
| awgur@5 | 99 |
| awgur@5 | 100 self.alert('--- END EXCEPTION ---') |
| awgur@5 | 101 |
| awgur@5 | 102 |
| awgur@5 | 103 class NullLog(AbstractLogBase): |
| awgur@5 | 104 def _write(self, mark: str, msg: Any): |
| awgur@5 | 105 pass |
| awgur@5 | 106 |
| awgur@5 | 107 def __init__(self, *a, **kwa): |
| awgur@5 | 108 super().__init__('n') |
| awgur@0 | 109 |
| awgur@5 | 110 def sub_log(self, name: str): |
| awgur@5 | 111 return self |
| awgur@5 | 112 |
| awgur@5 | 113 @classmethod |
| awgur@5 | 114 def make(cls, *a, **kwa): |
| awgur@5 | 115 return cls() |
| awgur@5 | 116 |
| awgur@5 | 117 def flush(self, *a, **kwa): |
| awgur@5 | 118 pass |
| awgur@5 | 119 |
| awgur@5 | 120 @staticmethod |
| awgur@5 | 121 def init_syslog(ident): |
| awgur@5 | 122 pass |