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

bear_utils/database/_db_manager.py

@@ -32,42 +32,35 @@ class DatabaseManager:
             raise ValueError("Base class is not set, failed to set base.")
         return cls._base
 
-    def __init__(self, db_url: str | Path | None = None):
+    def __init__(self, db_url: str | Path | None = None, default_schema: str = "sqlite:///"):
         if db_url is None or db_url == "":
             raise ValueError("Database URL cannot be None or empty.")
-        if isinstance(db_url, str) and not db_url.startswith("sqlite://"):
-            db_url = f"sqlite:///{db_url}"
+        if isinstance(db_url, str) and not db_url.startswith(default_schema):
+            db_url = f"{default_schema}{db_url}"
         self.db_url: str = str(db_url)
         self.engine: Engine = create_engine(self.db_url, echo=False)
         base: DeclarativeMeta = DatabaseManager.get_base()
         self.metadata: MetaData = base.metadata
-        self.SessionFactory = sessionmaker(bind=self.engine)
-        self.session = scoped_session(self.SessionFactory)
+        self.SessionFactory: sessionmaker[Session] = sessionmaker(bind=self.engine)
+        self.session: scoped_session[Session] = scoped_session(self.SessionFactory)
         atexit.register(self.close_all)
         self.create_tables()
 
     def get_all_records(self, table_obj: type[TableType]) -> list[TableType]:
         """Get all records from a table."""
-        with self.open_session() as session:
-            return session.query(table_obj).all()
+        return self.session().query(table_obj).all()
 
     def count_records(self, table_obj: type[TableType]) -> int:
         """Count the number of records in a table."""
-        with self.open_session() as session:
-            count: int = session.query(table_obj).count()
-        return count
+        return self.session().query(table_obj).count()
 
     def get_records_by_var(self, table_obj: type[TableType], variable: str, value: str) -> list[TableType]:
         """Get records from a table by a specific variable."""
-        with self.open_session() as session:
-            records: list[TableType] = session.query(table_obj).filter(getattr(table_obj, variable) == value).all()
-        return records
+        return self.session().query(table_obj).filter(getattr(table_obj, variable) == value).all()
 
     def count_records_by_var(self, table_obj: type[TableType], variable: str, value: str) -> int:
         """Count the number of records in a table by a specific variable."""
-        with self.open_session() as session:
-            count: int = session.query(table_obj).filter(getattr(table_obj, variable) == value).count()
-        return count
+        return self.session().query(table_obj).filter(getattr(table_obj, variable) == value).count()
 
     @contextmanager
     def open_session(self) -> Generator[Session, Any]:

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,22 +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
 
-SUCCESS: list[str] = ["name", "success"]
-FAILURE: list[str] = ["name"]
+# Pydantic will yell if we put this into a TYPE_CHECKING block.
+from bear_utils.logger_manager import AsyncLoggerProtocol, LoggerProtocol  # noqa: TC001
+
+if TYPE_CHECKING:
+    from collections.abc import Callable
+
+
+SUCCESS: list[str] = ["name", "success", "number_of_tasks"]
+FAILURE: list[str] = ["name", "number_of_tasks"]
 
 
 class FunctionResponse(BaseModel):
@@ -240,6 +242,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 +262,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 +302,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(
@@ -304,22 +338,16 @@ class FunctionResponse(BaseModel):
             content = []
         if not isinstance(error, (list | str)):
             error = []
-
         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 +380,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.23.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bear-utils
-Version: 0.8.21
+Version: 0.8.23
 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.23
 
 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.23.dist-info}/RECORD

@@ -28,16 +28,16 @@ bear_utils/constants/date_related.py,sha256=vwgPPGamVJ8p12iRFu3IzTksmGfhqYULwrk-
 bear_utils/constants/server.py,sha256=1gWA3h1HH12uk5nqX3r5EFkffPKVDTo3he51teHSDbk,271
 bear_utils/constants/time_related.py,sha256=Mykb27THqC-K0HFrbbrdkTNJUKhzBEOfmPJ0rx2-L6E,705
 bear_utils/database/__init__.py,sha256=dS_HHJKESpsI6BFDLVx055o0GCJV9CMYOQVuHs7EfgY,192
-bear_utils/database/_db_manager.py,sha256=rW4yq6arMF7UbgKrA7C2Wi37O-byqzae39tIZixfRZk,3977
+bear_utils/database/_db_manager.py,sha256=bbg5zG06DcOvd37oafLIqc480BwF9ZW9qWF3ldZHR8o,3805
 bear_utils/events/__init__.py,sha256=EFqmuzhaEYK9kjkGlrM7bjdjPwFEDbKn6RjJKfIBEJY,414
 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=aGUhxfliaqE2tXKGtVPDeOy5JJRjHN5M9gRgI1IsopY,16257
 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.23.dist-info/METADATA,sha256=paN99eKZqMAyoDD6z25V7EFeHK1IcDaAvRwXBQPjyJ8,8763
+bear_utils-0.8.23.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+bear_utils-0.8.23.dist-info/RECORD,,