`i dZddlZddlZddlZddlZddlmZddlm Z m Z dej dej fdZ dej dejefd Zdej defd Zdej dejejeejeejeffd ZGd d ejZdejeefde ddfdZdS)zbAttribute docstrings parsing. .. seealso:: https://peps.python.org/pep-0257/#what-is-a-docstring N) ModuleType) DocstringDocstringParamnodereturnc"t|dS)z 066 15 .Iy,&tz22)DN9 % +400 dS\3:6 7 7 %   t $ $ $ $ $ % %r componentrci|_d|_ tjt j|}t j|}t j|r| |npt|t j rEt|j dt j r | |j dn#t$rYnwxYw|jS)zGet attribute docstrings from the given component. :param component: component to process (class or module) :returns: for each attribute docstring, a tuple with (description, type, default) Nr)r+r*textwrapdedentinspect getsourcerparseismoduler3rr-bodyr,OSError)r/r4sourcetrees r get_attr_docsz!AttributeDocstrings.get_attr_docsNs )_W%6y%A%ABBF9V$$D ** ) 4    D#*-- )* ! cl33 ) 49Q<(((    D ~s&C C! C!)__name__ __module__ __qualname____doc__r+r*r3TAnyDictrTupleOptionalr@rr r'r'<s@@II % % % QWS!*S/1:c?BCC Drr'obj docstringc *td|jD}t|D]@\}\}}}||vr3t d|g||||du|}|j|AdS)zAdd attribute docstrings found in the object's source code. :param obj: object from which to parse attribute docstrings :param docstring: Docstring object where found attributes are added :returns: list with names of added attributes c3$K|] }|jV dSr))arg_name).0ps r z+add_attribute_docstrings..qs$66666666r attributeN)args descriptionrO type_name is_optionalr$)setparamsr'r@itemsrmetaappend)rKrLrYrOrUrVr$params r add_attribute_docstringsr^hs66Y%5666 6 6F++C006688 ) )33; 7 6 ! !"!8,'!##4/ E N ! !% ( ( ( ) )r)rDrr8r6typingrEtypesrcommonrrASTrFrrIrrboolrrHr% NodeVisitorr'Uniontyper^rJrr rgs  --------""QU"""" cg !*S/    SW 'ZQZ_ajo=>?&)))))#/)))X) z! ")/8) ))))))r