# This file was auto-generated by Fern from our API Definition. import typing from json.decoder import JSONDecodeError from ....core.api_error import ApiError from ....core.client_wrapper import AsyncClientWrapper, SyncClientWrapper from ....core.http_response import AsyncHttpResponse, HttpResponse from ....core.jsonable_encoder import jsonable_encoder from ....core.request_options import RequestOptions from ....core.serialization import convert_and_respect_annotation_metadata from ....core.unchecked_base_model import construct_type from ....errors.unprocessable_entity_error import UnprocessableEntityError from ....types.create_pronunciation_dictionary_response_model import CreatePronunciationDictionaryResponseModel from ....types.http_validation_error import HttpValidationError from ....types.pronunciation_dictionary_version_locator import PronunciationDictionaryVersionLocator # this is used as the default value for optional parameters OMIT = typing.cast(typing.Any, ...) class RawPronunciationDictionariesClient: def __init__(self, *, client_wrapper: SyncClientWrapper): self._client_wrapper = client_wrapper def create( self, project_id: str, *, pronunciation_dictionary_locators: typing.Sequence[PronunciationDictionaryVersionLocator], invalidate_affected_text: typing.Optional[bool] = OMIT, request_options: typing.Optional[RequestOptions] = None, ) -> HttpResponse[CreatePronunciationDictionaryResponseModel]: """ Create a set of pronunciation dictionaries acting on a project. This will automatically mark text within this project as requiring reconverting where the new dictionary would apply or the old one no longer does. Parameters ---------- project_id : str The ID of the project to be used. You can use the [List projects](/docs/api-reference/studio/get-projects) endpoint to list all the available projects. pronunciation_dictionary_locators : typing.Sequence[PronunciationDictionaryVersionLocator] A list of pronunciation dictionary locators (pronunciation_dictionary_id, version_id) encoded as a list of JSON strings for pronunciation dictionaries to be applied to the text. A list of json encoded strings is required as adding projects may occur through formData as opposed to jsonBody. To specify multiple dictionaries use multiple --form lines in your curl, such as --form 'pronunciation_dictionary_locators="{\\"pronunciation_dictionary_id\\":\\"Vmd4Zor6fplcA7WrINey\\",\\"version_id\\":\\"hRPaxjlTdR7wFMhV4w0b\\"}"' --form 'pronunciation_dictionary_locators="{\\"pronunciation_dictionary_id\\":\\"JzWtcGQMJ6bnlWwyMo7e\\",\\"version_id\\":\\"lbmwxiLu4q6txYxgdZqn\\"}"'. invalidate_affected_text : typing.Optional[bool] This will automatically mark text in this project for reconversion when the new dictionary applies or the old one no longer does. request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- HttpResponse[CreatePronunciationDictionaryResponseModel] Successful Response """ _response = self._client_wrapper.httpx_client.request( f"v1/studio/projects/{jsonable_encoder(project_id)}/pronunciation-dictionaries", method="POST", json={ "pronunciation_dictionary_locators": convert_and_respect_annotation_metadata( object_=pronunciation_dictionary_locators, annotation=typing.Sequence[PronunciationDictionaryVersionLocator], direction="write", ), "invalidate_affected_text": invalidate_affected_text, }, headers={ "content-type": "application/json", }, request_options=request_options, omit=OMIT, ) try: if 200 <= _response.status_code < 300: _data = typing.cast( CreatePronunciationDictionaryResponseModel, construct_type( type_=CreatePronunciationDictionaryResponseModel, # type: ignore object_=_response.json(), ), ) return HttpResponse(response=_response, data=_data) if _response.status_code == 422: raise UnprocessableEntityError( headers=dict(_response.headers), body=typing.cast( HttpValidationError, construct_type( type_=HttpValidationError, # type: ignore object_=_response.json(), ), ), ) _response_json = _response.json() except JSONDecodeError: raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text) raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json) class AsyncRawPronunciationDictionariesClient: def __init__(self, *, client_wrapper: AsyncClientWrapper): self._client_wrapper = client_wrapper async def create( self, project_id: str, *, pronunciation_dictionary_locators: typing.Sequence[PronunciationDictionaryVersionLocator], invalidate_affected_text: typing.Optional[bool] = OMIT, request_options: typing.Optional[RequestOptions] = None, ) -> AsyncHttpResponse[CreatePronunciationDictionaryResponseModel]: """ Create a set of pronunciation dictionaries acting on a project. This will automatically mark text within this project as requiring reconverting where the new dictionary would apply or the old one no longer does. Parameters ---------- project_id : str The ID of the project to be used. You can use the [List projects](/docs/api-reference/studio/get-projects) endpoint to list all the available projects. pronunciation_dictionary_locators : typing.Sequence[PronunciationDictionaryVersionLocator] A list of pronunciation dictionary locators (pronunciation_dictionary_id, version_id) encoded as a list of JSON strings for pronunciation dictionaries to be applied to the text. A list of json encoded strings is required as adding projects may occur through formData as opposed to jsonBody. To specify multiple dictionaries use multiple --form lines in your curl, such as --form 'pronunciation_dictionary_locators="{\\"pronunciation_dictionary_id\\":\\"Vmd4Zor6fplcA7WrINey\\",\\"version_id\\":\\"hRPaxjlTdR7wFMhV4w0b\\"}"' --form 'pronunciation_dictionary_locators="{\\"pronunciation_dictionary_id\\":\\"JzWtcGQMJ6bnlWwyMo7e\\",\\"version_id\\":\\"lbmwxiLu4q6txYxgdZqn\\"}"'. invalidate_affected_text : typing.Optional[bool] This will automatically mark text in this project for reconversion when the new dictionary applies or the old one no longer does. request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- AsyncHttpResponse[CreatePronunciationDictionaryResponseModel] Successful Response """ _response = await self._client_wrapper.httpx_client.request( f"v1/studio/projects/{jsonable_encoder(project_id)}/pronunciation-dictionaries", method="POST", json={ "pronunciation_dictionary_locators": convert_and_respect_annotation_metadata( object_=pronunciation_dictionary_locators, annotation=typing.Sequence[PronunciationDictionaryVersionLocator], direction="write", ), "invalidate_affected_text": invalidate_affected_text, }, headers={ "content-type": "application/json", }, request_options=request_options, omit=OMIT, ) try: if 200 <= _response.status_code < 300: _data = typing.cast( CreatePronunciationDictionaryResponseModel, construct_type( type_=CreatePronunciationDictionaryResponseModel, # type: ignore object_=_response.json(), ), ) return AsyncHttpResponse(response=_response, data=_data) if _response.status_code == 422: raise UnprocessableEntityError( headers=dict(_response.headers), body=typing.cast( HttpValidationError, construct_type( type_=HttpValidationError, # type: ignore object_=_response.json(), ), ), ) _response_json = _response.json() except JSONDecodeError: raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text) raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)