bear-utils 0.9.6__tar.gz → 0.9.8__tar.gz

{bear_utils-0.9.6 → bear_utils-0.9.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bear-utils
-Version: 0.9.6
+Version: 0.9.8
 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.8/src/bear_utils/_internal/_version.py

@@ -0,0 +1 @@
+__version__ = "0.9.8"

{bear_utils-0.9.6 → bear_utils-0.9.8}/src/bear_utils/_internal/cli.py

@@ -15,7 +15,6 @@ import sys
 from typing import Any
 
 from bear_utils._internal import debug
-from bear_utils._internal._version import __version__
 from bear_utils.cli._get_version import VALID_BUMP_TYPES, cli_bump
 from bear_utils.constants import STDERR, ExitCode
 
@@ -43,14 +42,14 @@ class _Version(Action):
         super().__init__(nargs=nargs, **kwargs)
 
     def __call__(self, *_: Any, **__: Any) -> None:
-        version: str = f"{debug._get_name()} v{_version}"
+        version: str = f"{debug._get_name()} v{debug._get_version()}"
         print(version)
         sys.exit(ExitCode.SUCCESS)
 
 
 def get_version() -> ExitCode:
     """CLI command to get the version of the package."""
-    print(__version__)
+    print(debug._get_version())
     return ExitCode.SUCCESS
 
 
@@ -64,11 +63,11 @@ def bump_version(args: list[str] | None = None) -> ExitCode:
         help=f"Type of version bump: {', '.join(VALID_BUMP_TYPES)}",
     )
     _args: Namespace = parser.parse_args(args or sys.argv[1:])
-    return cli_bump([_args.bump_type, debug.__PACKAGE_NAME__, __version__])
+    return cli_bump([_args.bump_type, debug._get_name(), debug._get_version()])
 
 
 def get_parser() -> ArgumentParser:
-    name = debug._get_name()
+    name: str = debug._get_name()
     parser = ArgumentParser(description=name.capitalize(), prog=name, exit_on_error=False)
     parser.add_argument("-V", "--version", action=_Version, help="Print the version of the package")
     subparser = parser.add_subparsers(dest="command", required=False, help="Available commands")

{bear_utils-0.9.6 → bear_utils-0.9.8}/src/bear_utils/_internal/debug.py

@@ -7,22 +7,50 @@ import os
 import platform
 import sys
 
+from pydantic import BaseModel, Field, field_validator
+
 from bear_utils._internal._version import __version__
 from bear_utils.cli._get_version import Version
 
 __PACKAGE_NAME__ = "bear-utils"
 
 
+class _ProjectMetadata(BaseModel):
+    """Dataclass to store project metadata."""
+
+    name: str = Field(default=__PACKAGE_NAME__, description="Project name of the package.")
+    version: str = Field(default=__version__, description="Project version.")
+    description: str = Field(default="No description available.", description="Project description.")
+
+    def __str__(self) -> str:
+        """String representation of the project metadata."""
+        return f"{self.name} v{self.version}: {self.description}"
+
+    @field_validator("version", mode="before")
+    @classmethod
+    def validate_version(cls, v: str) -> str:
+        """Validate the version string."""
+        if not isinstance(v, str) or "0.0.0" in v:
+            try:
+                v = version(__PACKAGE_NAME__)
+            except PackageNotFoundError:
+                v = "0.0.0"
+        return v
+
+
+_metadata = _ProjectMetadata()
+
+
 @dataclass
 class _Package:
     """Dataclass to store package information."""
 
-    name: str = __PACKAGE_NAME__
+    name: str = _metadata.name
     """Package name."""
-    version: str = __version__
+    version: str = _metadata.version
     """Package version."""
-    _version: Version = field(default_factory=lambda: Version.from_string(__version__))
-    description: str = "No description available."
+    _version: Version = field(default_factory=lambda: Version.from_string(_metadata.version))
+    description: str = _metadata.description
     """Package description."""
 
     def __post_init__(self) -> None:
@@ -40,7 +68,7 @@ class _Package:
         return f"{self.name} v{self.version}: {self.description}"
 
 
-@dataclass
+@dataclass(frozen=True)
 class _Variable:
     """Dataclass describing an environment variable."""
 
@@ -50,7 +78,7 @@ class _Variable:
     """Variable value."""
 
 
-@dataclass
+@dataclass(frozen=True)
 class _Environment:
     """Dataclass to store environment information."""
 
@@ -79,18 +107,18 @@ def _interpreter_name_version() -> tuple[str, str]:
     return "", "0.0.0"
 
 
-def _get_package_info(dist: str = __PACKAGE_NAME__) -> _Package:
+def _get_package_info(dist: str = _metadata.name) -> _Package:
     try:
         return _Package(
             name=dist,
-            version=__version__ or version(dist),
+            version=_metadata.version or version(dist),
             description=metadata(dist)["Summary"],
         )
     except PackageNotFoundError:
         return _Package(name=dist)
 
 
-def _get_name(dist: str = __PACKAGE_NAME__) -> str:
+def _get_name(dist: str = _metadata.name) -> str:
     """Get name of the given distribution.
 
     Parameters:
@@ -102,7 +130,7 @@ def _get_name(dist: str = __PACKAGE_NAME__) -> str:
     return _get_package_info(dist).name
 
 
-def _get_version(dist: str = __PACKAGE_NAME__) -> str:
+def _get_version(dist: str = _metadata.name) -> str:
     """Get version of the given distribution.
 
     Parameters:
@@ -114,7 +142,7 @@ def _get_version(dist: str = __PACKAGE_NAME__) -> str:
     return _get_package_info(dist).version
 
 
-def _get_description(dist: str = __PACKAGE_NAME__) -> str:
+def _get_description(dist: str = _metadata.name) -> str:
     """Get description of the given distribution.
 
     Parameters:
@@ -133,10 +161,10 @@ def _get_debug_info() -> _Environment:
         Environment information.
     """
     py_name, py_version = _interpreter_name_version()
-    packages: list[str] = [__PACKAGE_NAME__]
+    packages: list[str] = [_metadata.name]
     variables: list[str] = [
         "PYTHONPATH",
-        *[var for var in os.environ if var.startswith(__PACKAGE_NAME__.replace("-", "_"))],
+        *[var for var in os.environ if var.startswith(_metadata.name.replace("-", "_"))],
     ]
     return _Environment(
         interpreter_name=py_name,

{bear_utils-0.9.6 → bear_utils-0.9.8}/src/bear_utils/extras/_zapper.py

@@ -189,7 +189,7 @@ def zap_multi(
         >>> zap_multi("!?*", "Hello!? World! *", "-")
         'Hello- World- -'
     """
-    zapper = Zapper(sym, src, replace, atomic=atomic)
+    zapper: Zapper[str] = Zapper(sym, src, replace, atomic=atomic)
     return zapper.zap().value
 
 

bear_utils-0.9.6/src/bear_utils/logger_manager/_console_junk.py → bear_utils-0.9.8/src/bear_utils/logger_manager/_logger_misc.py

@@ -1,5 +1,6 @@
 from collections.abc import Callable
 from io import StringIO
+import json
 from logging import Formatter, Handler, LogRecord
 from logging.handlers import BufferingHandler
 import threading
@@ -94,6 +95,24 @@ class ConsoleFormatter(Formatter):
         return super().format(record)
 
 
+class JSONLFormatter(Formatter):
+    """A formatter that outputs log records in JSON Lines format."""
+
+    def format(self, record: LogRecord) -> str:
+        extra: LoggerExtraInfo = get_extra(record)
+        log_entry = {
+            "time": self.formatTime(record, self.datefmt),
+            "level": record.levelname,
+            "message": record.msg,
+            "funcName": record.funcName,
+            "name": record.name,
+            "module": record.module,
+            "line": record.lineno,
+            **extra,
+        }
+        return json.dumps(log_entry)
+
+
 class ConsoleBuffering(BufferingHandler):
     def __init__(
         self,

{bear_utils-0.9.6 → bear_utils-0.9.8}/src/bear_utils/logger_manager/loggers/console_logger.py

@@ -14,7 +14,7 @@ from rich.theme import Theme
 
 from bear_utils.constants.date_related import DATE_TIME_FORMAT
 from bear_utils.logger_manager._common import FIVE_MEGABYTES, VERBOSE_CONSOLE_FORMAT, VERBOSE_FORMAT, ExecValues
-from bear_utils.logger_manager._console_junk import ConsoleBuffering, ConsoleFormatter, ConsoleHandler
+from bear_utils.logger_manager._logger_misc import ConsoleBuffering, ConsoleFormatter, ConsoleHandler
 
 from .base_logger import BaseLogger
 
@@ -124,6 +124,24 @@ class ConsoleLogger(Logger, BaseLogger):
             for handler in self._handlers:
                 self.addHandler(handler)
 
+    def set_console_formatter(self, fmt: str = VERBOSE_CONSOLE_FORMAT) -> None:
+        """Set the formatter for the console handler."""
+        if hasattr(self, "console_handler"):
+            self.console_handler.setFormatter(ConsoleFormatter(fmt=fmt, datefmt=DATE_TIME_FORMAT))
+            self.verbose(f"ConsoleLogger: Console formatter set to {fmt}")
+
+    def set_file_formatter(self, fmt: str = VERBOSE_FORMAT) -> None:
+        """Set the formatter for the file handler."""
+        if hasattr(self, "file_handler"):
+            self.file_handler.setFormatter(Formatter(fmt=fmt, datefmt=DATE_TIME_FORMAT))
+            self.verbose(f"ConsoleLogger: File formatter set to {fmt}")
+
+    def set_buffer_formatter(self, fmt: str = VERBOSE_CONSOLE_FORMAT) -> None:
+        """Set the formatter for the buffer handler."""
+        if hasattr(self, "buffer_handler"):
+            self.buffer_handler.setFormatter(ConsoleFormatter(fmt=fmt, datefmt=DATE_TIME_FORMAT))
+            self.verbose(f"ConsoleLogger: Buffer formatter set to {fmt}")
+
     def stop_queue_listener(self) -> None:
         """Stop the queue listener if it exists and clean up resources."""
         if hasattr(self, "listener"):

{bear_utils-0.9.6 → bear_utils-0.9.8}/src/bear_utils/logger_manager/loggers/console_logger.pyi

@@ -5,7 +5,7 @@ from typing import Any
 from rich.text import Text
 from rich.theme import Theme
 
-from bear_utils.logger_manager._console_junk import ConsoleBuffering, ConsoleHandler
+from bear_utils.logger_manager._logger_misc import ConsoleBuffering, ConsoleHandler
 
 from .base_logger import BaseLogger
 from .sub_logger import SubConsoleLogger

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

@@ -1 +0,0 @@
-__version__ = "0.9.6"