Merge pull request #67 from DataMini/release-please--branches--main--changes--next

release: 3.7.0

Author: frei-l

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "3.6.0"
+  ".": "3.7.0"
 }

.stats.yml

@@ -1,2 +1,2 @@
-configured_endpoints: 82
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/datamini%2Fasktable-8e9dc6bfba12f2eba83e978265436d2d6daabb89b04188ee749a32b3e2a6f55d.yml
+configured_endpoints: 90
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/datamini%2Fasktable-f4eb4b4f84901ac48b5fbfbde2712cf15833c5824a01aa2e164524465819a2e8.yml

CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## 3.7.0 (2024-12-16)
+
+Full Changelog: [v3.6.0...v3.7.0](https://github.com/DataMini/asktable-python/compare/v3.6.0...v3.7.0)
+
+### Features
+
+* **api:** api update ([#66](https://github.com/DataMini/asktable-python/issues/66)) ([6594f10](https://github.com/DataMini/asktable-python/commit/6594f1034b276bb3001540d114d02267c1794b6e))
+* **api:** api update ([#68](https://github.com/DataMini/asktable-python/issues/68)) ([5fe3dcb](https://github.com/DataMini/asktable-python/commit/5fe3dcb932fd23f19b086540e9fa9153da05760b))
+* **api:** api update ([#73](https://github.com/DataMini/asktable-python/issues/73)) ([76b3810](https://github.com/DataMini/asktable-python/commit/76b3810c6f74f12314041abff16e09052f2fa515))
+* **api:** manual updates ([#74](https://github.com/DataMini/asktable-python/issues/74)) ([2735ed4](https://github.com/DataMini/asktable-python/commit/2735ed4040e9b0d9adc0b46bc6cd9330269b8787))
+
+
+### Chores
+
+* **internal:** add support for TypeAliasType ([#70](https://github.com/DataMini/asktable-python/issues/70)) ([c0046ed](https://github.com/DataMini/asktable-python/commit/c0046ed398c750087a03659a92a10240e32d0829))
+* **internal:** bump pyright ([#69](https://github.com/DataMini/asktable-python/issues/69)) ([3bd5327](https://github.com/DataMini/asktable-python/commit/3bd5327773c10649284d0e95c55d9ba4a06c0ee4))
+* **internal:** codegen related update ([#71](https://github.com/DataMini/asktable-python/issues/71)) ([ef36085](https://github.com/DataMini/asktable-python/commit/ef3608545a5e58e405226176a907dab1b73fc9fd))
+* **internal:** codegen related update ([#72](https://github.com/DataMini/asktable-python/issues/72)) ([6a363c3](https://github.com/DataMini/asktable-python/commit/6a363c3cf0964cf648422dd06a13fb4fa7d98808))
+
 ## 3.6.0 (2024-12-10)
 
 Full Changelog: [v3.5.0...v3.6.0](https://github.com/DataMini/asktable-python/compare/v3.5.0...v3.6.0)

api.md

@@ -103,7 +103,7 @@ Methods:
 Types:
 
 ```python
-from asktable.types import Chat, Message
+from asktable.types import AIMessage, Chat, ToolMessage, UserMessage, ChatSendMessageResponse
 ```
 
 Methods:
@@ -112,15 +112,25 @@ Methods:
 - <code title="get /chats/{chat_id}">client.chats.<a href="./src/asktable/resources/chats/chats.py">retrieve</a>(chat_id) -> <a href="./src/asktable/types/chat.py">Chat</a></code>
 - <code title="get /chats">client.chats.<a href="./src/asktable/resources/chats/chats.py">list</a>(\*\*<a href="src/asktable/types/chat_list_params.py">params</a>) -> <a href="./src/asktable/types/chat.py">SyncPage[Chat]</a></code>
 - <code title="delete /chats/{chat_id}">client.chats.<a href="./src/asktable/resources/chats/chats.py">delete</a>(chat_id) -> None</code>
-- <code title="post /chats/{chat_id}">client.chats.<a href="./src/asktable/resources/chats/chats.py">send_message</a>(chat_id, \*\*<a href="src/asktable/types/chat_send_message_params.py">params</a>) -> <a href="./src/asktable/types/message.py">Message</a></code>
+- <code title="post /chats/{chat_id}">client.chats.<a href="./src/asktable/resources/chats/chats.py">send_message</a>(chat_id, \*\*<a href="src/asktable/types/chat_send_message_params.py">params</a>) -> <a href="./src/asktable/types/chat_send_message_response.py">ChatSendMessageResponse</a></code>
 
 ## Messages
 
+Types:
+
+```python
+from asktable.types.chats import (
+    MessageRetrieveResponse,
+    MessageListResponse,
+    MessageSendMessageResponse,
+)
+```
+
 Methods:
 
-- <code title="get /chats/{chat_id}/messages/{message_id}">client.chats.messages.<a href="./src/asktable/resources/chats/messages.py">retrieve</a>(message_id, \*, chat_id) -> <a href="./src/asktable/types/message.py">Message</a></code>
-- <code title="get /chats/{chat_id}/messages">client.chats.messages.<a href="./src/asktable/resources/chats/messages.py">list</a>(chat_id, \*\*<a href="src/asktable/types/chats/message_list_params.py">params</a>) -> <a href="./src/asktable/types/message.py">SyncPage[Message]</a></code>
-- <code title="post /chats/{chat_id}/messages">client.chats.messages.<a href="./src/asktable/resources/chats/messages.py">send_message</a>(chat_id, \*\*<a href="src/asktable/types/chats/message_send_message_params.py">params</a>) -> <a href="./src/asktable/types/message.py">Message</a></code>
+- <code title="get /chats/{chat_id}/messages/{message_id}">client.chats.messages.<a href="./src/asktable/resources/chats/messages.py">retrieve</a>(message_id, \*, chat_id) -> <a href="./src/asktable/types/chats/message_retrieve_response.py">MessageRetrieveResponse</a></code>
+- <code title="get /chats/{chat_id}/messages">client.chats.messages.<a href="./src/asktable/resources/chats/messages.py">list</a>(chat_id, \*\*<a href="src/asktable/types/chats/message_list_params.py">params</a>) -> <a href="./src/asktable/types/chats/message_list_response.py">SyncPage[MessageListResponse]</a></code>
+- <code title="post /chats/{chat_id}/messages">client.chats.messages.<a href="./src/asktable/resources/chats/messages.py">send_message</a>(chat_id, \*\*<a href="src/asktable/types/chats/message_send_message_params.py">params</a>) -> <a href="./src/asktable/types/chats/message_send_message_response.py">MessageSendMessageResponse</a></code>
 
 # Datasources
 
@@ -320,5 +330,51 @@ Methods:
 - <code title="post /business-glossary">client.business_glossary.<a href="./src/asktable/resources/business_glossary.py">create</a>(\*\*<a href="src/asktable/types/business_glossary_create_params.py">params</a>) -> <a href="./src/asktable/types/business_glossary_create_response.py">BusinessGlossaryCreateResponse</a></code>
 - <code title="get /business-glossary/{entry_id}">client.business_glossary.<a href="./src/asktable/resources/business_glossary.py">retrieve</a>(entry_id) -> <a href="./src/asktable/types/entry_with_definition.py">EntryWithDefinition</a></code>
 - <code title="patch /business-glossary/{entry_id}">client.business_glossary.<a href="./src/asktable/resources/business_glossary.py">update</a>(entry_id, \*\*<a href="src/asktable/types/business_glossary_update_params.py">params</a>) -> <a href="./src/asktable/types/entry.py">Entry</a></code>
-- <code title="get /business-glossary">client.business_glossary.<a href="./src/asktable/resources/business_glossary.py">list</a>(\*\*<a href="src/asktable/types/business_glossary_list_params.py">params</a>) -> <a href="./src/asktable/types/entry.py">SyncPage[Entry]</a></code>
+- <code title="get /business-glossary">client.business_glossary.<a href="./src/asktable/resources/business_glossary.py">list</a>(\*\*<a href="src/asktable/types/business_glossary_list_params.py">params</a>) -> <a href="./src/asktable/types/entry_with_definition.py">SyncPage[EntryWithDefinition]</a></code>
 - <code title="delete /business-glossary/{entry_id}">client.business_glossary.<a href="./src/asktable/resources/business_glossary.py">delete</a>(entry_id) -> <a href="./src/asktable/types/business_glossary_delete_response.py">object</a></code>
+
+# Preferences
+
+Types:
+
+```python
+from asktable.types import (
+    PreferenceCreateResponse,
+    PreferenceRetrieveResponse,
+    PreferenceUpdateResponse,
+    PreferenceDeleteResponse,
+)
+```
+
+Methods:
+
+- <code title="post /preference">client.preferences.<a href="./src/asktable/resources/preferences.py">create</a>(\*\*<a href="src/asktable/types/preference_create_params.py">params</a>) -> <a href="./src/asktable/types/preference_create_response.py">PreferenceCreateResponse</a></code>
+- <code title="get /preference">client.preferences.<a href="./src/asktable/resources/preferences.py">retrieve</a>() -> <a href="./src/asktable/types/preference_retrieve_response.py">PreferenceRetrieveResponse</a></code>
+- <code title="patch /preference">client.preferences.<a href="./src/asktable/resources/preferences.py">update</a>(\*\*<a href="src/asktable/types/preference_update_params.py">params</a>) -> <a href="./src/asktable/types/preference_update_response.py">PreferenceUpdateResponse</a></code>
+- <code title="delete /preference">client.preferences.<a href="./src/asktable/resources/preferences.py">delete</a>() -> <a href="./src/asktable/types/preference_delete_response.py">object</a></code>
+
+# Trainings
+
+Types:
+
+```python
+from asktable.types import TrainingCreateResponse, TrainingListResponse, TrainingDeleteResponse
+```
+
+Methods:
+
+- <code title="post /training">client.trainings.<a href="./src/asktable/resources/trainings.py">create</a>(\*\*<a href="src/asktable/types/training_create_params.py">params</a>) -> <a href="./src/asktable/types/training_create_response.py">TrainingCreateResponse</a></code>
+- <code title="get /training">client.trainings.<a href="./src/asktable/resources/trainings.py">list</a>(\*\*<a href="src/asktable/types/training_list_params.py">params</a>) -> <a href="./src/asktable/types/training_list_response.py">SyncPage[TrainingListResponse]</a></code>
+- <code title="delete /training/{id}">client.trainings.<a href="./src/asktable/resources/trainings.py">delete</a>(id, \*\*<a href="src/asktable/types/training_delete_params.py">params</a>) -> <a href="./src/asktable/types/training_delete_response.py">object</a></code>
+
+# Scores
+
+Types:
+
+```python
+from asktable.types import ScoreCreateResponse
+```
+
+Methods:
+
+- <code title="post /score">client.scores.<a href="./src/asktable/resources/scores.py">create</a>(\*\*<a href="src/asktable/types/score_create_params.py">params</a>) -> <a href="./src/asktable/types/score_create_response.py">ScoreCreateResponse</a></code>

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "asktable"
-version = "3.6.0"
+version = "3.7.0"
 description = "The official Python library for the asktable API"
 dynamic = ["readme"]
 license = "Apache-2.0"
@@ -10,7 +10,7 @@ authors = [
 dependencies = [
     "httpx>=0.23.0, <1",
     "pydantic>=1.9.0, <3",
-    "typing-extensions>=4.7, <5",
+    "typing-extensions>=4.10, <5",
     "anyio>=3.5.0, <5",
     "distro>=1.7.0, <2",
     "sniffio",

requirements-dev.lock

@@ -68,7 +68,7 @@ pydantic-core==2.27.1
     # via pydantic
 pygments==2.18.0
     # via rich
-pyright==1.1.389
+pyright==1.1.390
 pytest==8.3.3
     # via pytest-asyncio
 pytest-asyncio==0.24.0

src/asktable/_client.py

@@ -59,6 +59,9 @@ class Asktable(SyncAPIClient):
     caches: resources.CachesResource
     integration: resources.IntegrationResource
     business_glossary: resources.BusinessGlossaryResource
+    preferences: resources.PreferencesResource
+    trainings: resources.TrainingsResource
+    scores: resources.ScoresResource
     with_raw_response: AsktableWithRawResponse
     with_streaming_response: AsktableWithStreamedResponse
 
@@ -129,6 +132,9 @@ def __init__(
         self.caches = resources.CachesResource(self)
         self.integration = resources.IntegrationResource(self)
         self.business_glossary = resources.BusinessGlossaryResource(self)
+        self.preferences = resources.PreferencesResource(self)
+        self.trainings = resources.TrainingsResource(self)
+        self.scores = resources.ScoresResource(self)
         self.with_raw_response = AsktableWithRawResponse(self)
         self.with_streaming_response = AsktableWithStreamedResponse(self)
 
@@ -251,6 +257,9 @@ class AsyncAsktable(AsyncAPIClient):
     caches: resources.AsyncCachesResource
     integration: resources.AsyncIntegrationResource
     business_glossary: resources.AsyncBusinessGlossaryResource
+    preferences: resources.AsyncPreferencesResource
+    trainings: resources.AsyncTrainingsResource
+    scores: resources.AsyncScoresResource
     with_raw_response: AsyncAsktableWithRawResponse
     with_streaming_response: AsyncAsktableWithStreamedResponse
 
@@ -321,6 +330,9 @@ def __init__(
         self.caches = resources.AsyncCachesResource(self)
         self.integration = resources.AsyncIntegrationResource(self)
         self.business_glossary = resources.AsyncBusinessGlossaryResource(self)
+        self.preferences = resources.AsyncPreferencesResource(self)
+        self.trainings = resources.AsyncTrainingsResource(self)
+        self.scores = resources.AsyncScoresResource(self)
         self.with_raw_response = AsyncAsktableWithRawResponse(self)
         self.with_streaming_response = AsyncAsktableWithStreamedResponse(self)
 
@@ -444,6 +456,9 @@ def __init__(self, client: Asktable) -> None:
         self.caches = resources.CachesResourceWithRawResponse(client.caches)
         self.integration = resources.IntegrationResourceWithRawResponse(client.integration)
         self.business_glossary = resources.BusinessGlossaryResourceWithRawResponse(client.business_glossary)
+        self.preferences = resources.PreferencesResourceWithRawResponse(client.preferences)
+        self.trainings = resources.TrainingsResourceWithRawResponse(client.trainings)
+        self.scores = resources.ScoresResourceWithRawResponse(client.scores)
 
 
 class AsyncAsktableWithRawResponse:
@@ -461,6 +476,9 @@ def __init__(self, client: AsyncAsktable) -> None:
         self.caches = resources.AsyncCachesResourceWithRawResponse(client.caches)
         self.integration = resources.AsyncIntegrationResourceWithRawResponse(client.integration)
         self.business_glossary = resources.AsyncBusinessGlossaryResourceWithRawResponse(client.business_glossary)
+        self.preferences = resources.AsyncPreferencesResourceWithRawResponse(client.preferences)
+        self.trainings = resources.AsyncTrainingsResourceWithRawResponse(client.trainings)
+        self.scores = resources.AsyncScoresResourceWithRawResponse(client.scores)
 
 
 class AsktableWithStreamedResponse:
@@ -478,6 +496,9 @@ def __init__(self, client: Asktable) -> None:
         self.caches = resources.CachesResourceWithStreamingResponse(client.caches)
         self.integration = resources.IntegrationResourceWithStreamingResponse(client.integration)
         self.business_glossary = resources.BusinessGlossaryResourceWithStreamingResponse(client.business_glossary)
+        self.preferences = resources.PreferencesResourceWithStreamingResponse(client.preferences)
+        self.trainings = resources.TrainingsResourceWithStreamingResponse(client.trainings)
+        self.scores = resources.ScoresResourceWithStreamingResponse(client.scores)
 
 
 class AsyncAsktableWithStreamedResponse:
@@ -495,6 +516,9 @@ def __init__(self, client: AsyncAsktable) -> None:
         self.caches = resources.AsyncCachesResourceWithStreamingResponse(client.caches)
         self.integration = resources.AsyncIntegrationResourceWithStreamingResponse(client.integration)
         self.business_glossary = resources.AsyncBusinessGlossaryResourceWithStreamingResponse(client.business_glossary)
+        self.preferences = resources.AsyncPreferencesResourceWithStreamingResponse(client.preferences)
+        self.trainings = resources.AsyncTrainingsResourceWithStreamingResponse(client.trainings)
+        self.scores = resources.AsyncScoresResourceWithStreamingResponse(client.scores)
 
 
 Client = Asktable

src/asktable/_models.py

@@ -46,6 +46,7 @@
     strip_not_given,
     extract_type_arg,
     is_annotated_type,
+    is_type_alias_type,
     strip_annotated_type,
 )
 from ._compat import (
@@ -428,6 +429,8 @@ def construct_type(*, value: object, type_: object) -> object:
     # we allow `object` as the input type because otherwise, passing things like
     # `Literal['value']` will be reported as a type error by type checkers
     type_ = cast("type[object]", type_)
+    if is_type_alias_type(type_):
+        type_ = type_.__value__  # type: ignore[unreachable]
 
     # unwrap `Annotated[T, ...]` -> `T`
     if is_annotated_type(type_):

src/asktable/_response.py

@@ -25,7 +25,7 @@
 import pydantic
 
 from ._types import NoneType
-from ._utils import is_given, extract_type_arg, is_annotated_type, extract_type_var_from_base
+from ._utils import is_given, extract_type_arg, is_annotated_type, is_type_alias_type, extract_type_var_from_base
 from ._models import BaseModel, is_basemodel
 from ._constants import RAW_RESPONSE_HEADER, OVERRIDE_CAST_TO_HEADER
 from ._streaming import Stream, AsyncStream, is_stream_class_type, extract_stream_chunk_type
@@ -126,9 +126,15 @@ def __repr__(self) -> str:
         )
 
     def _parse(self, *, to: type[_T] | None = None) -> R | _T:
+        cast_to = to if to is not None else self._cast_to
+
+        # unwrap `TypeAlias('Name', T)` -> `T`
+        if is_type_alias_type(cast_to):
+            cast_to = cast_to.__value__  # type: ignore[unreachable]
+
         # unwrap `Annotated[T, ...]` -> `T`
-        if to and is_annotated_type(to):
-            to = extract_type_arg(to, 0)
+        if cast_to and is_annotated_type(cast_to):
+            cast_to = extract_type_arg(cast_to, 0)
 
         if self._is_sse_stream:
             if to:
@@ -164,18 +170,12 @@ def _parse(self, *, to: type[_T] | None = None) -> R | _T:
             return cast(
                 R,
                 stream_cls(
-                    cast_to=self._cast_to,
+                    cast_to=cast_to,
                     response=self.http_response,
                     client=cast(Any, self._client),
                 ),
             )
 
-        cast_to = to if to is not None else self._cast_to
-
-        # unwrap `Annotated[T, ...]` -> `T`
-        if is_annotated_type(cast_to):
-            cast_to = extract_type_arg(cast_to, 0)
-
         if cast_to is NoneType:
             return cast(R, None)
 

src/asktable/_utils/__init__.py

@@ -39,6 +39,7 @@
     is_iterable_type as is_iterable_type,
     is_required_type as is_required_type,
     is_annotated_type as is_annotated_type,
+    is_type_alias_type as is_type_alias_type,
     strip_annotated_type as strip_annotated_type,
     extract_type_var_from_base as extract_type_var_from_base,
 )