-PhhHUdZddlmZddlZddlZddlmZddlmZddlm Z ddl m Z ddl Z ddl m Z dd lmZdd lmZmZmZdd lmZdd lmZmZdd lmZddlmZddlmZddlm Z ej!e"Z#ej$dZ%e rxddl&m'Z'm(Z(ddl)m*Z*m+Z+ddl m,Z,m-Z-ddl.m/Z/ddl0m1Z1m2Z2m3Z3ddl4m5Z5ddlm6Z6m7Z7ddl8m9Z9ddl:m;Z;ddlm?Z?Gdde-Z@Gdd e-ZAGd!d"e-ZBeCZDd#eEd$<edbd'ZFdcd+ZGddd/ZHdcd0ZIded3ZJdfd4ZKdgd7ZLdhd8ZMdhd9ZNedbd:ZOedbd;ZPedid>ZQedjdid?ZRGd@dAZSGdBdCeTZUGdDdEeSZVGdFdGZWGdHdIeZXGdJdKeZYedkdPZZGdQdReZ[GdSdTeZ\GdUdVZ]GdWdXe]Z^GdYdZe j_Z`d[eEd\<djdldaZadS)mzUtility functions for docutils.) annotationsN)contextmanager)copy)Path) TYPE_CHECKING)nodes) FileOutput) Directive directivesroles) StateMachine)Reporterunescape) SphinxError)__)logging)nested_parse_to_nodesz>^(.+?:(?:\d+)?): \((DEBUG|INFO|WARNING|ERROR|SEVERE)/(\d+)?\) )IteratorSequence) ModuleType TracebackType)AnyProtocol)Values)ElementNodesystem_message)Inliner)State StringList)Builder)Config)BuildEnvironment) RoleFunctionc.eZdZUded<ded<ded<dS)_LanguageModulezdict[str, str]labelsz list[str]author_separatorsbibliographic_fieldsN)__name__ __module__ __qualname____annotations__T/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/sphinx/util/docutils.pyr&r&,s6$$$$''''''r/r&ceZdZd d Zd S) _DirectivesDispatcherdirective_namestrlanguage_moduler&documentnodes.documentreturn3tuple[type[Directive] | None, list[system_message]]cdSNr.selfr3r5r6s r0__call__z_DirectivesDispatcher.__call__2s CF#r/N)r3r4r5r&r6r7r8r9r*r+r,r>r.r/r0r2r21s. F F F F F Fr/r2ceZdZd d Zd S)_RolesDispatcher role_namer4r5r&linenointreporterrr80tuple[RoleFunction | None, list[system_message]]cdSr;r.r=rBr5rCrEs r0r>z_RolesDispatcher.__call__;s @Csr/N) rBr4r5r&rCrDrErr8rFr?r.r/r0rArA:s. C C C C C Cr/rAzset[type[Element]]additional_nodesr8Iterator[None]c#K ttj}ttj}dV|t_|t_t t D]+}t|t |,dS#|t_|t_t t D]+}t|t |,wxYw)z"Create namespace for reST parsers.N) rr _directivesr _roleslistrIunregister_nodediscard)rLrMnodes r0docutils_namespacerRHs +:122 el## !,  )** + +D D ! ! !  $ $T * * * * + +"-  )** + +D D ! ! !  $ $T * * * * +s 6BAC.namer4boolc|tjvS)z1Check the *name* directive is already registered.)r rLrSs r0is_directive_registeredrWYs :) ))r/ directivetype[Directive]Nonec0tj||dS)zRegister a directive to docutils. This modifies global state of docutils. So it is better to use this inside ``docutils_namespace()`` to prevent side-effects. N)r register_directive)rSrXs r0r\r\^s !$ 22222r/c|tjvS)z,Check the *name* role is already registered.)r rMrVs r0is_role_registeredr^gs 5< r/roler$c0tj||dS)zRegister a role to docutils. This modifies global state of docutils. So it is better to use this inside ``docutils_namespace()`` to prevent side-effects. N)r register_local_role)rSr_s r0 register_rolerbls  dD)))))r/cFtj|ddS)z Unregister a role from docutils.N)r rMpoprVs r0unregister_rolereus  LT4     r/rQ type[Element]cFttjd|jzS)z'Check the *node* is already registered.visit_)hasattrrGenericNodeVisitorr*rQs r0is_node_registeredrlzs 5+X -E F FFr/cttjd|jzs6tj|jgt |dSdS)zRegister a node to docutils. This modifies global state of some visitors. So it is better to use this inside ``docutils_namespace()`` to prevent side-effects. rhN)rirrjr*_add_node_class_namesrIaddrks r0 register_noderpsY 5+X -E F F# #T]O444T"""""##r/c^ttjd|jzrt tjd|jzt tjd|jzt tjd|jzt tjd|jzdSdS)zaUnregister a node from docutils. This is inverse of ``nodes._add_nodes_class_names()``. rhdepart_N)rirrjr*delattrSparseNodeVisitorrks r0rOrOs u'DM)ABBD((T]*BCCC()dm*CDDD'DM)ABBB'T])BCCCCC DDr/c#Kddlm d d fd } |tj_dVtj_dS#tj_wxYw) zPatch docutils.languages.get_language() temporarily. This ignores the second argument ``reporter`` to suppress warnings. See: https://github.com/sphinx-doc/sphinx/issues/3788 r get_languageN language_coder4rEReporter | Noner8rc|Sr;r.rxrErws r0patched_get_languagez2patched_get_language..patched_get_language|M***r/r;rxr4rEryr8r)docutils.languagesrwdocutils languagesr|rws @r0r|r|s0/////9=+++++++ 7*>' +7''','6666s ;Ac#Kddlm d d fd } |tjjj_dVtjjj_dS#tjjj_wxYw) a]Patch docutils.parsers.rst.languages.get_language(). Starting from docutils 0.17, get_language() in ``rst.languages`` also has a reporter, which needs to be disabled temporarily. This should also work for old versions of docutils, because reporter is none by default. See: https://github.com/sphinx-doc/sphinx/issues/10179 rrvNrxr4rEryr8rc|Sr;r.r{s r0r|z6patched_rst_get_language..patched_get_languager}r/r;r~)docutils.parsers.rst.languagesrwrparsersrstrrs @r0patched_rst_get_languagers<;;;;;9=+++++++ C6J&3 7C&333l&3BBBBs AA,confdirstr | os.PathLike[str] | Nonec#K tjdd}|r>t|d}t |tjd<dV|"tjdddS|tjd<dS#|!tjddn|tjd<wxYw)z?Let docutils know the location of ``docutils.conf`` for Sphinx.DOCUTILSCONFIGNz docutils.conf)osenvirongetrresolver4rd)rdocutils_configdocutils_conf_paths r0using_user_docutils_confrs ;*..)94@@  C!%g!?!?!G!G!I!I +./A+B+BBJ' (   " JNN+T 2 2 2 2 2+:BJ' ( ( (  " JNN+T 2 2 2 2+:BJ' ( : : : :s A$B4Cc#Kt5t5t|5dVdddn #1swxYwYdddn #1swxYwYddddS#1swxYwYdS)zPatch to docutils temporarily.N)r|rr)rs r0patch_docutilsrsI  "" !))  sVA0AA AA AA A A0A A0A A00A47A4cJeZdZdZddZddZd d Zdd ZddZd!dZ d"dZ dS)#CustomReSTDispatcherzCustom reST's mark-up dispatcher. This replaces docutils's directives and roles dispatch mechanism for reST parser by original one temporarily. r8rZc&d|_d|_dS)Nc dgfSr;r.argss r0z/CustomReSTDispatcher.__init__..s D":r/c dgfSr;r.rs r0rz/CustomReSTDispatcher.__init__..s 4*r/)directive_func roles_funcr=s r0__init__zCustomReSTDispatcher.__init__s5M5M,D,Dr/c.|dSr;)enablers r0 __enter__zCustomReSTDispatcher.__enter__s r/exc_typetype[BaseException] | None exc_valueBaseException | None tracebackTracebackType | Nonec.|dSr;)disable)r=rrrs r0__exit__zCustomReSTDispatcher.__exit__s r/ctj|_tj|_|jt_|jt_dSr;)r rXrr r_ role_funcrs r0rzCustomReSTDispatcher.enables-(2#~ Y r/cJ|jt_|jt_dSr;)rr rXrr r_rs r0rzCustomReSTDispatcher.disables#2 ^ r/r3r4r5rr6r7r9c0||||Sr;)rr<s r0rXzCustomReSTDispatcher.directives "">?HMMMr/rBrCrDrEr)tuple[RoleFunction, list[system_message]]c2|||||Sr;)rrHs r0r_zCustomReSTDispatcher.role s&~~        r/Nr8rZ)rrrrrrr8rZr3r4r5rr6r7r8r9 rBr4r5rrCrDrErr8r) r*r+r,__doc__rrrrrrXr_r.r/r0rrs EEEE$$$$NNNN       r/rceZdZdS)ElementLookupErrorN)r*r+r,r.r/r0rrsDr/rc<eZdZdZdfd Zdfd Zdfd ZxZS)sphinx_domainszcMonkey-patch directive and role dispatch, so that domain-specific markup takes precedence. envr#r8rZcx|j|_|j|_tdSr;)domainscurrent_documentsuperr)r=r __class__s r0rzsphinx_domains.__init__"s3{ # 4 r/r3r4r5rr6r7r9c|}d|vr{|d\}}} |j|}||}||gfSnc#t$r+t td|Yn/wxYw|}|jj } | | |}||gfS|jj |}||gfSt|||S)z>Lookup a directive, given its name which can include a domain.:Nzunknown directive name: %s) lower partitionrrXKeyErrorloggerwarningrrdefault_domainstandard_domainr) r=r3r5r6 domain_name_rSdomainelementrrs r0rXzsphinx_domains.directive's;(--// . #1#;#;C#@#@ KD 'k2!**400&"B;&'  Q Q Qr">??PPPPP Q"D!2AN)(22488&"B;&,.88>>  B; ww  (KKK A2BBrBrCrDrErrc|}d|vr{|d\}}} |j|}||} | | gfSnc#t$r+t td|Yn/wxYw|}|jj } | | |} | | gfS|jj |} | | gfSt||||S)z9Lookup a role, given its name which can include a domain.rNzunknown role name: %s) rrrr_rrrrrrrr) r=rBr5rCrErrrSrrrrs r0r_zsphinx_domains.roleJs7OO%% )  #,#6#6s#;#; KD 'k2!++d++&"B;&'  G G Gr"9::IFFFFF GD!2AN)(--d33&"B;&,.33D99  B; ww||IIIIr)rr#r8rZrr)r*r+r,rrrXr_ __classcell__rs@r0rrs !L!L!L!L!L!LF"J"J"J"J"J"J"J"J"J"Jr/rceZdZddZdS) WarningStreamtextr4r8rZcft|}|s1t|dddS|\}}}td|}t|||ddS)Nz r)type)locationr) report_researchrrrstripgroupssublog)r=rmatchedrrlevelmessages r0writezWarningStream.writeps""4(( J NN4;;v..ZN @ @ @ @ @$+NN$4$4 !HdEmmB--4466G JJtWxjJ I I I I Ir/N)rr4r8rZ)r*r+r,rr.r/r0rros.JJJJJJr/rcVeZdZeddZejejddfdfd ZxZ S)LoggingReporterclstype[LoggingReporter]rErr8cR||j|j|j|j|jS)zACreate an instance of LoggingReporter from other reporter object.)source report_level halt_level debug_flag error_handler)rrEs r0 from_reporterzLoggingReporter.from_reporter{s5 s O  !      "    r/Fbackslashreplacerr4rrDrdebugrTrrZcrt}t||||||dS)N)r)rrr)r=rrrrrstreamrs r0rzLoggingReporter.__init__sF  L*fe=      r/)rrrErr8r) rr4rrDrrDrrTrr4r8rZ) r*r+r, classmethodrr WARNING_LEVEL SEVERE_LEVELrrrs@r0rrzst    [  %2"//            r/rc$eZdZdZdfd ZxZS) NullReporterz A dummy reporter; write nothing.r8rZcNtddddS)Nri)rr)r=rs r0rzNullReporter.__init__s% S!$$$$$r/r)r*r+r,rrrrs@r0rrsC**%%%%%%%%%%r/rstateState[list[str]]contentr c#K |jjj}tgd}||_|j|jj_dV||jj_dS#||jj_wxYw)z1Switch current source input of state temporarily.N)memorEget_source_and_liner input_lines)rrgsal state_machines r0switch_source_inputrsx 7z"6-9T,B,B $+ !2?2S / 37 ///$ /6666s AAA,c0eZdZdZd fd Zd fd ZxZS) SphinxFileOutputz#Better FileOutput class for Sphinx.kwargsrr8rZc |dd|_|ddtjdi|dS)Noverwrite_if_changedFencodingzutf-8r.)rdr setdefaultrr)r=rrs r0rzSphinxFileOutput.__init__sS$*JJ/Eu$M$M!*g...""6"""""r/datar4ch|jr|jrd|jvrz|jrstj|jrOt|j|j5}| }dddn #1swxYwY||kr|St |S)Nb)r ) destination_path autoclosemoderrpathexistsopenr readrr)r=r fon_diskrs r0rzSphinxFileOutput.writes  !  49$$)%t455%d+dmDDD #&&(( # # # # # # # # # # # # # # #$ ww}}T"""sBBB)rrr8rZ)r r4r8r4)r*r+r,rrrrrs@r0rrsa--###### ##########r/rceZdZdZed dZed!dZd"dZd#d Zd$dZ d%d&dZ d'dddd(dZ ddd)dZ dS)*SphinxDirectiveaA base class for Sphinx directives. This class provides helper methods for Sphinx directives. .. versionadded:: 1.8 .. note:: The subclasses of this class might not work with docutils. This class is strongly coupled with Sphinx. r8r#c.|jjjjS)z[Reference to the :class:`.BuildEnvironment` object. .. versionadded:: 1.8 )rr6settingsrrs r0rzSphinxDirective.envs z"+//r/r"c|jjS)zQReference to the :class:`.Config` object. .. versionadded:: 1.8 rconfigrs r0rzSphinxDirective.config xr/tuple[str, int]c@|j|jS)zCGet source and line number. .. versionadded:: 3.0 )rrrCrs r0get_source_infozSphinxDirective.get_source_infos !55dkBBBr/rQrrZcH|\|_|_dS)zOSet source and line number to the node. .. versionadded:: 2.1 Nr!rliner=rQs r0set_source_infozSphinxDirective.set_source_infos" "&!5!5!7!7 TYYYr/r4cf|\}}|r |r|d|S|r|dS|rd|SdSzNGet current location info for logging. .. versionadded:: 4.2 rz :rr!r=rr$s r0 get_locationzSphinxDirective.get_locationk ++--   &d &%%t%% %  <<<   '&&& &rr/Fallow_section_headingsrT list[Node]cFt|j|j|j|S)aParse the directive's content into nodes. :param allow_section_headings: Are titles (sections) allowed in the directive's content? Note that this option bypasses Docutils' usual checks on doctree structure, and misuse of this option can lead to an incoherent doctree. In Docutils, section nodes should only be children of ``Structural`` nodes, which includes ``document``, ``section``, and ``sidebar`` nodes. .. versionadded:: 7.4 offsetr-)rrrcontent_offset)r=r-s r0parse_content_to_nodesz&SphinxDirective.parse_content_to_nodess.% J L     r/rr0rr1rDcL|dkr|j}t|j|||S)aParse *text* into nodes. :param text: Text, in string form. ``StringList`` is also accepted. :param allow_section_headings: Are titles (sections) allowed in *text*? Note that this option bypasses Docutils' usual checks on doctree structure, and misuse of this option can lead to an incoherent doctree. In Docutils, section nodes should only be children of ``Structural`` nodes, which includes ``document``, ``section``, and ``sidebar`` nodes. :param offset: The offset of the content. .. versionadded:: 7.4 r4r0)r2rr)r=rr1r-s r0parse_text_to_nodesz#SphinxDirective.parse_text_to_nodess:0 R<<(F$ J #9     r/)rCrC'tuple[list[Node], list[system_message]]cR|dkr|j}|j||S)aParse *text* as inline elements. :param text: The text to parse, which should be a single line or paragraph. This cannot contain any structural elements (headings, transitions, directives, etc). :param lineno: The line number where the interpreted text begins. :returns: A list of nodes (text and inline elements) and a list of system_messages. .. versionadded:: 7.4 r4)rCr inline_text)r=rrCs r0 parse_inlinezSphinxDirective.parse_inline6s, R<<[Fz%%dF333r/Nr8r#r8r")r8rrQrr8rZr8r4)F)r-rTr8r.)r)rr4r1rDr-rTr8r.)rr4rCrDr8r7) r*r+r,rpropertyrrr!r&r+r3r6r:r.r/r0rrs000X0XCCCC8888    .3     0 ',       D+-44444444r/rceZdZUdZded<ded<ded<ded<ded <d ed <d ed < d!d"dZd#dZed$dZed%dZ d&d'dZ d&d(dZ d)d Z dS)* SphinxRolezA base class for Sphinx roles. This class provides helper methods for Sphinx roles. .. versionadded:: 2.0 .. note:: The subclasses of this class might not work with docutils. This class is strongly coupled with Sphinx. r4rSrawtextrrDrCrinlinerzdict[str, Any]options Sequence[str]rNr.dict[str, Any] | Noner8r7cn||_t||_||_||_||ni|_||_|r||_nK|j j j |_|js|j j j |_|jsd}t||S)Nzcannot determine default role!)rBrrrCrCrDrrrSrr default_rolerrrun) r=rSrBrrCrCrDrmsgs r0r>zSphinxRole.__call__ds TNN   ")"5ww2    ' DII1>DI9 9 HO8 9 '6!#&&&xxzzr/ctr;)NotImplementedErrorrs r0rIzSphinxRole.runs!!r/r#c.|jjjjS)z[Reference to the :class:`.BuildEnvironment` object. .. versionadded:: 2.0 )rCr6rrrs r0rzSphinxRole.envs |$-11r/r"c|jjS)zQReference to the :class:`.Config` object. .. versionadded:: 2.0 rrs r0rzSphinxRole.configrr/ int | NonercR||j}|jj|Sr;)rCrCrEr)r=rCs r0r!zSphinxRole.get_source_infos' >[F|$88@@@r/rQrrZcJ||\|_|_dSr;r#)r=rQrCs r0r&zSphinxRole.set_source_infos"!%!5!5f!=!= TYYYr/cf|\}}|r |r|d|S|r|dS|rd|SdSr(r)r*s r0r+zSphinxRole.get_locationr,r/Nr.rSr4rBr4rr4rCrDrCrrDrFrrEr8r7)r8r7r;r<r;)rCrOr8r)rQrrCrOr8rZr>) r*r+r,rr-r>rIr?rrr!r&r+r.r/r0rArAKs.IIILLL IIIKKK*.!#<""""222X2XAAAAA >>>>>      r/rAceZdZUdZded<ded<ded<ded<ejdejZ ddfd Z xZ S) ReferenceRoleaA base class for reference roles. The reference roles can accept ``link title `` style as a text for the role. The parsed result; link title and target will be stored to ``self.title`` and ``self.target``. .. versionadded:: 2.0 rThas_explicit_titledisabledr4titletargetz^(.+?)\s*(?$Nr.rSrBrrCrDrCrrDrFrrEr8r7c |i}|d|_|j|}|rVd|_t |d|_t |d|_n/d|_t ||_t ||_t |||||||S)N!TF) startswithrXexplicit_title_rematchrWrgrouprYrZrr>) r=rSrBrrCrCrDrrrs r0r>zReferenceRole.__call__s ?G,, (..t44  )&*D #!'--"2"233DJ"7==#3#344DKK&+D #!$DJ"4..DKwwgtVWgwWWWr/rSrT) r*r+r,rr-recompileDOTALLr`r>rrs@r0rVrVsNNNJJJKKK# #@")LL*.!#XXXXXXXXXXXr/rVcDeZdZdZdfd Zdfd Zdfd Zdd ZxZS)SphinxTranslatoraA base class for Sphinx translators. This class adds a support for visitor/departure method for super node class if visitor/departure method for node class is not found. It also provides helper methods for Sphinx translators. .. versionadded:: 2.0 .. note:: The subclasses of this class might not work with docutils. This class is strongly coupled with Sphinx. r6r7builderr!r8rZct|||_|j|_|j|_|jj|_dSr;)rrrhrrrr_domains)r=r6rhrs r0rzSphinxTranslator.__init__sE """ n  )  + r/rQrc|jjD]+}t|d|jzd}|r||dS,t |dS)zDispatch node to appropriate visitor method. The priority of visitor method is: 1. ``self.visit_{node_class}()`` 2. ``self.visit_{super_node_class}()`` 3. ``self.unknown_visit()`` zvisit_%sN)r__mro__getattrr*rdispatch_visitr=rQ node_classmethodrs r0rnzSphinxTranslator.dispatch_visitss.0 ) )JT: 0C#CTJJF t   GG " "4 ( ( ( ( (r/c|jjD]+}t|d|jzd}|r||dS,t |dS)zDispatch node to appropriate departure method. The priority of departure method is: 1. ``self.depart_{node_class}()`` 2. ``self.depart_{super_node_class}()`` 3. ``self.unknown_departure()`` z depart_%sN)rrlrmr*rdispatch_departureros r0rsz#SphinxTranslator.dispatch_departuress.0 - -JT;1D#DdKKF t   GG & &t , , , , ,r/cZttd||dS)Nzunknown node type: %r)r)rrrr%s r0 unknown_visitzSphinxTranslator.unknown_visits)r122D4HHHHHr/)r6r7rhr!r8rZr=) r*r+r,rrrnrsrurrs@r0rgrgs  ,,,,,,)))))) ------ IIIIIIIIr/rgztuple[Values, Reporter]__document_cache__ source_pathrrr7c t\}}nB#t$r5tj|}|j|jfxa\}}YnwxYw|t|}tj |||}| |d|S)a&Return a new empty document object. This is an alternative of docutils'. This is a simple wrapper for ``docutils.utils.new_document()``. It caches the result of docutils' and use it on second call for instantiation. This makes an instantiation of document nodes much faster. N)rr4) rv NameErrorrutils new_documentrrErrr6 note_source)rwrcached_settingsrEdocr6s r0r{r{sT$6! TTTn))+669<s|9SS6_hhhT((~hEEEH b))) Os rs%%%"""""" %%%%%% """"""==========......--------%%%%%%555555  8 $ $ BJH   %C22222222////////$$$$$$$$((((((<<<<<<<<<<33333377777777''''''$$$$$$333333//////((((((((( FFFFFFFFCCCCC8CCC(+suu,,,, + + + + **** 3333    ****!!!! GGGG #### D D D D7777*CCCC2 ; ; ; ;5 5 5 5 5 5 5 5 p        OJOJOJOJOJ)OJOJOJdJJJJJJJJ     h   8%%%%%8%%%7777"#####z###2@4@4@4@4@4i@4@4@4F````````F.X.X.X.X.XJ.X.X.Xb6I6I6I6I6Iu(6I6I6Iv,+++r/