logurich 0.1.0__tar.gz

logurich-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 PakitoSec
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

logurich-0.1.0/PKG-INFO

@@ -0,0 +1,63 @@
+Metadata-Version: 2.4
+Name: logurich
+Version: 0.1.0
+Summary: A Python library combining Loguru and Rich for beautiful logging.
+Author-email: PakitoSec <jeromep83@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/PakitoSec/logurich
+Project-URL: Repository, https://github.com/PakitoSec/logurich
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Logging
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: loguru
+Requires-Dist: rich
+Dynamic: license-file
+
+# logurich
+
+A Python library combining Loguru and Rich for beautiful logging.
+
+## Installation
+
+```bash
+pip install logurich
+```
+
+## Usage
+
+Logurich now supports direct imports from the package root, making it easier to access the logger and console:
+
+```python
+# Import directly from the package root
+from logurich import logger, console
+
+# Use the logger
+logger.info("This is a log message")
+
+# Use rich color and rich object formatting
+logger.info("[bold green]Rich formatted text[/bold green]")
+
+# Panel rich object with logger and prefix
+logger.rich(
+    "INFO", Panel("Rich Panel", border_style="green"), title="Rich Panel Object"
+)
+
+# Panel rich object without prefix
+logger.rich(
+    "INFO",
+    Panel("Rich Panel without prefix", border_style="green"),
+    title="Rich Panel",
+    prefix=False,
+)
+```

logurich-0.1.0/README.md

@@ -0,0 +1,37 @@
+# logurich
+
+A Python library combining Loguru and Rich for beautiful logging.
+
+## Installation
+
+```bash
+pip install logurich
+```
+
+## Usage
+
+Logurich now supports direct imports from the package root, making it easier to access the logger and console:
+
+```python
+# Import directly from the package root
+from logurich import logger, console
+
+# Use the logger
+logger.info("This is a log message")
+
+# Use rich color and rich object formatting
+logger.info("[bold green]Rich formatted text[/bold green]")
+
+# Panel rich object with logger and prefix
+logger.rich(
+    "INFO", Panel("Rich Panel", border_style="green"), title="Rich Panel Object"
+)
+
+# Panel rich object without prefix
+logger.rich(
+    "INFO",
+    Panel("Rich Panel without prefix", border_style="green"),
+    title="Rich Panel",
+    prefix=False,
+)
+```

logurich-0.1.0/logurich/__init__.py

@@ -0,0 +1,29 @@
+__version__ = "0.1.0"
+
+from .console import console, configure_console, get_console, rich_to_str, set_console
+from .core import (
+    ContextValue,
+    ctx,
+    global_configure,
+    global_set_context,
+    init_logger,
+    logger,
+    mp_configure,
+)
+
+init_logger("INFO")
+
+__all__ = [
+    "logger",
+    "init_logger",
+    "mp_configure",
+    "global_configure",
+    "global_set_context",
+    "ContextValue",
+    "ctx",
+    "console",
+    "configure_console",
+    "get_console",
+    "set_console",
+    "rich_to_str",
+]

logurich-0.1.0/logurich/__init__.pyi

@@ -0,0 +1,51 @@
+from __future__ import annotations
+
+from typing import ContextManager, Final, Literal, Mapping, Protocol
+
+from .core import ContextValue, LoguRich
+from rich.console import Console
+
+LogLevel = Literal["TRACE", "DEBUG", "INFO", "SUCCESS", "WARNING", "ERROR", "CRITICAL"]
+LevelByModuleValue = str | int | bool
+LevelByModuleMapping = Mapping[str | None, LevelByModuleValue]
+
+class _SupportsStr(Protocol):
+    def __str__(self) -> str: ...
+
+ContextBinding = ContextValue | _SupportsStr | None
+
+__version__: Final[str]
+
+logger: LoguRich
+console: Console
+
+def ctx(
+    value: object,
+    *,
+    style: str | None = None,
+    value_style: str | None = None,
+    bracket_style: str | None = None,
+    label: str | None = None,
+    show_key: bool | None = None,
+) -> ContextValue: ...
+def init_logger(
+    log_level: LogLevel,
+    log_verbose: int = 0,
+    log_filename: str | None = None,
+    log_folder: str = "logs",
+    level_by_module: LevelByModuleMapping | None = None,
+    *,
+    rich_handler: bool = False,
+    diagnose: bool = False,
+    enqueue: bool = True,
+    highlight: bool = False,
+) -> str | None: ...
+def mp_configure(logger_: LoguRich) -> None: ...
+def global_configure(**kwargs: ContextBinding) -> ContextManager[None]: ...
+def global_set_context(**kwargs: ContextBinding) -> None: ...
+def configure_console(*args: object, **kwargs: object) -> Console: ...
+def get_console() -> Console: ...
+def set_console(console: Console) -> None: ...
+def rich_to_str(*objects: object, ansi: bool = True, **kwargs: object) -> str: ...
+
+__all__: Final[list[str]]

logurich-0.1.0/logurich/console.py

@@ -0,0 +1,96 @@
+from __future__ import annotations
+
+from typing import Any
+
+from rich.console import Console, ConsoleRenderable
+from rich.pretty import Pretty
+from rich.table import Table
+from rich.text import Text
+
+_console = None
+
+
+def rich_to_str(*objects, ansi: bool = True, **kwargs) -> str:
+    console = get_console()
+    with console.capture() as capture:
+        console.print(*objects, **kwargs)
+    if ansi is True:
+        return capture.get()
+    return str(Text.from_ansi(capture.get()))
+
+
+def rich_format_grid(prefix: Text, data: ConsoleRenderable, real_width: int) -> Table:
+    grid = Table.grid()
+    grid.add_column()
+    grid.add_column()
+    content = Text.from_ansi(rich_to_str(data, width=real_width, end=""))
+    lines = content.split()
+    for line in lines:
+        pline = prefix.copy()
+        grid.add_row(pline, line)
+    return grid
+
+
+def rich_console_renderer(
+    prefix: str, rich_format: bool, data: Any
+) -> list[ConsoleRenderable]:
+    console = get_console()
+    rich_prefix = prefix[:-2] + "# "
+    pp = Text.from_markup(rich_prefix)
+    real_width = console.width - len(pp)
+    renderable = []
+    for r in data:
+        if rich_format:
+            if isinstance(r, str):
+                item = pp.copy()
+                item = item.append(Text.from_markup(r))
+                renderable.append(item)
+            elif isinstance(r, Text) and r.split() == 1:
+                item = pp.copy()
+                item = item.append_text(r)
+                renderable.append(item)
+            elif isinstance(r, ConsoleRenderable):
+                renderable.append(rich_format_grid(pp, r, real_width))
+            else:
+                renderable.append(
+                    rich_format_grid(
+                        pp, Pretty(r, max_depth=2, max_length=2), real_width
+                    )
+                )
+        else:
+            if isinstance(r, str):
+                renderable.append(Text.from_ansi(r))
+            else:
+                renderable.append(r)
+    return renderable
+
+
+def set_console(console: Console):
+    global _console
+    _console = console
+
+
+def get_console() -> Console:
+    global _console
+    if _console is None:
+        _console = Console(markup=True)
+    return _console
+
+
+def configure_console(*args: Any, **kwargs: Any) -> Console:
+    """Reconfigures the logurich console by replacing it with another.
+
+    Args:
+        *args (Any): Positional arguments for the replacement :class:`~rich.console.Console`.
+        **kwargs (Any): Keyword arguments for the replacement :class:`~rich.console.Console`.
+
+    Return:
+        Return the logurich console
+    """
+    new_console = Console(*args, **kwargs)
+    _console = get_console()
+    _console.__dict__ = new_console.__dict__
+    return _console
+
+
+console = get_console()