fastapi-toolsets 5.1.5__tar.gz → 5.1.7__tar.gz

{fastapi_toolsets-5.1.5 → fastapi_toolsets-5.1.7}/PKG-INFO

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

{fastapi_toolsets-5.1.5 → fastapi_toolsets-5.1.7}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "fastapi-toolsets"
-version = "5.1.5"
+version = "5.1.7"
 description = "Production-ready utilities for FastAPI applications"
 readme = "README.md"
 license = "MIT"

{fastapi_toolsets-5.1.5 → fastapi_toolsets-5.1.7}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "fastapi-toolsets"
-version = "5.1.5"
+version = "5.1.7"
 description = "Production-ready utilities for FastAPI applications"
 readme = "README.md"
 license = "MIT"

{fastapi_toolsets-5.1.5 → fastapi_toolsets-5.1.7}/src/fastapi_toolsets/__init__.py

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

fastapi_toolsets-5.1.7/src/fastapi_toolsets/_orm.py

@@ -0,0 +1,36 @@
+"""SQLAlchemy state and expression helpers."""
+
+from collections.abc import Iterable, 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_to_many(rels: Iterable[Any]) -> bool:
+    """True if the relationship path *rels* crosses a collection."""
+    return any(rel.property.uselist for rel in rels)
+
+
+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")
+    }