omlish 0.0.0.dev423__py3-none-any.whl → 0.0.0.dev484__py3-none-any.whl

omlish/lite/reprs.py

@@ -1,85 +0,0 @@
-# ruff: noqa: UP007 UP045
-import dataclasses as dc
-import typing as ta
-
-
-##
-
-
-@dc.dataclass(frozen=True)
-class AttrRepr:
-    attrs: ta.Sequence[str]
-
-    # _: dc.KW_ONLY
-
-    with_module: bool = False
-    use_qualname: bool = False
-    with_id: bool = False
-    value_filter: ta.Optional[ta.Callable[[ta.Any], bool]] = None
-    recursive: bool = False
-
-    @classmethod
-    def of(cls, *attrs: str, **kwargs: ta.Any) -> 'AttrRepr':
-        return cls(attrs, **kwargs)
-
-    #
-
-    def _build_(self, obj: ta.Any) -> str:
-        vs = ', '.join(
-            f'{attr}={v!r}'
-            for attr in self.attrs
-            for v in [getattr(obj, attr)]
-            if self.value_filter is None or self.value_filter(v)
-        )
-
-        return (
-            f'{obj.__class__.__module__ + "." if self.with_module else ""}'
-            f'{obj.__class__.__qualname__ if self.use_qualname else obj.__class__.__name__}'
-            f'{("@" + hex(id(obj))[2:]) if self.with_id else ""}'
-            f'({vs})'
-        )
-
-    _build: ta.ClassVar[ta.Callable[[ta.Any], str]]
-
-    def __call__(self, obj: ta.Any) -> str:
-        try:
-            build: ta.Any = self._build
-
-        except AttributeError:
-            build = self._build_
-            if self.recursive:
-                build = self._reprlib().recursive_repr()(build)
-            object.__setattr__(self, '_build', build)
-
-        return build(obj)
-
-    #
-
-    def __get__(self, instance, owner):
-        if instance is None:
-            return self
-
-        def __repr__(other):  # noqa
-            return self(other)
-
-        return __repr__.__get__(instance, owner)
-
-    #
-
-    _reprlib_: ta.ClassVar[ta.Any]
-
-    @classmethod
-    def _reprlib(cls) -> ta.Any:
-        try:
-            return cls._reprlib_
-        except AttributeError:
-            pass
-
-        import reprlib  # noqa
-
-        cls._reprlib_ = reprlib
-        return reprlib
-
-
-def attr_repr(obj: ta.Any, *attrs: str, **kwargs: ta.Any) -> str:
-    return AttrRepr(attrs, **kwargs)(obj)

omlish/logs/abc.py

@@ -1,319 +0,0 @@
-# ruff: noqa: A002 N802 N815
-import types
-import typing as ta
-
-
-##
-
-
-Level: ta.TypeAlias = int
-
-
-ExceptionInfo: ta.TypeAlias = tuple[type[BaseException], BaseException, types.TracebackType]
-
-
-class LogRecord:
-    """https://docs.python.org/3/library/logging.html#logrecord-attributes"""
-
-    # Name of the logger used to log the call.
-    name: str
-
-    # Human-readable time when the LogRecord was created. By default this is of the form '2003-07-08 16:49:45,896' (the
-    # numbers after the comma are millisecond portion of the time).
-    asctime: str
-
-    # The logged message, computed as msg % args. This is set when Formatter.format() is invoked.
-    message: str
-
-    # The format string passed in the original logging call. Merged with args to produce message, or an arbitrary object
-    # (see Using arbitrary objects as messages).
-    msg: str
-
-    # The tuple of arguments merged into msg to produce message, or a dict whose values are used for the merge (when
-    # there is only one argument, and it is a dictionary).
-    args: tuple
-
-    # Text logging level for the message ('DEBUG', 'INFO', 'WARNING', 'ERROR', 'CRITICAL').
-    levelname: str
-
-    # # Numeric logging level for the message (DEBUG, INFO, WARNING, ERROR, CRITICAL).
-    levelno: Level
-
-    # Full pathname of the source file where the logging call was issued (if available).
-    pathname: str
-
-    # Filename portion of pathname.
-    filename: str
-
-    # Module (name portion of filename).
-    module: str
-
-    # Exception tuple (à la sys.exc_info) or, if no exception has occurred, None.
-    exc_info: ExceptionInfo | None
-
-    exc_text: str | None
-
-    # Stack frame information (where available) from the bottom of the stack in the current thread, up to and including
-    # the stack frame of the logging call which resulted in the creation of this record.
-    stack_info: str | None
-
-    # Source line number where the logging call was issued (if available).
-    lineno: int
-
-    # Name of function containing the logging call.
-    funcName: str
-
-    # Time when the LogRecord was created (as returned by time.time_ns() / 1e9).
-    created: float
-
-    # Millisecond portion of the time when the LogRecord was created.
-    msecs: float
-
-    # Time in milliseconds when the LogRecord was created, relative to the time the logging module was loaded.
-    relativeCreated: float
-
-    # Thread ID (if available).
-    thread: int
-
-    # Thread name (if available).
-    threadName: str
-
-    # Process name (if available).
-    processName: str
-
-    # Process ID (if available).
-    process: int
-
-    # asyncio.Task name (if available).
-    taskName: str
-
-
-##
-
-
-class Formatter(ta.Protocol):
-    """https://docs.python.org/3/library/logging.html#formatter-objects"""
-
-    default_time_format: ta.ClassVar[str]
-    default_msec_format: ta.ClassVar[str]
-
-    def formatTime(self, record: LogRecord, datefmt: str | None = None) -> str: ...
-
-    def formatException(self, ei: ExceptionInfo) -> str: ...
-
-    def usesTime(self) -> bool: ...
-
-    def formatMessage(self, record: LogRecord) -> str: ...
-
-    def formatStack(self, stack_info: str) -> str: ...
-
-    def format(self, record: LogRecord) -> str: ...
-
-
-class BufferingFormatter(ta.Protocol):
-    """https://docs.python.org/3/library/logging.html#logging.BufferingFormatter"""
-
-    def formatHeader(self, records: ta.Sequence[LogRecord]) -> str: ...
-
-    def formatFooter(self, records: ta.Sequence[LogRecord]) -> str: ...
-
-    def format(self, records: ta.Sequence[LogRecord]) -> str: ...
-
-
-##
-
-
-class Filter(ta.Protocol):
-    """https://docs.python.org/3/library/logging.html#filter-objects"""
-
-    def filter(self, record: LogRecord) -> bool: ...
-
-
-class Filterer(ta.Protocol):
-    """A base class for loggers and handlers which allows them to share common code."""
-
-    def addFilter(self, filter: Filter) -> None: ...
-
-    def removeFilter(self, filter: Filter) -> None: ...
-
-    def filter(self, record: LogRecord) -> bool: ...
-
-
-##
-
-
-class Handler(Filterer, ta.Protocol):
-    """https://docs.python.org/3/library/logging.html#handler-objects"""
-
-    level: Level
-
-    def get_name(self) -> str: ...
-
-    def set_name(self, name: str) -> None: ...
-
-    name: str
-
-    def createLock(self) -> None: ...
-
-    def acquire(self) -> None: ...
-
-    def release(self) -> None: ...
-
-    def setLevel(self, level: Level) -> None: ...
-
-    def format(self, record: LogRecord) -> str: ...
-
-    def emit(self, record: LogRecord) -> None: ...
-
-    def handle(self, record: LogRecord) -> bool: ...
-
-    def setFormatter(self, fmt: Formatter) -> None: ...
-
-    def flush(self) -> None: ...
-
-    def close(self) -> None: ...
-
-    def handleError(self, record: LogRecord) -> None: ...
-
-
-class Stream(ta.Protocol):
-    def write(self, s: str) -> None: ...
-
-    def flush(self) -> None: ...  # OPTIONAL METHOD
-
-    def close(self) -> None: ...  # OPTIONAL METHOD
-
-
-class StreamHandler(Handler, ta.Protocol):
-    """https://docs.python.org/3/library/logging.handlers.html#logging.StreamHandler"""
-
-    terminator: ta.ClassVar[str]
-
-    stream: Stream
-
-    def flush(self) -> None: ...
-
-    def emit(self, record: LogRecord) -> None: ...
-
-    def setStream(self, stream: Stream) -> None: ...
-
-
-##
-
-
-class Manager(ta.Protocol):
-    """There is [under normal circumstances] just one Manager instance, which holds the hierarchy of loggers."""
-
-    root: 'Logger'
-
-    disable: Level
-
-    def getLogger(self, name: str) -> 'Logger': ...
-
-    def setLoggerClass(self, klass: type['Logger']) -> None: ...
-
-    def setLogRecordFactory(self, factory: ta.Callable[..., LogRecord]) -> None: ...  # UNREFERENCED?
-
-
-##
-
-
-Caller: ta.TypeAlias = tuple[
-    str,  # filename
-    int,  # lineno
-    str,  # name
-    str,  # formatted
-]
-
-
-class Logger(Filterer, ta.Protocol):
-    """https://docs.python.org/3/library/logging.html#logger-objects"""
-
-    name: str
-    level: Level
-    parent: ta.Optional['Logger']
-    propagate: bool
-    handlers: list[Handler]
-    disabled: bool
-
-    manager: Manager
-
-    def setLevel(self, level: Level) -> None: ...
-
-    def debug(self, msg: str, *args: ta.Any, **kwargs: ta.Any) -> None: ...
-    def info(self, msg: str, *args: ta.Any, **kwargs: ta.Any) -> None: ...
-    def warning(self, msg: str, *args: ta.Any, **kwargs: ta.Any) -> None: ...
-    def warn(self, msg: str, *args: ta.Any, **kwargs: ta.Any) -> None: ...
-    def error(self, msg: str, *args: ta.Any, **kwargs: ta.Any) -> None: ...
-    def exception(self, msg: str, *args: ta.Any, **kwargs: ta.Any) -> None: ...
-    def critical(self, msg: str, *args: ta.Any, **kwargs: ta.Any) -> None: ...
-    def fatal(self, msg: str, *args: ta.Any, **kwargs: ta.Any) -> None: ...
-
-    def log(self, level: Level, msg: str, *args: ta.Any, **kwargs: ta.Any) -> None: ...
-
-    def findCaller(self, stack_info: bool = False, stacklevel: int = 1) -> Caller: ...
-
-    def makeRecord(
-        self,
-        name,
-        level,
-        fn,
-        lno,
-        msg,
-        args,
-        exc_info,
-        func: str | None = None,
-        extra: ta.Mapping[str, ta.Any] | None = None,
-        sinfo: str | None = None,
-    ) -> LogRecord: ...
-
-    def handle(self, record: LogRecord) -> None: ...
-
-    def addHandler(self, hdlr: Handler) -> None: ...
-
-    def removeHandler(self, hdlr: Handler) -> None: ...
-
-    def hasHandlers(self) -> bool: ...
-
-    def callHandlers(self, record: LogRecord) -> None: ...
-
-    def getEffectiveLevel(self) -> Level: ...
-
-    def isEnabledFor(self, level: Level) -> bool: ...
-
-    def getChild(self, suffix: str) -> 'Logger': ...
-
-
-##
-
-
-class LoggerAdapter(ta.Protocol):
-    """https://docs.python.org/3/library/logging.html#loggeradapter-objects"""
-
-    logger: Logger
-    extra: ta.Mapping[str, ta.Any]
-
-    def process(self, msg: str, kwargs: dict[str, ta.Any]) -> tuple[str, dict[str, ta.Any]]: ...
-
-    def debug(self, msg: str, *args: ta.Any, **kwargs: ta.Any) -> None: ...
-    def info(self, msg: str, *args: ta.Any, **kwargs: ta.Any) -> None: ...
-    def warning(self, msg: str, *args: ta.Any, **kwargs: ta.Any) -> None: ...
-    def warn(self, msg: str, *args: ta.Any, **kwargs: ta.Any) -> None: ...
-    def error(self, msg: str, *args: ta.Any, **kwargs: ta.Any) -> None: ...
-    def exception(self, msg: str, *args: ta.Any, **kwargs: ta.Any) -> None: ...
-    def critical(self, msg: str, *args: ta.Any, **kwargs: ta.Any) -> None: ...
-    def fatal(self, msg: str, *args: ta.Any, **kwargs: ta.Any) -> None: ...
-
-    def log(self, level: Level, msg: str, *args: ta.Any, **kwargs: ta.Any) -> None: ...
-
-    def isEnabledFor(self, level: Level) -> bool: ...
-
-    def setLevel(self, level: Level) -> None: ...
-
-    def getEffectiveLevel(self) -> Level: ...
-
-    def hasHandlers(self) -> bool: ...
-
-    manager: Manager
-
-    name: str

omlish/logs/callers.py

@@ -1,67 +0,0 @@
-# ruff: noqa: UP006 UP007 UP045
-# @omlish-lite
-import io
-import os.path
-import sys
-import traceback
-import types
-import typing as ta
-
-
-##
-
-
-class LoggingCaller(ta.NamedTuple):
-    filename: str
-    lineno: int
-    func: str
-    sinfo: ta.Optional[str]
-
-    @classmethod
-    def is_internal_frame(cls, frame: types.FrameType) -> bool:
-        filename = os.path.normcase(frame.f_code.co_filename)
-
-        # https://github.com/python/cpython/commit/5ca6d7469be53960843df39bb900e9c3359f127f
-        if 'importlib' in filename and '_bootstrap' in filename:
-            return True
-
-        return False
-
-    @classmethod
-    def find_frame(cls, ofs: int = 0) -> types.FrameType:
-        f: ta.Optional[types.FrameType] = sys._getframe(2 + ofs)  # noqa
-
-        while f is not None and hasattr(f, 'f_code'):
-            if f.f_code.co_filename != __file__:
-                return f
-
-            f = f.f_back
-
-        raise RuntimeError
-
-    @classmethod
-    def find(
-            cls,
-            ofs: int = 0,
-            *,
-            stack_info: bool = False,
-    ) -> 'LoggingCaller':
-        f = cls.find_frame(ofs + 1)
-        # TODO: ('(unknown file)', 0, '(unknown function)', None) ?
-
-        sinfo = None
-        if stack_info:
-            sio = io.StringIO()
-            sio.write('Stack (most recent call last):\n')
-            traceback.print_stack(f, file=sio)
-            sinfo = sio.getvalue()
-            sio.close()
-            if sinfo[-1] == '\n':
-                sinfo = sinfo[:-1]
-
-        return cls(
-            f.f_code.co_filename,
-            f.f_lineno,
-            f.f_code.co_name,
-            sinfo,
-        )

omlish/logs/color.py

@@ -1,27 +0,0 @@
-# ruff: noqa: ANN201 N802
-import logging
-import typing as ta
-
-from ..term import codes as tc
-from .standard import StandardLogFormatter
-
-
-##
-
-
-class ColorLogFormatter(StandardLogFormatter):
-    LEVEL_COLORS: ta.Mapping[int, tc.SGRs.FG] = {
-        logging.WARNING: tc.SGRs.FG.BRIGHT_YELLOW,
-        logging.ERROR: tc.SGRs.FG.BRIGHT_RED,
-        logging.CRITICAL: tc.SGRs.FG.BRIGHT_RED,
-    }
-
-    def formatMessage(self, record):
-        buf = super().formatMessage(record)
-        try:
-            c = self.LEVEL_COLORS[record.levelno]
-        except KeyError:
-            pass
-        else:
-            buf = tc.SGR(c) + buf + tc.SGR(tc.SGRs.RESET)
-        return buf

omlish/logs/configs.py

@@ -1,29 +0,0 @@
-# ruff: noqa: UP006 UP045
-# @omlish-lite
-"""
-https://docs.python.org/3/howto/logging.html#configuring-logging
-https://docs.python.org/3/library/logging.config.html#logging-config-dictschema
-"""
-import dataclasses as dc
-import typing as ta
-
-
-FilterConfig = ta.Dict[str, ta.Any]  # ta.TypeAlias
-FormatterConfig = ta.Dict[str, ta.Any]  # ta.TypeAlias
-HandlerConfig = ta.Dict[str, ta.Any]  # ta.TypeAlias
-LoggerConfig = ta.Dict[str, ta.Any]  # ta.TypeAlias
-
-
-##
-
-
-@dc.dataclass()
-class DictConfig:
-    version: int = 1
-    incremental: bool = False
-    disable_existing_loggers: bool = False
-    filters: ta.Dict[str, FilterConfig] = dc.field(default_factory=dict)
-    formatters: ta.Dict[str, FormatterConfig] = dc.field(default_factory=dict)
-    handlers: ta.Dict[str, HandlerConfig] = dc.field(default_factory=dict)
-    loggers: ta.Dict[str, LoggerConfig] = dc.field(default_factory=dict)
-    root: ta.Optional[LoggerConfig] = None

omlish/logs/handlers.py

@@ -1,17 +0,0 @@
-# ruff: noqa: UP006 UP007 UP045
-# @omlish-lite
-import logging
-import typing as ta
-
-
-##
-
-
-class ListHandler(logging.Handler):
-    def __init__(self) -> None:
-        super().__init__()
-
-        self.records: ta.List[logging.LogRecord] = []
-
-    def emit(self, record: logging.LogRecord) -> None:
-        self.records.append(record)