o 6Wj @sdZddlZddlZddlmZmZmZmZddl m Z ddl m Z m Z mZmZe jee jee jee jeiZe jfdejede de fd d Ze jfd ejde de fd d Ze jejdfde de dededef ddZdS)zThe main parsing routine.N)epydocgooglenumpydocrest)add_attribute_docstrings) DocstringDocstringStyle ParseErrorRenderingStyletextstylereturnc Cs|tjkr t||Sd}g}tD]#}z||}Wnty1}z|}WYd}~qd}~ww||q|s<|t|dddddS)zParse the docstring into its components. :param text: docstring text to parse :param style: docstring style :returns: parsed docstring representation NcSs t|jS)N)lenmeta)drf/home/esfera/Documents/content_generation/venv/lib/python3.10/site-packages/docstring_parser/parser.py0s zparse..T)keyreverser)rAUTO _STYLE_MAPparsevaluesr appendsorted)r r excretsmoduleretexrrrrs   robjcCs0t|j|d}t|st|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 docstringrrrparse_from_object3s r'z r&rendering_styleindentcCs(t|tjkr |jn|}|j|||dS)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))rrrr compose)r&r r(r)rrrrr*Rs  r*)r"r#typingTdocstring_parserrrrrdocstring_parser.attrdocrdocstring_parser.commonrrr r RESTGOOGLENUMPYDOCEPYDOCrrOptionalstrrAnyr'COMPACTr*rrrrsR    !