bear-utils 0.8.21__py3-none-any.whl → 0.8.22__py3-none-any.whl

bear_utils/extras/_async_helpers.py

@@ -1,9 +1,26 @@
 import asyncio
-from asyncio import AbstractEventLoop
+from asyncio import AbstractEventLoop, Task
 from collections.abc import Callable
 from contextlib import suppress
 import inspect
 
+from pydantic import BaseModel, Field
+
+
+class AsyncResponseModel(BaseModel):
+    """A model to handle asynchronous operations with a function and its arguments."""
+
+    loop: AbstractEventLoop | None = Field(default=None, description="The event loop to run the function in.")
+    task: Task | None = Field(default=None, description="The task created for the asynchronous function.")
+    before_loop: bool = Field(default=False, description="If the function was called from a running loop.")
+
+    model_config = {"arbitrary_types_allowed": True}
+
+    def conditional_run(self) -> None:
+        """Run the event loop until the task is complete if not in a running loop."""
+        if self.loop and self.task and not self.before_loop:
+            self.loop.run_until_complete(self.task)
+
 
 def is_async_function(func: Callable) -> bool:
     """Check if a function is asynchronous.
@@ -36,3 +53,15 @@ def gimmie_async_loop() -> AbstractEventLoop:
     loop: AbstractEventLoop = asyncio.new_event_loop()
     asyncio.set_event_loop(loop)
     return loop
+
+
+def create_async_task(
+    func: Callable,
+    *args,
+    **kwargs,
+) -> AsyncResponseModel:
+    """Create an asyncio task for a given function."""
+    before_loop: bool = in_async_loop()
+    loop: AbstractEventLoop = gimmie_async_loop()
+    task = loop.create_task(func(*args, **kwargs))
+    return AsyncResponseModel(loop=loop, task=task, before_loop=before_loop)

bear_utils/extras/responses/function_response.py

@@ -2,23 +2,24 @@
 
 from __future__ import annotations
 
-from collections.abc import Callable
 import json
 from subprocess import CompletedProcess
 from types import SimpleNamespace as Namespace
-from typing import Any, Literal, Self, overload
+from typing import TYPE_CHECKING, Any, Literal, Self, overload
 
 from pydantic import BaseModel, Field, field_validator
 
-from bear_utils.extras._async_helpers import AbstractEventLoop, gimmie_async_loop, in_async_loop, is_async_function
-from bear_utils.logger_manager import (
-    AsyncLoggerProtocol,
-    LoggerProtocol,
-)
+from bear_utils.extras._async_helpers import AsyncResponseModel, create_async_task, is_async_function
+
+# Pydantic will yell if we put this into a TYPE_CHECKING block.
+from bear_utils.logger_manager import AsyncLoggerProtocol, LoggerProtocol  # noqa: TC001
 
 SUCCESS: list[str] = ["name", "success"]
 FAILURE: list[str] = ["name"]
 
+if TYPE_CHECKING:
+    from collections.abc import Callable
+
 
 class FunctionResponse(BaseModel):
     """A class to represent the response of a function call, including success status, content, and error messages."""
@@ -240,6 +241,19 @@ class FunctionResponse(BaseModel):
         self._add_error(error=result.stderr.strip() if result.stderr else "")
         self.returncode = result.returncode
 
+    def _handle_content(self, content: list[str] | str | FunctionResponse | CompletedProcess | Any) -> None:
+        """Handle different types of content and update the FunctionResponse."""
+        if isinstance(content, FunctionResponse):
+            self._handle_function_response(func_response=content)
+        elif isinstance(content, CompletedProcess):
+            self._handle_completed_process(result=content)
+        elif isinstance(content, (str | list)):
+            self._add_content(content=content)
+        else:
+            return
+        self.number_of_tasks += 1
+
+    @overload
     def add(
         self,
         content: list[str] | str | FunctionResponse | CompletedProcess | None = None,
@@ -247,19 +261,36 @@ class FunctionResponse(BaseModel):
         returncode: int | None = None,
         log_output: bool = False,
         extra: dict[str, Any] | None = None,
-    ) -> Self:
+        *,
+        to_dict: Literal[True],
+    ) -> dict[str, Any]: ...
+
+    @overload
+    def add(
+        self,
+        content: list[str] | str | FunctionResponse | CompletedProcess | None = None,
+        error: str | list[str] | None = None,
+        returncode: int | None = None,
+        log_output: bool = False,
+        extra: dict[str, Any] | None = None,
+        *,
+        to_dict: Literal[False] = False,
+    ) -> Self: ...
+
+    def add(
+        self,
+        content: list[str] | str | FunctionResponse | CompletedProcess | None = None,
+        error: str | list[str] | None = None,
+        returncode: int | None = None,
+        log_output: bool = False,
+        extra: dict[str, Any] | None = None,
+        *,
+        to_dict: bool = False,
+    ) -> Self | dict[str, Any]:
         """Append additional content to the existing content."""
         try:
             if content is not None:
-                if isinstance(content, FunctionResponse):
-                    self._handle_function_response(func_response=content)
-                    self.number_of_tasks += 1
-                elif isinstance(content, CompletedProcess):
-                    self._handle_completed_process(result=content)
-                    self.number_of_tasks += 1
-                elif isinstance(content, (str | list)) and content:
-                    self._add_content(content=content)
-                    self.number_of_tasks += 1
+                self._handle_content(content=content)
             if error is not None and isinstance(error, (str | list)):
                 self._add_error(error=error)
             if isinstance(returncode, int):
@@ -270,6 +301,8 @@ class FunctionResponse(BaseModel):
                 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
+        if to_dict:
+            return self.done(to_dict=True)
         return self
 
     def _log_handling(
@@ -308,18 +341,14 @@ class FunctionResponse(BaseModel):
         if not content and not error:
             return
 
-        before_loop: bool = in_async_loop()
-        loop: AbstractEventLoop = gimmie_async_loop()
-        task = loop.create_task(
-            _log_messages(
-                content=content,
-                error=error,
-                info_func=logger.info,
-                error_func=logger.error,
-            )
+        res: AsyncResponseModel = create_async_task(
+            _log_messages,
+            content=content,
+            error=error,
+            info_func=logger.info,
+            error_func=logger.error,
         )
-        if task is not None and loop is not None and not before_loop:
-            loop.run_until_complete(task)
+        res.conditional_run()
 
     @overload
     def done(self, to_dict: Literal[True], suppress: list[str] | None = None) -> dict[str, Any]: ...
@@ -352,7 +381,7 @@ class FunctionResponse(BaseModel):
         add("name", self.name, bool(self.name))
         add("success", self.success)
         add("returncode", self.returncode, self.returncode > 0)
-        add("number_of_tasks", self.number_of_tasks, self.number_of_tasks > 0)
+        add("number_of_tasks", self.number_of_tasks, (self.number_of_tasks > 0 and not self.success))
         add("content", self.content, bool(self.content))
         add("error", self.error, bool(self.error))
         result.update(self.extra)

bear_utils/gui/gui_tools/qt_app.py

@@ -36,7 +36,7 @@ class QTApplication(QObject):
                 self.app.setOrganizationDomain(org_domain)
         else:
             self.app = QApplication.instance()
-        self.console = ConsoleLogger.get_instance(init=True, name=app_name, level=VERBOSE)
+        self.console: ConsoleLogger = ConsoleLogger.get_instance(init=True, name=app_name, level=VERBOSE)
         atexit.register(self.cleanup)
 
     def _default_exit_shortcuts(self) -> None:

{bear_utils-0.8.21.dist-info → bear_utils-0.8.22.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bear-utils
-Version: 0.8.21
+Version: 0.8.22
 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
@@ -24,7 +24,7 @@ Provides-Extra: gui
 Requires-Dist: pyqt6>=6.9.0; extra == 'gui'
 Description-Content-Type: text/markdown
 
-# Bear Utils v# Bear Utils v0.8.21
+# Bear Utils v# Bear Utils v0.8.22
 
 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.21.dist-info → bear_utils-0.8.22.dist-info}/RECORD

@@ -33,11 +33,11 @@ bear_utils/events/__init__.py,sha256=EFqmuzhaEYK9kjkGlrM7bjdjPwFEDbKn6RjJKfIBEJY
 bear_utils/events/events_class.py,sha256=vPDjWrbut8L3TFn7byyYFZpWYM5ADIqtW2Aeh-qtKfQ,1632
 bear_utils/events/events_module.py,sha256=DkQsDZ5WzM1MH1Msg7mRny40a17Jl31CXbpw4-pICxc,2349
 bear_utils/extras/__init__.py,sha256=szflSapj7aGFc2j5sTitQFccXu-6_UdGG-eYuv6zVJI,607
-bear_utils/extras/_async_helpers.py,sha256=JNzUferzvTf98ocGyHE1jTzeI0_PzskRXwwYsx743Pw,1132
+bear_utils/extras/_async_helpers.py,sha256=4buULZZkR0n2z13Q8_FK59dMchj0Mup03YBaqSCbveQ,2291
 bear_utils/extras/_tools.py,sha256=-rOH_-0pRd7_-o_l2QqByYBB2yhbXcTC8fuQf4Sx-eg,7671
 bear_utils/extras/platform_utils.py,sha256=Ai7ow7S-_cKb5zFwFh8dkC8xmbMJFy-0_-w3NCERdEw,1362
 bear_utils/extras/responses/__init__.py,sha256=XbE4VKemrKRwx9E5jqy__OiM_AAjA58ebnqQ2hytnT0,225
-bear_utils/extras/responses/function_response.py,sha256=yzZCBAIvjJbq1jBTU9X31FTc5xD_dIBSE0kuFa5YKq4,15333
+bear_utils/extras/responses/function_response.py,sha256=VFhYGoSXbqdkgeBWYdmHcHcJ2Z0BFg_Y8EmdkaF442Y,16220
 bear_utils/extras/wrappers/__init__.py,sha256=crh4sKOLvuhNMVX5bJYjCFWtXtH7G47UgNPOHq3HXTk,43
 bear_utils/extras/wrappers/add_methods.py,sha256=z2XZG2ZoYOB1MaGiLli4NRyyTeRgBy7tuYsiy8mTa9s,4422
 bear_utils/files/__init__.py,sha256=mIdnFSXoDE64ElM43bN2m6KuafURnN82ki0pdqN8q2o,201
@@ -57,7 +57,7 @@ bear_utils/gui/__init__.py,sha256=z_rOZ-nN3E6Hd_nGD6SdDVqE61VUk2OOogI6U89nkkA,34
 bear_utils/gui/gui_tools/__init__.py,sha256=cD6cKxU1cmKDVaBRT8KsqsCbulf6TUNAmVr50XGPpo8,446
 bear_utils/gui/gui_tools/_settings.py,sha256=xSQ7I-axAifZNvEw_28mnFBFYIJd4xFuDpycFFQLib0,1201
 bear_utils/gui/gui_tools/_types.py,sha256=krguJ-ccALKeUHz9auh_iyOCzeAuerOYcuhWW8jjJQ0,248
-bear_utils/gui/gui_tools/qt_app.py,sha256=hjZtHNJkCcpfT_KkUV35aa9y92ejEhpAV3AFgd27IbY,5865
+bear_utils/gui/gui_tools/qt_app.py,sha256=sxBLcPgy2r9coFqjN3wnCoFKdyvCWvHIJfb64NHtJOs,5880
 bear_utils/gui/gui_tools/qt_color_picker.py,sha256=5NtLiBHk5r9Goma_oiymriH49D_JGIk844p4Hsi51io,4744
 bear_utils/gui/gui_tools/qt_file_handler.py,sha256=FgWdS-9WnjVuyGIC8V30ByDCBeJGZKGc8KRTy34SFfI,4404
 bear_utils/gui/gui_tools/qt_input_dialog.py,sha256=5KaCM9q8kmoy-Fd0j1FbXIVrLlE7W47NEGdhsWtvKwQ,9281
@@ -86,6 +86,6 @@ bear_utils/monitoring/__init__.py,sha256=9DKNIWTp_voLnaWgiP-wJ-o_N0hYixo-MzjUmg8
 bear_utils/monitoring/_common.py,sha256=LYQFxgTP9fk0cH71IQTuGwBYYPWCqHP_mMRNecoD76M,657
 bear_utils/monitoring/host_monitor.py,sha256=e0TYRJw9iDj5Ga6y3ck1TBFEeH42Cax5mQYaNU8yams,13241
 bear_utils/time/__init__.py,sha256=VctjJG17SyEHAFXytI1sZrOrq7zm3hVenIDOJFdaMN0,1424
-bear_utils-0.8.21.dist-info/METADATA,sha256=40Y3kA8qpdI_LU3UFuHntvEdmuXCySQ99s1Y6IYDig8,8763
-bear_utils-0.8.21.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-bear_utils-0.8.21.dist-info/RECORD,,
+bear_utils-0.8.22.dist-info/METADATA,sha256=bI6HOJaPlDs8ml0B_n-if7qmczI67TKOllT-6JkXXhY,8763
+bear_utils-0.8.22.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+bear_utils-0.8.22.dist-info/RECORD,,