lambdadb 0.7.0.dev0__tar.gz → 0.7.2__tar.gz

{lambdadb-0.7.0.dev0 → lambdadb-0.7.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lambdadb
-Version: 0.7.0.dev0
+Version: 0.7.2
 Summary: The Official LambdaDB Python SDK.
 License-File: LICENSE
 Author: Functional Systems, Inc.
@@ -152,8 +152,10 @@ with LambdaDB(
 ) as client:
     # Collection-scoped: no need to pass collection_name to every call
     coll = client.collection("my_collection")
-    docs = coll.docs.list()
-    results = coll.query(query={"queryString": {"query": "some text"}})
+    list_res = coll.docs.list()
+    items = list_res.results          # or list_res.documents for doc bodies only
+    res = coll.query(query={"queryString": {"query": "some text"}})
+    docs_only = res.documents         # document bodies; use res.results for score/metadata
     coll.docs.upsert(docs=[{"id": "1", "text": "hello"}])
 ```
 
@@ -220,6 +222,10 @@ with LambdaDB(
 
 **Recommended:** Use the collection-scoped API: `client.collection("name").docs.list()`, `.docs.fetch()`, `.docs.upsert()`, etc., and `client.collection("name").query()` for search. This matches the REST API structure and avoids repeating the collection name.
 
+* **Response access:** List, query, and fetch responses expose `.results` (full result items, with score/metadata when applicable) and `.documents` (document bodies only). When the API returns `is_docs_inline: false` with a presigned `docs_url`, the SDK automatically fetches from that URL so `response.results` and `response.documents` are always populated when using `coll.query()` and `coll.docs.fetch()`.
+* **Pagination:** Use `coll.docs.list_pages(size=10)` to iterate pages of up to `size` documents, or `coll.docs.iter_all(page_size=100)` to iterate over all documents.
+* **Advanced options:** Pass `options=RequestOptions(timeout_ms=..., http_headers=...)` to any docs or query call; import with `from lambdadb import RequestOptions`. For delete by filter, prefer `query_filter=...` over `filter_=...`. Response types such as `ListDocsResponse`, `QueryCollectionResponse`, and `FetchDocsResponse` are also exported from `lambdadb` for type hints.
+
 <details open>
 <summary>Available methods</summary>
 
@@ -235,9 +241,12 @@ with LambdaDB(
 #### [Collections.Docs](docs/sdks/docs/README.md)
 
 * [list_docs](docs/sdks/docs/README.md#list_docs) - List documents in a collection.
+* [list_pages](docs/sdks/docs/README.md#list_pages) - Iterate pages of up to `size` documents each.
+* [iter_all](docs/sdks/docs/README.md#iter_all) - Iterate over all documents (handles pagination).
 * [upsert](docs/sdks/docs/README.md#upsert) - Upsert documents into a collection. Note that the maximum supported payload size is 6MB.
 * [get_bulk_upsert](docs/sdks/docs/README.md#get_bulk_upsert) - Request required info to upload documents.
 * [bulk_upsert](docs/sdks/docs/README.md#bulk_upsert) - Bulk upsert documents into a collection. Note that the maximum supported object size is 200MB.
+* [bulk_upsert_docs](docs/sdks/docs/README.md#bulk_upsert_docs) - One-step bulk upsert: upload a list of documents without handling presigned URL or S3 yourself.
 * [update](docs/sdks/docs/README.md#update) - Update documents in a collection. Note that the maximum supported payload size is 6MB.
 * [delete](docs/sdks/docs/README.md#delete) - Delete documents by document IDs or query filter from a collection.
 * [fetch](docs/sdks/docs/README.md#fetch) - Lookup and return documents by document IDs from a collection.

{lambdadb-0.7.0.dev0 → lambdadb-0.7.2}/README.md

@@ -131,8 +131,10 @@ with LambdaDB(
 ) as client:
     # Collection-scoped: no need to pass collection_name to every call
     coll = client.collection("my_collection")
-    docs = coll.docs.list()
-    results = coll.query(query={"queryString": {"query": "some text"}})
+    list_res = coll.docs.list()
+    items = list_res.results          # or list_res.documents for doc bodies only
+    res = coll.query(query={"queryString": {"query": "some text"}})
+    docs_only = res.documents         # document bodies; use res.results for score/metadata
     coll.docs.upsert(docs=[{"id": "1", "text": "hello"}])
 ```
 
@@ -199,6 +201,10 @@ with LambdaDB(
 
 **Recommended:** Use the collection-scoped API: `client.collection("name").docs.list()`, `.docs.fetch()`, `.docs.upsert()`, etc., and `client.collection("name").query()` for search. This matches the REST API structure and avoids repeating the collection name.
 
+* **Response access:** List, query, and fetch responses expose `.results` (full result items, with score/metadata when applicable) and `.documents` (document bodies only). When the API returns `is_docs_inline: false` with a presigned `docs_url`, the SDK automatically fetches from that URL so `response.results` and `response.documents` are always populated when using `coll.query()` and `coll.docs.fetch()`.
+* **Pagination:** Use `coll.docs.list_pages(size=10)` to iterate pages of up to `size` documents, or `coll.docs.iter_all(page_size=100)` to iterate over all documents.
+* **Advanced options:** Pass `options=RequestOptions(timeout_ms=..., http_headers=...)` to any docs or query call; import with `from lambdadb import RequestOptions`. For delete by filter, prefer `query_filter=...` over `filter_=...`. Response types such as `ListDocsResponse`, `QueryCollectionResponse`, and `FetchDocsResponse` are also exported from `lambdadb` for type hints.
+
 <details open>
 <summary>Available methods</summary>
 
@@ -214,9 +220,12 @@ with LambdaDB(
 #### [Collections.Docs](docs/sdks/docs/README.md)
 
 * [list_docs](docs/sdks/docs/README.md#list_docs) - List documents in a collection.
+* [list_pages](docs/sdks/docs/README.md#list_pages) - Iterate pages of up to `size` documents each.
+* [iter_all](docs/sdks/docs/README.md#iter_all) - Iterate over all documents (handles pagination).
 * [upsert](docs/sdks/docs/README.md#upsert) - Upsert documents into a collection. Note that the maximum supported payload size is 6MB.
 * [get_bulk_upsert](docs/sdks/docs/README.md#get_bulk_upsert) - Request required info to upload documents.
 * [bulk_upsert](docs/sdks/docs/README.md#bulk_upsert) - Bulk upsert documents into a collection. Note that the maximum supported object size is 200MB.
+* [bulk_upsert_docs](docs/sdks/docs/README.md#bulk_upsert_docs) - One-step bulk upsert: upload a list of documents without handling presigned URL or S3 yourself.
 * [update](docs/sdks/docs/README.md#update) - Update documents in a collection. Note that the maximum supported payload size is 6MB.
 * [delete](docs/sdks/docs/README.md#delete) - Delete documents by document IDs or query filter from a collection.
 * [fetch](docs/sdks/docs/README.md#fetch) - Lookup and return documents by document IDs from a collection.

{lambdadb-0.7.0.dev0 → lambdadb-0.7.2}/pyproject.toml

@@ -1,7 +1,7 @@
 
 [project]
 name = "lambdadb"
-version = "0.7.0.dev0"
+version = "0.7.2"
 description = "The Official LambdaDB Python SDK."
 authors = [{ name = "Functional Systems, Inc." },]
 readme = "README.md"
@@ -31,13 +31,13 @@ in-project = true
 mypy = "==1.15.0"
 pylint = "==3.2.3"
 pyright = "==1.1.398"
+pytest = ">=7.0"
 
 [build-system]
 requires = ["poetry-core"]
 build-backend = "poetry.core.masonry.api"
 
 [tool.pytest.ini_options]
-asyncio_default_fixture_loop_scope = "function"
 pythonpath = ["src"]
 
 [tool.mypy]

lambdadb-0.7.2/src/lambdadb/__init__.py

@@ -0,0 +1,30 @@
+"""LambdaDB Python client package exports."""
+
+from .version import (
+    GEN_VERSION as _GEN_VERSION,
+    OPENAPI_DOC_VERSION as _OPENAPI_DOC_VERSION,
+    TITLE as _TITLE,
+    get_user_agent,
+    get_version,
+)
+from .sdk import *
+from .sdkconfiguration import *
+from .collection import RequestOptions
+from .models import (
+    FetchDocsResponse,
+    ListDocsResponse,
+    QueryCollectionResponse,
+)
+
+
+VERSION: str = get_version()
+OPENAPI_DOC_VERSION = _OPENAPI_DOC_VERSION
+SPEAKEASY_GENERATOR_VERSION = _GEN_VERSION
+USER_AGENT = get_user_agent()
+
+# Backward-compatible legacy exports
+__title__ = _TITLE
+__version__ = VERSION
+__openapi_doc_version__ = OPENAPI_DOC_VERSION
+__gen_version__ = SPEAKEASY_GENERATOR_VERSION
+__user_agent__ = USER_AGENT