11i4SrSSKrSSKrSSKJr SSKJrJrJrJ r SSK J r SSK J r SSKJr SSKJr SS KJr SS KJr SS KJr SS KJrJr SS KJrJr \ Sr0rSS\SSSS\R@"5SSSSS\"54S\!S\S\\S\"S\"S\"S\"S\\!\ 4S\"S\\"\!4S\S \S!\#S"\4S#jjr$S\S\"S\\"\!4S\S\S \4 S$jr%S\S%\\!\\!4S\S\"S!\#S\"S\"4S&jr&g)'zjProvides the phonemize function To use it in your own code, type: from phonemizer import phonemize N)Logger)OptionalUnionListPattern)Literal)BACKENDS) BaseBackend)LanguageSwitch) WordMismatch) get_logger) Punctuation)default_separator Separator)list2strstr2listespeak espeak-mbrolafestivalsegmentszen-usrF keep-flagsignorelanguagebackend separatorstrip prepend_textpreserve_empty_linespreserve_punctuationpunctuation_marks with_stresstielanguage_switchwords_mismatchnjobsloggerc @[RS:a/URSSR[R55 [ X)XX5 US:XaU(aUR S5 US:Xa"UR (aUR S5 UU[U5UU U U U 4nU[;a[[UXXMXV5$US:Xa[U"UUUU U U U US9nU[U'O%US:Xa[U"UUS 9nO[U"UUUUS 9n[UXXMXV5$) u Multilingual text to phonemes converter Return a phonemized version of an input `text`, given its `language` and a phonemization `backend`. Note ---- To improve the processing speed it is better to minimize the calls to this function: provide the input text as a list and call phonemize() a single time is much more efficient than calling it on each element of the list. Indeed the initialization of the phonemization backend can be expensive, especially for espeak. In one example, Do this: >>> text = [line1, line2, ...] >>> phonemize(text, ...) Not this: >>> for line in text: >>> phonemize(line, ...) Parameters ---------- text: str or list of str The text to be phonemized. Any empty line will be ignored. If ``text`` is an str, it can be multiline (lines being separated by ``\n``). If ``text`` is a list, each element is considered as a separated line. Each line is considered as a text utterance. language: str The language code of the input text, must be supported by the backend. If ``backend`` is 'segments', the language can be a file with a grapheme to phoneme mapping. backend: str, optional The software backend to use for phonemization, must be 'festival' (US English only is supported, coded 'en-us'), 'espeak', 'espeak-mbrola' or 'segments'. separator: Separator string separators between phonemes, syllables and words, default to separator.default_separator. Syllable separator is considered only for the festival backend. Word separator is ignored by the 'espeak-mbrola' backend. Initialize it as follows: >>> from phonemizer.separator import Separator >>> separator = Separator(phone='-', word=' ') strip: bool, optional If True, don't output the last word and phone separators of a token, default to False. prepend_text: bool, optional When True, returns a pair (input utterance, phonemized utterance) for each line of the input text. When False, returns only the phonemized utterances. Default to False preserve_empty_lines: bool, optional When True, will keep the empty lines in the phonemized output. Default to False and remove all empty lines. preserve_punctuation: bool, optional When True, will keep the punctuation in the phonemized output. Not supported by the 'espeak-mbrola' backend. Default to False and remove all the punctuation. punctuation_marks: str or re.Pattern, optional The punctuation marks to consider when dealing with punctuation, either for removal or preservation. Can be defined as a string or regular expression. Default to Punctuation.default_marks(). with_stress: bool, optional This option is only valid for the 'espeak' backend. When True the stresses on phonemes are present (stresses characters are ˈ'ˌ). When False stresses are removed. Default to False. tie: bool or char, optional This option is only valid for the 'espeak' backend with espeak>=1.49. It is incompatible with phone separator. When not False, use a tie character within multi-letter phoneme names. When True, the char 'U+361' is used (as in d͡ʒ), 'z' means ZWJ character, default to False. language_switch: str, optional Espeak can output some words in another language (typically English) when phonemizing a text. This option setups the policy to use when such a language switch occurs. Three values are available : 'keep-flags' (the default), 'remove-flags' or 'remove-utterance'. The 'keep-flags' policy keeps the language switching flags, for example "(en) or (jp)", in the output. The 'remove-flags' policy removes them and the 'remove-utterance' policy removes the whole line of text including a language switch. This option is only valid for the 'espeak' backend. words_mismatch: str, optional Espeak can join two consecutive words or drop some words, yielding a word count mismatch between orthographic and phonemized text. This option setups the policy to use when such a words count mismatch occurs. Three values are available: 'ignore' (the default) which do nothing, 'warn' which issue a warning for each mismatched line, and 'remove' which remove the mismatched lines from the output. njobs: int The number of parallel jobs to launch. The input text is split in ``njobs`` parts, phonemized on parallel instances of the backend and the outputs are finally collapsed. logger: logging.Logger the logging instance where to send messages. If not specified, use the default system logger. Returns ------- phonemized text: str or list of str The input ``text`` phonemized for the given ``language`` and ``backend``. The returned value has the same type of the input text (either a list or a string), excepted if ``prepend_input`` is True where the output is forced as a list of pairs (input_text, phonemized text). Raises ------ RuntimeError if the ``backend`` is not valid or is valid but not installed, if the ``language`` is not supported by the ``backend``, if any incompatible options are used. )z]Your are using python-%s which is unsupported by the phonemizer, please update to python>=3.6.rz1espeak-mbrola backend cannot preserve punctuationz5espeak-mbrola backend cannot preserve word separationr)r"r!r#r$r%r&r()r()r"r!r() sys version_infoerrorjoin_check_argumentswarningwordstr_PHONEMIZER_CACHE _phonemizer )textrrrrrr r!r"r#r$r%r&r'r( cache_key phonemizers N/home/james-whalen/.local/lib/python3.13/site-packages/phonemizer/phonemize.py phonemizer;+sSf &   +,/HHS5E5E,F H coO/!&:JK/!innNO    I%%+I6Wczz(g& /!5#+) (2)$ O #g&  g& /!5   j$5 ddcUS;a*[SRUSRS555eU(a US:wa[SRU55eU(a US:wa[SRU55eU(a*UR(a[SURS35eUS :wa US:wa[S RU55eUS :wa!US:wa[S RU55eg g )zAuxiliary function to phonemize() Ensures the parameters are compatible with each other, raises a RuntimeError the first encountered error. rz,{} is not a supported backend, choose in {}.z, rz[the "with_stress" option is available for espeak backend only, but you are using {} backendzSthe "tie" option is available for espeak backend only, but you are using {} backendzAthe "tie" option is incompatible with phone separator (which is "z")rz_the "language_switch" option is available for espeak backend only, but you are using {} backendrz^the "words_mismatch" option is available for espeak backend only, but you are using {} backendN) RuntimeErrorformatr0phone)rr#r$rr%r&s r:r1r1sII :C"EFG G w(* ++16'?< <  w(" ++16'?< <  y #//*" ./ / ,&7h+> 117B B !g&9 117B B':!r<r7c~[U5n[U5Vs/sH!oR[R5PM# nnU(a6[ U5V Vs/sHupUR5(aMU PM n n nUVs/sHoR5(dMUPM nnU(aUR XX4S9n O/n U(a4W H.n U(aURU S5 U RU S5 M0 U(a[[X55$U[:Xa [U 5$U $s snfs snn fs snf)z|Auxiliary function to phonemize() Does the phonemization and returns the phonemized text. Raises a RuntimeError on error. )rrr') typerroslinesep enumerater;insertlistzipr4r) rr7rrr'rr text_typelinen empty_lines phonemizedis r:r6r6,sT I08~ >~tJJrzz "~D >(1$LWQtzz|q L" 2TTZZ\DTD 2 && U'A  A Ar"   a $C)**C ## ; ?M 3s(D/D47D4D: D:)'__doc__rDr-loggingrtypingrrrrtyping_extensionsrphonemizer.backendr phonemizer.backend.baser )phonemizer.backend.espeak.language_switchr (phonemizer.backend.espeak.words_mismatchr phonemizer.loggerr phonemizer.punctuationrphonemizer.separatorrrphonemizer.utilsrrBackendr5 default_marksr4boolintr;r1r6r<r:ras 11%'/DA(.=/ C D  #):"%*%*1<1J1J1L! %*6'/#KeKeKeI& Ke  Ke  Ke#Ke#Ke!g.KeKe49 Ke(Ke%KeKeKe\0B0B0B49 0B 0B ( 0B % 0Bf//CcN#// /  /  /#/r<