11ia;SrSSKrSSKrSSKrSSKrSSKrSSKrSSKrSSKrSSK J r J r SSK J r SSKJr "SS5rg)zWrapper on espeak-ng libraryN)TupleDict) EspeakAPI) EspeakVoicecX\rSrSrSrSrSrSr\S5r \S5r Sr S\ 4S jr \S \4S j5r\S \4S j5r\S5rSr\S\\\\44Sj5r\S5r\S5r\S5r\R6"SS9SSj5rSrSrSS\S\S\4Sjjr S\4Sjr!Sr"g) EspeakWrapperaWrapper on espeak shared library The aim of this wrapper is not to be exhaustive but to encapsulate the espeak functions required for phonemization. It relies on a espeak shared library (*.so on Linux, *.dylib on Mac and *.dll on Windows) that must be installed on the system. Use the function `EspeakWrapper.set_library()` before instanciation to customize the library to use. Raises ------ RuntimeError if the espeak shared library cannot be loaded NcSUlSUlSUl[UR 5UR 5UlSUlSUlgN) _version _data_path_voicerlibrary data_path_espeak_libc_ _tempfile_selfs [/home/james-whalen/.local/lib/python3.13/site-packages/phonemizer/backend/espeak/wrapper.py__init__EspeakWrapper.__init__5sC*.  !@  cURco[RS:Xa[RR O;[R R[RRS55UlUR$)Nwin32c) rsysplatformctypeswindllmsvcrtcdll LoadLibraryutil find_libraryrs r_libcEspeakWrapper._libcCsX ;; (+ (? $$ '' (@(@(EF K{{rcURcO[R"5Ul[R"URURR 5 UR$r )rtempfileNamedTemporaryFileweakreffinalizeclosers r _tempfileEspeakWrapper._tempfileKsF ?? "'99;DO   T__doo.C.C DrcJURURURS.$)z/For pickling, when phonemizing on multiple jobs)versionrvoice)r r rrs r __getstate__EspeakWrapper.__getstate__Ts#}}[[" "rstatecTUR5 USUlUSUlUSUlUR(aiSURR;a)UR URRSS5 gUR URR 5 gg)z1For unpickling, when phonemizing on multiple jobsr1rr2mbN)rr r r identifier set_voicelanguage)rr5s r __setstate__EspeakWrapper.__setstate__[s i(  ,Gn ;;t{{---t{{55ab9:t{{334 rrcXlg)a(Sets the espeak backend to use `library` If this is not set, the backend uses the default espeak shared library from the system installation. Parameters ---------- library (str or None) : the path to the espeak shared library to use as backend. Set `library` to None to restore the default. N)_ESPEAK_LIBRARYclsrs r set_libraryEspeakWrapper.set_librarygs &rrcXlg)a.Sets the path for the data to be used by the espeak backend. If this is not set, the backend uses the default data path from the system installation. Parameters ---------- data_path : str The path to the data to be used by the espeak backend. Set `data_path` to None to restore the default. N)_ESPEAK_DATA_PATH)rArs r set_data_pathEspeakWrapper.set_data_pathvs !*rc UR(a UR$S[R;a[R"[RS5nUR 5(a*[R "U[R5(d[SUS35eUR5$[RRS5=(d [RRS5nU(d [S5eU$)Returns the espeak library used as backend The following precedence rule applies for library lookup: 1. As specified by BaseEspeakBackend.set_library() 2. Or as specified by the environment variable PHONEMIZER_ESPEAK_LIBRARY 3. Or the default espeak library found on the system Raises ------ RuntimeError if the espeak library cannot be found or if the environment variable PHONEMIZER_ESPEAK_LIBRARY is set to a non-readable file PHONEMIZER_ESPEAK_LIBRARYzPHONEMIZER_ESPEAK_LIBRARY=z is not a readable filez espeak-ngespeakzfailed to find espeak library) r?osenvironpathlibPathis_fileaccessR_OK RuntimeErrorresolverr$r%r@s rrEspeakWrapper.librarys$   && & &"** 4ll2::.I#JKGOO%%"))GRWW*E*E"0 :-.//??$ $ ((53 ((2 /1 1rcURR5up[R"UR 55UlUR R 5(d [S5eUR 5R5RS5SRSS5n[SURS555Ul g) z9Initializes version and dapa path from the espeak libraryz(failed to retrieve espeak data directory rz-devc38# UHn[U5v M g7fr )int).0vs r 8EspeakWrapper._fetch_version_and_path..sA.@c!ff.@s.N) rinforNrOdecoder is_dirrSstripsplitreplacetupler )rr1rs r_fetch_version_and_path%EspeakWrapper._fetch_version_and_paths!\\..0",,y'7'7'9:%%''IJ J.."((*005a8@@LAgmmC.@AA rreturncTURcUR5 UR$)z?The espeak version as a tuple of integers (major, minor, patch))r rgrs rr1EspeakWrapper.versions$ ==  ( ( *}}rc.URR$)z-The espeak library as a pathlib.Path instance)r library_pathrs rrmEspeakWrapper.library_paths||(((rcUR(a[R"UR5nUR5(a4[R "UR[R 5(d[URS35eUR5Ul OS[R;a[R"[RS5nUR5(a*[R "U[R 5(d[SUS35eUR5Ul URc![US5(aUR5 UR$)rIz is not a readable directoryPHONEMIZER_ESPEAK_DATA_PATHzPHONEMIZER_ESPEAK_DATA_PATH=r) rErNrOrbrLrQrRrSrTr rMhasattrrg)rrs rrEspeakWrapper.data_paths$  ! ! T%;%;2344(//1DO ?? "wtY'?'?  ( ( *rcUR$)zcThe configured voice as an EspeakVoice instance If `set_voice` has not been called, returns None )rrs rr2EspeakWrapper.voices{{r)maxsizec U(a[US9R5nURRU=(d S5nSn/nX#(aX#RnUR [[ R"UR5RSS5[ R"UR5SS[ R"UR5S95 US- nX#(aMU$)z>Voices available for phonemization, as a list of `EspeakVoice`)r;Nr_rW)namer;r9) r to_ctypesr list_voicescontentsappendrLfsdecoderyre languagesr9)rryvoicesindexavailable_voicesr2s rrEspeakWrapper.available_voicess -779D))$,$7mM**E  # #K[[,44S#>U__5ab9;;u'7'78%: ; QJE mm rc,SU;a:URS5Vs0sHnURSSUR_M nnOC0nUR5H-nURU;dMURX2R'M/ X1nUR R URS55S:wa[ S US35eUR5nU(d[ S US35eX l gs snf![a [ SUS35Sef=f) zSetup the voice to use for phonemization Parameters ---------- voice_code (str) : Must be a valid language code that is actually supported by espeak Raises ------ RuntimeError if the required voice cannot be initialized r7mbrolar8Nzinvalid voice code ""utf8rzfailed to load voice ") rr9r;KeyErrorrSrset_voice_by_nameencode _get_voicer)r voice_coder2 available voice_names rr:EspeakWrapper.set_voices0 :  "228<>II..0>>2050@0@Inn-1 O".J << ) )**;*;F*C D I( A68 8!!7 |1EF F 1> O!5j\CD$ N Os$C3C88DcURR5nUR(a[R"U5$g)z^Returns the current voice used for phonemization If no voice has been set up, returns None. N)rget_current_voiceryr from_ctypes)rr2s rrEspeakWrapper._get_voice.s1  ..0 ::**51 1rtexttiecpURc [S5eU(aURS::a [S5e[R"[R "UR S555nSnURS::aSnO*U(aS[S5S --nO[S 5S -S -n/nURRb[URRX4U5nU(aURUR55 URRbM[S RU5$) u@Translates a text into phonemes, must call set_voice() first. This method is used by the Espeak backend. Wrapper on the espeak_TextToPhonemes function. Parameters ---------- text (str) : the text to phonemize tie (bool, optional) : When True use a '͡' character between consecutive characters of a single phoneme. Else separate phoneme with '_'. This option requires espeak>=1.49. Default to False. Returns ------- phonemes (str) : the phonemes for the text encoded in IPA, with '_' as phonemes separator (excepted if ``tie`` is True) and ' ' as word separator. no voice specified)rx0r8z,tie option only compatible with espeak>=1.49rrxu͡rwrW)r2rSr1rpointerc_char_prordr|valuertext_to_phonemesr}rajoin)rrrtext_ptr text_mode phonemes_moderesultphonemess rrEspeakWrapper.text_to_phonemes9s* :: 34 4 4<<:->@ @>>&//$++f2E"FG <<: %,M ,s4yA~=MHMD0M%%1||44]4H hoo/0 %%1 xxrcURS:a [S5eURc [S5e[R[R/UR R l[RUR R l [R/UR Rl[RUR Rl URRS5 UR R URRR5URR R55nUR"R%S['S5S--U5 UR"R)[R"URS55[R*"[-U5S -5[R."S 55nUR RU5 US:wa [S 5eURR1S5 URR35R55R75nU$) aTranslates a text into phonemes, must call set_voice() first. Only compatible with espeak>=1.49. This method is used by the EspeakMbrola backend. Wrapper on the espeak_Synthesize function. Parameters ---------- text (str) : the text to phonemize Returns ------- phonemes (str) : the phonemes for the text encoded in SAMPA, with '_' as phonemes separator and no word separation. )rx1z not compatible with espeak<=1.48rrrwrrrxzfailed to synthetize)r1rSr2rrr&fopenargtypesc_void_prestypefclosec_intr.truncateryrmoderset_phoneme_tracer synthetizec_size_tlenc_uintseekreadrarc)rrfile_pstatus phonemizeds rrEspeakWrapper.synthetizems" <<' !AB B :: 34 4&,__foo$F !#)??  &,oo%6 "$*LL ! "!! NN   & & ( NN   & & (* &&y3s8q='@&I(( OODKK/ 0 OOCIM * MM$ ! &! Q;56 6 A^^((*11399; r)r rrrr rr )F)#__name__ __module__ __qualname____firstlineno____doc__r?rErpropertyr&r.r3rr< classmethodstrrBrFrrgrrZr1rmrr2 functools lru_cacherr:rboolrr__static_attributes__rrrrsW$O " 5$ 5 &# & & *c * *""H BsC}- ))!!F& ' $(T 2 S2 t2 2 h2s2rr)rr ctypes.utilrrLrNrr)r+typingrrphonemizer.backend.espeak.apirphonemizer.backend.espeak.voicerrrrrrs7#   37@@r