wC!WdZdZddlmZddlmZddlmZddl m Z m Z dZ iZ iZ dZd Zd Zd Zd ZGd dZGddZ d3dZdej.ie_edej2edej4edej6edej8edej:edej<edej>edej@ d3dZ!ede! d3dZ"ede"d3dZ#d ejHie#_ed!e# d3d"Z%d#ejHie%_ed$e% d3d%Z&ed&e& d3d'Z'ed(e'ed)e'ed*e'ed+e'ed,e'ed-e'ed.e'ed/e'ed0e'd1Z(d2Z)y)4a This module defines standard interpreted text role functions, a registry for interpreted text roles, and an API for adding to and retrieving from the registry. See also `Creating reStructuredText Interpreted Text Roles`__. __ https://docutils.sourceforge.io/docs/ref/rst/roles.html The interface for interpreted role functions is as follows:: def role_fn(name, rawtext, text, lineno, inliner, options=None, content=None): code... # Set function attributes for customization: role_fn.options = ... role_fn.content = ... Parameters: - ``name`` is the local name of the interpreted text role, the role name actually used in the document. - ``rawtext`` is a string containing the entire interpreted text construct. Return it as a ``problematic`` node linked to a system message if there is a problem. - ``text`` is the interpreted text content, with backslash escapes converted to nulls (````). - ``lineno`` is the line number where the text block containing the interpreted text begins. - ``inliner`` is the Inliner object that called the role function. It defines the following useful attributes: ``reporter``, ``problematic``, ``memo``, ``parent``, ``document``. - ``options``: A dictionary of directive options for customization, to be interpreted by the role function. Used for additional attributes for the generated elements and other functionality. - ``content``: A list of strings, the directive content for customization ("role" directive). To be interpreted by the role function. Function attributes for customization, interpreted by the "role" directive: - ``options``: A dictionary, mapping known option names to conversion functions such as `int` or `float`. ``None`` or an empty dict implies no options to parse. Several directive option conversion functions are defined in the `directives` module. All role functions implicitly support the "class" option, unless disabled with an explicit ``{'class': None}``. - ``content``: A boolean; true if content is allowed. Client code must handle the case where content is required but not supplied (an empty content list will be supplied). Note that unlike directives, the "arguments" function attribute is not supported for role customization. Directive arguments are handled by the "role" directive itself. Interpreted role functions return a tuple of two values: - A list of nodes which will be inserted into the document tree at the point where the interpreted role was encountered (can be an empty list). - A list of system messages, which will be inserted into the document tree immediately after the end of the current inline block (can also be empty). reStructuredText)nodes) directives)en)Lexer LexerErrorztitle-referencec|j}g}g}|tvr t||fS|rd} |j|}nt}|s( tj|}|j d|z|r3|jd j|| } |j | |tvrt|} t|| | |fSd|fS#t$r"}|j d|d|dYd}~d}~wt $r%|j d|d|j dYwxYw#t $r|j d |z|}YwxYw) a1 Locate and return a role function from its language-dependent name, along with a list of system messages. If the role is not found in the current language, check English. Return a 2-tuple: role function (``None`` if the named role cannot be found) and a list of system messages. Nz3Problem retrieving role entry from language module z: .zNo role entry for "z " in module "z".z%Using English fallback for role "%s".z#Trying "%s" as canonical role name. line) lower_rolesrolesAttributeErrorappendKeyError__name__DEFAULT_INTERPRETED_ROLE_fallback_language_moduleinfojoin_role_registryregister_local_role) role_namelanguage_modulelinenoreporternormnamemessagesmsg_text canonicalnameerrormessagerole_fns ?/usr/lib/python3.12/site-packages/docutils/parsers/rst/roles.pyroler'fsn HHH6h))  E+11(;M1   %5;;HEM OOC'( )-- ( 3&-A & /Hg.  >? I OO0?H I I E OO(/*B*BD E E % OOA'( )%M  %s/C'D! DC--.DD!EEcHt||t|j<y)z Register an interpreted text role by its canonical name. :Parameters: - `name`: The canonical name of the interpreted role. - `role_fn`: The role function. See the module docstring. N)set_implicit_optionsrrnamer%s r&register_canonical_roler,s!#*N4::< cHt||t|j<y)z Register an interpreted text role by its local or language-dependent name. :Parameters: - `name`: The local or language-dependent name of the interpreted role. - `role_fn`: The role function. See the module docstring. N)r)rrr*s r&rrs!"F4::<r-ct|dr |jdtji|_yd|jvrtj|jd<yy)z] Add customization options to role functions, unless explicitly set or disabled. optionsNclass)hasattrr0r class_option)r%s r&r)r)sN 7I &'//*A"J$;$;<  '#-#:#:  (r-c4t||}t||y)zAFor roles which simply wrap a given `node_class` around the text.N) GenericRoler,)canonical_name node_classr's r&register_generic_roler8s ~z 2DND1r-c eZdZdZdZ ddZy)r5zr Generic interpreted text role. The interpreted text is simply wrapped with the provided node class. c ||_||_yN)r+r7)selfrr7s r&__init__zGenericRole.__init__s $r-NcFt|}|j||fi|ggfSr;)normalized_role_optionsr7)r<r'rawtexttextrinlinerr0contents r&__call__zGenericRole.__call__s,)'299:B>>r-NNr __module__ __qualname____doc__r=rDr-r&r5r5s % (,?r-r5c"eZdZdZddZ ddZy) CustomRolez*Wrapper for custom interpreted text roles.Nc||_||_t|dd|_t|dd|_||_||_y)Nr0rC)r+ base_rolegetattrr0rCsupplied_optionssupplied_content)r<rrNr0rCs r&r=zCustomRole.__init__s@ "y)T: y)T: ' 'r-c t|j} |j||jxsg} |xsg}| r|rdgng} |j ||||||| | z|zS#t$rYHwxYw)Nr )r0rC)r?rPupdate TypeErrorrQrN) r<r'r@rArrBr0rCoptsrQ delimiters r&rDzCustomRole.__call__s&t'<'<=  KK  006B-R.7TF ~~dGT67&*&6y&@&HJ J    sA%% A10A1rErFrJr-r&rLrLs4((, Jr-rLNcLt|}tj||fi|ggfS)z9Base for custom roles if no other base role is specified.)r?rinline)r'r@rArrBr0rCs r&generic_custom_rolerYs, &g.G LL$ 2' 2 3R 77r-r1 abbreviationacronymemphasisliteralstrong subscript superscriptct|} ttj|}|dks|dkDrt |jjj|jjj|zz} tj|d|zfd| i|ggfS#t$r<|j j d|z|}|j|||} | g|gfcYSwxYw)Nri'z} |jj| } |j||| } | g| gfcYd} ~ Sd} ~ wwxYw)NlanguagecodeclassesT)r)r?getextendrrrrdrgrhsyntax_highlightrrrrfr]rXText)r'r@rArrBr0rCrrtokensr#rmrnrzvalues r& code_rolerUs1%g.G{{:r*HhGGwy)*HG+x u~~dD18''00AAC =="g 6D!  ELLw? ?D EJJu% %D ! 62: &&u-!!'7C8use|s?C-- D463D/)D4/D4rrc|t|}tj|d}tj||fi|}|ggfS)NT)r?rrdmath)r'r@rArrBr0rCrzs r& math_rolerxs=%g.G >>$ %D ::gt /w /D 62:r-rct|jjd|z|}|j|||}|g|gfS)Nz+Interpreted text role "%s" not implemented.r )rr#rf) r'r@rArrBr0rCrmrns r&unimplemented_rolersJ    5<6 ! KC   gw 4C 53%<r-indexznamed-referencezanonymous-referencez uri-referencezfootnote-referencezcitation-referencezsubstitution-referencetargetz#restructuredtext-unimplemented-rolec6|rd|vrd|vsJ|d|d<|d=yyy)z7Deprecated. Obsoleted by ``normalized_role_options()``.r1rNrJ)r0s r& set_classesrs: 7g%'''$W-  G &wr-cX|iS|j}d|vrd|vsJ|d|d<|d=|S)z Return normalized dictionary of role options. * ``None`` is replaced by an empty dictionary. * The key 'class' is renamed to 'classes'. r1r)copy)r0results r&r?r?sI \\^F&&&&"7Oy 7O Mr-rE)*rI __docformat__docutilsrdocutils.parsers.rstrdocutils.parsers.rst.languagesrrdocutils.utils.code_analyzerrrrrrr'r,rr)r8r5rLrYr3r0rZr[r\r]r^r_r`title_referencerpr{r unchangedrrrrr?rJr-r&rs" FP# +J:,  3l + #;2 ??"JJ8/38 ' (?(?@ne&8&89i/j%..1i/h -k5??3mU%6%67')>)>?.2P&);<.22);<&j223x(%)< !5!56  *%) *.2!34)+=>-/AB);<,.@A,.@A02DE"45=*, r-