bear-utils 0.7.23__tar.gz → 0.7.24__tar.gz

{bear_utils-0.7.23 → bear_utils-0.7.24}/.bumpversion.cfg

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

{bear_utils-0.7.23 → bear_utils-0.7.24}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bear-utils
-Version: 0.7.23
+Version: 0.7.24
 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
@@ -20,7 +20,7 @@ Requires-Dist: tinydb>=4.8.2
 Requires-Dist: toml>=0.10.2
 Description-Content-Type: text/markdown
 
-# Bear Utils v# Bear Utils v0.7.23
+# Bear Utils v# Bear Utils v0.7.24
 
 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.7.23 → bear_utils-0.7.24}/README.md

@@ -1,4 +1,4 @@
-# Bear Utils v# Bear Utils v0.7.23
+# Bear Utils v# Bear Utils v0.7.24
 
 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.7.23 → bear_utils-0.7.24}/noxfile.py

@@ -5,6 +5,23 @@ import nox
 PYTHON_VERSIONS: list[str] = ["3.13", "3.14"]
 
 
+@nox.session(venv_backend="uv", tags=["lint", "fix"])
+def coverage(session: nox.Session) -> None:
+    """Run tests with coverage reporting."""
+    session.install("coverage[toml]", "pytest", "pytest-cov")
+    session.install("-e", ".")
+
+    session.run(
+        "pytest",
+        "--cov=src",
+        "--cov-report=term-missing",
+        "--cov-report=html",
+        "--cov-config=config/coverage.ini",
+    )
+
+    session.log("Coverage HTML report generated in htmlcov/")
+
+
 @nox.session(venv_backend="uv", tags=["lint"])
 def ruff_check(session: nox.Session) -> None:
     """Run ruff linting and formatting checks (CI-friendly, no changes)."""

{bear_utils-0.7.23 → bear_utils-0.7.24}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "bear-utils"
-version = "0.7.23"
+version = "0.7.24"
 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"
@@ -29,9 +29,11 @@ build-backend = "hatchling.build"
 [dependency-groups]
 dev = [
     "bump2version>=1.0.1",
+    "coverage>=7.9.2",
     "isort>=6.0.1",
     "nox>=2025.5.1",
     "pytest>=8.3.5",
+    "pytest-cov>=6.2.1",
     "twine>=6.1.0",
 ]
 gui = [

{bear_utils-0.7.23 → bear_utils-0.7.24}/src/bear_utils/extras/responses/function_response.py

@@ -5,12 +5,11 @@ from __future__ import annotations
 from io import StringIO
 import json
 from subprocess import CompletedProcess
-from typing import TYPE_CHECKING, Any, Literal, Self, overload
+from typing import Any, Literal, Self, overload
 
 from pydantic import BaseModel, Field, field_validator
 
-if TYPE_CHECKING:
-    from bear_utils.constants.logger_protocol import LoggerProtocol
+from bear_utils.constants.logger_protocol import LoggerProtocol  # noqa: TC001 # DO NOT PUT INTO A TYPE_CHECKING BLOCK
 
 SUCCESS: list[str] = ["name", "success"]
 FAILURE: list[str] = ["name"]
@@ -130,6 +129,25 @@ class FunctionResponse(BaseModel):
         """Check if the response indicates success."""
         return self.returncode == 0
 
+    def sub_task(
+        self,
+        name: str = "",
+        content: str | list[str] = "",
+        error: str | list[str] = "",
+        extra: dict[str, Any] | None = None,
+        returncode: int | None = None,
+        log_output: bool = False,
+    ) -> None:
+        """Add a sub-task response to the FunctionResponse."""
+        func_response: FunctionResponse = FunctionResponse(name=name, logger=self.logger).add(
+            content=content,
+            error=error,
+            returncode=returncode or self.returncode,
+            log_output=log_output,
+            extra=extra,
+        )
+        self.add(content=func_response)
+
     def successful(
         self,
         content: str | list[str] | CompletedProcess,
@@ -184,6 +202,19 @@ class FunctionResponse(BaseModel):
         except Exception as e:
             raise ValueError(f"Failed to add content: {e!s}") from e
 
+    def _handle_function_response(self, func_response: FunctionResponse) -> None:
+        """Handle a FunctionResponse object and update the current response."""
+        if func_response.extra:
+            self.extra.update(func_response.extra)
+        self._add_to_error(error=func_response.error, name=func_response.name)
+        self._add_to_content(content=func_response.content, name=func_response.name)
+
+    def _handle_completed_process(self, result: CompletedProcess[str]) -> None:
+        """Handle a CompletedProcess object and update the FunctionResponse."""
+        self._add_to_content(content=result.stdout.strip() if result.stdout else "")
+        self._add_to_error(error=result.stderr.strip() if result.stderr else "")
+        self.returncode = result.returncode
+
     def add(
         self,
         content: list[str] | str | FunctionResponse | CompletedProcess | None = None,
@@ -205,45 +236,49 @@ class FunctionResponse(BaseModel):
             Self: The updated FunctionResponse instance.
         """
         try:
-            if isinstance(content, FunctionResponse):
-                if content.extra:
-                    self.extra.update(content.extra)
-                self._add_to_error(error=content.error, name=content.name)
-                self._add_to_content(content=content.content, name=content.name)
-                self.number_of_tasks += 1
-            elif isinstance(content, CompletedProcess):
-                result: CompletedProcess[str] = content
-                self._add_to_content(content=result.stdout.strip() if result.stdout else "")
-                self._add_to_error(error=result.stderr.strip() if result.stderr else "")
-                self.returncode = result.returncode
-                self.number_of_tasks += 1
-            elif isinstance(content, str | list):
-                self._add_to_content(content=content)
-                self.number_of_tasks += 1
-            if isinstance(error, str | list):
-                self._add_to_error(error=error)
-            if returncode is not None:
-                self.returncode = returncode
-            if extra is not None and isinstance(extra, dict):
-                self.extra.update(extra)
-            if log_output and self.logger is not None:
-                if content is not None and error is None:
-                    if isinstance(content, list):
-                        for item in content:
-                            self.logger.info(message=f"{self.name}: {item}" if self.name else item)
-                    elif isinstance(content, str):
-                        self.logger.info(message=f"{self.name}: {content}" if self.name else content)
-                elif error is not None and content is None:
-                    if isinstance(error, list):
-                        for err in error:
-                            self.logger.error(message=f"{self.name}: {err}" if self.name else err)
-                    elif isinstance(error, str):
-                        self.logger.error(message=f"{self.name}: {error}" if self.name else error)
-
+            match content:
+                case FunctionResponse():
+                    self._handle_function_response(func_response=content)
+                    self.number_of_tasks += 1
+                case CompletedProcess():
+                    self._handle_completed_process(result=content)
+                    self.number_of_tasks += 1
+                case str() | list() if content:
+                    self._add_to_content(content=content)
+                    self.number_of_tasks += 1
+                case None:
+                    content = None
+                case _:
+                    content = None
+            self._add_to_error(error=error) if isinstance(error, (str | list)) else None
+            self.returncode = returncode if returncode is not None else self.returncode
+            self.extra.update(extra) if isinstance(extra, dict) else None
+            if log_output and self.logger is not None and (content is not None or error is not None):
+                self._log_handling(content=content, error=error, logger=self.logger)
         except Exception as e:
             raise ValueError(f"Failed to add content: {e!s}") from e
         return self
 
+    def _log_handling(
+        self,
+        content: list[str] | str | FunctionResponse | CompletedProcess | None,
+        error: str | list[str] | None,
+        logger: LoggerProtocol,
+    ) -> None:
+        """Log the content and error messages if they exist."""
+        if content is not None and error is None:
+            if isinstance(content, list):
+                for item in content:
+                    logger.info(message=f"{self.name}: {item}" if self.name else item)
+            elif isinstance(content, str):
+                logger.info(message=f"{self.name}: {content}" if self.name else content)
+        elif error is not None and content is None:
+            if isinstance(error, list):
+                for err in error:
+                    logger.error(message=f"{self.name}: {err}" if self.name else err)
+            elif isinstance(error, str):
+                logger.error(message=f"{self.name}: {error}" if self.name else error)
+
     @overload
     def done(self, to_dict: Literal[True], suppress: list[str] | None = None) -> dict[str, Any]: ...
 

{bear_utils-0.7.23 → bear_utils-0.7.24}/src/bear_utils/files/file_handlers/_base_file_handler.py

@@ -8,12 +8,6 @@ P = ParamSpec("P")
 R = TypeVar("R")
 
 
-def check_data_type(data: dict[str, Any] | str, valid_types: tuple[type, ...]) -> None:
-    """Check if the data is of a valid type for text files."""
-    if not isinstance(data, valid_types):
-        raise TypeError(f"Data must be one of {valid_types}, got {type(data)}")
-
-
 class FileHandler(ABC):
     """Abstract class for file handling with read, write, and present methods
 
@@ -40,7 +34,7 @@ class FileHandler(ABC):
         return file_path.suffix.lstrip(".") in cls.valid_extensions
 
     @classmethod
-    def check_data_type(cls, data: Any) -> Any:
+    def check_data_type(cls, data: dict[str, Any] | str, valid_types: tuple[type, ...]) -> None:
         """Check if the data is of the correct type.
 
         Args:
@@ -49,8 +43,8 @@ class FileHandler(ABC):
         Returns:
             bool: True if the data is of the correct type, False otherwise
         """
-        if not isinstance(data, cls.valid_types):
-            raise TypeError(f"Data must be one of {cls.valid_types}, got {type(data)}")
+        if not isinstance(data, valid_types):
+            raise TypeError(f"Data must be one of {valid_types}, got {type(data)}")
 
     @classmethod
     def ValidateFileType(cls, method: Callable[P, R]) -> Callable[P, R]:  # noqa: N802 disable=invalid-name

{bear_utils-0.7.23 → bear_utils-0.7.24}/src/bear_utils/files/file_handlers/json_file_handler.py

@@ -4,7 +4,7 @@ import json
 from pathlib import Path
 from typing import Any, ClassVar, overload
 
-from ._base_file_handler import FileHandler, check_data_type
+from ._base_file_handler import FileHandler
 
 
 class JsonFileHandler(FileHandler):
@@ -44,7 +44,7 @@ class JsonFileHandler(FileHandler):
         """Write data to a JSON file."""
         try:
             super().write_file(file_path=file_path, data=data)
-            check_data_type(data=data, valid_types=self.valid_types)
+            self.check_data_type(data=data, valid_types=self.valid_types)
             data = self.present_file(data, indent=indent, sort_keys=sort_keys)
             file_path.write_text(data=data, encoding="utf-8")
         except Exception as e:

{bear_utils-0.7.23 → bear_utils-0.7.24}/src/bear_utils/files/file_handlers/log_file_handler.py

@@ -3,7 +3,7 @@
 from pathlib import Path
 from typing import Any, ClassVar, cast
 
-from ._base_file_handler import FileHandler, check_data_type
+from ._base_file_handler import FileHandler
 
 
 class LogFileHandler(FileHandler):
@@ -27,7 +27,7 @@ class LogFileHandler(FileHandler):
         """Write data to a log file."""
         try:
             super().write_file(file_path=file_path, data=data)
-            check_data_type(data=data, valid_types=self.valid_types)
+            self.check_data_type(data=data, valid_types=self.valid_types)
             with open(file_path, "w", encoding="utf-8") as file:
                 file.write(cast("str", data))
         except Exception as e:

{bear_utils-0.7.23 → bear_utils-0.7.24}/src/bear_utils/files/file_handlers/toml_file_handler.py

@@ -30,7 +30,7 @@ class TomlFileHandler(FileHandler):
         """Write data to a TOML file."""
         try:
             super().write_file(file_path=file_path, data=data)
-
+            self.check_data_type(data=data, valid_types=self.valid_types)
             with open(file_path, "w", encoding="utf-8") as file:
                 if isinstance(data, dict):
                     toml.dump(data, file, **kwargs)

{bear_utils-0.7.23 → bear_utils-0.7.24}/src/bear_utils/files/file_handlers/txt_file_handler.py

@@ -4,7 +4,7 @@ import json
 from pathlib import Path
 from typing import Any, ClassVar, overload
 
-from ._base_file_handler import FileHandler, check_data_type
+from ._base_file_handler import FileHandler
 
 
 class TextFileHandler(FileHandler):
@@ -44,7 +44,7 @@ class TextFileHandler(FileHandler):
         """Write data to a text file."""
         try:
             super().write_file(file_path=file_path, data=data)
-            check_data_type(data, self.valid_types)
+            self.check_data_type(data=data, valid_types=self.valid_types)
             if isinstance(data, dict):
                 data = json.dumps(data, indent=indent, sort_keys=sort_keys)
             elif isinstance(data, list):

{bear_utils-0.7.23 → bear_utils-0.7.24}/src/bear_utils/files/file_handlers/yaml_file_handler.py

@@ -50,6 +50,7 @@ class YamlFileHandler(FileHandler):
         """Write data to a YAML file."""
         try:
             super().write_file(file_path=file_path, data=data)
+            self.check_data_type(data=data, valid_types=self.valid_types)
             with open(file=file_path, mode="w", encoding="utf-8") as file:
                 yaml.dump(data, stream=file, default_flow_style=False, sort_keys=False, **kwargs)
         except Exception as e: