11i0SrSSKrSSKrSSKrSSKrSSKrSSKrSSKrSSKrSSK J r SSKJ r SSK J r JrJrJrJrJr SSKJr SSKJr SSKJr SS KJrJr "S S \5rg) #Festival backend for the phonemizerN)Logger)Path)OptionalDictListIOUnionPattern) BaseBackend)lispy) Separator)get_package_resourceversion_as_tuplec 4^\rSrSrSrSrS&S\S\\\\ 4S\ S\\ 4U4Sjjjr \ S 5r\S \4S j5r\S \4S j5r\S5r\S5r\ S \\\44Sj5rS\\S\S\S\ S \\4 Sjr\ S\S \4Sj5r\ S\4Sj5r\S\\4Sj5rS\4Sjr\ S\S\S \4Sj5r \ S\\S\S\ S \4Sj5r!\S \\\S\S\ S \4S!j5r"\S\S\ S \4S"j5r#\S#\S\S\ S \\4S$j5r$S%r%U=r&$)'FestivalBackend#rNlanguagepunctuation_markspreserve_punctuationloggerc>>[TU]UUUUS9 URRSUR 55 [ S5n[ US5nUR5UlSSS5 URRSU5 g!,(df  N+=f)N)rrrzfestival executable is %szfestival/phonemize.scmrz loaded %s) super__init__rdebug executableropenread_script)selfrrrr script_filefscript __class__s ^/home/james-whalen/.local/lib/python3.13/site-packages/phonemizer/backend/festival/festival.pyrFestivalBackend.__init__*s  /!5   5t7HI++CD +s #w"<<>DL$ +{3$ #s B Bcg)Nfestivalr)r%nameFestivalBackend.name<sr*rc UcSUlg[R"U5nUR5(a*[R "U[R 5(d[US35eUR5Ulg)apSets the festival backend to use `executable` If this is not set, the backend uses the default festival executable from the system installation. Parameters ---------- executable (str) : the path to the festival executable to use as backend. Set `executable` to None to restore the default. Raises ------ RuntimeError if `executable` is not an executable file. N is not an executable file) _FESTIVAL_EXECUTABLEpathlibris_fileosaccessX_OK RuntimeErrorresolveclsrs r%set_executableFestivalBackend.set_executable@sq"  '+C $ \\*- ""$$:rww)G)G,89; ;$.#5#5#7 r*returncUR(a UR$S[R;a[R"[RS5nUR 5(a([R "U[RS9(d[SUS35eUR5$[R"S5nU(d [S5e[ U5R5$)aReturns the absolute path to the festival executable used as backend The following precedence rule applies for executable lookup: 1. As specified by FestivalBackend.set_executable() 2. Or as specified by the environment variable PHONEMIZER_FESTIVAL_EXECUTABLE 3. Or the default 'festival' binary found on the system with ``shutil.which('festival')`` Raises ------ RuntimeError if the festival executable cannot be found or if the environment variable PHONEMIZER_FESTIVAL_EXECUTABLE is set to a non-executable file PHONEMIZER_FESTIVAL_EXECUTABLE)modezPHONEMIZER_FESTIVAL_EXECUTABLE=r.r(z"failed to find festival executable) r/r2environr0rr1r3r4r5r6shutilwhichr7s r%rFestivalBackend.executable\s(  # #++ + +rzz 9 bjj*J'LMJ&&(( *277;"5j\B0122%%' '\\*- 46 6J''))r*cFUR5 g![a gf=f)z=True if the festival executable is available, False otherwiseFT)rr5)r8s r% is_availableFestivalBackend.is_availables*  NN   s   c,UR5n[R"US/5RS5R 5nSn[ R "X25RS5n[U5$![a [SU35Sef=f)zFestival version as a tupe of integers (major, minor, patch) Raises ------ RuntimeError if FestivalBackend.is_available() is False or if the version cannot be extracted for some reason. z --versionlatin1z.* ([0-9\.]+[0-9]):z%cannot extract festival version from N) r subprocess check_outputdecodestriprematchgroupAttributeErrorr5r)r8r( long_versionfestival_version_reversions r%rSFestivalBackend.versions>>#".. { #%%+VH%5eeg 5 Nhh2AGGJG  ((  N7zBDIM N Ns %A99Bc SS0$)zuA dictionnary of language codes -> name supported by festival Actually only en-us (American English) is supported. zen-usz english-usr)r)r*r%supported_languages#FestivalBackend.supported_languagess&&r*textoffset separatorrLcURU5n[U5S:Xa/$URU5nURXU5nU$)a|Return a phonemized version of `text` with festival This function is a wrapper on festival, a text to speech program, allowing simple phonemization of some English text. The US phoneset we use is the default one in festival, as described at http://www.festvox.org/bsv/c4711.html Any opening and closing parenthesis in `text` are removed, as they interfer with the Scheme expression syntax. Moreover double quotes are replaced by simple quotes because double quotes denotes utterances boundaries in festival. Parsing a ill-formed Scheme expression during post-processing (typically with unbalanced parenthesis) raises an IndexError. r) _preprocesslen_process _postprocess)r!rXrYrZrLs r%_phonemize_auxFestivalBackend._phonemize_auxsI"% t9>I}}T"  %8 r*linecSU-S-$)z4Return the string `line` surrounded by double quotes"r)rbs r%_double_quotedFestivalBackend._double_quotedsTzCr*c[U5[S5:XaSnURSS5RSS5RSS5R5$)z+Remove 'forbidden' characters from the line'rd())setreplacerLres r%_cleanedFestivalBackend._cleanedsO t9C D||C$,,S"5==c2FLLNNr*cR^U4SjU5nSRU4SjU55$)zReturns the contents of `text` formatted for festival input This function adds double quotes to begining and end of each line in text, if not already presents. The returned result is a multiline string. Empty lines in inputs are ignored. c3T># UHoS:wdM TRU5v M g7frjN)ro.0rbr8s r% .FestivalBackend._preprocess..s'?+/42: CLL  4 (( c3T># UHoS:wdM TRU5v M g7frs)rfrts r%rvrws*M1= $C  t $ $rx)join)r8rX cleaned_texts` r%r\FestivalBackend._preprocesss6?+/? yyM1=MM Mr*c[R"SSS9nURU5 UR5 URn[ R S:XaURSS5n[R"SSS9nURURRU55 UR5 UR5SUR3nUR(aURRSU5 [R"S5nURXV5sS S S 5 [R "UR5 sS S S 5 [R "UR5 sS S S 5 $!,(df  O=f[R "UR5 O%![R "UR5 f=fS S S 5 O!,(df  O=f[R "UR5 O%![R "UR5 f=fS S S 5 g !,(df  g =f) zReturn the raw phonemization of `text` This function delegates to festival the text analysis and syllabic structure extraction. Return a string containing the "SylStructure" relation tree of the text, as a scheme expression. zw+F)deletewin32\z\\z -b z running %sN)tempfileNamedTemporaryFilewritecloser+sysplatformrnr formatrrr TemporaryFile _run_festivalr2remove)r!rXdatar+scmcmdfstderrs r%r^FestivalBackend._processs ( (e < % 4  yy<<7*<<f5D00eD, $,,"5"5d";< !%!2 34zB;; KK--lC@&33D9W#'#5#5c#C:9 #((+#ED& $))$== <2:99 #((+ #((++#EDD& $))$ $))$$== < F / F>8 G- H! I F F>!G->"G  G-$ H- G; 7H>!I"II Irrc V[R"[R"USS9US9n[R "SSUR S55$![RaCnURS5 [SUS URS UR535S eS nAff=f) zRuns the festival command for phonemization Returns the raw phonemized output (need to be postprocesses). Raises a RuntimeError if festival fails. F)posix)stderrz + rGrz Command "z" returned exit status z , output is: N) rIrJshlexsplitrMsubrKCalledProcessErrorseekr5 returncoder)rroutputerrs r%rFestivalBackend._run_festivals ;,, Cu-g?F66$V]]8%<= =,, ; LLOC5 77GH&||~.016: ; ;sAAB(%>B##B(syllc|URnSUSS5nURSU55nU(aU$XC-$)z3Parse a syllable from festival to phonemized outputc3P# UHoSSRSS5v M g7f)rrdrjN)rn)ruphones r%rv4FestivalBackend._postprocess_syll../s&BQx{""3++s$&rHNc34# UHoS:wdM Uv M g7frsr))ruos r%rvr0s1#Qbqq#s  )rr{)rrZrLsepouts r%_postprocess_syll!FestivalBackend._postprocess_syll+s@ooBabBhh1#11s**r*wordcz^^^TRnURUUU4SjUSS55nT(aU$XT-$)z/Parse a word from festival to phonemized outputc3J># UHnTRUTT5v M g7f)N)r)rurr8rZrLs r%rv4FestivalBackend._postprocess_word..7s*"   ! !$ 5 9 9 s #rHN)syllabler{)r8rrZrLrrs` `` r%_postprocess_word!FestivalBackend._postprocess_word3sB  hh"QR""s**r*cURn/n[R"U5H.nURXbU5nUS:wdMUR U5 M0 UR U5nU(aU$XT-$)z/Parse a line from festival to phonemized outputrj)rr parserappendr{)r8rbrZrLrrrs r%_postprocess_line!FestivalBackend._postprocess_line<shnnKK%D((%@Drz 4 &hhsms**r*treecURS5Vs/sHnUS;dM URXBU5PM sn$s snf)z8Conversion from festival syllable tree to desired formatry)rjz (nil nil nil))rr)r8rrZrLrbs r%r_FestivalBackend._postprocessIsJ!JJt,6,D44>%%du=,6 66s ;;)r )NFN)'__name__ __module__ __qualname____firstlineno____doc__r/strrr r boolrr staticmethodr+ classmethodr9rrrDrSrrVrintrr`rfror\r^r rrrrr___static_attributes__ __classcell__)r$s@r%rr#s- EI.3,044$,U3<-@$A4'+4"&)44$8886&*4&*&*P))6'c3h''49ciX\aefiaj0 S S   Os O O MtCy M M(%S(%T;3;;;;(+S +i++QT+++T$s)_++SW+\_++ +S +D +S + +66 6$64PS966r*r)rr2r0rMrr@rIrrloggingrrtypingrrrr r r phonemizer.backend.baser phonemizer.backend.festivalr phonemizer.separatorrphonemizer.utilsrrrr)r*r%rsH*   ;;/-*Ck6kk6r*