B öÀ„\>?ã@sdZddlmZddlmZddlmZddlmZddl m Z m Z ddl m Z ddlmZdd lmZdd lmZmZmZdd lmZdd lmZGd d„deƒZGdd„deƒZGdd„deƒZGdd„deƒZGdd„deƒZGdd„de ƒZdd„Z dS)zË sphinx.domains.javascript ~~~~~~~~~~~~~~~~~~~~~~~~~ The JavaScript domain. :copyright: Copyright 2007-2019 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. é)Únodes)Ú directives)Úaddnodes)ÚObjectDescription)ÚDomainÚObjType)Ú_pseudo_parse_arglist)Ú_)ÚXRefRole)ÚFieldÚ GroupedFieldÚ TypedField)ÚSphinxDirective)Ú make_refnodec@sDeZdZdZdZdZdZdd„Zdd„Zdd „Z d d „Z d d „Z dS)ÚJSObjectz- Description of a JavaScript object. FNc Cs | ¡}d|krJ|dd…dkrJ| dd¡\}}| ¡}|dd… ¡}n|}d}|jj dd¡}|jj d¡}|}z6y| dd¡\}} Wntk r¦|} d }YnXWd| }|rÈ|rÈd ||g¡}n|dkrØ|rØ|}X|} |rðd ||g¡} ||d <||d <| |d <|jr$|t   |j|j¡7}|rD|t   |d|d¡7}n|rb|t   |d|d¡7}|t   ||¡7}|j r˜|sŽ|t  ¡7}n t||ƒ| |fS) zÑBreaks 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Ú.ÚÚmoduleÚobjectÚfullname)ÚstripÚsplitÚenvÚ ref_contextÚgetÚrsplitÚ ValueErrorÚjoinÚdisplay_prefixrZdesc_annotationZ desc_addnameZ desc_nameÚ has_argumentsZdesc_parameterlistr) ÚselfÚsigÚsignodeÚmemberZarglistÚprefixÚmod_nameÚnameZ member_prefixÚ member_namer©r,ú8lib/python3.7/site-packages/sphinx/domains/javascript.pyÚhandle_signature1sN    zJSObject.handle_signaturecCs|jj d¡}|r|dpd|d}||jjjkrÌ|d |¡|d | dd¡¡|j |d <|jj  |¡|jj d d }||krº|j j j d |d |j ||d¡|jd|jj|jf||<| ||¡}|rþ|jd d|| dd¡ddf¡dS)Nz js:modulerrrÚnamesÚidsú$Ú_S_ÚfirstÚjsÚobjectsz$duplicate object description of %s, zother instance in )ÚlineÚentriesÚsingle)rrrÚstateÚdocumentr0ÚappendÚreplacer/Únote_explicit_targetÚ domaindataZ state_machineZreporterZwarningZdoc2pathÚlinenoÚdocnameÚobjtypeÚget_index_textZ indexnode)r$Úname_objr%r&r)rr5Ú indextextr,r,r-Úadd_target_and_indexgs&     zJSObject.add_target_and_indexcCs||\}}|jdkr2|s"tdƒ|Stdƒ||fS|jdkrHtdƒ|S|jdkr^tdƒ|S|jdkrxtd ƒ||fSd S) NÚfunctionz%s() (built-in function)z%s() (%s method)Úclassz %s() (class)Údataz %s (global variable or constant)Ú attributez%s (%s attribute)r)rAr )r$Z objectnamerCr*Úobjr,r,r-rBs       zJSObject.get_index_textcCshd}|jr4|j ¡\}}|r&| d¡nd}|jr4|}|rd||jjd<|jrd|jj dg¡}| |¡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 heirarchy 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 Nrz js:objectz js:objects)r/ÚpoprÚ allow_nestingrrÚ setdefaultr;)r$r(Zobj_nameZobj_name_prefixr5r,r,r-Úbefore_contentŽs zJSObject.before_contentcCs\|jj dg¡}|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:objectsrrNz js:object)rrrMrLrKÚ IndexErrorÚlen)r$r5r,r,r-Ú after_content³s  zJSObject.after_content) Ú__name__Ú __module__Ú __qualname__Ú__doc__r#r"rLr.rErBrNrQr,r,r,r-r"s6%rc @sdeZdZdZdZededƒdddded ed ƒd d dd ededƒdddededƒdddgZ dS)Ú JSCallablezrÚtargetr9r:r=r;r rÚindex)r$r)raZretZ targetnoderDÚinoder,r,r-Úrunûs      z JSModule.runN) rRrSrTrUZ has_contentZrequired_argumentsZoptional_argumentsZfinal_argument_whitespacerÚflagZ option_specrfr,r,r,r-r`às r`c@seZdZdd„ZdS)Ú JSXRefRolecCs¢|j d¡|d<|j d¡|d<|sv| d¡}| d¡}|dd…dkrv|dd…}| d¡}|dkrv||dd…}|dd…dkrš|dd…}d|d <||fS) Nz js:objectz js:modulerú~rrrTÚ refspecific)rrÚlstripÚrfind)r$rZrefnodeZhas_explicit_titleÚtitlercÚdotr,r,r-Ú process_links     zJSXRefRole.process_linkN)rRrSrTror,r,r,r-rhsrhc@sæeZdZdZdZdZeedƒdƒeedƒdƒeedƒdƒeed ƒd ƒeed ƒd ƒeed ƒd ƒdœZe e e e e e dœZ eddeddeddeƒeƒeƒdœZiidœZdd„Zdd„Zd#dd„Zdd„Zdd„Zdd„Zd d!„Zd"S)$ÚJavaScriptDomainzJavaScript language domain.r4Z JavaScriptrFrYÚmethodÚmethrGrHrIÚattrrÚmod)rFrqrGrHrIrT)Z fix_parens)rYrrrGrHrsrt)r5rbcCspx6t|jd ¡ƒD] \}\}}||kr|jd|=qWx2t|jd ¡ƒD]\}}||krL|jd|=qLWdS)Nr5rb)ÚlistrHÚitems)r$r@rÚ pkg_docnameZ_lr)r,r,r-Ú clear_docGs  zJavaScriptDomain.clear_doccCslx6|d ¡D]&\}\}}||kr||f|jd|<qWx.|d ¡D]\}}||krF||jd|<qFWdS)Nr5rb)rvrH)r$ZdocnamesZ otherdatarÚfnrAr)rwr,r,r-Úmerge_domaindataPs z!JavaScriptDomain.merge_domaindatarc Cs¾|dd…dkr|dd…}|jd}g}|rH|rH| d |||g¡¡|r`| d ||g¡¡|rx| d ||g¡¡| |¡|dkr’| ¡d} x|D]} | |krœ| } qœW| | | ¡fS)Néþÿÿÿz()r5rr)rHr;r!Úreverser) r$rr)r(r*ÚtypÚ searchorderr5ZsearchesZnewnameZ search_namer,r,r-Úfind_objZs$    zJavaScriptDomain.find_objc Csd| d¡}| d¡} | d¡r"dp$d} | ||| ||| ¡\} } | sFdSt||| d|  dd¡|| ƒS)Nz js:modulez js:objectrjrrr1r2)rÚhasattrrrr<) r$rÚ fromdocnameÚbuilderr}rcÚnodeÚcontnoder)r(r~r*rJr,r,r-Ú resolve_xrefss   zJavaScriptDomain.resolve_xrefc Csf| d¡}| d¡}| ||||dd¡\} } | s4gSd| | d¡t||| d|  dd¡|| ƒfgS)Nz js:modulez js:objectrzjs:rr1r2)rrZrole_for_objtyperr<) r$rrr‚rcrƒr„r)r(r*rJr,r,r-Úresolve_any_xrefs   z!JavaScriptDomain.resolve_any_xrefc csBx s&         '1w