a !f#@sDdZddlZddlZddlmZddlmZdZGdddeZ dS)z;Client for interacting with the Google Cloud Translate API.N _to_bytes) Connectionenc@s:eZdZdZdefddZd ddZddZd d d ZdS)ClientalClient to bundle configuration needed for API requests. :type api_key: str :param api_key: The key used to send with requests as a query parameter. :type http: :class:`httplib2.Http` or class that defines ``request()``. :param http: (Optional) HTTP object to make requests. If not passed, an :class:`httplib.Http` object is created. :type target_language: str :param target_language: (Optional) The target language used for translations and language names. (Defaults to :data:`ENGLISH_ISO_639`.) NcCs,||_|durt}t|d|_||_dS)N)http)api_keyhttplib2ZHttpr connectiontarget_language)selfrrr r X/var/www/html/python-backend/venv/lib/python3.9/site-packages/gcloud/translate/client.py__init__.s  zClient.__init__cCsNd|ji}|dur|j}|dur(||d<|jjdd|d}|didd S) a&Get list of supported languages for translation. Response See: https://cloud.google.com/translate/v2/ discovering-supported-languages-with-rest :type target_language: str :param target_language: (Optional) The language used to localize returned language names. Defaults to the target language on the current client. :rtype: list :returns: List of dictionaries. Each dictionary contains a supported ISO 639-1 language code (using the dictionary key ``language``). If ``target_language`` is passed, each dictionary will also contain the name of each supported language (localized to the target language). keyNtargetGETz /languagesmethodpath query_paramsdata languagesr )rr r api_requestget)r r rresponser r r get_languages5s zClient.get_languagesc Csd}t|tjrd}|g}d|jfg}|dd|D|jjdd|d}|d id d }t|t|kr|t d ||t |D]h\}}t||d kr||d||<n"dt||f}t |||||||d<|| ddq|r|dS|SdS)aDetect the language of a string or list of strings. See: https://cloud.google.com/translate/v2/ detecting-language-with-rest :type values: str or list :param values: String or list of strings that will have language detected. :rtype: str or list :returns: A list of dictionaries for each queried value. Each dictionary typically contains three keys * ``confidence``: The confidence in language detection, a float between 0 and 1. * ``input``: The corresponding input value. * ``language``: The detected language (as an ISO 639-1 language code). though the key ``confidence`` may not always be present. If only a single value is passed, then only a single dictionary will be returned. :raises: :class:`ValueError ` if the number of detections is not equal to the number of values. :class:`ValueError ` if a value produces a list of detections with 0 or multiple results in it. FTrcss|]}dt|dfVqdSqzutf-8Nr.0valuer r r vsz)Client.detect_language..rz/detectrr detectionsr z-Expected same number of values and detectionsrz6Expected a single detection per value, API returned %dinputZ isReliableN) isinstancesix string_typesrextendr rrlen ValueError enumeratepop) r values single_valuerrr#indexr!messager r rdetect_languageRs8     zClient.detect_languager c Csd}t|tjrd}|g}|dur(|j}t|tjr:|g}d|jfd|fg}|dd|D|dd|D|dur|d |f|dur|d |f|jjd d |d }| di dd} t |t | krt d|| tj || D]\} } | | d<q|r| dS| SdS)a9Translate a string or list of strings. See: https://cloud.google.com/translate/v2/ translating-text-with-rest :type values: str or list :param values: String or list of strings to translate. :type target_language: str :param target_language: The language to translate results into. This is required by the API and defaults to the target language of the current instance. :type format_: str :param format_: (Optional) One of ``text`` or ``html``, to specify if the input text is plain text or HTML. :type source_language: str :param source_language: (Optional) The language of the text to be translated. :type customization_ids: str or list :param customization_ids: (Optional) ID or list of customization IDs for translation. Sets the ``cid`` parameter in the query. :rtype: str or list list :returns: A list of dictionaries for each queried value. Each dictionary typically contains three keys (though not all will be present in all cases) * ``detectedSourceLanguage``: The detected language (as an ISO 639-1 language code) of the text. * ``translatedText``: The translation of the text into the target language. * ``input``: The corresponding input value. If only a single value is passed, then only a single dictionary will be returned. :raises: :class:`ValueError ` if the number of values and translations differ. FTNrrcss|]}dt|dfVqdSrrrr r rr"sz#Client.translate..css|]}d|fVqdS)cidNr )r r3r r rr"formatsourcerrr translationsr z'Expected iterations to have same lengthr%r)r&r'r(r rr)appendr rrr*r+moveszip) r r.r Zformat_Zsource_languageZcustomization_idsr/rrr8r! translationr r r translates<,    zClient.translate)N)NNNr ) __name__ __module__ __qualname____doc__ENGLISH_ISO_639rrr2r=r r r rrs Br) rAr r'Zgcloud._helpersrZgcloud.translate.connectionrrBobjectrr r r rs