ceramic_ai 2.2.0__tar.gz → 2.3.0__tar.gz

ceramic_ai-2.3.0/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "2.3.0"
+}

{ceramic_ai-2.2.0 → ceramic_ai-2.3.0}/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 2.3.0 (2026-05-12)
+
+Full Changelog: [v2.2.0...v2.3.0](https://github.com/CeramicTeam/ceramic-python/compare/v2.2.0...v2.3.0)
+
+### Features
+
+* add maxDescriptionLength parameter ([8ea839c](https://github.com/CeramicTeam/ceramic-python/commit/8ea839c96d46ac2c60ad25e2c6e1da75c9f34c46))
+
 ## 2.2.0 (2026-05-12)
 
 Full Changelog: [v2.1.1...v2.2.0](https://github.com/CeramicTeam/ceramic-python/compare/v2.1.1...v2.2.0)

{ceramic_ai-2.2.0 → ceramic_ai-2.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: ceramic_ai
-Version: 2.2.0
+Version: 2.3.0
 Summary: The official Python library for the ceramic API
 Project-URL: Homepage, https://github.com/CeramicTeam/ceramic-python
 Project-URL: Repository, https://github.com/CeramicTeam/ceramic-python

{ceramic_ai-2.2.0 → ceramic_ai-2.3.0}/examples/smoke_tests/python_sdk_async_smoke.py

@@ -7,6 +7,7 @@ from ceramic_ai._exceptions import (
     CeramicError,
     APIStatusError,
     AuthenticationError,
+    UnprocessableEntityError,
 )
 
 # ---------------------------
@@ -148,29 +149,29 @@ async def ex_query_validation() -> None:
 #                 exc=BadRequestError,
 #             )
 
-# async def ex_max_description_length_validations() -> None:
-#     client = make_client()
-
-#     cases: Iterable[Tuple[str, int, bool]] = [
-#         ("zero", 0, False),
-#         ("small", 40, False),
-#         ("valid_small", 50, True),
-#         ("valid_default", 1500, True),
-#         ("very_large", 6000, False),
-#     ]
+async def ex_max_description_length_validations() -> None:
+    client = make_client()
 
-#     for name, mdl, is_valid in cases:
-#         label = f"max_description_length validation: {name} (max_description_length={mdl})"
-#         if is_valid:
-#             await expect_ok(label, lambda mdl=mdl: client.search(query="rate limits and retries", max_description_length=mdl))
-#         else:
-#             await expect_api_error(
-#                 label,
-#                 lambda mdl=mdl: client.search(query="rate limits and retries", max_description_length=mdl),
-#                 status=400,
-#                 code="invalid_parameter",
-#                 exc=BadRequestError,
-#             )
+    cases = [
+        ("zero",          0,    False),
+        ("below_min",     999,  False),
+        ("valid_min",     1000, True),
+        ("valid_default", 3000, True),
+        ("above_max",     8001, False),
+    ]
+
+    for name, mdl, is_valid in cases:
+        label = f"max_description_length validation: {name} (max_description_length={mdl})"
+        if is_valid:
+            await expect_ok(label, lambda mdl=mdl: client.search(query="rate limits and retries", max_description_length=mdl))
+        else:
+            await expect_api_error(
+                label,
+                lambda mdl=mdl: client.search(query="rate limits and retries", max_description_length=mdl),
+                status=422,
+                code="invalid_parameter",
+                exc=UnprocessableEntityError,
+            )
 
 
 async def main() -> None:
@@ -179,7 +180,7 @@ async def main() -> None:
         await ex_invalid_api_key()
         await ex_query_validation()
         # await ex_max_results_validations()
-        # await ex_max_description_length_validations()
+        await ex_max_description_length_validations()
     except CeramicError as e:
         print("\nCeramic SDK error (not an API status error):")
         print(str(e))

{ceramic_ai-2.2.0 → ceramic_ai-2.3.0}/examples/smoke_tests/python_sdk_smoke.py

@@ -6,6 +6,7 @@ from ceramic_ai._exceptions import (
     CeramicError,
     APIStatusError,
     AuthenticationError,
+    UnprocessableEntityError,
 )
 
 # ---------------------------
@@ -149,29 +150,29 @@ def ex_query_validation() -> None:
 #                 exc=BadRequestError,
 #             )
 
-# def ex_max_description_length_validations() -> None:
-#     client = make_client()
-
-#     cases: Iterable[Tuple[str, int, bool]] = [
-#         ("zero", 0, False),
-#         ("small", 40, False),
-#         ("valid_small", 50, True),
-#         ("valid_default", 1500, True),
-#         ("very_large", 6000, False),
-#     ]
+def ex_max_description_length_validations() -> None:
+    client = make_client()
 
-#     for name, mdl, is_valid in cases:
-#         label = f"max_description_length validation: {name} (max_description_length={mdl})"
-#         if is_valid:
-#             expect_ok(label, lambda mdl=mdl: client.search(query="rate limits and retries", max_description_length=mdl))
-#         else:
-#             expect_api_error(
-#                 label,
-#                 lambda mdl=mdl: client.search(query="rate limits and retries", max_description_length=mdl),
-#                 status=400,
-#                 code="invalid_parameter",
-#                 exc=BadRequestError,
-#             )
+    cases = [
+        ("zero",         0,    False),
+        ("below_min",    999,  False),
+        ("valid_min",    1000, True),
+        ("valid_default", 3000, True),
+        ("above_max",    8001, False),
+    ]
+
+    for name, mdl, is_valid in cases:
+        label = f"max_description_length validation: {name} (max_description_length={mdl})"
+        if is_valid:
+            expect_ok(label, lambda mdl=mdl: client.search(query="rate limits and retries", max_description_length=mdl))
+        else:
+            expect_api_error(
+                label,
+                lambda mdl=mdl: client.search(query="rate limits and retries", max_description_length=mdl),
+                status=422,
+                code="invalid_parameter",
+                exc=UnprocessableEntityError,
+            )
 
 
 def main() -> None:
@@ -180,7 +181,7 @@ def main() -> None:
         ex_invalid_api_key()
         ex_query_validation()
         # ex_max_results_validations()
-        # ex_max_description_length_validations()
+        ex_max_description_length_validations()
     except CeramicError as e:
         # This catches SDK configuration issues like missing env var, etc.
         print("\nCeramic SDK error (not an API status error):")

{ceramic_ai-2.2.0 → ceramic_ai-2.3.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "ceramic_ai"
-version = "2.2.0"
+version = "2.3.0"
 description = "The official Python library for the ceramic API"
 dynamic = ["readme"]
 license = "Apache-2.0"

{ceramic_ai-2.2.0 → ceramic_ai-2.3.0}/src/ceramic_ai/_client.py

@@ -212,7 +212,6 @@ class Ceramic(SyncAPIClient):
         *,
         query: str,
         max_description_length: int | Omit = omit,
-        max_results: int | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -227,9 +226,7 @@ class Ceramic(SyncAPIClient):
           query: The search query in keyword format. Must contain between 1 and 50 words (words
               are separated by spaces; extra whitespace is ignored).
 
-          max_description_length: Maximum character length for result descriptions.
-
-          max_results: Maximum number of results to return.
+          max_description_length: Maximum character length for each result's description.
 
           extra_headers: Send extra headers
 
@@ -247,7 +244,6 @@ class Ceramic(SyncAPIClient):
                 {
                     "query": query,
                     "max_description_length": max_description_length,
-                    "max_results": max_results,
                 },
                 client_search_params.ClientSearchParams,
             ),
@@ -444,7 +440,6 @@ class AsyncCeramic(AsyncAPIClient):
         *,
         query: str,
         max_description_length: int | Omit = omit,
-        max_results: int | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -459,9 +454,7 @@ class AsyncCeramic(AsyncAPIClient):
           query: The search query in keyword format. Must contain between 1 and 50 words (words
               are separated by spaces; extra whitespace is ignored).
 
-          max_description_length: Maximum character length for result descriptions.
-
-          max_results: Maximum number of results to return.
+          max_description_length: Maximum character length for each result's description.
 
           extra_headers: Send extra headers
 
@@ -480,7 +473,6 @@ class AsyncCeramic(AsyncAPIClient):
                 {
                     "query": query,
                     "max_description_length": max_description_length,
-                    "max_results": max_results,
                 },
                 client_search_params.ClientSearchParams,
             ),

{ceramic_ai-2.2.0 → ceramic_ai-2.3.0}/src/ceramic_ai/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "ceramic_ai"
-__version__ = "2.2.0"  # x-release-please-version
+__version__ = "2.3.0"  # x-release-please-version

{ceramic_ai-2.2.0 → ceramic_ai-2.3.0}/src/ceramic_ai/types/client_search_params.py

@@ -18,7 +18,4 @@ class ClientSearchParams(TypedDict, total=False):
     """
 
     max_description_length: Annotated[int, PropertyInfo(alias="maxDescriptionLength")]
-    """Maximum character length for result descriptions."""
-
-    max_results: Annotated[int, PropertyInfo(alias="maxResults")]
-    """Maximum number of results to return."""
+    """Maximum character length for each result's description."""

{ceramic_ai-2.2.0 → ceramic_ai-2.3.0}/tests/api_resources/test_client.py

@@ -30,8 +30,7 @@ class TestClient:
     def test_method_search_with_all_params(self, client: Ceramic) -> None:
         client_ = client.search(
             query="California rental laws",
-            max_description_length=1,
-            max_results=1,
+            max_description_length=1000,
         )
         assert_matches_type(SearchResponse, client_, path=["response"])
 
@@ -80,8 +79,7 @@ class TestAsyncClient:
     async def test_method_search_with_all_params(self, async_client: AsyncCeramic) -> None:
         client = await async_client.search(
             query="California rental laws",
-            max_description_length=1,
-            max_results=1,
+            max_description_length=1000,
         )
         assert_matches_type(SearchResponse, client, path=["response"])
 

ceramic_ai-2.2.0/.release-please-manifest.json

@@ -1,3 +0,0 @@
-{
-  ".": "2.2.0"
-}