fastapi-toolsets 5.1.4__tar.gz → 5.1.6__tar.gz

{fastapi_toolsets-5.1.4 → fastapi_toolsets-5.1.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fastapi-toolsets
-Version: 5.1.4
+Version: 5.1.6
 Summary: Production-ready utilities for FastAPI applications
 Keywords: fastapi,sqlalchemy,postgresql
 Author: d3vyce

{fastapi_toolsets-5.1.4 → fastapi_toolsets-5.1.6}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "fastapi-toolsets"
-version = "5.1.4"
+version = "5.1.6"
 description = "Production-ready utilities for FastAPI applications"
 readme = "README.md"
 license = "MIT"
@@ -115,7 +115,10 @@ extend-immutable-calls = [
 
 [tool.pytest.ini_options]
 testpaths = ["tests"]
-filterwarnings = ["ignore::DeprecationWarning"]
+filterwarnings = [
+    "ignore::DeprecationWarning",
+    "error::sqlalchemy.exc.SADeprecationWarning",
+]
 
 [tool.coverage.run]
 source = ["src/fastapi_toolsets"]

{fastapi_toolsets-5.1.4 → fastapi_toolsets-5.1.6}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "fastapi-toolsets"
-version = "5.1.4"
+version = "5.1.6"
 description = "Production-ready utilities for FastAPI applications"
 readme = "README.md"
 license = "MIT"
@@ -110,6 +110,7 @@ extend-immutable-calls = ["fastapi.Depends", "fastapi.Security"]
 testpaths = ["tests"]
 filterwarnings = [
     "ignore::DeprecationWarning",
+    "error::sqlalchemy.exc.SADeprecationWarning",
 ]
 
 [tool.coverage.run]

{fastapi_toolsets-5.1.4 → fastapi_toolsets-5.1.6}/src/fastapi_toolsets/__init__.py

@@ -24,4 +24,4 @@ Example usage:
         return Response(data={"user": user.username}, message="Success")
 """
 
-__version__ = "5.1.4"
+__version__ = "5.1.6"

fastapi_toolsets-5.1.6/src/fastapi_toolsets/_orm.py

@@ -0,0 +1,31 @@
+"""SQLAlchemy state and expression helpers."""
+
+from collections.abc import Sequence
+from typing import Any
+
+from sqlalchemy import inspect as sa_inspect
+from sqlalchemy import tuple_
+
+
+def key_expr(columns: Sequence[Any]) -> Any:
+    """*columns* as one comparable expression: the column, or a tuple of them."""
+    return columns[0] if len(columns) == 1 else tuple_(*columns)
+
+
+def is_expired(obj: Any) -> bool:
+    """True when *obj* or any of its attributes must be re-read from the database."""
+    state = sa_inspect(obj)
+    return bool(state.expired or state.expired_attributes)
+
+
+def loaded_relationships(obj: Any) -> set[str]:
+    """Relationship keys currently loaded on *obj*."""
+    state = sa_inspect(obj, raiseerr=False)
+    if state is None:
+        return set()
+    unloaded = state.unloaded
+    return {
+        rel.key
+        for rel in state.mapper.relationships
+        if rel.key not in unloaded and rel.lazy not in ("dynamic", "write_only")
+    }