FgݟSSKJrJrJrJrJrJrJrJrJ r SSK J r J r SSK JrJrJrJrJrJrJr SSKrSSKrSSKrSSKrSSKrSSKrSSKrSSKJrJrJ r J!r!J"r"J#r#J$r$J%r%J&r& SSK'r("SS5r)g) ) DocumentHandleDocumentStatus Formality GlossaryInfoGlossaryLanguagePairLanguageSplitSentences TextResultUsage) http_clientutil)DocumentNotReadyExceptionGlossaryNotFoundExceptionQuotaExceededExceptionTooManyRequestsExceptionDeepLExceptionAuthorizationExceptionDocumentTranslationExceptionN) AnyBinaryIODictIterableListOptionalTextIOTupleUnionc \rSrSrSrSrSrSrSSSSSS .S \S \ \S \ \ \S4S \ S\ \ \S4S\ 4 Sjjr SrSSSSSS.S\S\S\ \S\ \S\ S\ \S\\\ \\R&4\44SjjrSYS\S\ \\R&4S\S\ S\ 4 S jjrS!\ \S"\4S#jrSZS!\ \\S4S"\ \\4S$\ \\S4S\ \\S4S\4 S%jjrS&\S!\ \\4S"\ \\4S'\S(\ \\4S\4 S)jrS*rS+\S,\4S-jr\ S.5r!SSSSSSSSSSSS/. S0\ \\"\4S!\ \\S4S"\ \\4S1\ \S2\ \\#S4S3\ \ S$\ \\S4S\ \\S4S4\ \S5\ \ S6\ \\$\S4S7\ \\$\S4S8\ \\$\S4S\ \%\$\%44S9jjr&SZS0\ \\"\4S\S"\ \\S4S\ \%\$\%44S:jjr'S\RPSS;.S<\ \\)RT4S=\ \\)RT4S!\ \S"\S$\ \\4S\ \\S4S\+4S>jjr,S\RPSSSS?.S@\ \-\.\4SA\ \-\.\4S!\ \S"\S$\ \\4S\ \\S4SB\ \SC\ \S\+4SDjjr/SSSSSS?.S@\ \-\.\\\4S!\ \S"\S$\ \\S4S\ \\S4SB\ \SC\ \S\04SEjjr1SF\0S\+4SGjr2SF\0S\+4SHjr3S[SF\0SI\ \-\.\S4SJ\S\ \R&4SKjjr4S\S\$\4SLjjr5S\S\$\4SMjjr6S\$\74SNjr8S\94SOjr:S&\S!\ \\4S"\ \\4S(\ \\4S\4 SPjr;S&\S!\ \\4S"\ \\4SQ\ \-\.\\\4S\4 SRjrS\ \\4S\4SVjr?S\ \\4SS4SWjr@SXrAg)] Translator/aWrapper for the DeepL API for language translation. You must create an instance of Translator to use the DeepL API. :param auth_key: Authentication key as found in your DeepL API account. :param server_url: (Optional) Base URL of DeepL API, can be overridden e.g. for testing purposes. :param proxy: (Optional) Proxy server URL string or dictionary containing URL strings for the 'http' and 'https' keys. This is passed to the underlying requests session, see the requests proxy documentation for more information. :param send_platform_info: (Optional) boolean that indicates if the client library can send basic platform info (python version, OS, http library version) to the DeepL API. True = send info, False = only send client library version :param verify_ssl: (Optional) Controls how requests verifies SSL certificates. This is passed to the underlying requests session, see the requests verify documentation for more information. :param skip_language_check: Deprecated, and now has no effect as the corresponding internal functionality has been removed. This parameter will be removed in a future version. All functions may raise DeepLException or a subclass if a connection error occurs. zhttps://api.deepl.comzhttps://api-free.deepl.comiNTF) server_urlproxysend_platform_info verify_sslskip_language_checkauth_keyr"r#r$r%r&cU(d [S5eUc3[R"U5(a URO URnX l[ R"X4U5UlSSU30Ul g)Nzauth_key must not be empty AuthorizationzDeepL-Auth-Key ) ValueErrorrauth_key_is_free_account_DEEPL_SERVER_URL_FREE_DEEPL_SERVER_URL _server_urlr HttpClient_clientheaders)selfr'r"r#r$r%r&s a/Users/admin/workspace/ai/PDFMathTranslate/myenv/lib/python3.13/site-packages/deepl/translator.py__init__Translator.__init__Qsy9: :  00::++++  &"-- z  (?8*)EF c$UR5 gN)closer2s r3__del__Translator.__del__ks  r6POST)methoddatajsonstreamr1urlr>r?r@rAr1returnc UbUb [S5eUc0n[RRURU5n[ R "SX!S9 [ R"SX4S9 Uc [5nURURR5VV s0sHupX;dM X_M sn n5 URR"UU4UUUUS.UD6upSn[U [5(aU n [ R""U 5nO U R&n [ R "SXS 9 [ R"S U S 9 XU4$s sn nf![ R$a NJf=f) z[ Makes a request to the API, and returns response as status code, content and JSON object. Nz cannot accept both json and datazRequest to DeepL API)r>rBzRequest details)r?r@)r?r@rAr1zDeepL API response)rB status_codezResponse details)content)r*urllibparseurljoinr.rlog_info log_debugdictupdater1itemsr0request_with_backoff isinstancestr json_moduleloadsJSONDecodeErrortext) r2rBr>r?r@rAr1kwargskvrErF content_strs r3 _api_callTranslator._api_callnsa   0?@ @ <Dll""4#3#3S9 ,VE (t? ?fG"ll002 G2daa6FTQT2 G  $||@@        gs # #!K "((1",,K *M );?T))5 H$..  s E /E <EE*)E*rErFglossarydownloading_documentc SnUb&[U[5(aSU;a USUS-- nUb&[U[5(aSU;a USUS-- nSUs=::aS:ag U[RR:Xa [ SU3US 9eXR :Xa [S U3US 9eU[RR:Xa!U(a [S U3US 9e[S U3US 9eU[RR:Xa [S U3US 9eU[RR:Xa[SU3SUS9eU[RR:Xa#U(a[SU3SUS9e[SU3SUS9eU[R R";a[R R"UOSn[U[$5(aUO UR&n[SUSUSUS3SUS9e)Nmessagez , message: detailz , detail: iz%Authorization failure, check auth_keyhttp_status_codez/Quota for this billing period has been exceededzGlossary not foundzNot found, check server_urlz Bad requestzEToo many requests, DeepL servers are currently experiencing high loadT) should_retryrdzDocument not readyzService unavailableUnknownzUnexpected status code:  z , content: .F)rPrLhttp HTTPStatus FORBIDDENr_HTTP_STATUS_QUOTA_EXCEEDEDr NOT_FOUNDrr BAD_REQUESTTOO_MANY_REQUESTSrSERVICE_UNAVAILABLErclient responsesrQrU) r2rErFr@r\r]r` status_namerYs r3_raise_for_statusTranslator._raise_for_statussH   4 6 69;L }tI6 6G   4 6 68t;K |d8n4 4G + # #  $ DOO55 5(7yA!, << <(A'K!, DOO55 5/( 2%0!-gY7!, DOO77 7 gY'+ DOO== =*#9&!!,   DOO?? ?#/( 2!%%0 %)'3!%%0$++"7"77 %%k2  &0%=%='7<[ R "U5UR:wdXR:wa [S5eURX5 SU0nUbXS'Ub[U5R5US'[U[5(aURUS'U$UbXES'U$)Nz+source_lang is required if using a glossaryz/source_lang and target_lang must match glossaryrwrvr} glossary_id) rQupperr*rPrrremove_regional_variantrwrvr{lowerr)r2rvrwr}r\ request_datas r3_check_language_and_formality(Translator._check_language_and_formalitys +&,,.  "k*002K  K$7JK K h - -00=''("6"66 E ##K=%{3  "*5 '  (+I(<(<(>L % h - -*2*>*>L ' !*2 'r6nameentries_formatentriesc[R"U5n[R"U5nU(d [S5eUUUUUS.nURSUS9upxn UR XxU SS9 [ R "U 5$)Nzglossary name must not be empty)rrvrwrr v2/glossariesr@Tr\)rrr*rZrtr from_json) r2rrvrwrrrstatusrFr@s r3_create_glossaryTranslator._create_glossary%s66{C 66{C >? ?&&,  !% ,!/!  vtD%%d++r6c\[US5(aURR5 gg)Nr0)hasattrr0r9r:s r3r9Translator.closeBs$ 4 # # LL    $r6 app_info_nameapp_info_versionc<URRX5 U$r8)r0 set_app_info)r2rrs r3rTranslator.set_app_infoFs !!-B r6cUR$r8)r.r:s r3r"Translator.server_urlJsr6) rvcontextsplit_sentencespreserve_formattingr}r\ tag_handlingoutline_detectionnon_splitting_tagssplitting_tags ignore_tagsrUrrrrrrrrc [U[5(a [U5S:Xa [S5eU/nSnO*[ US5(aSn[ U5nO [ S5eURUUUU5nXS'UbXOS'Ub[U5US 'Ub[U5US 'U bXS 'U b[U 5US 'S [[[[4S[[4SjnU b U"U 5US'U b U"U 5US'U b U"U 5US'URSUS9unnnURUUU5 U(a'[U[5(aURS/5O/n/nUHRnU(aURSS5OSnU(aURSS5OSnUR![#UUS95 MT U(aU$US$)aTranslate text(s) into the target language. :param text: Text to translate. :type text: UTF-8 :class:`str`; string sequence (list, tuple, iterator, generator) :param source_lang: (Optional) Language code of input text, for example "DE", "EN", "FR". If omitted, DeepL will auto-detect the input language. If a glossary is used, source_lang must be specified. :param target_lang: language code to translate text into, for example "DE", "EN-US", "FR". :param context: (Optional) Additional contextual text to influence translations, that is not translated itself. Note: this is an alpha feature: it may be deprecated at any time, or incur charges if it becomes generally available. See the API documentation for more information and example usage. :param split_sentences: (Optional) Controls how the translation engine should split input into sentences before translation, see :class:`SplitSentences`. :param preserve_formatting: (Optional) Set to True to prevent the translation engine from correcting some formatting aspects, and instead leave the formatting unchanged. :param formality: (Optional) Desired formality for translation, as Formality enum, "less", "more", "prefer_less", "prefer_more", or "default". :param glossary: (Optional) glossary or glossary ID to use for translation. Must match specified source_lang and target_lang. :param tag_handling: (Optional) Type of tags to parse before translation, only "xml" and "html" are currently available. :param outline_detection: (Optional) Set to False to disable automatic tag detection. :param non_splitting_tags: (Optional) XML tags that should not split a sentence. :type non_splitting_tags: List of XML tags or comma-separated-list of tags. :param splitting_tags: (Optional) XML tags that should split a sentence. :type splitting_tags: List of XML tags or comma-separated-list of tags. :param ignore_tags: (Optional) XML tags containing text that should not be translated. :type ignore_tags: List of XML tags or comma-separated-list of tags. :return: List of TextResult objects containing results, unless input text was one string, then a single TextResult object is returned. rztext must not be emptyF__iter__Tz9text parameter must be a string or an iterable of stringsrUrrrrr tag_argumentrCc[U[5(aU/nUVVs/sHnURS5HnUPM M snn$s snnf)N,)rPrQsplit)r arg_stringtags r3 join_tags,Translator.translate_text..join_tagssU,,, ,~ #/".J%++C0C0". s%Arrrz v2/translater translationsr_detected_source_language)detected_source_lang)rPrQlenr*rlist TypeErrorrboolrrrrZrtrLgetappendr )r2rUrvrwrrrr}r\rrrrr multi_inputrrrrFr@routput translationlangs r3translate_textTranslator.translate_textNsx dC 4yA~ !9::6DK T: & &K:DK 99      $V  &- #  &.1/.BL* +  *267J2KL. /  #+7 (  (045F0GL, - E#x}*<$= $s)   )1:;M1NL- .  %-6~-FL) *  "*3K*@L ' $ !/!  vw5D$// HH^R (  'K2=;??62.2D :B?  MM*TE F(%v3&)3r6c [U[5(d Sn[U5eUcURnUS:XaSnUR"U4UR UUS.UD6$)aTranslate text(s) using given glossary. The source and target languages are assumed to match the glossary languages. Note that if the glossary target language is English (EN), the text will be translated into British English (EN-GB). To instead translate into American English specify target_lang="EN-US". :param text: Text to translate. :type text: UTF-8 :class:`str`; string sequence (list, tuple, iterator, generator) :param glossary: glossary to use for translation. :type glossary: :class:`GlossaryInfo`. :param target_lang: override target language of glossary. :return: List of TextResult objects containing results, unless input text was one string, then a single TextResult object is returned. a This function expects the glossary parameter to be an instance of GlossaryInfo. Use get_glossary() to obtain a GlossaryInfo using the glossary ID of an existing glossary. Alternatively, use translate_text() and specify the glossary ID using the glossary parameter. ryzEN-GB)rvrwr\)rPrr*rwrrv)r2rUr\rwrVmsgs r3translate_text_with_glossary'Translator.translate_text_with_glossarysz0(L11I S/ !  "..Kd"% ""   ,,#     r6)rvr}r\ input_path output_pathc "[R"U5RR5n[R"U5RR5nXx:XaSOUSSn [ US5n [ US5n UR U U UUUUU S9sSSS5 sSSS5 $![ a-n U R5 [R"U5 U eSn A ff=f!,(df  O=fSSS5 g!,(df  g=f)aUpload document at given input path, translate it into the target language, and download result to given output path. :param input_path: Path to document to be translated. :param output_path: Path to store translated document. :param source_lang: (Optional) Language code of input document, for example "DE", "EN", "FR". If omitted, DeepL will auto-detect the input language. :param target_lang: Language code to translate document into, for example "DE", "EN-US", "FR". :param formality: (Optional) Desired formality for translation, as Formality enum, "less", "more", "prefer_less", or "prefer_more". :param glossary: (Optional) glossary or glossary ID to use for translation. Must match specified source_lang and target_lang. :return: DocumentStatus when document translation completed, this allows the number of billed characters to be queried. :raises DocumentTranslationException: If an error occurs during translation. The exception includes information about the document request. Nr rbwb)rwrvr}r\ output_format) pathlibPurePathsuffixropentranslate_document Exceptionr9osunlink) r2rrrvrwr}r\in_extout_extrin_fileout_filees r3 translate_document_from_filepath+Translator.translate_document_from_filepaths@!!*-44::<"";/66<<> & 1wqr{ *d #wk4(H 22 $/$/"+!)&33)($ #!NN$IIk*G)(($ # #sB5 DC%B+ D+ C"5(CC""C%% C3 /D D)rvr}r\filenamerinput_documentoutput_documentrrc RURUUUUUUUS9n URU 5n U R(aURX5 U R(d$U R=(d Sn [ SU 3U 5eU $![an [ [ U 5U 5U eSn A ff=f)aUpload document, translate it into the target language, and download result. :param input_document: Document to translate as a file-like object. It is recommended to open files in binary mode. :param output_document: File-like object to receive translated document. :param source_lang: (Optional) Language code of input document, for example "DE", "EN", "FR". If omitted, DeepL will auto-detect the input language. :param target_lang: Language code to translate document into, for example "DE", "EN-US", "FR". :param formality: (Optional) Desired formality for translation, as Formality enum, "less", "more", "prefer_less", or "prefer_more". :param glossary: (Optional) glossary or glossary ID to use for translation. Must match specified source_lang and target_lang. :param filename: (Optional) Filename including extension, only required if uploading string or bytes containing file content. :param output_format: (Optional) Desired output file extension, if it differs from the input file format. :return: DocumentStatus when document translation completed, this allows the number of billed characters to be queried. :raises DocumentTranslationException: If an error occurs during translation, the exception includes the document handle. )rwrvr}r\rrNz unknown errorz+Error occurred while translating document: )translate_document_upload"translate_document_wait_until_doneoktranslate_document_downloadrrrQ error_message) r2rrrvrwr}r\rrhandlerrrs r3rTranslator.translate_document5sN// ##'0  F<A E Fs3B B& B!!B&cZURX#XE5nU(aXxS'0n [U[[45(aUc [ S5eSXa40n OSU0n UR SXS9upn UR XU 5 U (d0n [U RSS5U RSS55$) aUpload document to be translated and return handle associated with request. :param input_document: Document to translate as a file-like object, or string or bytes containing file content. :param source_lang: (Optional) Language code of input document, for example "DE", "EN", "FR". If omitted, DeepL will auto-detect the input language. :param target_lang: Language code to translate document into, for example "DE", "EN-US", "FR". :param formality: (Optional) Desired formality for translation, as Formality enum, "less", "more", "prefer_less", or "prefer_more". :param glossary: (Optional) glossary or glossary ID to use for translation. Must match specified source_lang and target_lang. :param filename: (Optional) Filename including extension, only required if uploading string or bytes containing file content. :param output_format: (Optional) Desired output file extension, if it differs from the input file format. :return: DocumentHandle with ID and key identifying document. rzAfilename is required if uploading file content as string or bytesfilez v2/document)r?files document_idr_ document_key) rrPrQbytesr*rZrtrr) r2rrvrwr}r\rrrrrrFr@s r3r$Translator.translate_document_uploadus@99 i  ,9 ) " nsEl 3 3 h78E^,E $  !/!  v5D HH]B '.")E  r6rcBSUR0nSUR3nURX2S9upEnURXEU5 U(a'[ U[ 5(aUR SS5OSnU(d [SU5eU(a'[ U[ 5(aUR SS5OSnU(a'[ U[ 5(aUR SS5OSn U(a'[ U[ 5(aUR S S5OSn [XxX5$) aJGets the status of the document translation request associated with given handle. :param handle: DocumentHandle to the request to check. :return: DocumentStatus containing the request status. :raises DocumentTranslationException: If an error occurs during querying the document, the exception includes the document handle. r v2/document/rrNz/Querying document status gave an empty responseseconds_remainingbilled_charactersr) rrrZrtrPrLrrr) r2rr?rBrErFr@rrrrs r3translate_document_get_status(Translator.translate_document_get_statuss 3 34V//01%)^^C^%C" d {T:D$// HHXt $  .A6  D$// HH($ / D$// HH($ / D$// HH_d +   '8  r6c<URU5nUR(ayUR(dhSn[R"SUSS35 [ R "U5 URU5nUR(aUR(dMhU$)aX Continually polls the status of the document translation associated with the given handle, sleeping in between requests, and returns the final status when the translation completes (whether successful or not). :param handle: DocumentHandle to the document translation to wait on. :return: DocumentStatus containing the status when completed. g@z:Rechecking document translation status after sleeping for z.3fz seconds.)rrdonerrJtimesleep)r2rrsecss r3r-Translator.translate_document_wait_until_dones{33F;ii D MM&&*3Zy:  JJt 77?Fii  r6 output_file chunk_sizec0SUR0nSURS3nURXTSS9upgn[U[R 5(deUR USUSS9 U(a*URUS9n U Hn URU 5 M g U$) aDownloads the translated document for the request associated with given handle and returns a response object for streaming the data. Call iter_content() on the response object to read streamed file data. Alternatively, a file-like object may be given as output_file where the complete file will be downloaded and written to. :param handle: DocumentHandle associated with request. :param output_file: (Optional) File-like object to store downloaded document. If not provided, use iter_content() on the returned response object to read streamed file data. :param chunk_size: (Optional) Size of chunk in bytes for streaming. Only used if output_file is specified. :return: None if output_file is specified, otherwise the requests.Response will be returned. rrz/resultT)r@rAz)r])rN) rrrZrPrequestsResponsert iter_contentwrite) r2rrrr?rBrEresponser@chunkschunks r3r&Translator.translate_document_downloads, 3 34V//08&*nn 4'5' # t(H$5$56666  4d   **j*AF!!%( Or6cURSSS9up#nURX#U5 U(a[U[5(aUO/nUVs/sHn[ USUS5PM sn$s snf)a Request the list of available source languages. :param skip_cache: Deprecated, and now has no effect as the corresponding internal functionality has been removed. This parameter will be removed in a future version. :return: List of supported source languages. v2/languagesGETr>languager)rZrtrPrr)r2 skip_cacherrFr@ languagesrs r3get_source_languagesTranslator.get_source_languages's!%~e L v5!jt&<&r?rrsupports_formalityN)rZrtrPrrr)r2rr?rrFr@rrs r3get_target_languagesTranslator.get_target_languages:s! $ 5t!/!  v5!jt&<&r1Trz.Could not get the glossary content as a stringrc) rPrrrZrtrQrrconvert_tsv_to_dictr2r\rrrFr@s r3get_glossary_entriesTranslator.get_glossary_entriess h - -"..K"K $[M 2:;!/!  vtD'3'' @!' ''00r6c[U[5(a URnOUnURSU3SS9up4nUR X4USS9 g)zDeletes specified glossary. :param glossary: GlossaryInfo or ID of glossary to delete. :raises GlossaryNotFoundException: If no glossary with given ID is found. r!DELETErTrN)rPrrrZrtr+s r3delete_glossaryTranslator.delete_glossarys] h - -"..K"K $[M *!/!  vtDr6)r0r.r1)FFr8)Nr )F)B__name__ __module__ __qualname____firstlineno____doc__r-r,rlrQrrrrr4r;rLrintrrrrZrtr{rrrrrrr9rpropertyr"rr rr rrDEFAULTrrrrrrrrrrrrrr rrr rrrr"r&r,r0__static_attributes__r6r3r r /s409#& %)(,#'-1$)GGSM G T3_% G ! G$T/*G"G4##"&6* 6* 6* tn 6* tn 6*6*$6* sE#x000136 76*z%* HHsH---.H H  H # HT #C= 7: (48 $3$./$3=)$i-. $ \4/0 $  $L,,3=),3=) ,  , sEz" , ,:!#  37!%<@.21537&*,0:>6:37A4C#&'A43$./ A4 3=) A4 # A4sND89A4&d^A4i-.A4\4/0A4smA4$D>A4"#tCy$"67A4c49d23A43S 4/0A4 z4 ++ ,!A4N37 - C#&'- - 3$./ - z4 ++ , - h&*+4+<+<373#w///033 0 0013 c] 3  3i(3\4/03 3t&*+4+<+<37"&'+>fh34>vx45> c] >  >i(>\4/0>3-> }> >H&*1537"&'+9 fhUC?@9 c] 9  9 i-. 9 \4/09 3-9  }9  9 v. $. . `$ 6;? --68S$67- - (## $ -^ X & X . -A(B (5) ) 3=)) 3=) ) c3h )  ) V+ + 3=)+ 3=) + #uc9: +  + Z , , , Ml!3 M1U3 3D-E1$1:Ec<.?(@ETEr6r )*deepl.api_datarrrrrrr r r r_r r exceptionsrrrrrrrri http.clientr@rRrrrrtypingrrrrrrrrr urllib.parserGr r;r6r3rAsa          aEaEr6