beaver-db 0.6.2__py3-none-any.whl → 0.7.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of beaver-db might be problematic. Click here for more details.

@@ -4,7 +4,7 @@ import time
4
4
  from typing import Any, Iterator
5
5
 
6
6
 
7
- class SubWrapper(Iterator):
7
+ class ChannelManager(Iterator):
8
8
  """
9
9
  A synchronous, blocking iterator that polls a channel for new messages.
10
10
  """
@@ -25,7 +25,7 @@ class SubWrapper(Iterator):
25
25
  self._poll_interval = poll_interval
26
26
  self._last_seen_timestamp = time.time()
27
27
 
28
- def __iter__(self) -> "SubWrapper":
28
+ def __iter__(self) -> "ChannelManager":
29
29
  """Returns the iterator object itself."""
30
30
  return self
31
31
 
beaver/collections.py CHANGED
@@ -45,7 +45,7 @@ class Document:
45
45
  return f"Document(id='{self.id}', {metadata_str})"
46
46
 
47
47
 
48
- class CollectionWrapper:
48
+ class CollectionManager:
49
49
  """
50
50
  A wrapper for multi-modal collection operations with an in-memory ANN index,
51
51
  FTS, and graph capabilities.
beaver/core.py CHANGED
@@ -3,10 +3,10 @@ import sqlite3
3
3
  import time
4
4
  from typing import Any
5
5
 
6
- from .dicts import DictWrapper
7
- from .lists import ListWrapper
8
- from .subscribers import SubWrapper
9
- from .collections import CollectionWrapper
6
+ from .dicts import DictManager
7
+ from .lists import ListManager
8
+ from .channels import ChannelManager
9
+ from .collections import CollectionManager
10
10
 
11
11
 
12
12
  class BeaverDB:
@@ -152,21 +152,21 @@ class BeaverDB:
152
152
 
153
153
  # --- Factory and Passthrough Methods ---
154
154
 
155
- def dict(self, name: str) -> DictWrapper:
155
+ def dict(self, name: str) -> DictManager:
156
156
  """Returns a wrapper object for interacting with a named dictionary."""
157
157
  if not isinstance(name, str) or not name:
158
158
  raise TypeError("Dictionary name must be a non-empty string.")
159
- return DictWrapper(name, self._conn)
159
+ return DictManager(name, self._conn)
160
160
 
161
- def list(self, name: str) -> ListWrapper:
161
+ def list(self, name: str) -> ListManager:
162
162
  """Returns a wrapper object for interacting with a named list."""
163
163
  if not isinstance(name, str) or not name:
164
164
  raise TypeError("List name must be a non-empty string.")
165
- return ListWrapper(name, self._conn)
165
+ return ListManager(name, self._conn)
166
166
 
167
- def collection(self, name: str) -> CollectionWrapper:
167
+ def collection(self, name: str) -> CollectionManager:
168
168
  """Returns a wrapper for interacting with a document collection."""
169
- return CollectionWrapper(name, self._conn)
169
+ return CollectionManager(name, self._conn)
170
170
 
171
171
  def publish(self, channel_name: str, payload: Any):
172
172
  """Publishes a JSON-serializable message to a channel. This is synchronous."""
@@ -183,6 +183,6 @@ class BeaverDB:
183
183
  (time.time(), channel_name, json_payload),
184
184
  )
185
185
 
186
- def subscribe(self, channel_name: str) -> SubWrapper:
186
+ def subscribe(self, channel_name: str) -> ChannelManager:
187
187
  """Subscribes to a channel, returning a synchronous iterator."""
188
- return SubWrapper(self._conn, channel_name)
188
+ return ChannelManager(self._conn, channel_name)
beaver/dicts.py CHANGED
@@ -3,7 +3,7 @@ import sqlite3
3
3
  import time # Add this import
4
4
  from typing import Any, Iterator, Tuple
5
5
 
6
- class DictWrapper:
6
+ class DictManager:
7
7
  """A wrapper providing a Pythonic interface to a dictionary in the database."""
8
8
 
9
9
  def __init__(self, name: str, conn: sqlite3.Connection):
beaver/lists.py CHANGED
@@ -2,7 +2,7 @@ import json
2
2
  import sqlite3
3
3
  from typing import Any, Union, Iterator
4
4
 
5
- class ListWrapper:
5
+ class ListManager:
6
6
  """A wrapper providing a Pythonic, full-featured interface to a list in the database."""
7
7
 
8
8
  def __init__(self, name: str, conn: sqlite3.Connection):
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: beaver-db
3
- Version: 0.6.2
3
+ Version: 0.7.0
4
4
  Summary: Fast, embedded, and multi-modal DB based on SQLite for AI-powered applications.
5
5
  Requires-Python: >=3.13
6
6
  Description-Content-Type: text/markdown
@@ -180,6 +180,18 @@ listener_thread.join()
180
180
  publisher_thread.join()
181
181
  ```
182
182
 
183
+ ## Roadmap
184
+
185
+ These are some of the features and improvements planned for future releases:
186
+
187
+ - **Fuzzy search**: Implement fuzzy matching capabilities for text search.
188
+ - **Faster ANN**: Explore integrating more advanced ANN libraries like `faiss` for improved vector search performance.
189
+ - **Priority Queues**: Introduce a priority queue data structure for task management.
190
+ - **Improved Pub/Sub**: Fan-out implementation with a more Pythonic API.
191
+ - **Async API**: Comprehensive async support with on-demand wrappers for all collections.
192
+
193
+ Check out the [roadmap](roadmap.md) for a detailed list of upcoming features and design ideas.
194
+
183
195
  ## License
184
196
 
185
197
  This project is licensed under the MIT License.
@@ -0,0 +1,11 @@
1
+ beaver/__init__.py,sha256=-z5Gj6YKMOswpJOOn5Gej8z5i6k3c0Xs00DIYLA-bMI,75
2
+ beaver/channels.py,sha256=2lem2_yEFMc7cjdSx4FbFZQOaeT-HtbSvon3WYYRYzY,1952
3
+ beaver/collections.py,sha256=htlOnjQl8YwjNKkDsK74c805PQQO9Zq2kIhnKxekLds,15064
4
+ beaver/core.py,sha256=K_abD1RiAMT1jYv6T11fpckNljjqcotu3lkLkCz0bHg,6670
5
+ beaver/dicts.py,sha256=y4z632XKWU29ekP_vdFSOP-MAG9Z8b79kBEHA88gO7E,4463
6
+ beaver/lists.py,sha256=jFlDWwyaYycG0ZFVm58rMChefUaVZhaP1UeQ-hVo3Sg,9082
7
+ beaver_db-0.7.0.dist-info/licenses/LICENSE,sha256=1xrIY5JnMk_QDQzsqmVzPIIyCgZAkWCC8kF2Ddo1UT0,1071
8
+ beaver_db-0.7.0.dist-info/METADATA,sha256=MmlUva8ILoEMDdXyoujG1N-iGwMSScFuEx3qqF_vGyU,7196
9
+ beaver_db-0.7.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
10
+ beaver_db-0.7.0.dist-info/top_level.txt,sha256=FxA4XnX5Qm5VudEXCduFriqi4dQmDWpQ64d7g69VQKI,7
11
+ beaver_db-0.7.0.dist-info/RECORD,,
@@ -1,11 +0,0 @@
1
- beaver/__init__.py,sha256=-z5Gj6YKMOswpJOOn5Gej8z5i6k3c0Xs00DIYLA-bMI,75
2
- beaver/collections.py,sha256=II26aeXelbtfs0zkcHImvPDtoyDhPCCP8bsosEqoKvw,15064
3
- beaver/core.py,sha256=jRCItRw0JMCSjp8JDQZ07iv43IhrncYlczNGob20rp8,6661
4
- beaver/dicts.py,sha256=kahrUMFw3Y7jflHO97KSNa9V1scCBiI2P7TMFexFmD0,4463
5
- beaver/lists.py,sha256=b4C2eqzCCrugHiyxpKLNPbFE6nLetoFP-rYBjbnoFPk,9082
6
- beaver/subscribers.py,sha256=tCty2iDbeE9IXcPicbxj2CB5gqfLufMB9-nLQwqNBUU,1944
7
- beaver_db-0.6.2.dist-info/licenses/LICENSE,sha256=1xrIY5JnMk_QDQzsqmVzPIIyCgZAkWCC8kF2Ddo1UT0,1071
8
- beaver_db-0.6.2.dist-info/METADATA,sha256=tCzUm0a1-R5F8TCOENdJHtQv5c8be-cCCJYj2uO4YJo,6566
9
- beaver_db-0.6.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
10
- beaver_db-0.6.2.dist-info/top_level.txt,sha256=FxA4XnX5Qm5VudEXCduFriqi4dQmDWpQ64d7g69VQKI,7
11
- beaver_db-0.6.2.dist-info/RECORD,,