bear-utils 0.9.3__tar.gz → 0.9.5__tar.gz

{bear_utils-0.9.3 → bear_utils-0.9.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bear-utils
-Version: 0.9.3
+Version: 0.9.5
 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

bear_utils-0.9.5/src/bear_utils/_internal/_version.py

@@ -0,0 +1 @@
+version = "0.9.5"

{bear_utils-0.9.3 → bear_utils-0.9.5}/src/bear_utils/_internal/cli.py

@@ -17,7 +17,7 @@ from typing import Any
 from bear_utils._internal import debug
 from bear_utils._internal._version import version as _version
 from bear_utils.cli._get_version import VALID_BUMP_TYPES, cli_bump
-from bear_utils.constants import ExitCode
+from bear_utils.constants import STDERR, ExitCode
 
 
 class _DebugInfo(Action):
@@ -97,7 +97,7 @@ def main(args: list[str] | None = None) -> ExitCode:
     try:
         parser: ArgumentParser = get_parser()
         opts: Namespace = parser.parse_args(args)
-        command = opts.command
+        command: str | None = opts.command
         if command is None:
             parser.print_help()
             return ExitCode.SUCCESS
@@ -105,12 +105,12 @@ def main(args: list[str] | None = None) -> ExitCode:
             return get_version()
         if command == "bump-version":
             if not hasattr(opts, "bump_type"):
-                print("Error: 'bump-version' command requires a 'bump_type' argument.", file=sys.stderr)
+                print("Error: 'bump-version' command requires a 'bump_type' argument.", STDERR)
                 return ExitCode.FAILURE
-            bump_type = opts.bump_type
+            bump_type: str = opts.bump_type
             return bump_version([bump_type])
     except Exception as e:
-        print(f"Error initializing CLI: {e}", file=sys.stderr)
+        print(f"Error initializing CLI: {e}", STDERR)
         return ExitCode.FAILURE
     return ExitCode.SUCCESS
 

{bear_utils-0.9.3 → bear_utils-0.9.5}/src/bear_utils/constants/_meta.py

@@ -29,10 +29,9 @@ class RichStrEnum(StrEnum):
     default: str
 
     def __new__(cls, value: StrValue) -> Self:
-        text: str = value.text
         obj: Self = str.__new__(cls, value.value)
         obj._value_ = value.value
-        obj.text = text
+        obj.text = value.text
         obj.default = value.default
         return obj
 
@@ -91,10 +90,9 @@ class RichIntEnum(IntEnum):
     default: int
 
     def __new__(cls, value: IntValue) -> Self:
-        text: str = value.text
         obj: Self = int.__new__(cls, value.value)
         obj._value_ = value.value
-        obj.text = text
+        obj.text = value.text
         obj.default = value.default
         return obj
 

{bear_utils-0.9.3 → bear_utils-0.9.5}/src/bear_utils/graphics/font/__init__.py

@@ -1,10 +1,12 @@
 """A set of command-line interface (CLI) utilities for creating font outputs."""
 
+from ._theme import CyberTheme, FontStyle
 from .block_font import BLOCK_LETTERS, char_to_block, print_block_font, word_to_block
 
 __all__ = [
     "BLOCK_LETTERS",
-    "char_to_block",
+    "CyberTheme",
+    "FontStyle",
     "char_to_block",
     "print_block_font",
     "word_to_block",

bear_utils-0.9.5/src/bear_utils/graphics/font/_theme.py

@@ -0,0 +1,31 @@
+from bear_utils.constants._meta import RichStrEnum, StrValue as Value
+
+
+class CyberTheme(RichStrEnum):
+    """Namespace for cyberpunk color theme constants."""
+
+    primary = Value("bright_magenta", "Primary color")
+    neon_green = Value("bright_green", "Neon green color")
+    neon_cyan = Value("bright_cyan", "Neon cyan color")
+    warning = Value("bright_yellow", "Warning color")
+    error = Value("bright_red", "Error color")
+    credits = Value("bright_yellow", "Credits color")
+    data = Value("bright_blue", "Data color")
+    system = Value("dim white", "System color")
+
+
+class FontStyle(RichStrEnum):
+    """Enumeration for block font styles."""
+
+    SOLID = Value("solid", "█")
+    HOLLOW = Value("hollow", "░")
+    PIPES = Value("pipes", "|")
+    OUTLINE = Value("outline", "■")
+    DASHED = Value("dashed", "─")
+    DOTTED = Value("dotted", "·")
+    ZIGZAG = Value("zigzag", "╱")  # noqa: RUF001
+    CROSSED = Value("crossed", "╳")  # noqa: RUF001
+    FANCY = Value("fancy", "◆")
+    RIGHT_ARROWS = Value("right_arrows", "▶")
+    LEFT_ARROWS = Value("left_arrows", "◀")
+    STARS = Value("stars", "★")

{bear_utils-0.9.3 → bear_utils-0.9.5}/src/bear_utils/graphics/font/_utils.py

@@ -1,20 +1,33 @@
 from __future__ import annotations
 
-from collections.abc import Callable
 from dataclasses import dataclass
 from io import StringIO
-import re
-from typing import Any, Self
+import os
 
+from pyfiglet import figlet_format
 from rich.align import Align
 from rich.panel import Panel
 from rich.text import Text
 
-from bear_utils.graphics.font._theme import CyberTheme
-from bear_utils.graphics.font.block_font import Style
+from bear_utils.constants._meta import RichStrEnum, StrValue as Value
+from bear_utils.graphics import ColorGradient
+from bear_utils.graphics.font.block_font import FontStyle
 from bear_utils.logger_manager import LogConsole as Console
 
 
+def random_num(rng: int = 100) -> int:
+    """Generate a random number between 0 and the specified range."""
+    random_bytes: bytes = os.urandom(1)
+    random_index: int = int.from_bytes(random_bytes, "big") % rng
+    return random_index
+
+
+def random_style() -> str:
+    rnd_index: int = random_num(100)
+    gradient = ColorGradient()
+    return gradient.map_to_rgb(0, 100, rnd_index)
+
+
 @dataclass
 class HeaderConfig:
     """Configuration for header styling."""
@@ -28,9 +41,10 @@ class HeaderConfig:
     border_style: str = "bold blue"  # s2 - top/bottom lines
     separator_style: str = "bold green"  # s3 - left/right separators
     overall_style: str = "bold yellow"  # s4
+    border_enabled: bool = True
     center_align: bool = True
     return_txt: bool = False
-    use_panel: bool = False  # New option!
+    use_panel: bool = False
 
 
 class TextHelper:
@@ -86,7 +100,7 @@ class TextHelper:
             **kwargs: Override any config values (top_sep, left_sep, etc.)
         """
         local_console = Console()
-        cfg = config or HeaderConfig()
+        cfg: HeaderConfig = config or HeaderConfig()
         for key, value in kwargs.items():
             if hasattr(cfg, key):
                 setattr(cfg, key, value)
@@ -98,7 +112,7 @@ class TextHelper:
             if not cfg.return_txt:
                 local_console.print(output, style=cfg.overall_style)
 
-            temp_console = Console(file=StringIO(), width=cfg.length)
+            temp_console: Console[StringIO] = Console(file=StringIO(), width=cfg.length)
             temp_console.print(output, style=cfg.overall_style)
             return temp_console.file.getvalue()
 
@@ -108,10 +122,8 @@ class TextHelper:
             header_lines = [Align.center(line) for line in header_lines]
 
         if not cfg.return_txt:
-            local_console.print()  # Leading newline
             for line in header_lines:
                 local_console.print(line, style=cfg.overall_style)
-            local_console.print()  # Trailing newline
         output_lines: list[str] = [str(line) for line in header_lines]
         return "\n" + "\n".join(output_lines) + "\n"
 
@@ -119,10 +131,10 @@ class TextHelper:
         """Quick header with predefined styles."""
         styles = {
             "cyberpunk": HeaderConfig(
-                top_sep=str(Style.SOLID),
-                left_sep=str(Style.RIGHT_ARROWS),
-                right_sep=str(Style.LEFT_ARROWS),
-                bottom_sep=str(Style.SOLID),
+                top_sep=str(FontStyle.SOLID),
+                left_sep=str(FontStyle.RIGHT_ARROWS),
+                right_sep=str(FontStyle.LEFT_ARROWS),
+                bottom_sep=str(FontStyle.SOLID),
                 title_style="bold bright_magenta",
                 border_style="bright_cyan",
                 separator_style="bright_green",
@@ -153,36 +165,56 @@ def ascii_header(title: str, print_out: bool = True, **kwargs) -> str:
 
 
 if __name__ == "__main__":
-    top = Style.SOLID.text
-    bottom = Style.SOLID.text
-    left = Style.RIGHT_ARROWS.text
-    right = Style.LEFT_ARROWS.text
+    top: str = ""
+    bottom: str = ""
+    left: str = FontStyle.HOLLOW.text
+    right: str = FontStyle.HOLLOW.text
     ascii_header(
-        "Welcome to Bear Utils",
+        "CYBERDYNE BANKING SYSTEM",
         top_sep=top,
         bottom_sep=bottom,
         left_sep=left,
         right_sep=right,
-        title_style=CyberTheme.primary,
-        separator_style=CyberTheme.system,
-        border_style=CyberTheme.neon_cyan,
+        title_style="red",
+        separator_style="black",
+        border_style="black",
         print_out=True,
     )
 
-    from pyfiglet import figlet_format
-
-    ANSI_SHADOW = "ansi_shadow"
-    BLOODY = "bloody"
-    BANNER_3_D = "banner3-D"
-    POISON = "poison"
-    ALPHA = "alpha"
-    DOOM = "doom"
-    DOT_MATRIX = "dotmatrix"
-    JAZMINE = "jazmine"
-    RAMMSTEIN = "rammstein"
-    REVERSE = "reverse"
-    DIAGONAL_3D = "3d_diagonal"
-    GHOST = "ghost"
-
-    text = figlet_format("BANKER", font="computer")
-    print(text)
+    class FigletFonts(RichStrEnum):
+        """Namespace for Figlet font constants."""
+
+        COMPUTER = Value("computer", "Computer font")
+        SLANT = Value("slant", "Slant font")
+        STANDARD = Value("standard", "Standard font")
+        SMALL = Value("small", "Small font")
+        BIG = Value("big", "Big font")
+        BLOCK = Value("block", "Block font")
+        STAR_WARS = Value("starwars", "Star Wars font")
+        CYBER_MEDIUM = Value("cybermedium", "Cyber Medium font")
+        CYBER_LARGE = Value("cyberlarge", "Cyber Large font")
+        CYBER_SMALL = Value("cybersmall", "Cyber Small font")
+        ANSI_SHADOW = Value("ansi_shadow", "ANSI Shadow font")
+        BLOODY = Value("bloody", "Bloody font")
+        BANNER_3_D = Value("banner3-D", "Banner 3-D font")
+        POISON = Value("poison", "Poison font")
+        ALPHA = Value("alpha", "Alpha font")
+        DOOM = Value("doom", "Doom font")
+        DOT_MATRIX = Value("dotmatrix", "Dot Matrix font")
+        JAZMINE = Value("jazmine", "Jazmine font")
+        RAMMSTEIN = Value("rammstein", "Rammstein font")
+        GHOST = Value("ghost", "Ghost font")
+        DIAGONAL_3D = Value("3d_diagonal", "Diagonal 3D font")
+
+    WORD = "BRAINS"
+    text = ""
+    console = Console()
+    for font in FigletFonts:
+        try:
+            text = figlet_format(WORD, font=font.value)
+        except Exception as e:
+            console.print(f"Error generating font '{font.value}': {e}")
+            continue
+        # console.print(f"\nFont: {font.value}", style="dim white")
+        # console.print(text, style=random_style())
+        # text = ""

{bear_utils-0.9.3 → bear_utils-0.9.5}/src/bear_utils/graphics/font/block_font.py

@@ -3,7 +3,7 @@
 from rich.align import Align
 from rich.console import Console
 
-from bear_utils.constants import RichStrEnum, StrValue
+from bear_utils.graphics.font import FontStyle
 from bear_utils.graphics.font._raw_block_letters import (
     ASTERISK,
     AT,
@@ -58,6 +58,7 @@ from bear_utils.graphics.font._raw_block_letters import (
     Z,
 )
 from bear_utils.graphics.font._theme import CyberTheme as Theme
+from bear_utils.graphics.font._utils import random_style
 
 BLOCK_LETTERS: dict[str, list[str]] = {
     "A": A,
@@ -113,40 +114,19 @@ BLOCK_LETTERS: dict[str, list[str]] = {
     "$": DOLLAR,
 }
 
-
-class Style(RichStrEnum):
-    """Enumeration for block font styles."""
-
-    SOLID = StrValue("solid", "█")
-    HOLLOW = StrValue("hollow", "░")
-    PIPES = StrValue("pipes", "|")
-    OUTLINE = StrValue("outline", "■")
-    DASHED = StrValue("dashed", "─")
-    DOTTED = StrValue("dotted", "·")
-    ZIGZAG = StrValue("zigzag", "╱")  # noqa: RUF001
-    CROSSED = StrValue("crossed", "╳")  # noqa: RUF001
-    FANCY = StrValue("fancy", "◆")
-    RIGHT_ARROWS = StrValue("right_arrows", "▶")
-    LEFT_ARROWS = StrValue("left_arrows", "◀")
-    STARS = StrValue("stars", "★")
-
-
-OG_CHAR = Style.SOLID
+console = Console()
 
 
 def apply_block_style(block_rows: list[str], style: str = "solid") -> list[str]:
     """Replace block characters with different symbols."""
     try:
-        new_char: Style = Style.get(value=style, default=OG_CHAR)
-        return [row.replace(OG_CHAR.text, new_char.text) for row in block_rows]
+        new_char: FontStyle = FontStyle.get(value=style, default=FontStyle.SOLID)
+        return [row.replace(FontStyle.SOLID.text, new_char.text) for row in block_rows]
     except (KeyError, AttributeError) as e:
-        available = ", ".join(Style._value2member_map_.keys())
+        available = ", ".join(FontStyle.keys())
         raise ValueError(f"Invalid style: {style}. Available styles: {available}") from e
 
 
-console = Console()
-
-
 def char_to_block(char: str) -> list[str]:
     """Convert a single character to its block font representation."""
     return BLOCK_LETTERS.get(char.upper(), ["        "] * 5)
@@ -190,15 +170,16 @@ def print_block_font(text: str, color: str = Theme.neon_green) -> None:
         console.print(Align.center(f"[{color}]{row}[/{color}]"))
 
 
-def show_off_styles(word: str, style: str = Theme.primary) -> None:
+def show_off_styles(word: str, style: str | None = None) -> None:
     """Display all block styles by using an example word"""
     console.print("Available block styles:")
 
-    for symbol in Style:
-        styled_word = word_to_block(word, font=symbol.name.lower())
+    for symbol in FontStyle:
+        styled_word = word_to_block(word, font=symbol)
+        style = random_style()
 
         console.print()
-        console.print(Align.center(f"[{Theme.system}]{symbol.name.title()} Style:[/]"))
+        console.print(Align.center(f"[{Theme.system}]{symbol.title()} Style:[/]"))
         console.print(Align.center(f"[{style}]{styled_word}[/]"))
         console.print()
 
@@ -207,5 +188,5 @@ __all__ = ["BLOCK_LETTERS", "char_to_block", "word_to_block"]
 # fmt: on
 
 if __name__ == "__main__":
-    WORD = "CLAUDE"
+    WORD = "CLAIRE"
     show_off_styles(WORD)

{bear_utils-0.9.3 → bear_utils-0.9.5}/src/bear_utils/logger_manager/_log_level.py

@@ -16,14 +16,14 @@ NOTSET: Literal[0] = 0
 class LogLevel(RichIntEnum):
     """Enumeration for logging levels."""
 
-    NOTSET = Value(NOTSET, "NOTSET")
-    VERBOSE = Value(VERBOSE, "VERBOSE")
-    DEBUG = Value(DEBUG, "DEBUG")
-    INFO = Value(INFO, "INFO")
-    WARNING = Value(WARNING, "WARNING")
-    ERROR = Value(ERROR, "ERROR")
-    FAILURE = Value(FAILURE, "FAILURE")
-    SUCCESS = Value(SUCCESS, "SUCCESS")
+    NOTSET = Value(NOTSET, "NOTSET", default=NOTSET)
+    VERBOSE = Value(VERBOSE, "VERBOSE", default=VERBOSE)
+    DEBUG = Value(DEBUG, "DEBUG", default=DEBUG)
+    INFO = Value(INFO, "INFO", default=INFO)
+    WARNING = Value(WARNING, "WARNING", default=WARNING)
+    ERROR = Value(ERROR, "ERROR", default=ERROR)
+    FAILURE = Value(FAILURE, "FAILURE", default=FAILURE)
+    SUCCESS = Value(SUCCESS, "SUCCESS", default=SUCCESS)
 
 
 level_to_name = {

{bear_utils-0.9.3 → bear_utils-0.9.5}/src/bear_utils/logger_manager/loggers/fastapi_logger.py

@@ -45,7 +45,7 @@ class LogRequest(BaseModel):
     @field_serializer("level")
     def serialize_level(self, value: LogLevel | int | str) -> int:
         """Serialize the log level to an integer."""
-        return LogLevel.get(value).value
+        return LogLevel.get(value, default=DEBUG).value
 
 
 class LoggingServer[T: TextIO](SingletonBase):
@@ -65,7 +65,7 @@ class LoggingServer[T: TextIO](SingletonBase):
         self.port: int = port
         self.log_file: Path = Path(log_file)
         self.log_file.parent.mkdir(parents=True, exist_ok=True)
-        self.level: LogLevel = LogLevel.get(level)
+        self.level: LogLevel = LogLevel.get(level, default=DEBUG)
         self.app = FastAPI()
         self.server_thread = None
         self._running = False
@@ -111,7 +111,7 @@ class LoggingServer[T: TextIO](SingletonBase):
                 args=request["args"] if isinstance(request, dict) else request.args,
                 kwargs=request["kwargs"] if isinstance(request, dict) else request.kwargs,
             )
-            level: LogLevel = LogLevel.get(request.level)
+            level: LogLevel = LogLevel.get(request.level, default=DEBUG)
             if level.value < self.level.value:
                 return self.response(status="ignored", message="Log level is lower than server's minimum level")
             message = request.message
@@ -137,7 +137,6 @@ class LoggingServer[T: TextIO](SingletonBase):
         level: LogLevel,
         message: str,
         end: str = "\n",
-        console: bool = True,
         *args,
         **kwargs,
     ) -> ExitCode:
@@ -152,7 +151,7 @@ class LoggingServer[T: TextIO](SingletonBase):
             if kwargs:
                 for key, value in kwargs.items():
                     buffer.append(f"{key}={value}{end}")
-            if console:
+            if kwargs.pop("console", False):
                 self.print(f"{end}".join(buffer))
             with open(self.log_file, "a", encoding="utf-8") as f:
                 for line in buffer:
@@ -207,14 +206,14 @@ class LoggingClient[T: TextIO]:
         server_url: str | None = None,
         host: str = "http://localhost",
         port: int = 8080,
-        level: LogLevel | int | str = INFO,
+        level: LogLevel | int | str = DEBUG,
         file: T = DEVNULL,  # Default to DEVNULL to discard console output
     ) -> None:
         """Initialize the ServerLogger."""
         self.host: str = host
         self.port: int = port
         self.server_url: str = server_url or f"{self.host}:{self.port}"
-        self.level: LogLevel = LogLevel.get(level)
+        self.level: LogLevel = LogLevel.get(level, default=DEBUG)
         self.client: AsyncClient = AsyncClient(timeout=5.0)
         self.file: T = file
 

{bear_utils-0.9.3 → bear_utils-0.9.5}/src/bear_utils/logger_manager/loggers/simple_logger.py

@@ -3,19 +3,17 @@
 from io import StringIO
 from typing import TextIO
 
-from bear_utils.constants import STDERR, STDOUT
+from bear_utils.constants import STDERR, STDOUT, NullFile
 from bear_utils.logger_manager._log_level import LogLevel
 from bear_utils.time import EpochTimestamp
 
-VERBOSE: LogLevel = LogLevel.get("VERBOSE")
-DEBUG: LogLevel = LogLevel.get("DEBUG")
-INFO: LogLevel = LogLevel.get("INFO")
-WARNING: LogLevel = LogLevel.get("WARNING")
-ERROR: LogLevel = LogLevel.get("ERROR")
-SUCCESS: LogLevel = LogLevel.get("SUCCESS")
-FAILURE: LogLevel = LogLevel.get("FAILURE")
-
-CHOICES = [STDOUT, STDERR, StringIO]
+VERBOSE: LogLevel = LogLevel.VERBOSE
+DEBUG: LogLevel = LogLevel.DEBUG
+INFO: LogLevel = LogLevel.INFO
+WARNING: LogLevel = LogLevel.WARNING
+ERROR: LogLevel = LogLevel.ERROR
+SUCCESS: LogLevel = LogLevel.SUCCESS
+FAILURE: LogLevel = LogLevel.FAILURE
 
 
 class SimpleLogger[T: TextIO]:
@@ -23,8 +21,8 @@ class SimpleLogger[T: TextIO]:
 
     def __init__(self, level: str | int | LogLevel = "DEBUG", file: T = STDERR) -> None:
         """Initialize the logger with a minimum log level and output file."""
-        self.level: LogLevel = LogLevel.get(level)
-        self.file: T = file
+        self.level: LogLevel = LogLevel.get(level, default=DEBUG)
+        self.file: T = file  # Can be STDOUT, STDERR, StringIO, NullFile or other TextIO Objects
         self.buffer: list[str] = []
 
     def print(self, msg: object, end: str = "\n") -> None:
@@ -80,10 +78,18 @@ class SimpleLogger[T: TextIO]:
         self.log(FAILURE, msg, *args, **kwargs)
 
 
+__all__ = [
+    "STDERR",
+    "STDOUT",
+    "LogLevel",
+    "NullFile",
+    "SimpleLogger",
+]
+
 # Example usage:
 if __name__ == "__main__":
     logger = SimpleLogger(file=StringIO())
-    logger_two = SimpleLogger(level="INFO", file=STDERR)
+    logger_two = SimpleLogger(level="INFO", file=NullFile())
     logger.info(msg="This is an info message")
     logger_two.info(msg="This is an info message")
 

bear_utils-0.9.3/src/bear_utils/_internal/_version.py

@@ -1 +0,0 @@
-version = "0.9.3"

bear_utils-0.9.3/src/bear_utils/graphics/font/_theme.py

@@ -1,11 +0,0 @@
-class CyberTheme:
-    """Namespace for cyberpunk color theme constants."""
-
-    primary: str = "bright_magenta"
-    neon_green: str = "bright_green"
-    neon_cyan: str = "bright_cyan"
-    warning: str = "bright_yellow"
-    error: str = "bright_red"
-    credits: str = "bright_yellow"
-    data: str = "bright_blue"
-    system: str = "dim white"