㎒j .dZddlZddlZddlmZmZmZmZddl m Z ddl m Z m Z mZmZe jee jee jee jeiZe jfdejede de fd Ze jfd ejde de fd Ze jejd fd e de dededef dZdS)zThe main parsing routine.N)epydocgooglenumpydocrest)add_attribute_docstrings) DocstringDocstringStyle ParseErrorRenderingStyletextstylereturncd|tjkr t||Sd}g}tD]F} ||}||.#t $r }|}Yd}~?d}~wwxYw|s|t|dddS)zParse the docstring into its components. :param text: docstring text to parse :param style: docstring style :returns: parsed docstring representation Nc*t|jS)N)lenmeta)ds EC:\Projects\DSCons\.venv\Lib\site-packages\docstring_parser\parser.pyzparse..0sc!&kkT)keyreverser)r AUTO _STYLE_MAPparsevaluesappendr sorted)r r excretsmoduleretexs rrrs ###% &&t,,,!%C D##%% ,,t$$C KK       CCCCCC   $114 @ @ @ CCsA<< BB  Bobjct|j|}tj|stj|rt |||S)aQParse the object's docstring(s) into its components. The object can be anything that has a ``__doc__`` attribute. In contrast to the ``parse`` function, ``parse_from_object`` is able to parse attribute docstrings which are defined in the source code instead of ``__doc__``. Currently only attribute docstrings defined at class and module levels are supported. Attribute docstrings defined in ``__init__`` methods are not supported. When given a class, only the attribute docstrings of that class are parsed, not its inherited classes. This is a design decision. Separate calls to this function should be performed to get attribute docstrings of parent classes. :param obj: object from which to parse the docstring(s) :param style: docstring style :returns: parsed docstring representation )r )r__doc__inspectisclassismoduler)r$r docstrings rparse_from_objectr+3sR.ck///Is1w/441 i000 rz r*rendering_styleindentczt|tjkr|jn|}||||S)aRender a parsed docstring into docstring text. :param docstring: parsed docstring representation :param style: docstring style to render :param indent: the characters used as indentation in the docstring string :returns: docstring text )r,r-)rr rr compose)r*r r,r-r!s rr/r/RsH N$777 UF >>?6   r)r&r'typingTdocstring_parserrrrrdocstring_parser.attrdocrdocstring_parser.commonrr r r RESTGOOGLENUMPYDOCEPYDOCrrOptionalstrrAnyr+COMPACTr/rrr>s;;;;;;;;;;;;======6X6  4B3FDD *S/D"0DDDDD<+/  B+/&4&<  $    r