Y gX ~dZddlZddlZddlZddlZddlZddlmZddl m Z m Z ejdiZ ejdddkr5e jej dej"d ej$d id ej&d ej(fd Zd ej&d ej,efdZd ej&d efdZd ej&d ej,ej6eej,eej,effdZGddej:Zdej>e efde d dfdZ!y)zbAttribute docstrings parsing. .. seealso:: https://peps.python.org/pep-0257/#what-is-a-docstring N) ModuleType) DocstringDocstringParamvalue)nsnodereturnc<t|t|jS)z>: ;;cRttdrtj|St|tjtj tj tjfrtt|St|tjr |jSy)z0Convert the AST node to source code as a string.unparseN) hasattrastr isinstanceStrNum NameConstantConstantstrrNameidrs r ast_unparser# sksI{{4  $#''3+;+;S\\JK)$/00$!ww rct|tjxrYt|jtjtj fxr#tt |jtS)z2Return True if the given node is a literal string.)rrExprrrrrr rs rast_is_literal_strr&,sR 4" @ tzzCLL#''#: ; @ -djj93 ?rct|tjtjfrt|tjr|jdn |j }t|tj rcd}t|tjrt|j}d}|jrt|j}|j||fSy)z@Return name, type and default if the given node is an attribute.rN) rrAssign AnnAssigntargetstargetr!r# annotationrr")r r+type_strdefaults rast_get_attributer/5s$S]]34)$ ;DLLO  fchh 'H$ .&t7Gzz%djj199h/ / rc eZdZdZdZdZdZdejdeje eje eje eje fffdZ y)AttributeDocstringsz6An ast.NodeVisitor that collects attribute docstrings.Nc4|jr@t|r5|j\}}}t|j||f|j|<t ||_t |tjtjfr|j|yyN) prev_attrr&rr attr_docsr/rrClassDefModule generic_visit)selfr attr_name attr_type attr_defaults rvisitzAttributeDocstrings.visitNs{ >>0615 .Iy,&tzz2)DNN9 % +40 dS\\3::6 7   t $ 8r componentrci|_d|_ tjt j |}t j|}t j|r|j||jSt|t jrEt|jdt jr|j|jd|jS#t$rY|jSwxYw)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)r5r4textwrapdedentinspect getsourcerparseismoduler=rr7bodyr6OSError)r9r>sourcetrees r get_attr_docsz!AttributeDocstrings.get_attr_docsZs )__W%6%6y%ABF99V$D * 4 ~~ D#**-* ! cll3 499Q<(~~  ~~ s(C** DD)__name__ __module__ __qualname____doc__r5r4r=TAnyDictr TupleOptionalrJrrr1r1Hs[@II % QWWS!**S/1::c?BCC Drr1obj docstringc  td|jD}tj|j D]>\}\}}}||vst d|g||||du|}|j j|@y)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 c34K|]}|jywr3)arg_name).0ps r z+add_attribute_docstrings..}s66s attributeN)args descriptionrY type_name is_optionalr.)setparamsr1rJitemsrmetaappend)rUrVrcrYr_r`r.params radd_attribute_docstringsrhts6Y%5%56 6F++C0668 )33; 7 6 !"!8,'!##4/ E NN ! !% ( )r)"rNrrBsysr@typingrOtypesrcommonrrrr version_infoupdaterrrASTrPrrSr r#boolr&rRr/ NodeVisitorr1UniontyperhrTrrrtsD   -\\7+BQ6!   g GGS GGS <?&)#//)X) z! ")/8) )r