o NizB@sxddlmZddlZddlZddlmZmZddlmZddl m Z ddl m Z ddl mZmZmZddlmZdd lmZmZmZmZmZdd lmZdd lmZdd lmZmZm Z dd l!m"Z"er~ddl#m$Z$ddl%m&Z&ddl'm(Z(ddl)m*Z*m+Z+e,e-Z.e/dej0Z1GdddZ2Gddde2eZ3Gddde2eZ4Gddde2e Z5Gdddee6e7e7fZ8dS)) annotationsN) TYPE_CHECKINGClassVar)nodes) directives)addnodes)desc_signature pending_xrefpending_xref_condition)ObjectDescription)_parse_annotation_parse_arglist_parse_type_list_pseudo_parse_arglistparse_reftarget)_)logging)Field GroupedField TypedField)make_id)Node)Inliner)BuildEnvironment) OptionSpec TextlikeNodeaM^ ([\w.]*\.)? # class name(s) (\w+) \s* # thing name (?: \[\s*(.*)\s*])? # optional: type parameters list (?: \(\s*(.*)\s*\) # optional: arguments (?:\s* -> \s* (.*))? # return annotation )? $ # and nothing more csNeZdZejddddfdfdd ZedZejddddfdddZ Z S) PyXrefMixinNrolenamestrdomaintarget innernodetype[TextlikeNode]contnode Node | NoneenvBuildEnvironment | NoneinlinerInliner | Nonelocationreturnrc  stj||||||ddd} t| tr~|dusJd| d<|jd| d<|jd| d<t|\} } } } | | krN| | d<| | d<| | || | 7} | S|jj r~| j }| | dd }|d |}t d d |d d t d d g|Rd dig}| || S)N)r'r)T refspecific py:modulepy:classreftype reftarget.resolved) conditionr4*)super make_xref isinstancer ref_contextgetrclearconfig!python_use_unqualified_type_nameschildrensplitr extend)selfrrr r!r#r%r'r)resultr.r/reftitlerr> shortnametextnode contnodes __class__Q/home/ubuntu/.local/lib/python3.10/site-packages/sphinx/domains/python/_object.pyr72s4      zPyXrefMixin.make_xrefz>(\s*[\[\]\(\),](?:\s*o[rf]\s)?\s*|\s+o[rf]\s+|\s*\|\s*|\.\.\.) list[Node]c  Cs|j|} t|o||k} d} g} td| D]1} | r"t| }| s*|j| r5| |p2|| | n| | ||| |||||| dvrJd} q| S)NF>typing.Literal~typing.LiteralLiteralT) _delimiters_rer?boolastextfilterrTextmatchappendr7)rArrr r!r#r%r'r) sub_targetssplit_contnode in_literalresults sub_targetrIrIrJ make_xrefs_s   zPyXrefMixin.make_xrefs)rrrrr rr!r"r#r$r%r&r'r(r)r$r*r)rrrrr rr!r"r#r$r%r&r'r(r)r$r*rK) __name__ __module__ __qualname__remphasisr7recompilerOr[ __classcell__rIrIrGrJr1s ) rc@ eZdZdS)PyFieldNr\r]r^rIrIrIrJrdrdc@rc)PyGroupedFieldNrerIrIrIrJrgrfrgc@rc) PyTypedFieldNrerIrIrIrJrhrfrhc @seZdZUdZejejejejejejejejejejejejd Zded<e de dddd d d e d e d dddd d e de dddd de de dddde de dddddgZdZd?d"d#Zd@d%d&ZdAd*d+ZdBd.d/ZdCd2d3ZdDd6d7ZdEd8d9ZdEd:d;ZdFdS)GPyObjectz Description of a general Python object. :cvar allow_nesting: Class is an object that allows for nested namespaces :vartype allow_nesting: bool ) zno-indexno-index-entryzno-contents-entryzno-typesettingnoindex noindexentrynocontentsentrysingle-line-parameter-listsingle-line-type-parameter-listmodule canonical annotationzClassVar[OptionSpec] option_spec parameter Parameters)paramrtargargumentkeywordkwargkwparamclass) paramtypetypeT)labelnames typerolename typenames can_collapsevariable Variables)varivarcvar)vartype exceptionsRaisesexc)raisesraise exceptionexcept)rrrr returnvalueReturnsF)returnsr*)rhas_argr returntypez Return type)rtype)rrr bodyrolenamesigrr*list[nodes.Node]cCsgS)zTMay return a prefix to put before the object name in the signature. rI)rArrIrIrJget_signature_prefixzPyObject.get_signature_prefixrPcCsdS)zqMay return true if an empty argument list is to be generated even if the document contains none. FrI)rArIrIrJ needs_arglistrzPyObject.needs_arglistsignodertuple[str, str]c Cs~t|}|dur t|\}}}}}|jd|jjd} |jjd} | rZd} |rH|| ks8|| drH||} |t | d d}n$|rS| d||} n| d|} nd} |rh| d} ||} nd} |} | |d<| |d <| |d <|jj j p|jj jpd } t |}|d }d |jvo||d|d | kod kn}|d}d|jvo||d|d | kod kn}||}|rt|turd|d}t||tjt|dg|R7}|r|t||7}n| r | r |jj jr | d}|t||7}|t||7}|r?z |t||j|7}Wnty>}ztjd|||dWYd}~nd}~ww|rz |t||j|7}Wn>ty]t|||Yn/t tfy}ztjd|||dt|||WYd}~nd}~ww|!r|t"7}|rt#||j}|tj$|dg|R7}|jd}|r|td|dt%t&'|7}| |fS)aJTransform a Python signature into RST nodes. Return (fully qualified name of the thing, classname if any). If inside a class, the current class name is handled intelligently: * it is stripped from the displayed name if present * it is added to the full name (return value) if not present Nrpr,r-Fr0Tr2r|fullnamerrnroz^Python directive method get_signature_prefix() must return a list of nodes. Return value was 'z'.z could not parse tp_list (%r): %sr)z could not parse arglist (%r): %srr )( py_sig_rerT ValueErrorgroupsoptionsr:r%r9 startswithlenlstriprstripr<$python_maximum_signature_line_lengthmaximum_signature_line_lengthspanrr~r TypeErrorrdesc_annotation desc_addnameadd_module_names desc_namer Exceptionloggerwarningr SyntaxErrorrNotImplementedErrorrdesc_parameterlistr desc_returnsdesc_sig_spacerrS)rArrmprefixnametp_listarglistretannmodname classname add_modulermax_lensig_len tp_list_spanmulti_line_parameter_list arglist_spanmulti_line_type_parameter_list sig_prefixmsgnodetextrr>annorIrIrJhandle_signatures        &  &        zPyObject.handle_signaturesig_nodetuple[str, ...]cCsBd|vrdS|d}|d}|r|g|dRSt|dS)NrrIrpr0)r:r?tuple)rArrrrIrIrJ_object_hierarchy_parts<s z PyObject._object_hierarchy_partsrrcCs d}t|)z2Return the text for the index entry of the object.z!must be implemented in subclasses)r)rArrrrIrIrJget_index_textGszPyObject.get_index_textname_clsNonec Cs|jd|jjd}|r|dnd|d}t|j|jjd|}|d||jj||jj j }|j ||j ||d|jd}|rR|j ||j |d |d d |jvrn| ||} | rp|jd d | |ddfdSdSdS)Nrpr,r0r2ridsrrqT)aliasedr)rjentriessingle)rr:r%r9rstatedocumentrUnote_explicit_targetdomains python_domain note_objectobjtyper indexnode) rArrrrrnode_idrcanonical_name indextextrIrIrJadd_target_and_indexLs$    zPyObject.add_target_and_indexcCsd}|jr|jd\}}|jr|}n|r|d}|r1||jjd<|jr1|jjdg}||d|jvrS|jjdg}||jjd|jd|jjd<dSdS) aHandle object nesting before content :py:class:`PyObject` represents Python language constructs. For constructs that are nestable, such as a Python classes, 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`. Nr1r0r- py:classesrp py:modulesr,) r allow_nestingstripr%r9 setdefaultrUrr:)rArr name_prefixclassesmodulesrIrIrJbefore_contentas"     zPyObject.before_contentcCs|jjdg}|jr$tt |Wdn1swYt|dkr.|dnd|jjd<d|j vrV|jjdg}|rM||jjd<dS|jjddSdS) 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`. rNrr1r-rprr,) r%r9rr contextlibsuppress IndexErrorpoprr)rArrrIrIrJ after_contents    zPyObject.after_contentcCs|dsdS|jjj}|jd}|jr|dvrd}nd}|d^}}|jdkr2|d||S|jdkr;||S|jd krKd g|||SdS) N _toc_partsr2r>methodfunctionz()rrhideallr0)r:r%appr<parentadd_function_parenthesestoc_object_entries_show_parentsjoin)rArr<rparensparentsrrIrIrJ_toc_entry_names      zPyObject._toc_entry_nameN)rrr*r)r*rP)rrrrr*r)rrr*r)rrrrr*r)rrrrrrr*r)r*r)rrr*r)r\r]r^__doc__rflag unchangedrs__annotations__rhrrgrrddoc_field_typesrrrrrrrrrrrIrIrIrJris\          x   !ri)9 __future__rrr`typingrrdocutilsrdocutils.parsers.rstrsphinxrsphinx.addnodesrr r sphinx.directivesr "sphinx.domains.python._annotationsr r rrr sphinx.localer sphinx.utilrsphinx.util.docfieldsrrrsphinx.util.nodesrdocutils.nodesrdocutils.parsers.rst.statesrsphinx.environmentrsphinx.util.typingrr getLoggerr\rraVERBOSErrrdrgrhrrrirIrIrIrJs:             O