refactor(submodules): Refactor all submodules (#222) (#224)

* Topic/db utils (#220)

* feat(pyproject): Update pyproject & pdm lockfile (#217)

Co-authored-by: redjax <[email protected]>

* Feat/add db utils (#219)

* feat(pyproject): Update pyproject & pdm lockfile (#216)

Co-authored-by: redjax <[email protected]>

* feat(db-utils): Add db utils

Add utilities for SQLAlchemy.

Add connection models (dataclasses)

Add SQLAlchemy utils (i.e. get_engine(), get_session())

Add declartive Base object

---------

Co-authored-by: redjax <[email protected]>

---------

Co-authored-by: redjax <[email protected]>

* refactor(submodules): Refactor all submodules (#222)

Remove PDM package definitions. Submodules are modules, not Python packages.

Add some missing imports

Add docstrings & comments

Co-authored-by: redjax <[email protected]>

---------

Co-authored-by: redjax <[email protected]>

Author: redjax

red_utils/__init__.py

@@ -2,7 +2,7 @@
 
 import pkgutil
 
-## Import modules with only stdblit dependencies directly
+## Import modules with only stdlib dependencies directly
 from .context_managers import DictProtect, ListProtect, async_benchmark, benchmark
 from .dict_utils import debug_dict, merge_dicts, update_dict, validate_dict
 from .file_utils import crawl_dir, default_json_dir, export_json, ts
@@ -23,6 +23,8 @@
     trim_uuid,
 )
 
+## Use pkgutil to only load modules
+#  if dependencies are met
 if pkgutil.find_loader("diskcache"):
     from . import diskcache_utils
 
@@ -39,3 +41,6 @@
 if pkgutil.find_loader("fastapi"):
     if pkgutil.find_loader("uvicorn"):
         from . import fastapi_utils
+
+if pkgutil.find_loader("sqlalchemy"):
+    from . import sqlalchemy_utils

red_utils/context_managers/benchmarks/fn_benchmarks.py

@@ -3,7 +3,6 @@
 from contextlib import asynccontextmanager, contextmanager
 import time
 
-
 @contextmanager
 def benchmark(description: str = "Unnamed function timer") -> None:
     """Time a function call.

red_utils/context_managers/object_managers/protect.py

@@ -4,7 +4,6 @@
 import inspect
 import json
 
-
 class ListProtect:
     """Protect a list during modification by modifying a copy instead of the original.
 

red_utils/dict_utils/.gitignore

@@ -1,3 +1,4 @@
 from __future__ import annotations
 
-from .src import debug_dict, merge_dicts, update_dict, validate_dict
+from .operations import debug_dict, merge_dicts, update_dict
+from .validators import validate_dict

red_utils/dict_utils/__init__.py

@@ -4,7 +4,6 @@
 
 from .validators import validate_dict
 
-
 def debug_dict(in_dict: dict = None) -> None:
     """Debug print a dict by looping overkeys and printing.
 

red_utils/dict_utils/src/operations.py renamed to red_utils/dict_utils/operations.py

@@ -1,6 +1,5 @@
 from __future__ import annotations
 
-
 def validate_dict(_dict: dict[str, str] = None) -> dict[str, str]:
     if not _dict:
         raise ValueError("Missing dict to evaluate")