*hafSSKJrJrJr SSKrSSKrSSKrSSKrSSKr\RRS:a\ r \ r SSKJr SSKJr O\rSSKJr \R*"\5rSrSrSrSr"S S 5rS r"S S \5rg))print_functionabsolute_importunicode_literalsN)MappingProxyType)getfullargspec) getargspecc$SSKJn [U5$)a  Return a dictionary that contains the default collection of known LaTeX escape sequences for unicode characters. The keys of the dictionary are integers that correspond to unicode code points (i.e., `ord(char)`). The values are the corresponding LaTeX replacement strings. The returned dictionary may not be modified. To alter the behavior of :py:func:`unicode_to_latex()`, you should specify custom rules to a new instance of :py:class:`UnicodeToLatexEncoder`. .. versionadded:: 2.0 This function was introduced in `pylatexenc 2.0`. ) uni2latex) _uni2latexmapr _MappingProxyType) _uni2latexs m/home/mande/repo/quber/.venv/lib/python3.13/site-packages/pylatexenc/latexencode/_unicode_to_latex_encoder.pyget_builtin_uni2latex_dictr6s"7 Z ((r c,\rSrSrSrSSjrSrSrg)UnicodeToLatexConversionRulela Specify a rule how to convert unicode characters into LaTeX escapes. .. py:attribute:: rule_type One of :py:data:`RULE_DICT`, :py:data:`RULE_REGEX`, or :py:data:`RULE_CALLABLE`. .. py:attribute:: rule A specification of the rule itself. The `rule` attribute is an object that depends on what `rule_type` is set to. See below. .. py:attribute:: replacement_latex_protection If non-`None`, then the setting here will override any `replacement_latex_protection` set on :py:class:`UnicodeToLatexConversionRule` objects. By default the value is `None`, and you can set a replacement_latex_protection globally for all rules on the :py:class:`UnicodeToLatexEncoder` object. The use of this attribute is mainly in case you have a fancy rule in which you already guarantee that whatever you output is valid LaTeX even if concatenated with the remainder of the string; in this case you can set `replacement_latex_protection='none'` to avoid unnecessary or unwanted braces around the generated code. .. versionadded:: 2.10 The `replacement_latex_protection` attribute was introduced in `pylatexenc 2.10`. Constructor syntax:: UnicodeToLatexConversionRule(RULE_XXX, <...>) UnicodeToLatexConversionRule(rule_type=RULE_XXX, rule=<...>) UnicodeToLatexConversionRule(..., replacement_latex_protection='none') Note that you can get some built-in rules via the :py:func:`get_builtin_conversion_rules()` function:: conversion_rules = get_builtin_conversion_rules('defaults') # all defaults Rules types: - `RULE_DICT`: If `rule_type` is `RULE_DICT`, then `rule` should be a dictionary whose keys are integers representing unicode code points (e.g., `0x210F`), and whose values are corresponding replacement strings (e.g., ``r'\hbar'``). See :py:func:`get_builtin_uni2latex_dict()` for an example. - `RULE_REGEX`: If `rule_type` is `RULE_REGEX`, then `rule` should be an iterable of tuple pairs `(compiled_regular_expression, replacement_string)` where `compiled_regular_expression` was obtained with `re.compile(...)` and `replacement_string` is anything that can be specified as the second (`repl`) argument of `re.sub(...)`. This can be a replacement string that includes escapes (like ``\1, \2, \g``) for captured sub-expressions or a callable that takes a match object as argument. .. note:: The replacement string is parsed like the second argument to `re.sub()` and backslashes have a special meaning because they can refer to captured sub-expressions. For a literal backslash, use two backslashes ``\\`` in raw strings, four backslashes in normal strings. Example:: regex_conversion_rule = UnicodeToLatexConversionRule( rule_type=RULE_REGEX, rule=[ # protect acronyms of capital letters with braces, # e.g.: ABC -> {ABC} (re.compile(r'[A-Z]{2,}'), r'{\1}'), # Additional rules, e.g., "..." -> "\ldots" (re.compile(r'...'), r'\\ldots'), # note double \\ ] ) - `RULE_CALLABLE`: If `rule_type` is `RULE_CALLABLE`, then `rule` should be a callable that accepts two arguments, the unicode string and the position in the string (an integer). The callable will be called with the original unicode string as argument and the position of the character that needs to be encoded. If this rule can encode the given character at the given position, it should return a tuple `(consumed_length, replacement_string)` where `consumed_length` is the number of characters in the unicode string that `replacement_string` represents. If the character(s) at the given position can't be encoded by this rule, the callable should return `None` to indicate that further rules should be attempted. If the callable accepts an additional argument called `u2lobj`, then the :py:class:`UnicodeToLatexEncoder` instance is provided to that argument. For example, the following callable should achieve the same effect as the previous example with regexes:: def convert_stuff(s, pos): m = re.match(r'[A-Z]{2,}', s, pos) if m is not None: return (m.end()-m.start(), '{'+m.group()+'}') if s.startswith('...', pos): # or s[pos:pos+3] == '...' return (3, r'\ldots') return None .. versionadded:: 2.0 This class was introduced in `pylatexenc 2.0`. Nc(XlX lX0lgN) rule_typerulereplacement_latex_protection)selfrrrs r__init__%UnicodeToLatexConversionRule.__init__s# ,H)rcSRURRUR[ UR 5R[ UR55$)Nz>{}(rule_type={!r}, rule=<{}>, replacement_latex_protection={}))format __class____name__rtyperreprr)rs r__repr__%UnicodeToLatexConversionRule.__repr__sFOVV NN # #T^^T$))_5M5M 22 3  r)rrr)NN)r! __module__ __qualname____firstlineno____doc__rr$__static_attributes__rrrrlsrf(,.2I rrcUS:Xa[[[5S9/$US:XaSSKJn [[UR S9/$[ SRU55e)a Return a built-in set of conversion rules specified by a given name `builtin_name`. There are two builtin conversion rules, with the following names: - `'defaults'`: the default conversion rules, a custom-curated list of unicode chars to LaTeX escapes. - `'unicode-xml'`: the conversion rules derived from the `unicode.xml` file maintained at https://www.w3.org/TR/xml-entity-names/#source by David Carlisle. The return value is a list of :py:class:`UnicodeToLatexConversionRule` objects that can be either directly specified to the `conversion_rules=` argument of :py:class:`UnicodeToLatexEncoder`, or included in a larger list that can be provided to that argument. .. versionadded:: 2.0 This function was introduced in `pylatexenc 2.0`. defaults)rrz unicode-xmlr )_uni2latexmap_xmlzUnknown builtin rule set: {})r RULE_DICTrr.r ValueErrorr) builtin_namer.s rget_builtin_conversion_rulesr3sk.z!- 3M3OQS S}$'- 3D3N3NPR R 3::<H IIrc^\rSrSrSrU4SjrSrSrSrSr Sr S r S r S r S rS rSrSrSrSrSrSrSrSrSrSrU=r$)UnicodeToLatexEncoderiu Encode a string with unicode characters into a LaTeX snippet. The following general attributes can be specified as keyword arguments to the constructor. Note: These attributes must be specified to the constructor and may NOT be subsequently modified. This is because in the constructor we pre-compile some rules and flags to optimize calls to :py:meth:`unicode_to_text()`. .. py:attribute:: non_ascii_only Whether we should convert only non-ascii characters into LaTeX sequences, or also all known ascii characters with special LaTeX meaning such as '\\\\', '$', '&', etc. If `non_ascii_only` is set to `True` (the default is `False`), then conversion rules are not applied at positions in the string where an ASCII character is encountered. .. py:attribute:: conversion_rules The conversion rules, specified as a list of :py:class:`UnicodeToLatexConversionRule` objects. For each position in the string, the rules will be applied in the given sequence until a replacement string is found. Instead of a :py:class:`UnicodeToLatexConversionRule` object you may also specify a string specifying a built-in rule (e.g., 'defaults'), which will be expanded to the corresponding rules according to :py:func:`get_builtin_conversion_rules()`. If you specify your own list of rules using this argument, you will probably want to include presumably at the end of your list the element 'defaults' to include all built-in default conversion rules. To override built-in rules, simply add your custom rules earlier in the list. Example:: conversion_rules = [ # our custom rules UnicodeToLatexConversionRule(RULE_REGEX, [ # double \\ needed, see UnicodeToLatexConversionRule ( re.compile(r'...'), r'\\ldots' ), ( re.compile(r'î'), r'\\^i' ), ]), # plus all the default rules 'defaults' ] u = UnicodeToLatexEncoder(conversion_rules=conversion_rules) .. py:attribute:: replacement_latex_protection How to "protect" LaTeX replacement text that looks like it could be interpreted differently if concatenated to arbitrary strings before and after. Currently in the default scheme only one situation is recognized: if the replacement string ends with a latex macro invocation with a non-symbol macro name, e.g. ``\textemdash`` or ``\^\i``. Indeed, if we naively replace these texts in an arbitrary string (like ``maître``), we might get an invalid macro invocation (like ``ma\^\itre`` which causes un known macro name ``\itre``). Possible protection schemes are: - 'braces' (the default): Any suspicious replacement text (that might look fragile) is placed in curly braces ``{...}``. - 'braces-all': All replacement latex escapes are surrounded in protective curly braces ``{...}``, regardless of whether or not they might be deemed "fragile" or "unsafe". - 'braces-almost-all': Almost all replacement latex escapes are surrounded in protective curly braces ``{...}``. This option emulates closely the behavior of `brackets=True` of the function `utf8tolatex()` in `pylatexenc 1.x`, though I'm not sure it is really useful. [Specifically, all those replacement strings that start with a backslash are surrounded by curly braces]. - 'braces-after-macro': In the situation where the replacement latex code ends with a string-named macro, then a pair of empty braces is added at the end of the replacement text to protect the macro. - 'none': No protection is applied, even in "unsafe" cases. This is not recommended, as this will likely result in invalid LaTeX code. (Note this is the string 'none', not Python's built-in `None`.) - any callable object: The callable should take a single argument, the replacement latex string associated with a piece of the input (maybe a special character) that has been encoded; it should return the actual string to append to the output string. .. versionadded:: 2.10 You can specify a callable object to `replacement_latex_protection` since `pylatexenc 2.10`. .. py:attribute:: unknown_char_policy What to do when a non-ascii character is encountered without any known substitution macro. The attribute `unknown_char_policy` can be set to one of: - 'keep': keep the character as is; - 'replace': replace the character by a boldface question mark; - 'ignore': ignore the character from the input entirely and don't output anything for it; - 'fail': raise a `ValueError` exception; - 'unihex': output the unicode hexadecimal code (U+XXXX) of the character in typewriter font; - a Python callable --- will be called with argument the character that could not be encoded. (If the callable accepts a second argument called 'u2lobj', then the `UnicodeToLatexEncoder` instance is provided to that argument.) The return value of the callable is used as LaTeX replacement code. .. py:attribute:: unknown_char_warning In addition to the `unknown_char_policy`, this attribute indicates whether or not (`True` or `False`) one should generate a warning when a nonascii character without any known latex representation is encountered. (Default: True) .. py:attribute:: latex_string_class The return type of :py:meth:`unicode_to_latex()`. Normally this is a simple unicode string (`str` on `Python 3` or `unicode` on `Python 2`). But you can specify your custom string type via the `latex_string_class` argument. The `latex_string_class` will be invoked with no arguments to construct an empty object (so `latex_string_class` can be either an object that can be constructed with no arguments or it can be a function with no arguments that return a fresh object instance). The object must support the operation "+=", i.e., you should overload the ``__iadd__()`` method. For instance, you can record the chunks that would have been appended into a single string as follows:: class LatexChunkList: def __init__(self): self.chunks = [] def __iadd__(self, s): self.chunks.append(s) return self u = UnicodeToLatexEncoder(latex_string_class=LatexChunkList, replacement_latex_protection='none') result = u.unicode_to_latex("é → α") # result.chunks == [ r"\'e", ' ', r'\textrightarrow', ' ', # r'\ensuremath{\alpha}' ] .. warning:: None of the above attributes should be modified after constructing the object. The values specified to the class constructor are final and cannot be changed. [Indeed, the class constructor "compiles" these attribute values into a data structure that makes :py:meth:`unicode_to_text()` slightly more efficient.] .. versionadded:: 2.0 This class was introduced in `pylatexenc 2.0`. c |>URSS5UlURSS/5UlURSS5UlURSS5UlURS S 5UlURS [ 5UlU(a3[RS S RUR555 [[U]:"S0UD6 [R R#SUR55n/UlUGHinUR&[(:XaGUR$R+[,R."UR0UR2U55 M_UR&[4:XaGUR$R+[,R."UR6UR2U55 MUR&[8:XazUR2nS[;U5S;a[,R."UR2US9nUR$R+[,R."UR<XC55 GMH[?SRAUR&55e [CUR[D5(a!URGSURSS9Ul$O[KUR5(aUURnS[;U5S;a%[,R."URUS9Ul$O6URUl$O$[?SRAUR55eUR (dSUl&UR(aURNUl(OSUl(URSUR5Ul*g)Nnon_ascii_onlyFconversion_rulesr-rbracesunknown_char_policykeepunknown_char_warningTlatex_string_classz&Ignoring unknown keyword arguments: %s,c3h# UH(n[U[5(a [U5OU/v M* g7fr) isinstance basestringr3).0rs r 1UnicodeToLatexEncoder.__init__..s2B *1;1j0I0I )! ,QRu T*s02u2lobjr)rFzInvalid rule type: {}do_unknown_charwhatz.Invalid argument for unknown_char_policy: {!r}cgrr+)chs r0UnicodeToLatexEncoder.__init__..sDrcg)NFr+)sps rrLrMs%rr+)+popr7r8rr:r<unicoder=loggerwarningjoinkeyssuperr5r itertoolschain from_iterable_compiled_rulesrr/append functoolspartial_apply_rule_dictr RULE_REGEX_apply_rule_regex RULE_CALLABLEr_apply_rule_callable TypeErrorrr@rA_get_method_fn_do_unknown_charcallable_do_warn_unknown_char_check_do_skip_ascii_maybe_skip_ascii_get_replacement_latex_fn_apply_protection)rkwargsexpanded_conversion_rulesr thecallablefnr s rrUnicodeToLatexEncoder.__init__s$jj)95A & += | L,2JJ7UW_,`)#)::.CV#L $*JJ/Et$L!"(**-A7"K  NNCSXXfkkmE\ ] #T3=f=%.OO$A$AB **B % ! "-D~~*$$++%%d&;&;TYYM:-$$++%%d&<& >t~~ NOO#.( d.. ; ;$($7$7!((*%8%D ! d.. / /))B>"-a00(1(9(9$:R:R[_(`%(,(@(@%L#VD$<$<=? ?(()8D &   %)%>%>D "%7D ""&!?!?  - -" rcSU-S-URSS5-n[X5(d[SRX255e[ X5$)N_-zInvalid {}: {})replacehasattrr1rgetattr)rbasenamerI selfmethnames rre$UnicodeToLatexEncoder._get_method_fn sMTzC'$,,sC*@@ t**-44T@A At**rcH[U5(aU$URSUSS9$)Napply_protectionrrH)rgre)rrs rrk/UnicodeToLatexEncoder._get_replacement_latex_fns5 0 1 1/ /""  (/#  rc[U5n[R"SU5n"SS5nU"5nUR5UlSUlUR [ U5:aURX5(aM1URHnU"X5(dM O XR n[U5nUS:aUS::dUS;a+U=RU- slU=R S- slOJURU5 U=RURU5- slU=R S- slUR [ U5:aMUR$) z Convert unicode characters in the string `s` into latex escape sequences, according to the rules and options given to the constructor. NFCc\rSrSrSrg)3UnicodeToLatexEncoder.unicode_to_latex.._NSi!r+N)r!r&r'r(r*r+rr_NSr!s4rrr z r ) rR unicodedata normalizer=latexposlenrjr[ordrhrf)rrOrrP compiledrulerKos runicode_to_latex&UnicodeToLatexEncoder.unicode_to_latexs AJ  ! !% + E))+eec!fn%%a++ $ 4 4 %%!5uuXGGSbHnGGrMGEEQJE..r2GGt44R88GEEQJE)eec!fn,wwrc[XR5S:a7U=RXR- slU=RS- slgg)Nrr TF)rrr)rrOrPs rri*UnicodeToLatexEncoder._check_do_skip_ascii?s; qx=3  GGqx G EEQJErcj[X4R5nXQ;aURXAUSU5 gg)Nr T)rr_apply_replacement)rruledictrrOrPrs rr_&UnicodeToLatexEncoder._apply_rule_dictHs2 %%M =  # #A{At <rcUHupVURX4R5nUcM%[U5(a U"U5nOURU5nUR XHUR 5UR 5- U5 g gNT)matchrrgexpandrendstart) r ruleregexesrrOrPregexreplmreplstrs rra'UnicodeToLatexEncoder._apply_rule_regexNso&KE Auu%A}D>>"1gGhhtnG''AEEGaggi4GN'rc\U"X4R5nUcgUupgURXGXb5 gr)rr)r rulecallablerrOrPresconsumedrs rrc*UnicodeToLatexEncoder._apply_rule_callableYs31ee$ ; 8rcURnURbURUR5nU"U5nU=RU- slU=RU- slgr)rlrrkrr)rrPrnumcharsruleobj protect_fns rr(UnicodeToLatexEncoder._apply_replacementas]++   / / ;7744J$ 4 rcU$rr+rrs r_apply_protection_none,UnicodeToLatexEncoder._apply_protection_noneps rcxURS5nUS:a"XS-SR5(aSU-S-$U$)N\rr {}rfindisalpharrks r_apply_protection_braces.UnicodeToLatexEncoder._apply_protection_bracesssA JJt  6dQ34j((**:# # rc(USSS:XaSU-S-$U$)Nrr rrrr+rs r#_apply_protection_braces_almost_all9UnicodeToLatexEncoder._apply_protection_braces_almost_allys$ !9 :# # rcSU-S-$)Nrrr+rs r_apply_protection_braces_all2UnicodeToLatexEncoder._apply_protection_braces_all}sTzCrcrURS5nUS:aXS-SR5(aUS-$U$)Nrrr z{}rrs r$_apply_protection_braces_after_macro:UnicodeToLatexEncoder._apply_protection_braces_after_macros< JJt  6dQ34j((**$;  rcU$rr+rrKs r_do_unknown_char_keep+UnicodeToLatexEncoder._do_unknown_char_keeps rcg)Nz {\bfseries ?}r+rs r_do_unknown_char_replace.UnicodeToLatexEncoder._do_unknown_char_replacesrcg)Nr0r+rs r_do_unknown_char_ignore-UnicodeToLatexEncoder._do_unknown_char_ignoresrc4[S[U5U4-5eNu>No known latex representation for character: U+%04X - ‘%s’)r1rrs r_do_unknown_char_fail+UnicodeToLatexEncoder._do_unknown_char_fails"Yr7B-() )rcS[U5-$)Nz7\ensuremath{\langle}\texttt{U+%04X}\ensuremath{\rangle})rrs r_do_unknown_char_unihex-UnicodeToLatexEncoder._do_unknown_char_unihexsI3r7SSrcD[RS[U5U5 gr)rSrTrrs rrh+UnicodeToLatexEncoder._do_warn_unknown_charsW2w $r) rlr[rfrhrjr8r=r7rr:r<)r!r&r'r(r)rrerkrrir_rarcrrrrrrrrrrrrhr* __classcell__)r s@rr5r5swgPK Z+  $N     )T$$rr5) __future__rrrrloggingsysr]rX version_infomajorstrrRrAtypesrrinspectrdictr getLoggerr!rSrr/r`rbrr3objectr5r+rrrs4IH AGJ;&4   8 $),      HJFF$FF$r