O&iI.dZddlmZmZmZmZmZmZmZddl m Z ddl m Z m Z ddlmZddlmZddlmZmZddlmZdd lmZdd lmZdd lmZmZdd lmZdd l m!Z!ddl"m#Z#m$Z$ddl%m&Z&ddl'm(Z(ddl)m*Z*m+Z+m,Z,ddl-m.Z.m/Z/ddl0m1Z1m2Z2m3Z3ddl4m5Z5e(j6e7Z8Gddeee9e9fZ:Gdde:Z;Gdde;Z<Gdde.Z=Gdde&Z>Gdd eZ?d!ed"ee9effd#Z@d$S)%zThe JavaScript domain.)AnyDictIteratorListOptionalTuplecast)nodes)ElementNode) directives)addnodes)desc_signature pending_xref)Sphinx)Builder)ObjectDescription)DomainObjType)_pseudo_parse_arglist)BuildEnvironment)___)XRefRole)logging)Field GroupedField TypedField)SphinxDirectiveswitch_source_input)make_id make_refnodenested_parse_with_titles) OptionSpecc(eZdZUdZdZdZejejejdZe e d<de e fdZ dededeeeffd Zd edeed ffd Zd eeefdededdfdZded eeefdefdZddZddZdedefdZd edefdZdS)JSObjectz- Description of a JavaScript object. F)noindex noindexentrynocontentsentry option_specreturncgSNselfs f/home/geonatureadmin/si_en_reseau/tutos/venv/lib/python3.11/site-packages/sphinx/domains/javascript.pyget_display_prefixzJSObject.get_display_prefix.s sigsignodec |}d|vrX|dddkrJ|dd\}}|}|dd}n|}d}|jjdd}|jjd}|} |dd\}} n#t $r|} d }YnwxYw| }|r|rd||g}n0||r|}n)#| }|r|rd||g}n||r|}wxYw|} |rd||g} ||d <||d <| |d <|} | r|tj d d g| Rz }d} |r|} n|r|} | rbtj d d } | dD]2}| tj ||z } | tj ddz } 3|| z }|tjd d tj ||z }|jr)|s|tjz }nt#||| |fS) zBreaks down construct signatures Parses out prefix and argument list from construct definition. The namespace and class will be determined by the nesting of domain directives. (N) js:object js:module.moduleobjectfullname)stripsplitenv ref_contextgetrsplit ValueErrorjoinr2rdesc_annotation desc_addname desc_sig_namedesc_sig_punctuation desc_name has_argumentsdesc_parameterlistr)r0r4r5memberarglistprefixmod_namename member_prefix member_namerAdisplay_prefix actual_prefixaddNameps r1handle_signaturezJSObject.handle_signature2siikk #::#bcc(c//!iiQ//OFG\\^^Fcrcl((**GGFG%))+t<<8'++K88 ')/sA)>)> &M;;   KMMM D '- '6="9::M& D '- '6="9::M&&&&&  0xx//H$"& 0022  I x/BHHHH HG  %"MM  %$M  +B33G"((-- C C81!Q77788cBBB w G8%b"h.DT4.P.PQQQ   8 886888%gw777s*7CD C"D !C""D &D0sig_node.cd|vrdS|d}|d}|r|g|dRSt|dS)NrAr.r?r=)rFrCtuple)r0r]modnamerAs r1_object_hierarchy_partsz JSObject._object_hierarchy_partspsl X % %2,,x((J'  .2hnnS1122 2,,-- -r3name_objNcH|jjd}|r|dznd|dz}t|j|jjd|}|d||jj|tt|j d}| ||j ||d|j vr?|||}|r)|jd d ||ddfdSdSdS) Nr<r=r>ridsjslocationr(entriessingle)rDrErFr!statedocumentappendnote_explicit_targetr JavaScriptDomain get_domain note_objectobjtypeoptionsget_index_text indexnode) r0rbr4r5rTrAnode_iddomain indextexts r1add_target_and_indexzJSObject.add_target_and_index{s,8'++K88&.6HsNNB(1+E$(DJ$7XFFg&&& 00999&(;(;D(A(ABB8T\7WMMM  - -++Hh??I [y)00(IwPRTX1YZZZZZ . - [ [r3 objectnamec(|\}}|jdkr(|std|zStd||fzS|jdkrtd|zS|jdkrtd|zS|jdkrtd ||fzSd S) Nfunctionz%s() (built-in function)z%s() (%s method)classz %s() (class)dataz %s (global variable or constant) attributez%s (%s attribute)r>)rqr)r0ryrbrUobjs r1rszJSObject.get_index_texts c <: % % <344t;;'((D#;6 6 \W $ $^$$t+ + \V # #7884? ? \[ ( (())T3K7 7rr3c6d}|jr>|j\}}|r|dnd}|jr|}|rM||jjd<|jr9|jjdg}||dSdSdS)aHandle object nesting before content :py:class:`JSObject` represents JavaScript language constructs. For constructs that are nestable, this method will build up a stack of the nesting hierarchy so that it can be later de-nested correctly, in :py:meth:`after_content`. For constructs that aren't nestable, the stack is bypassed, and instead only the most recent object is tracked. This object prefix name will be removed with :py:meth:`after_content`. The following keys are used in ``self.env.ref_context``: js:objects Stores the object prefix history. With each nested element, we add the object prefix to this list. When we exit that object's nesting level, :py:meth:`after_content` is triggered and the prefix is removed from the end of the list. js:object Current object prefix. This should generally reflect the last element in the prefix history Nr=r; js:objects)namespoprB allow_nestingrDrE setdefaultrl)r0rSobj_nameobj_name_prefixobjectss r1before_contentzJSObject.before_contents0 : "*.*..*:*: 'X3BL_**3///F! "!  '06DH  -! '(.99,KKv&&&&&  ' ' ' 'r3c|jjdg}|jr& |n#t $rYnwxYwt |dkr|dnd|jjd<dS)a^Handle object de-nesting after content If this class is a nestable object, removing the last nested class prefix ends further nesting in the object. If this class is not a nestable object, the list of classes should not be altered as we didn't affect the nesting levels in :py:meth:`before_content`. rrr8Nr;)rDrErrr IndexErrorlen)r0rs r1 after_contentzJSObject.after_contents(&11,CC          A  A rAc.|ddS)zGenerate old styled node_id for JS objects. .. note:: Old Styled node_id was used until Sphinx-3.0. This will be removed in Sphinx-5.0. $_S_)replace)r0rAs r1 make_old_idzJSObject.make_old_ids U+++r3cv|dsdS|jjj}|jd}|jr|dvrd}nd}|d^}}|jdkr|d||zS|jdkr||zS|jd krd |||zgzSdS) N _toc_partsr>rq>methodr{()rvrAhideallr=)rFrDappconfigparentadd_function_parenthesestoc_object_entries_show_parentsrI)r0r]rrqparensparentsrUs r1_toc_entry_namezJSObject._toc_entry_names||L)) 2$/%%i00  * w:P/P/PFFF!,/$  1X = =<< D11F: :  1V ; ;&=  1U : :88Gtf}o566 6rr3)r+N)__name__ __module__ __qualname____doc__rOrr flagr*r$__annotations__rr r2strrrr\rarxrsrrrrr.r3r1r&r&s MM?"%?K DJ< C< .< U3PS8_< < < < | . .5c? . . . .[U38_[3[&4[9=[[[[  c3h C    "'"'"'"'H8888&,C,C,,,,3r3r&c eZdZdZdZededddded ed dd d ed edddededddgZ dS) JSCallablez66M+DJ++++++r3rcteZdZUdZdZdZdZdZej ej dZ e e d<de efd Zd edefd Zd S) JSModulea Directive to mark description of a new JavaScript module. This directive specifies the module name that will be used by objects that follow this directive. Options ------- noindex If the ``noindex`` option is specified, no linkable elements will be created, and the module won't be added to the global module index. This is useful for splitting up the module definition across multiple sections or files. :param mod_name: Module name Tr:rF)r'r)r*r+c|jd}||jjd<d|jv}t j}t|j|j 5|jj |_ t|j|j |dddn #1swxYwYg}|stt|jd}t|j|jj d|}|||||d||jj|jft jdd|gd }|jj |||t/d |z}t1jd ||ddfg } || ||j|S) Nrr<r'rer?rfr>T)rdismodz %s (module)ri)rh)rrBrDrErrr sectionr rjcontentrkr#r rnror! note_modulerpdocnamelinenotargetrmrlrrindexextendchildren) r0rTr' content_noderetrvrurrwinodes r1runz JSModule.run$s>!$**,,,4[)t|+ %  T\ : : M M$(J$7L ! $TZ| L L L M M M M M M M M M M M M M M M  *DH,?,?,E,EFFFdh (;XxPPG   x 1 1 1   x7)-)94;(G  I I I\"bwitDDDF J  4 4V < < < JJv   -((83INXy'2t,T+UVVVE JJu    <())) s%-BB"%B"r`c d|zS)zGenerate old styled node_id for JS modules. .. note:: Old Styled node_id was used until Sphinx-3.0. This will be removed in Sphinx-5.0. zmodule-r.)r0r`s r1rzJSModule.make_old_idCs 7""r3N)rrrr has_contentrequired_argumentsoptional_argumentsfinal_argument_whitespacer rr*r$rrr rrrr.r3r1rrs$K %?%?K T$Z>#3#3######r3rc>eZdZdedededededeeeff dZdS) JSXRefRolerDrefnodehas_explicit_titletitlerr+c|jd|d<|jd|d<|sj|d}|d}|dddkr2|dd}|d}|dkr ||dzd}|dddkr|dd}d|d <||fS) Nr;r<r=~rr:r8T refspecific)rErFlstriprfind)r0rDrrrrdots r1 process_linkzJSXRefRole.process_linkMs #22;?? "22;?? ! ,LL%%E]]3''FQqSzS  abb kk#&&"99!#'((OE !A#;#  ABBZF%)GM "f}r3N) rrrrr boolrrrr.r3r1rrLsb 07)-69CFKPQTVYQY?r3rceZdZUdZdZdZeeddeeddeeddeed d eed d eed d dZe e e e e e dZ edededeeedZiidZeeeeeeefffed<edeeeeeefffdZ d5dededededdf dZedeeeeefffdZdededdfdZdeddfd Zd!eed"eddfd#Z d6d%ed&ed'ed(ed)ed*edeeeeeefffd+Z d%ed,ed-e!d)ed.ed/e"d0e#de$e#fd1Z%d%ed,ed-e!d.ed/e"d0e#deeee#ffd2Z&de'eeeeeeeffd3Z(d/e#defd4Z)dS)7rnzJavaScript language domain.re JavaScriptr{rrmethr|r}r~attrr?mod)r{rr|r}r~r?T) fix_parens)rrr|r}rr)rmodules initial_datar+c8|jdiS)Nrr}rr/s r1rzJavaScriptDomain.objectsy##Ir222r3NrArqrurgc||jvr@|j|d}ttd||||||jj||f|j|<dS)Nrz.duplicate %s description of %s, other %s in %srf)rloggerwarningrrDr)r0rArqrurgrs r1rpzJavaScriptDomain.note_objectsr t| # #l8,Q/G NN2NOO"Hgw  S S S"&("2GW!E Xr3c8|jdiS)Nrrr/s r1rzJavaScriptDomain.modulesrr3r`c2|jj|f|j|<dSr-)rDrr)r0r`rus r1rzJavaScriptDomain.note_modules!%!17 ; Wr3rct|jD]\}\}}}||kr|j|=t|jD]\}\}}||kr|j|=dSr-)listritemsr)r0rrA pkg_docname_node_id_lr`s r1 clear_doczJavaScriptDomain.clear_docs59$,:L:L:N:N5O5O + + 1H1{Hbg%%L*04T\5G5G5I5I0J0J * * ,G,k8g%%L) * *r3docnames otherdatac|dD]\}\}}}||vr |||f|j|<|dD]\}\}}||vr ||f|j|<dS)Nrr)rrr) r0rrrAfnrurqrTrs r1merge_domaindataz!JavaScriptDomain.merge_domaindatas09)0D0J0J0L0L @ @ ,H,r7GX~~*,gw)? X&09)0D0J0J0L0L @ @ ,H,{Gh&&*5w)? X& @ @r3rrDrTrSrUtyp searchorderc|dddkr |dd}g}|r-|r+|d|||g|r*|d||g|r*|d||g|||dkr|d}|D] } | |jvr| }||j|fS)Nrr=r)rlrIreverserrF) r0rDrTrSrUrrsearchesnewname search_names r1find_objzJavaScriptDomain.find_objs# 9  9D  @ @ OOCHHh%=>> ? ? ?  8 OOCHHh%566 7 7 7  6 OOCHHfd^44 5 5 5 !        # & &Kdl**% ((1111r3 fromdocnamebuilderrnodecontnodec |d}|d} |drdnd} |||| ||| \} } | sdSt||| d| d|| S)Nr<r;rr:r)rFhasattrrr") r0rDrrrrrrrTrSrrUrs r1 resolve_xrefzJavaScriptDomain.resolve_xrefs88K((+&&<< 66=aaA MM#xkRR c 4G[#a&#a&(DQQQr3c |d}|d}|||||dd\} } | sgSd|| dzt||| d| d|| fgS)Nr<r;r:zjs:r)rFrrole_for_objtyper") r0rDrrrrrrTrSrUrs r1resolve_any_xrefz!JavaScriptDomain.resolve_any_xrefs88K((+&&MM#xqII c I..s1v666g{CFCFHdSSUV Vr3c#~Kt|jD]\}\}}}|||||dfVdS)Nr:)rrr)r0refnamerrurs r1 get_objectszJavaScriptDomain.get_objectss]04T\5G5G5I5I0J0J = = ,G,gw7C'1< < < < < = =r3c|d}|d}|d}|dSdtd|||gS)Nr<r; reftargetr=)rFrIfilter)r0rr`rSrs r1get_full_qualified_namez(JavaScriptDomain.get_full_qualified_namesb((;''+&&+&& >488F4'66)BCCDD Dr3r-)r)*rrrrrUrrr object_typesrrr&rr rrolesrrrrrpropertyrrrprrrrrrintrrrr rrrrrr r.r3r1rnrn`sE%% D EWQQz]]V44WQQx[[V44WQQwZZW55WQQvYYV44WQQ{^^V44WQQx[[U33 L " Jt,,,t,,,t,,,   E;;L$sDeCHo!5667 3c5c3#778333X3%)FFCF#FF!F-1FFFF3c5c?23333X3<3<<<<<<******@c@t@@@@@/022,22S2PS22(+249#uS#s]?S:S4T22220 R 0 Rs RW R R'* R2> RJQ R"7+ R R R R V$4 V3 VQX V!$ V,8 VDK V"5g#67 V V V V=XeCc3S,H&IJ====EGEEEEEEEr3rnrr+cD|tdddddS)NbuiltinrT)version env_versionparallel_read_safeparallel_write_safe) add_domainrn)rs r1setupr,s2NN#$$$"#   r3N)Artypingrrrrrrr docutilsr docutils.nodesr r docutils.parsers.rstr sphinxrsphinx.addnodesrrsphinx.applicationrsphinx.buildersrsphinx.directivesrsphinx.domainsrrsphinx.domains.pythonrsphinx.environmentr sphinx.localerr sphinx.rolesr sphinx.utilrsphinx.util.docfieldsrrrsphinx.util.docutilsrr sphinx.util.nodesr!r"r#sphinx.util.typingr$ getLoggerrrrr&rrrrrnr,r.r3r1rAs.CCCCCCCCCCCCCCCCCC((((((((++++++88888888%%%%%%######//////********777777//////!!!!!!AAAAAAAAAAEEEEEEEEMMMMMMMMMM))))))  8 $ $MMMMM sCx1MMM`$+++++J+++A#A#A#A#A#A#A#A#H(EEEEEvEEEDv$sCx.r3