B dI@sdZddlmZmZmZmZmZmZmZddl 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(6e7Z8Gdddeee9e9fZ:Gddde:Z;Gddde;ZGdd d eZ?eee9efd!d"d#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@seZdZUdZdZdZejejejdZe e d<e e dddZ eeeeefdd d Zeeed fd d dZeeefeeddddZeeeefedddZddddZddddZeedddZeed ddZdS)JSObjectz- Description of a JavaScript object. F)noindex noindexentrynocontentsentry option_spec)returncCsgS)N)selfr*r*f/work/yifan.wang/ringdown/master-ringdown-env/lib/python3.7/site-packages/sphinx/domains/javascript.pyget_display_prefix.szJSObject.get_display_prefix)sigsignoder)c Cs|}d|krJ|dddkrJ|dd\}}|}|dd}n|}d}|jjdd}|jjd}|}z6y|dd\}} Wntk r|} d }YnXWd| }|r|rd||g}n|dkr|r|}X|} |rd||g} ||d <||d <| |d <|} | r(|t j d | 7}d} |r8|} n |rB|} | rt d d } x4| dD]&}| t ||7} | t dd7} q`W|| 7}|t d d t ||7}|jr|s|t 7}n t||| |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)z js:objectz js:module.moduleobjectfullname)r5r5)stripsplitenv ref_contextgetrsplit ValueErrorjoinr-r Zdesc_annotationZ desc_addnameZ desc_sig_nameZdesc_sig_punctuationZ desc_name has_argumentsZdesc_parameterlistr)r+r.r/memberZarglistprefixmod_namenameZ member_prefix member_namer8Zdisplay_prefixZ actual_prefixZaddNamepr*r*r,handle_signature2s\   zJSObject.handle_signature.)sig_noder)cCsDd|kr dS|d}|d}|r2|f|dSt|dSdS)Nr8r*r6r4)r=r:tuple)r+rImodnamer8r*r*r,_object_hierarchy_partsps z JSObject._object_hierarchy_partsN)name_objr.r/r)c Cs|jjd}|r|dnd|d}t|j|jjd|}|d||jj|tt |j d}|j ||j ||dd|j kr|||}|r|jd d ||ddfdS) Nz js:moduler4r5ridsjs)locationr&entriessingle)r;r<r=r statedocumentappendnote_explicit_targetrJavaScriptDomain get_domain note_objectobjtypeoptionsget_index_textZ indexnode) r+rMr.r/rDr8node_iddomain indextextr*r*r,add_target_and_index{s  zJSObject.add_target_and_index) objectnamerMr)cCs||\}}|jdkr2|s"td|Std||fS|jdkrHtd|S|jdkr^td|S|jdkrxtd ||fSd S) Nfunctionz%s() (built-in function)z%s() (%s method)classz %s() (class)dataz %s (global variable or constant) attributez%s (%s attribute)r5)rZr)r+rarMrEobjr*r*r,r\s       zJSObject.get_index_textcCshd}|jr4|j\}}|r&|dnd}|jr4|}|rd||jjd<|jrd|jjdg}||dS)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 Nr4z js:objectz js:objects)namespopr9 allow_nestingr;r< setdefaultrU)r+rCobj_nameZobj_name_prefixobjectsr*r*r,before_contents zJSObject.before_contentcCs\|jjdg}|jr8y |Wntk r6YnXt|dkrL|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`. z js:objectsrr1Nz js:object)r;r<rjrirh IndexErrorlen)r+rlr*r*r, after_contents  zJSObject.after_content)r8r)cCs |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. $Z_S_)replace)r+r8r*r*r, make_old_idszJSObject.make_old_idcCs|dsdS|jjj}|jd}|jr8|dkr8d}nd}|d^}}|jdkrd|d||S|jdkrv||S|jd krd |||gSdS) NZ _toc_partsr5rZ>rbmethodz()r^r8Zhideallr4)r=r;appconfigparentZadd_function_parenthesesZtoc_object_entries_show_parentsr@)r+rIrwrZparensparentsrEr*r*r,_toc_entry_names      zJSObject._toc_entry_name)__name__ __module__ __qualname____doc__rArir flagr(r#__annotations__rr r-strrrrHrLr`r\rmrprsr{r*r*r*r,r$s > $r$c @sdeZdZdZdZededdddded ed dd dd ed eddddededdddgZ dS) JSCallablez|r>|d|||g|rV|d||g|rn|d||g|||dkr|d}x|D]} | |jkr| }qW||j|fS)Nz()r4r)rUr@reverserlr=) r+r;rDrCrErrZsearchesZnewnameZ search_namer*r*r,find_objs"    zJavaScriptDomain.find_obj)r; fromdocnamebuilderrrnodecontnoder)c Cs`|d}|d} |dr"dnd} |||| ||| \} } | sFdSt||| d| d|| S)Nz js:modulez js:objectrr3r)r=hasattrrr!) r+r;rrrrrrrDrCrrErfr*r*r, resolve_xrefs  zJavaScriptDomain.resolve_xref)r;rrrrrr)c Csb|d}|d}|||||dd\} } | s4gSd|| dt||| d| d|| fgS)Nz js:modulez js:objectr3zjs:r)r=rZrole_for_objtyper!) r+r;rrrrrrDrCrErfr*r*r,resolve_any_xrefs  z!JavaScriptDomain.resolve_any_xrefccs8x2t|jD] \}\}}}|||||dfVqWdS)Nr3)rrlr)r+Zrefnamerr]rr*r*r, get_objectsszJavaScriptDomain.get_objects)rr)cCsD|d}|d}|d}|dkr*dSdtd|||gSdS)Nz js:modulez js:objectZ reftargetr4)r=r@filter)r+rrKrCrr*r*r,get_full_qualified_names    z(JavaScriptDomain.get_full_qualified_name)N)r)*r|r}r~rrErrrZ object_typesrrr$rr rZrolesrrrrrpropertyrlrrYrrrrrrintrrrr rrrrrrr*r*r*r,rW`sP       ("  .  "rW)rvr)cCs|tdddddS)NbuiltinrT)versionZ env_versionZparallel_read_safeZparallel_write_safe)Z add_domainrW)rvr*r*r,setups  rN)ArtypingrrrrrrrZdocutilsr Zdocutils.nodesr r Zdocutils.parsers.rstr Zsphinxr Zsphinx.addnodesrrZsphinx.applicationrZsphinx.buildersrZsphinx.directivesrZsphinx.domainsrrZsphinx.domains.pythonrZsphinx.environmentrZ sphinx.localerrZ sphinx.rolesrZ sphinx.utilrZsphinx.util.docfieldsrrrZsphinx.util.docutilsrrZsphinx.util.nodesr r!r"Zsphinx.util.typingr# getLoggerr|rrr$rrrrrWrr*r*r*r,s:$            Q D