bear-utils 0.8.25__tar.gz → 0.8.26__tar.gz

{bear_utils-0.8.25 → bear_utils-0.8.26}/.bumpversion.cfg

@@ -1,5 +1,5 @@
 [bumpversion]
-current_version = 0.8.25
+current_version = 0.8.26
 
 [bumpversion:file:pyproject.toml]
 

{bear_utils-0.8.25 → bear_utils-0.8.26}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bear-utils
-Version: 0.8.25
+Version: 0.8.26
 Summary: Various utilities for Bear programmers, including a rich logging utility, a disk cache, and a SQLite database wrapper amongst other things.
 Author-email: chaz <bright.lid5647@fastmail.com>
 Requires-Python: >=3.12
@@ -25,7 +25,7 @@ Provides-Extra: gui
 Requires-Dist: pyqt6>=6.9.0; extra == 'gui'
 Description-Content-Type: text/markdown
 
-# Bear Utils v# Bear Utils v0.8.25
+# Bear Utils v# Bear Utils v0.8.26
 
 Personal set of tools and utilities for Python projects, focusing on modularity and ease of use. This library includes components for caching, database management, logging, time handling, file operations, CLI prompts, image processing, clipboard interaction, gradient utilities, event systems, and async helpers.
 

{bear_utils-0.8.25 → bear_utils-0.8.26}/README.md

@@ -1,4 +1,4 @@
-# Bear Utils v# Bear Utils v0.8.25
+# Bear Utils v# Bear Utils v0.8.26
 
 Personal set of tools and utilities for Python projects, focusing on modularity and ease of use. This library includes components for caching, database management, logging, time handling, file operations, CLI prompts, image processing, clipboard interaction, gradient utilities, event systems, and async helpers.
 

{bear_utils-0.8.25 → bear_utils-0.8.26}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "bear-utils"
-version = "0.8.25"
+version = "0.8.26"
 description = "Various utilities for Bear programmers, including a rich logging utility, a disk cache, and a SQLite database wrapper amongst other things."
 authors = [{ name = "chaz", email = "bright.lid5647@fastmail.com" }]
 readme = "README.md"

{bear_utils-0.8.25 → bear_utils-0.8.26}/src/bear_utils/extras/__init__.py

@@ -2,7 +2,7 @@
 
 from singleton_base import SingletonBase
 
-from ._tools import ClipboardManager, clear_clipboard, copy_to_clipboard, fmt_header, paste_from_clipboard
+from ._tools import ClipboardManager, ascii_header, clear_clipboard, copy_to_clipboard, paste_from_clipboard
 from .platform_utils import OS, get_platform, is_linux, is_macos, is_windows
 from .wrappers.add_methods import add_comparison_methods
 
@@ -11,9 +11,9 @@ __all__ = [
     "ClipboardManager",
     "SingletonBase",
     "add_comparison_methods",
+    "ascii_header",
     "clear_clipboard",
     "copy_to_clipboard",
-    "fmt_header",
     "get_platform",
     "is_linux",
     "is_macos",

{bear_utils-0.8.25 → bear_utils-0.8.26}/src/bear_utils/extras/_tools.py

@@ -5,42 +5,16 @@ from functools import cached_property
 import shutil
 from typing import TYPE_CHECKING
 
+from rich.console import Console
+
 from bear_utils.cli.shell._base_command import BaseShellCommand as ShellCommand
 from bear_utils.cli.shell._base_shell import AsyncShellSession
 from bear_utils.extras.platform_utils import OS, get_platform
-from bear_utils.logger_manager.loggers.base_logger import BaseLogger
 
 if TYPE_CHECKING:
     from subprocess import CompletedProcess
 
 
-class TextHelper:
-    @cached_property
-    def local_console(self) -> BaseLogger:
-        from bear_utils.logger_manager import BaseLogger  # noqa: PLC0415
-
-        init: bool = not BaseLogger.has_instance()
-        return BaseLogger.get_instance(init=init)
-
-    def print_header(
-        self,
-        title: str,
-        sep: str = "#",
-        length: int = 60,
-        s1: str = "bold red",
-        s2: str = "bold blue",
-        return_txt: bool = False,
-    ) -> str:
-        """Generate a header string"""
-        # FIXME: There are probably better ways to do this, but this is OK.
-        fill: str = sep * length
-        title = f" {title} ".center(length, sep).replace(title, f"[{s1}]{title}[/{s1}]")
-        output_text: str = f"\n{fill}\n{title}\n{fill}\n"
-        if not return_txt:
-            self.local_console.print(output_text, style=s2)
-        return output_text
-
-
 class ClipboardManager:
     """A class to manage clipboard operations such as copying, pasting, and clearing.
 
@@ -201,9 +175,71 @@ async def clear_clipboard_async() -> int:
     return await clipboard_manager.clear()
 
 
-def fmt_header(
+class TextHelper:
+    @cached_property
+    def local_console(self) -> Console:
+        return Console()
+
+    def print_header(
+        self,
+        title: str,
+        top_sep: str = "#",
+        left_sep: str = ">",
+        right_sep: str = "<",
+        bottom_sep: str = "#",
+        length: int = 60,
+        s1: str = "bold red",
+        s2: str = "bold blue",
+        return_txt: bool = False,
+    ) -> str:
+        """Generate a header string with customizable separators for each line.
+
+        Args:
+            title: The title text to display
+            top_sep: Character(s) for the top separator line
+            left_sep: Character(s) for the left side of title line
+            right_sep: Character(s) for the right side of title line
+            bottom_sep: Character(s) for the bottom separator line
+            length: Total width of each line
+            s1: Style for the title text
+            s2: Style for the entire header block
+            return_txt: If True, return the text instead of printing
+        """
+        # Top line: all top_sep characters
+        top_line: str = top_sep * length
+
+        # Bottom line: all bottom_sep characters
+        bottom_line: str = bottom_sep * length
+
+        # Title line: left_sep chars + title + right_sep chars
+        title_with_spaces = f" {title} "
+        styled_title = f"[{s1}]{title}[/{s1}]"
+
+        # Calculate padding needed on each side
+        title_length = len(title_with_spaces)
+        remaining_space = length - title_length
+        left_padding = remaining_space // 2
+        right_padding = remaining_space - left_padding
+
+        # Build the title line with different left and right separators
+        title_line = (
+            (left_sep * left_padding) + title_with_spaces.replace(title, styled_title) + (right_sep * right_padding)
+        )
+
+        # Assemble the complete header
+        output_text: str = f"\n{top_line}\n{title_line}\n{bottom_line}\n"
+
+        if not return_txt:
+            self.local_console.print(output_text, style=s2)
+        return output_text
+
+
+def ascii_header(
     title: str,
-    sep: str = "#",
+    top_sep: str = "#",
+    left_sep: str = ">",
+    right_sep: str = "<",
+    bottom_sep: str = "#",
     length: int = 60,
     style1: str = "bold red",
     style2: str = "bold blue",
@@ -213,13 +249,45 @@ def fmt_header(
 
     Args:
         title (str): The title to display in the header.
-        sep (str): The character to use for the separator. Defaults to '#'.
+        top_sep (str): The character to use for the top separator line. Defaults to '#'.
+        left_sep (str): The character to use for the left side of title line. Defaults to '>'.
+        right_sep (str): The character to use for the right side of title line. Defaults to '<'.
+        bottom_sep (str): The character to use for the bottom separator line. Defaults to '#'.
         length (int): The total length of the header line. Defaults to 60.
         style1 (str): The style for the title text. Defaults to 'bold red'.
         style2 (str): The style for the separator text. Defaults to 'bold blue'.
+        print_out (bool): Whether to print the header or just return it. Defaults to True.
     """
     text_helper = TextHelper()
     if print_out:
-        text_helper.print_header(title=title, sep=sep, length=length, s1=style1, s2=style2, return_txt=False)
+        text_helper.print_header(
+            title=title,
+            top_sep=top_sep,
+            left_sep=left_sep,
+            right_sep=right_sep,
+            bottom_sep=bottom_sep,
+            length=length,
+            s1=style1,
+            s2=style2,
+            return_txt=False,
+        )
         return ""
-    return text_helper.print_header(title=title, sep=sep, length=length, s1=style1, s2=style2, return_txt=True)
+    return text_helper.print_header(
+        title=title,
+        top_sep=top_sep,
+        left_sep=left_sep,
+        right_sep=right_sep,
+        bottom_sep=bottom_sep,
+        length=length,
+        s1=style1,
+        s2=style2,
+        return_txt=True,
+    )
+
+
+if __name__ == "__main__":
+    # Example usage of the TextHelper
+    text_helper = TextHelper()
+    text_helper.print_header("My Title", top_sep="#", bottom_sep="#")
+    text_helper.print_header("My Title", top_sep="=", left_sep=">", right_sep="<", bottom_sep="=")
+    text_helper.print_header("My Title", top_sep="-", left_sep="[", right_sep="]", bottom_sep="-")

{bear_utils-0.8.25 → bear_utils-0.8.26}/tests/test_logger.py

@@ -6,7 +6,7 @@ import pytest
 from rich.console import Console
 
 from bear_utils import VERBOSE, BufferLogger, ConsoleLogger, FileLogger
-from bear_utils.extras import fmt_header
+from bear_utils.extras import ascii_header as fmt_header
 
 console = Console()