jvspatial 0.2.4__tar.gz → 0.2.5__tar.gz

{jvspatial-0.2.4/jvspatial.egg-info → jvspatial-0.2.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jvspatial
-Version: 0.2.4
+Version: 0.2.5
 Summary: An asynchronous object-spatial Python library for persistence and business logic application layers.
 Author-email: "TrueSelph Inc." <adminh@trueselph.com>
 License: MIT
@@ -48,14 +48,14 @@ Provides-Extra: pgvector
 Requires-Dist: asyncpg>=0.29.0; extra == "pgvector"
 Requires-Dist: pgvector>=0.2.5; extra == "pgvector"
 Provides-Extra: dev
-Requires-Dist: pytest<9.2,>=7.0; extra == "dev"
+Requires-Dist: pytest<9.3,>=7.0; extra == "dev"
 Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
 Requires-Dist: pytest-benchmark>=4.0.0; extra == "dev"
 Requires-Dist: httpx>=0.24.0; extra == "dev"
 Requires-Dist: pre-commit>=3.0.0; extra == "dev"
 Requires-Dist: python-dotenv>=1.0.0; extra == "dev"
 Provides-Extra: test
-Requires-Dist: pytest<9.2,>=7.0; extra == "test"
+Requires-Dist: pytest<9.3,>=7.0; extra == "test"
 Requires-Dist: pytest-asyncio>=0.21.0; extra == "test"
 Requires-Dist: pytest-cov>=4.0.0; extra == "test"
 Requires-Dist: pytest-benchmark>=4.0.0; extra == "test"

{jvspatial-0.2.4 → jvspatial-0.2.5}/jvspatial/__init__.py

@@ -94,6 +94,7 @@ from .db import (
     LiteralBindingFact,
     create_database,
 )
+from .db.transaction import Transaction
 from .db.work_claim import claim_record, delete_claimed_record, release_claim
 
 # Observability primitives
@@ -170,6 +171,7 @@ __all__ = [
     "Server",
     # Database & Cache
     "Database",
+    "Transaction",
     "InsertIfAbsentResult",
     "GraphBindingSummary",
     "LiteralBindingFact",

{jvspatial-0.2.4 → jvspatial-0.2.5}/jvspatial/db/_cache.py

@@ -248,6 +248,11 @@ class CachingDatabase(Database):
         """Expose native projection support without promising a complete entity."""
         return bool(getattr(self.inner, "supports_native_projected_reads", False))
 
+    def can_pushdown_numeric_sort(self, query, sort) -> bool:
+        """Forward compiler coverage, never a cached data/authorization result."""
+        checker = getattr(self.inner, "can_pushdown_numeric_sort", None)
+        return bool(checker(query, sort)) if callable(checker) else False
+
     async def graph_edge_page(
         self, node_id: str, *, after: Optional[str] = None, limit: int = 50
     ) -> List[Dict[str, Any]]:

{jvspatial-0.2.4 → jvspatial-0.2.5}/jvspatial/db/_observable.py

@@ -357,6 +357,11 @@ class ObservableDatabase(Database):
         """Expose native projection support without promising a complete entity."""
         return bool(getattr(self.inner, "supports_native_projected_reads", False))
 
+    def can_pushdown_numeric_sort(self, query, sort) -> bool:
+        """Forward compiler coverage without recording a database operation."""
+        checker = getattr(self.inner, "can_pushdown_numeric_sort", None)
+        return bool(checker(query, sort)) if callable(checker) else False
+
     async def graph_edge_page(
         self, node_id: str, *, after: Optional[str] = None, limit: int = 50
     ) -> List[Dict[str, Any]]:

{jvspatial-0.2.4 → jvspatial-0.2.5}/jvspatial/db/database.py

@@ -416,6 +416,17 @@ class Database(ABC):
         """Whether the current adapter provides native graph fact summaries."""
         return False
 
+    def can_pushdown_numeric_sort(
+        self, query: Dict[str, Any], sort: List[Tuple[str, int]]
+    ) -> bool:
+        """Whether this query/order can remain native for number/null keys.
+
+        This is compiler coverage, not a data-type or permission proof. The
+        caller must establish homogeneous numeric/null values for non-ID
+        keys. Unsupported adapters refuse; no query is executed here.
+        """
+        return False
+
     async def graph_node_batch(self, ids: List[str]) -> Dict[str, Dict[str, Any]]:
         """Fetch raw projection nodes; wrappers bypass stale record caches."""
         return await self.find_many("node", ids)

{jvspatial-0.2.4 → jvspatial-0.2.5}/jvspatial/db/postgres.py

@@ -363,6 +363,16 @@ class PostgresDB(Database):
     supports_native_projected_reads: bool = True
     supports_native_graph_binding_summary: bool = True
 
+    def can_pushdown_numeric_sort(
+        self, query: Dict[str, Any], sort: List[Tuple[str, int]]
+    ) -> bool:
+        """Report complete compiler coverage without fetching or granting data."""
+        return (
+            bool(sort)
+            and translate_query(query) is not None
+            and translate_sort(sort) is not None
+        )
+
     def __init__(
         self,
         dsn: Optional[str] = None,
@@ -2586,11 +2596,58 @@ class PostgresTransaction(Transaction):
         self._operation_lock = _TaskReentrantLock()
         self._bootstrapped_collections: Set[str] = set()
         self._closing = False
+        # Freeze the tenant used when the held transaction was opened. Later
+        # ambient tenant changes cannot select a different logical lock scope.
+        self._lock_scope = (db.schema_name, current_tenant())
 
     def _ensure_active(self) -> None:
         if self._closing or not self.is_active or self._connection is None:
             raise DatabaseError("PostgreSQL transaction is no longer active")
 
+    @_serialized_transaction_operation
+    async def lock_record(
+        self, collection: str, record_id: str, *, shared: bool = False
+    ) -> Optional[Dict[str, Any]]:
+        """Read and lock one exact ID on the held, tenant-scoped connection."""
+        if not isinstance(record_id, str) or not record_id or type(shared) is not bool:
+            raise ValueError("A record ID and boolean shared mode are required")
+        col = _safe_collection(collection)
+        schema = _safe_collection(self._db.schema_name)
+        await self._db._bootstrap_collection(
+            collection,
+            connection=self._connection,
+            pending=self._bootstrapped_collections,
+        )
+        mode = "SHARE" if shared else "UPDATE"
+        row = await self._connection.fetchrow(
+            f"SELECT data FROM {schema}.{col} WHERE id=$1 FOR {mode}", record_id
+        )
+        return self._db._record_from_row(row) if row is not None else None
+
+    @_serialized_transaction_operation
+    async def advisory_lock(
+        self, namespace: str, key: str, *, shared: bool = False
+    ) -> None:
+        """Order cooperating logical-key users across connections and workers.
+
+        PostgreSQL scopes advisory locks to the database; schema and the opening
+        tenant are included in the bound namespace. Hash collisions can only
+        cause additional contention. Locks disappear on commit or rollback.
+        """
+        if (
+            not isinstance(namespace, str)
+            or not namespace
+            or not isinstance(key, str)
+            or not key
+            or type(shared) is not bool
+        ):
+            raise ValueError("A namespace, key and boolean shared mode are required")
+        function = "pg_advisory_xact_lock_shared" if shared else "pg_advisory_xact_lock"
+        scope = json.dumps([*self._lock_scope, namespace], separators=(",", ":"))
+        await self._connection.execute(
+            f"SELECT {function}(hashtext($1), hashtext($2))", scope, key
+        )
+
     @_serialized_transaction_operation
     async def save(self, collection: str, data: Dict[str, Any]) -> Dict[str, Any]:
         """Upsert ``data`` into ``collection`` within this transaction."""

{jvspatial-0.2.4 → jvspatial-0.2.5}/jvspatial/db/transaction.py

@@ -38,6 +38,27 @@ class Transaction(ABC):
         self.is_committed = False
         self.is_rolled_back = False
 
+    async def lock_record(
+        self, collection: str, record_id: str, *, shared: bool = False
+    ) -> Optional[Dict[str, Any]]:
+        """Lock an existing raw record until completion, without modifying it.
+
+        Shared peers may coexist; exclusive locks and record writes wait.
+        Missing records return None and are not protected against insertion.
+        Unsupported adapters refuse rather than claiming portable ordering.
+        """
+        raise NotImplementedError("This transaction does not support record locks")
+
+    async def advisory_lock(
+        self, namespace: str, key: str, *, shared: bool = False
+    ) -> None:
+        """Hold a cooperating logical-key lock until commit or rollback.
+
+        This does not lock records or grant application access. All logical
+        writers must participate; unsupported adapters explicitly refuse.
+        """
+        raise NotImplementedError("This transaction does not support advisory locks")
+
     @abstractmethod
     async def save(self, collection: str, data: Dict[str, Any]) -> Dict[str, Any]:
         """Save a record within this transaction.

{jvspatial-0.2.4 → jvspatial-0.2.5}/jvspatial/version.py

@@ -9,4 +9,4 @@ The GitHub Actions workflow will automatically create a git tag and publish to P
 # - MAJOR: Breaking changes
 # - MINOR: New features or breaking changes while pre-1.0
 # - PATCH: Bug fixes, backward compatible
-__version__ = "0.2.4"
+__version__ = "0.2.5"

{jvspatial-0.2.4 → jvspatial-0.2.5/jvspatial.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jvspatial
-Version: 0.2.4
+Version: 0.2.5
 Summary: An asynchronous object-spatial Python library for persistence and business logic application layers.
 Author-email: "TrueSelph Inc." <adminh@trueselph.com>
 License: MIT
@@ -48,14 +48,14 @@ Provides-Extra: pgvector
 Requires-Dist: asyncpg>=0.29.0; extra == "pgvector"
 Requires-Dist: pgvector>=0.2.5; extra == "pgvector"
 Provides-Extra: dev
-Requires-Dist: pytest<9.2,>=7.0; extra == "dev"
+Requires-Dist: pytest<9.3,>=7.0; extra == "dev"
 Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
 Requires-Dist: pytest-benchmark>=4.0.0; extra == "dev"
 Requires-Dist: httpx>=0.24.0; extra == "dev"
 Requires-Dist: pre-commit>=3.0.0; extra == "dev"
 Requires-Dist: python-dotenv>=1.0.0; extra == "dev"
 Provides-Extra: test
-Requires-Dist: pytest<9.2,>=7.0; extra == "test"
+Requires-Dist: pytest<9.3,>=7.0; extra == "test"
 Requires-Dist: pytest-asyncio>=0.21.0; extra == "test"
 Requires-Dist: pytest-cov>=4.0.0; extra == "test"
 Requires-Dist: pytest-benchmark>=4.0.0; extra == "test"

{jvspatial-0.2.4 → jvspatial-0.2.5}/jvspatial.egg-info/requires.txt

@@ -28,7 +28,7 @@ psutil>=5.9.0
 redis[hiredis]>=5.0.0
 
 [dev]
-pytest<9.2,>=7.0
+pytest<9.3,>=7.0
 pytest-asyncio>=0.21.0
 pytest-benchmark>=4.0.0
 httpx>=0.24.0
@@ -54,7 +54,7 @@ psutil>=5.9.0
 python-dotenv>=1.0.0
 
 [test]
-pytest<9.2,>=7.0
+pytest<9.3,>=7.0
 pytest-asyncio>=0.21.0
 pytest-cov>=4.0.0
 pytest-benchmark>=4.0.0

{jvspatial-0.2.4 → jvspatial-0.2.5}/pyproject.toml

@@ -68,7 +68,7 @@ pgvector = [
     "pgvector>=0.2.5",  # pgvector codec for asyncpg (HNSW/IVFFlat index support)
 ]
 dev = [
-    "pytest>=7.0,<9.2",  # pytest-benchmark 5.3 still uses the removed _nodeid API.
+    "pytest>=7.0,<9.3",  # pytest-benchmark 5.3 still uses the removed _nodeid API.
     "pytest-asyncio>=0.21.0",
     "pytest-benchmark>=4.0.0",
     "httpx>=0.24.0",
@@ -76,7 +76,7 @@ dev = [
     "python-dotenv>=1.0.0",
 ]
 test = [
-    "pytest>=7.0,<9.2",  # Keep the full suite and benchmark lane compatible.
+    "pytest>=7.0,<9.3",  # Keep the full suite and benchmark lane compatible.
     "pytest-asyncio>=0.21.0",
     "pytest-cov>=4.0.0",
     "pytest-benchmark>=4.0.0",