beaver-db 0.16.6__tar.gz → 0.16.7__tar.gz

{beaver_db-0.16.6 → beaver_db-0.16.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: beaver-db
-Version: 0.16.6
+Version: 0.16.7
 Summary: Fast, embedded, and multi-modal DB based on SQLite for AI-powered applications.
 License-File: LICENSE
 Classifier: License :: OSI Approved :: MIT License
@@ -26,6 +26,8 @@ A fast, single-file, multi-modal database for Python, built with the standard `s
 
 `beaver` is the **B**ackend for **E**mbedded, **A**ll-in-one **V**ector, **E**ntity, and **R**elationship storage. It's a simple, local, and embedded database designed to manage complex, modern data types without requiring a database server, built on top of SQLite.
 
+> If you like beaver's minimalist, no-bullshit philosophy, check out [castor](https://github.com/apiad/castor) for an equally minimalistic approach to task orchestration.
+
 ## Design Philosophy
 
 `beaver` is built with a minimalistic philosophy for small, local use cases where a full-blown database server would be overkill.

{beaver_db-0.16.6 → beaver_db-0.16.7}/README.md

@@ -11,6 +11,8 @@ A fast, single-file, multi-modal database for Python, built with the standard `s
 
 `beaver` is the **B**ackend for **E**mbedded, **A**ll-in-one **V**ector, **E**ntity, and **R**elationship storage. It's a simple, local, and embedded database designed to manage complex, modern data types without requiring a database server, built on top of SQLite.
 
+> If you like beaver's minimalist, no-bullshit philosophy, check out [castor](https://github.com/apiad/castor) for an equally minimalistic approach to task orchestration.
+
 ## Design Philosophy
 
 `beaver` is built with a minimalistic philosophy for small, local use cases where a full-blown database server would be overkill.

{beaver_db-0.16.6 → beaver_db-0.16.7}/beaver/queues.py

@@ -25,6 +25,12 @@ class AsyncQueueManager[T]:
         """Asynchronously adds an item to the queue with a specific priority."""
         await asyncio.to_thread(self._queue.put, data, priority)
 
+    async def peek(self) -> QueueItem[T] | None:
+        """
+        Asynchronously returns the first item without removing it, if any, otherwise returns None.
+        """
+        return await asyncio.to_thread(self._queue.peek)
+
     @overload
     async def get(self, block: Literal[True] = True, timeout: float | None = None) -> QueueItem[T]: ...
     @overload
@@ -77,7 +83,7 @@ class QueueManager[T]:
                 (self._name, priority, time.time(), self._serialize(data)),
             )
 
-    def _get_item_atomically(self) -> QueueItem[T] | None:
+    def _get_item_atomically(self, pop:bool=True) -> QueueItem[T] | None:
         """
         Performs a single, atomic attempt to retrieve and remove the
         highest-priority item from the queue. Returns None if the queue is empty.
@@ -100,12 +106,21 @@ class QueueManager[T]:
                 return None
 
             rowid, priority, timestamp, data = result
-            cursor.execute("DELETE FROM beaver_priority_queues WHERE rowid = ?", (rowid,))
+
+            if pop:
+                cursor.execute("DELETE FROM beaver_priority_queues WHERE rowid = ?", (rowid,))
 
             return QueueItem(
                 priority=priority, timestamp=timestamp, data=self._deserialize(data)
             )
 
+    def peek(self) -> QueueItem[T] | None:
+        """
+        Retrieves the first item of the queue.
+        If the queue is empy, returns None.
+        """
+        return self._get_item_atomically(pop=False)
+
     @overload
     def get(self, block: Literal[True] = True, timeout: float | None = None) -> QueueItem[T]: ...
     @overload

{beaver_db-0.16.6 → beaver_db-0.16.7}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "beaver-db"
-version = "0.16.6"
+version = "0.16.7"
 description = "Fast, embedded, and multi-modal DB based on SQLite for AI-powered applications."
 readme = "README.md"
 requires-python = ">=3.13"