§
    _÷#d§¿  ã            	       ó2  — d Z ddlZddlZddlZddlZddlmZ ddlmZm	Z	m
Z
mZmZmZmZ ddlmZ ddlmZ ddlmZ ddlmZmZ dd	lmZ dd
lmZ ddlmZ  ej        e ¦  «        Z! ej"        d¦  «        Z# ej"        d¦  «        Z$ ej"        d¦  «        Z% ej"        d¦  «        Z& ej"        d¦  «        Z' ej"        d¦  «        Z( ej"        d¦  «        Z) ej"        d¦  «        Z* ej"        d¦  «        Z+ ej"        d¦  «        Z, ej"        d¦  «        Z-dZ. G d„ dej/        ¦  «        Z0i fde1de
e1e1f         de1fd„Z2 G d„ d¦  «        Z3d ee1         dee1         fd!„Z4d"e1dee1         fd#„Z5d*d$e1d%e1de1fd&„Z6di fde1d%e1de7de1fd'„Z8 G d(„ d)e3¦  «        Z9dS )+z-Classes for docstring parsing and formatting.é    N)Úpartial)ÚAnyÚCallableÚDictÚListÚTupleÚTypeÚUnion)ÚSphinx©ÚConfig)ÚRemovedInSphinx60Warning)Ú_Ú__)Úlogging)Ústringify_annotation)Úget_type_hintsz
\.\. \S+::z^(\s|\w)+:\s*$z(.+?)\(\s*(.*[^\s]+)\s*\)z^[=\-`:\'"~^_*+#<>]{2,}\s*$z(?<!:):(?!:)z>((?::(?:[a-zA-Z0-9]+[\-_+:.])*[a-zA-Z0-9]+:`.+?`)|(?:``.+?``))z5(?:(?::(?:[a-zA-Z0-9]+[\-_+:.])*[a-zA-Z0-9]+:)?`.+?`)z^(\*|\+|\-)(\s+\S|\s*$)zP^(?P<paren>\()?(\d+|#|[ivxlcdm]+|[IVXLCDM]+|[a-zA-Z])(?(paren)\)|\.)(\s+\S|\s*$)z_(,\sor\s|\sor\s|\sof\s|:\s|\sto\s|,\sand\s|\sand\s|,\s|[{]|[}]|"(?:\\"|[^"])*"|'(?:\\'|[^'])*')z^default[^_0-9A-Za-z].*$)ÚNoneÚTrueÚFalseÚEllipsisc                   óL   ‡ — e Zd ZdZ e¦   «         Zdedefd„Zdefˆ fd„Z	ˆ xZ
S )ÚDequez‡
    A subclass of deque that mimics ``pockets.iterators.modify_iter``.

    The `.Deque.get` and `.Deque.next` methods are added.
    ÚnÚreturnc                 óF   — |t          | ¦  «        k     r| |         n| j        S )zx
        Return the nth element of the stack, or ``self.sentinel`` if n is
        greater than the stack size.
        )ÚlenÚsentinel)Úselfr   s     ú?/usr/lib/python3/dist-packages/sphinx/ext/napoleon/docstring.pyÚgetz	Deque.get9   s"   € ð
 �c $™iœiš-˜-ˆt�AŒwˆw¨T¬]Ð:ó    c                 óV   •— | r t          ¦   «                              ¦   «         S t          ‚©N)ÚsuperÚpopleftÚStopIteration)r   Ú	__class__s    €r    Únextz
Deque.next@   s%   ø€ Øð 	 Ý‘7”7—?’?Ñ$Ô$Ð$åÐr"   )Ú__name__Ú
__module__Ú__qualname__Ú__doc__Úobjectr   Úintr   r!   r)   Ú__classcell__©r(   s   @r    r   r   0   s}   ø€ € € € € ðð ð ˆv‰xŒx€Hð;�Sð ;˜Sð ;ð ;ð ;ð ;ð �cð  ð  ð  ð  ð  ð  ð  ð  ð  ð  r"   r   Ú_typeÚtranslationsr   c                 ó4   — | |v r||          S | dk    rdS d| z  S )z0Convert type specification to reference in reST.r   z:obj:`None`ú:class:`%s`© )r2   r3   s     r    Ú_convert_type_specr7   G   s1   € à�ÐÐØ˜EÔ"Ð"à�FŠ?ˆ?Ø �=à  5Ñ(Ð(r"   c                   ó`  — e Zd ZdZ ej        dej        ¦  «        Z	 	 	 dgdee	e
e	         f         dedede	d	e	d
ededdfd„Zde	fd„Zde
e	         fd„Zdhdede
e	         fd„Zde
e	         fd„Zde
e	         fd„Zdidededee	e	e
e	         f         fd„Z	 	 djdededede
ee	e	e
e	         f                  fd„Zdee	e
e	         f         fd„Zdkdede
ee	e	e
e	         f                  fd„Zde
e	         fd„Zde	fd „Zde
e	         fd!„Zde
e	         fd"„Zdkd#e
e	         d$ede
e	         fd%„Zd	e	de	fd&„Z d'e
e	         de
e	         fd(„Z!d)e	d#e
e	         de
e	         fd*„Z"dld+e	d#e
e	         d,e	de
e	         fd-„Z#	 dmd0e
ee	e	e
e	         f                  d1e	d2e	de
e	         fd3„Z$d4e	d5e	d6e
e	         de
e	         fd7„Z%d8e	d0e
ee	e	e
e	         f                  de
e	         fd9„Z&dnd;edefd<„Z'd=e	defd>„Z(d#e
e	         defd?„Z)d#e
e	         defd@„Z*dod#e
e	         dBede
e	         fdC„Z+dhd=e	dedefdD„Z,d#e
e	         defdE„Z-defdF„Z.defdG„Z/dpdH„Z0dpdI„Z1d)e	dJe	de
e	         fdK„Z2de
e	         fdL„Z3dJe	de
e	         fdM„Z4dJe	de
e	         fdN„Z5dJe	de
e	         fdO„Z6dJe	de
e	         fdP„Z7dJe	de
e	         fdQ„Z8dJe	de
e	         fdR„Z9dJe	dSede
e	         fdT„Z:dJe	de
e	         fdU„Z;dJe	de
e	         fdV„Z<dJe	de
e	         fdW„Z=dJe	de
e	         fdX„Z>dJe	de
e	         fdY„Z?dJe	de
e	         fdZ„Z@dJe	de
e	         fd[„ZAdJe	de
e	         fd\„ZBdJe	de
e	         fd]„ZCdJe	de
e	         fd^„ZDdJe	de
e	         fd_„ZEdJe	de
e	         fd`„ZFd=e	dee	e	e	f         fda„ZGdbe	dceHde	fdd„ZId#e
e	         de
e	         fde„ZJd4e	de	fdf„ZKdS )qÚGoogleDocstringaV  Convert Google style docstrings to reStructuredText.

    Parameters
    ----------
    docstring : :obj:`str` or :obj:`list` of :obj:`str`
        The docstring to parse, given either as a string or split into
        individual lines.
    config: :obj:`sphinx.ext.napoleon.Config` or :obj:`sphinx.config.Config`
        The configuration settings to use. If not given, defaults to the
        config object on `app`; or if `app` is not given defaults to the
        a new :class:`sphinx.ext.napoleon.Config` object.


    Other Parameters
    ----------------
    app : :class:`sphinx.application.Sphinx`, optional
        Application object representing the Sphinx process.
    what : :obj:`str`, optional
        A string specifying the type of the object to which the docstring
        belongs. Valid values: "module", "class", "exception", "function",
        "method", "attribute".
    name : :obj:`str`, optional
        The fully qualified name of the object.
    obj : module, class, exception, function, method, or attribute
        The object to which the docstring belongs.
    options : :class:`sphinx.ext.autodoc.Options`, optional
        The options given to the directive: an object with attributes
        inherited_members, undoc_members, show_inheritance and noindex that
        are True if the flag option of same name was given to the auto
        directive.


    Example
    -------
    >>> from sphinx.ext.napoleon import Config
    >>> config = Config(napoleon_use_param=True, napoleon_use_rtype=True)
    >>> docstring = '''One line summary.
    ...
    ... Extended description.
    ...
    ... Args:
    ...   arg1(int): Description of `arg1`
    ...   arg2(str): Description of `arg2`
    ... Returns:
    ...   str: Description of return value.
    ... '''
    >>> print(GoogleDocstring(docstring, config))
    One line summary.
    <BLANKLINE>
    Extended description.
    <BLANKLINE>
    :param arg1: Description of `arg1`
    :type arg1: int
    :param arg2: Description of `arg2`
    :type arg2: str
    <BLANKLINE>
    :returns: Description of return value.
    :rtype: str
    <BLANKLINE>

    zX^\s*((?::(?P<role>\S+):)?`(?P<name>~?[a-zA-Z0-9_.-]+)`| (?P<name2>~?[a-zA-Z0-9_.-]+))\s*NÚ Ú	docstringÚconfigÚappÚwhatÚnameÚobjÚoptionsr   c                 ó   — || _         || _        | j         s(ddlm} | j        r| j        j        n	 |¦   «         | _         |sBt          j        |¦  «        rd}n+t          j        |¦  «        rd}nt          |¦  «        rd}nd}|| _	        || _
        || _        || _        t          |t          ¦  «        r|                     ¦   «         }	n|}	t!          t#          t          j        |	¦  «        ¦  «        | _        g | _        d| _        d| _        t/          | d¦  «        sg | _        t/          | d	¦  «        �s³i d
| j        “d| j        “dt5          | j        d¦  «        “d| j        “dt5          | j        d¦  «        “dt5          | j        d¦  «        “dt5          | j        d¦  «        “d| j        “d| j        “dt5          | j        d¦  «        “dt5          | j        d¦  «        “d| j        “d| j        “d| j        “dt5          | j        d¦  «        “d| j         “d| j!        “i d| j        “d| j"        “d| j"        “d| j#        “d| j#        “d | j$        “d!| j$        “d"| j%        “d#| j&        “d$t5          | j        d$¦  «        “d%t5          | j        d%¦  «        “d&t5          | j        d&¦  «        “d't5          | j        d&¦  «        “d(| j'        “d)| j'        “d*| j(        “d+| j(        “¥| _)        |  *                    ¦   «          |  +                    ¦   «          d S ),Nr   r   ÚclassÚmoduleÚfunctionr.   FÚ_directive_sectionsÚ	_sectionsÚargsÚ	argumentsÚ	attentionÚ
attributesÚcautionÚdangerÚerrorÚexampleÚexamplesÚhintÚ	importantzkeyword argszkeyword argumentsÚmethodsÚnoteÚnoteszother parametersÚ
parametersÚreceiveÚreceivesr   ÚreturnsÚraiseÚraisesÚ
referenceszsee alsoÚtipÚtodoÚwarningÚwarningsÚwarnÚwarnsÚyieldÚyields),Ú_configÚ_appÚsphinx.ext.napoleonr   r<   ÚinspectÚisclassÚismoduleÚcallableÚ_whatÚ_nameÚ_objÚ_optÚ
isinstanceÚstrÚ
splitlinesr   ÚmapÚrstripÚ_linesÚ_parsed_linesÚ_is_in_sectionÚ_section_indentÚhasattrrF   Ú_parse_parameters_sectionr   Ú_parse_admonitionÚ_parse_attributes_sectionÚ_parse_examples_sectionÚ _parse_keyword_arguments_sectionÚ_parse_methods_sectionÚ_parse_notes_sectionÚ_parse_other_parameters_sectionÚ_parse_receives_sectionÚ_parse_returns_sectionÚ_parse_raises_sectionÚ_parse_references_sectionÚ_parse_see_also_sectionÚ_parse_warns_sectionÚ_parse_yields_sectionrG   Ú_load_custom_sectionsÚ_parse)
r   r;   r<   r=   r>   r?   r@   rA   r   Úliness
             r    Ú__init__zGoogleDocstring.__init__–   sï  € ð ˆŒØˆŒ	àŒ|ð 	GØ2Ð2Ð2Ð2Ð2Ð2Ø/3¬yÐF˜4œ9Ô+Ð+¸f¸f¹h¼hˆDŒLàð 	 ÝŒ˜sÑ#Ô#ð  Ø��ÝÔ! #Ñ&Ô&ð  Ø��Ý˜#‘”ð  Ø!��à�àˆŒ
ØˆŒ
ØˆŒ	ØˆŒ	Ý�i¥Ñ%Ô%ð 	Ø×(Ò(Ñ*Ô*ˆEˆEàˆEÝ�C¥¤
¨EÑ2Ô2Ñ3Ô3ˆŒØ(*ˆÔØ#ˆÔØ ˆÔÝ�tÐ2Ñ3Ô3ð 	5Ø24ˆDÔ$Ý�t˜[Ñ)Ô)ñ $	ð#3Ø˜Ô6ð#3à˜TÔ;ð#3ð �W TÔ%;¸[ÑIÔIð#3ð ˜dÔ<ð	#3ð
 �7 4Ô#9¸9ÑEÔEð#3ð �' $Ô"8¸(ÑCÔCð#3ð � Ô!7¸ÑAÔAð#3ð ˜4Ô7ð#3ð ˜DÔ8ð#3ð � Ô 6¸Ñ?Ô?ð#3ð �W TÔ%;¸[ÑIÔIð#3ð  Ô Eð#3ð $ TÔ%Jð#3ð ˜4Ô6ð#3ð � Ô 6¸Ñ?Ô?ð#3ð  ˜Ô2ð!#3ð" # DÔ$Hð##3ð #3ð$ ˜dÔ<ð%#3ð& ˜4Ô7ð'#3ð( ˜DÔ8ð)#3ð* ˜$Ô5ð+#3ð, ˜4Ô6ð-#3ð. ˜Ô3ð/#3ð0 ˜$Ô4ð1#3ð2 ˜dÔ<ð3#3ð4 ˜DÔ8ð5#3ð6 •w˜tÔ5°uÑ=Ô=ð7#3ð8 � Ô 6¸Ñ?Ô?ð9#3ð: �7 4Ô#9¸9ÑEÔEð;#3ð< �G DÔ$:¸IÑFÔFð=#3ð> ˜Ô1ð?#3ð@ ˜Ô2ðA#3ðB ˜Ô3ðC#3ðD ˜$Ô4ðE#3ð #3ˆDŒNðJ 	×"Ò"Ñ$Ô$Ð$à�Š‰Œˆˆˆr"   c                 óP   — d                      |                      ¦   «         ¦  «        S )z Return the parsed docstring in reStructuredText format.

        Returns
        -------
        unicode
            Unicode version of the docstring.

        ú
)Újoinr‹   ©r   s    r    Ú__str__zGoogleDocstring.__str__â   s   € ð �yŠy˜Ÿš™œÑ&Ô&Ð&r"   c                 ó   — | j         S )z³Return the parsed lines of the docstring in reStructuredText format.

        Returns
        -------
        list(str)
            The lines of the docstring in a list.

        )rv   r�   s    r    r‹   zGoogleDocstring.linesí   s   € ð Ô!Ð!r"   é   Úindentc                 óz  — g }| j                              d¦  «        }|                      ¦   «         sŠ|r|                      ||¦  «        rr|                     | j                              ¦   «         ¦  «         | j                              d¦  «        }|                      ¦   «         s|¯\|                      ||¦  «        °r|S ©Nr   )ru   r!   Ú_is_section_breakÚ_is_indentedÚappendr)   )r   r”   r‹   Úlines       r    Ú_consume_indented_blockz'GoogleDocstring._consume_indented_blockø   sÀ   € ØˆØŒ{�Š˜qÑ!Ô!ˆà×&Ò&Ñ(Ô(ð	&àð	&à×*Ò*¨4°Ñ8Ô8ð	&ð �LŠL˜œ×)Ò)Ñ+Ô+Ñ,Ô,Ð,Ø”;—?’? 1Ñ%Ô%ˆDð	 ×&Ò&Ñ(Ô(ð	&àð	&à×*Ò*¨4°Ñ8Ô8ð	&ð ˆr"   c                 ó6  — g }| j         r�| j                              d¦  «        ru|                      ¦   «         sa|                     | j                              ¦   «         ¦  «         | j         r.| j                              d¦  «        r|                      ¦   «         ¯a|S r–   )ru   r!   Ú_is_section_headerr™   r)   ©r   r‹   s     r    Ú_consume_contiguousz#GoogleDocstring._consume_contiguous  sš   € ØˆØŒ{ð 	-ØŒ{�Š˜qÑ!Ô!ð	-à×*Ò*Ñ,Ô,ð	-ð �LŠL˜œ×)Ò)Ñ+Ô+Ñ,Ô,Ð,ð Œ{ð 	-ØŒ{�Š˜qÑ!Ô!ð	-à×*Ò*Ñ,Ô,ð	-ð ˆr"   c                 óî   — g }| j                              d¦  «        }| j         rQ|sO|                     | j                              ¦   «         ¦  «         | j                              d¦  «        }| j         r|¯O|S r–   )ru   r!   r™   r)   ©r   r‹   rš   s      r    Ú_consume_emptyzGoogleDocstring._consume_empty  sx   € ØˆØŒ{�Š˜qÑ!Ô!ˆØŒkð 	& $ð 	&Ø�LŠL˜œ×)Ò)Ñ+Ô+Ñ,Ô,Ð,Ø”;—?’? 1Ñ%Ô%ˆDð Œkð 	& $ð 	&ð ˆr"   TFÚ
parse_typeÚprefer_typec                 ó   — | j                              ¦   «         }|                      |¦  «        \  }}}|d|}	}}|rXt                               |¦  «        }
|
r<|
                     d¦  «                             ¦   «         }|
                     d¦  «        }|                      |¦  «        }|r|s||}}|r(| j        j	        rt          || j        j        pi ¦  «        }|                      |¦  «        dz   }|	g|                      |                      |¦  «        ¦  «        z   }|                      || j        ¦  «                             ¦   «         }|||fS )Nr:   r“   é   )ru   r)   Ú_partition_field_on_colonÚ_google_typed_arg_regexÚmatchÚgroupÚstripÚ_escape_args_and_kwargsre   Únapoleon_preprocess_typesr7   Únapoleon_type_aliasesÚ_get_indentÚ_dedentr›   r(   r‹   )r   r£   r¤   rš   ÚbeforeÚcolonÚafterrm   r2   Ú_descr©   r”   Ú_descss                r    Ú_consume_fieldzGoogleDocstring._consume_field  sP  € àŒ{×ÒÑ!Ô!ˆà#×=Ò=¸dÑCÔCÑˆ��uØ$ b¨%�eˆuˆàð 	'Ý+×1Ò1°&Ñ9Ô9ˆEØð 'ØŸš A™œ×,Ò,Ñ.Ô.�ØŸš A™œ�à×,Ò,¨UÑ3Ô3ˆàð 	(˜uð 	(Ø  %�5ˆEàð 	X�T”\Ô;ð 	XÝ& u¨d¬lÔ.PÐ.VÐTVÑWÔWˆEà×!Ò! $Ñ'Ô'¨!Ñ+ˆØ�˜4Ÿ<š<¨×(DÒ(DÀVÑ(LÔ(LÑMÔMÑMˆØ—’ ¨¬Ñ5Ô5×;Ò;Ñ=Ô=ˆØ�e˜VÐ#Ð#r"   Úmultiplec                 ó€  — |                       ¦   «          g }|                      ¦   «         s“|                      ||¦  «        \  }}}|rE|rC|                     d¦  «        D ],}|                     |                     ¦   «         ||f¦  «         Œ-n|s|s|r|                     |||f¦  «         |                      ¦   «         ¯“|S )Nú,)r¢   r—   r¶   Úsplitr™   r«   )	r   r£   r¤   r·   Úfieldsrm   r2   r´   r?   s	            r    Ú_consume_fieldszGoogleDocstring._consume_fields-  së   € à×ÒÑÔÐØˆØ×(Ò(Ñ*Ô*ð 	6Ø"&×"5Ò"5°jÀ+Ñ"NÔ"NÑˆE�5˜%Øð 6˜Eð 6Ø!ŸKšK¨Ñ,Ô,ð @ð @�DØ—M’M 4§:¢:¡<¤<°¸Ð">Ñ?Ô?Ð?Ð?ð@àð 6˜%ð 6 5ð 6Ø—’˜u e¨UÐ4Ñ5Ô5Ð5ð ×(Ò(Ñ*Ô*ð 	6ð ˆr"   c                 ó8  — | j                              ¦   «         }|                      |¦  «        \  }}}|r|s	||}}||z  }|g|                      |                      ¦   «         ¦  «        z   }|                      || j        ¦  «                             ¦   «         }||fS r$   )ru   r)   r§   r°   Ú_consume_to_endr(   re   r‹   )r   rš   r2   r²   r´   rµ   s         r    Ú_consume_inline_attributez)GoogleDocstring._consume_inline_attribute:  sŸ   € ØŒ{×ÒÑ!Ô!ˆØ"×<Ò<¸TÑBÔBÑˆˆu�eØð 	˜Eð 	Ø  %�5ˆEØ�U‰NˆEØ�˜4Ÿ<š<¨×(<Ò(<Ñ(>Ô(>Ñ?Ô?Ñ?ˆØ—’ ¨¬Ñ5Ô5×;Ò;Ñ=Ô=ˆØ�fˆ}Ðr"   Úpreprocess_typesc                 óž  — |                       |                      ¦   «         ¦  «        }|r£|                      |d         ¦  «        \  }}}dd|}}}|r|r|g|dd …         z   }n
|dd …         }|}|r*|r(| j        j        rt          || j        j        pi ¦  «        }|                      || j        ¦  «                             ¦   «         }|||fgS g S )Nr   r:   r“   )	r°   Ú_consume_to_next_sectionr§   re   r­   r7   r®   r(   r‹   )	r   rÀ   r‹   r±   r²   r³   rm   r2   r´   s	            r    Ú_consume_returns_sectionz(GoogleDocstring._consume_returns_sectionD  sú   € à—’˜T×:Ò:Ñ<Ô<Ñ=Ô=ˆØð 	Ø#'×#AÒ#AÀ%ÈÄ(Ñ#KÔ#KÑ ˆF�E˜5Ø"$ b¨%˜%�5ˆEàð Øð &Ø"˜G e¨A¨B¨B¤iÑ/�E�Eà! ! " "œI�Eà�àð \Ð*ð \Ø”LÔ:ð\å*¨5°$´,Ô2TÐ2ZÐXZÑ[Ô[�à—N’N 5¨$¬,Ñ7Ô7×=Ò=Ñ?Ô?ˆEØ˜E 5Ð*Ð+Ð+àˆIr"   c                 óT   — |                       |                      ¦   «         ¦  «        }|S r$   )r°   rÂ   rž   s     r    Ú_consume_usage_sectionz&GoogleDocstring._consume_usage_section\  s$   € Ø—’˜T×:Ò:Ñ<Ô<Ñ=Ô=ˆØˆr"   c                 óœ   — | j                              ¦   «         }|                     d¦  «        }|                     ¦   «         | j        v r|}|S )Nú:)ru   r)   r«   ÚlowerrG   )r   ÚsectionÚstripped_sections      r    Ú_consume_section_headerz'GoogleDocstring._consume_section_header`  sJ   € Ø”+×"Ò"Ñ$Ô$ˆØ"Ÿ=š=¨Ñ-Ô-ÐØ×!Ò!Ñ#Ô# t¤~Ð5Ð5Ø&ˆGØˆr"   c                 ó~   — g }| j         r3|                     | j                              ¦   «         ¦  «         | j         °3|S r$   )ru   r™   r)   rž   s     r    r¾   zGoogleDocstring._consume_to_endg  sB   € ØˆØŒkð 	-Ø�LŠL˜œ×)Ò)Ñ+Ô+Ñ,Ô,Ð,ð Œkð 	-àˆr"   c                 ó  — |                       ¦   «          g }|                      ¦   «         s@|                     | j                             ¦   «         ¦  «         |                      ¦   «         ¯@||                       ¦   «         z   S r$   )r¢   r—   r™   ru   r)   rž   s     r    rÂ   z(GoogleDocstring._consume_to_next_sectionm  sz   € Ø×ÒÑÔÐØˆØ×(Ò(Ñ*Ô*ð 	-Ø�LŠL˜œ×)Ò)Ñ+Ô+Ñ,Ô,Ð,ð ×(Ò(Ñ*Ô*ð 	-à�t×*Ò*Ñ,Ô,Ñ,Ð,r"   r‹   Úfullc                 óf   ‡— |rd„ |D ¦   «         S |                       |¦  «        Šˆfd„|D ¦   «         S )Nc                 ó6   — g | ]}|                      ¦   «         ‘ŒS r6   )Úlstrip)Ú.0rš   s     r    ú
<listcomp>z+GoogleDocstring._dedent.<locals>.<listcomp>v  s    € Ð4Ð4Ð4 d�D—K’K‘M”MÐ4Ð4Ð4r"   c                 ó$   •— g | ]}|‰d …         ‘ŒS r$   r6   )rÒ   rš   Ú
min_indents     €r    rÓ   z+GoogleDocstring._dedent.<locals>.<listcomp>y  s"   ø€ Ð8Ð8Ð8¨$�D˜˜˜Ô%Ð8Ð8Ð8r"   )Ú_get_min_indent)r   r‹   rÎ   rÕ   s      @r    r°   zGoogleDocstring._dedentt  sL   ø€ Øð 	9Ø4Ð4¨eÐ4Ñ4Ô4Ð4à×-Ò-¨eÑ4Ô4ˆJØ8Ð8Ð8Ð8°%Ð8Ñ8Ô8Ð8r"   c                 óâ   — |                      d¦  «        r#t          | j        dd¦  «        r|d d…         dz   }|d d…         dk    rd|dd …         z   S |d d	…         d
k    rd|d	d …         z   S |S )Nr   Ústrip_signature_backslashFéÿÿÿÿz\_r¦   ú**z\*\*r“   Ú*z\*)ÚendswithÚgetattrre   )r   r?   s     r    r¬   z'GoogleDocstring._escape_args_and_kwargs{  sŽ   € Ø�=Š=˜ÑÔð 	%¥'¨$¬,Ð8SÐUZÑ"[Ô"[ð 	%Ø˜˜˜”9˜uÑ$ˆDà���Œ8�tÒÐØ˜T ! " "œXÑ%Ð%Ø�"�1�"ŒX˜Š_ˆ_Ø˜4   œ8Ñ#Ð#àˆKr"   Údescc                 óD  — |                       |¦  «        rdg|z   }nƒ|d                              d¦  «        rh|dd …         }|                      |d         ¦  «        }|                      |¦  «        }||k    rdg|z   }n!d|d         g|                      |d¦  «        z   }|S )Nr:   r   ú::r“   é   )Ú_is_listrÜ   r¯   Ú_get_initial_indentÚ_indent)r   rÞ   Ú
desc_blockr”   Úblock_indents        r    Ú_fix_field_desczGoogleDocstring._fix_field_desc†  s³   € Ø�=Š=˜ÑÔð 		CØ�4˜$‘;ˆDˆDØ�!ŒW×Ò˜dÑ#Ô#ð 	CØ˜a˜b˜bœˆJØ×%Ò% d¨1¤gÑ.Ô.ˆFØ×3Ò3°JÑ?Ô?ˆLØ˜fÒ$Ð$Ø�t˜d‘{��à˜D œG�} t§|¢|°JÀÑ'BÔ'BÑB�Øˆr"   Ú
admonitionc                 ó  — |                       |¦  «        }t          |¦  «        dk    r"d|›d|d                              ¦   «         ›�dgS |r7|                      |                      |¦  «        d¦  «        }d|z  dg|z   dgz   S d|z  dgS )Nr“   z.. z:: r   r:   é   z.. %s::)Ú_strip_emptyr   r«   rä   r°   )r   rè   r‹   s      r    Ú_format_admonitionz"GoogleDocstring._format_admonition“  sž   € Ø×!Ò! %Ñ(Ô(ˆÝˆu‰:Œ:˜Š?ˆ?ˆ?Ø$. J J°°a´·²Ñ0@Ô0@Ð0@ÐAÀ2ÐFÐFØð 	0Ø—L’L §¢¨eÑ!4Ô!4°aÑ8Ô8ˆEØ 
Ñ*¨BÐ/°%Ñ7¸2¸$Ñ>Ð>à 
Ñ*¨BÐ/Ð/r"   ÚprefixÚpaddingc                 ó(  — |rŽ|€dt          |¦  «        z  }g }t          |¦  «        D ]f\  }}|dk    r+|                     ||z                        ¦   «         ¦  «         Œ6|r|                     ||z   ¦  «         ŒQ|                     d¦  «         Œg|S |gS )Nú r   r:   )r   Ú	enumerater™   rt   )r   rí   r‹   rî   Úresult_linesÚirš   s          r    Ú_format_blockzGoogleDocstring._format_block�  s¶   € Øð 	ØˆØ¥ F¡¤Ñ+�ØˆLÝ$ UÑ+Ô+ð ,ð ,‘��4Ø˜’6�6Ø ×'Ò'¨°$©×(>Ò(>Ñ(@Ô(@ÑAÔAÐAÐAØð ,Ø ×'Ò'¨°$©Ñ7Ô7Ð7Ð7à ×'Ò'¨Ñ+Ô+Ð+Ð+ØÐà�8ˆOr"   ÚparamÚtyper»   Ú
field_roleÚ	type_rolec           	      ót  — g }|D ]®\  }}}|                       |¦  «        }t          |¦  «        rH|                      |¦  «        }d|›d|›d�}|                     |                      ||¦  «        ¦  «         n|                     d|›d|›d�¦  «         |r|                     d|›d|›d|›�¦  «         Œ¯|dgz   S )NrÇ   rð   ú: r:   )rë   Úanyrç   Úextendrô   r™   )	r   r»   r÷   rø   r‹   rm   r2   r´   Úfields	            r    Ú_format_docutils_paramsz'GoogleDocstring._format_docutils_params­  sê   € ð ˆØ#)ð 
	Gð 
	GÑˆE�5˜%Ø×%Ò% eÑ,Ô,ˆEÝ�5‰zŒzð >Ø×,Ò,¨UÑ3Ô3��Ø&0 j j°%°%°%Ð8�Ø—’˜T×/Ò/°°uÑ=Ô=Ñ>Ô>Ð>Ð>à—’�¨*¨*¨*°e°e°eÐ<Ñ=Ô=Ð=àð GØ—’�¨Y¨Y¨Y¸¸¸¸u¸uÐEÑFÔFÐFøØ˜�t‰|Ðr"   rm   r2   r´   c                 óV  — |                       |¦  «        }t          |¦  «        }|rdnd}|r'|rd|v rd|›d|›d|›�}n-d|›d|›d|›�}n!d|›d|›�}n|rd|v r|›|›�}nd	|›d	|›�}nd}|r:|                      |¦  «        }|d
         r||d
         z   g|dd …         z   S |g|z   S |gS )Nz -- r:   ú`rÚ   z** (ú)z** (*z*)rÛ   r   r“   )rë   rû   rç   )r   rm   r2   r´   Úhas_descÚ	separatorrý   s          r    Ú_format_fieldzGoogleDocstring._format_field¾  s1  € Ø×!Ò! %Ñ(Ô(ˆÝ�u‘:”:ˆØ&Ð.�F�F¨Bˆ	Øð 	Øð 8Ø˜%�<�<�<Ø/4¨u¨u°e°e°e¸Y¸YÐG�E�Eð  ð 27°°¸¸¸¸y¸yÐI�E�Eð	8ð ', e e¨Y¨YÐ7��Øð 	Ø�eˆ|ˆ|Ø"' %¨¨Ð3��ð ð %* E E¨9¨9Ð5��àˆEàð 	Ø×(Ò(¨Ñ/Ô/ˆEØ�QŒxð 'Ø  a¤Ñ(Ð)¨E°!°"°"¬IÑ5Ð5à�w ‘Ð&à�7ˆNr"   Ú
field_typec                 ó  — d|                      ¦   «         z  }dt          |¦  «        z  }t          |¦  «        dk    }g }|D ]§\  }}}|                      |||¦  «        }	|r\|r-|                     |                      |dz   |	¦  «        ¦  «         ŒN|                     |                      |dz   |	¦  «        ¦  «         Œ{|                     |                      |dz   |	¦  «        ¦  «         Œ¨|r|d         r|                     d¦  «         |S )Nz:%s:rð   r“   z * rÙ   r:   )r«   r   r  rü   rô   r™   )
r   r  r»   rî   Úmultir‹   rm   r2   r´   rý   s
             r    Ú_format_fieldszGoogleDocstring._format_fieldsÛ  s$  € à˜j×.Ò.Ñ0Ô0Ñ0ˆ
Ø�˜J™œÑ'ˆÝ�F‘”˜a’ˆØˆØ#)ð 	Jð 	JÑˆE�5˜%Ø×&Ò& u¨e°UÑ;Ô;ˆEØð JØð PØ—L’L ×!3Ò!3°G¸e±OÀUÑ!KÔ!KÑLÔLÐLÐLà—L’L ×!3Ò!3°JÀÑ4FÈÑ!NÔ!NÑOÔOÐOÐOà—’˜T×/Ò/°
¸SÑ0@À%ÑHÔHÑIÔIÐIÐIØð 	�U˜2”Yð 	Ø�LŠL˜ÑÔÐØˆr"   r   Ú
peek_aheadc                 óÞ   — | j                              |¦  «        }|| j         j        urD|r|                      |¦  «        S |dz  }| j                              |¦  «        }|| j         j        u°DdS )Nr“   r   )ru   r!   r   r¯   )r   r	  rš   s      r    Ú_get_current_indentz#GoogleDocstring._get_current_indentî  sv   € ØŒ{�Š˜zÑ*Ô*ˆØ˜$œ+Ô.Ð.Ð.Øð .Ø×'Ò'¨Ñ-Ô-Ð-Ø˜!‰OˆJØ”;—?’? :Ñ.Ô.ˆDð	 ˜$œ+Ô.Ð.Ð.ð
 ˆqr"   rš   c                 óz   — t          |¦  «        D ]\  }}|                     ¦   «         s|c S Œt          |¦  «        S r$   )rñ   Úisspacer   )r   rš   ró   Úss       r    r¯   zGoogleDocstring._get_indent÷  sE   € Ý˜d‘O”Oð 	ð 	‰DˆAˆqØ—9’9‘;”;ð Ø���ðå�4‰yŒyÐr"   c                 óB   — |D ]}|r|                       |¦  «        c S ŒdS r–   ©r¯   r¡   s      r    rã   z#GoogleDocstring._get_initial_indentý  s=   € Øð 	.ð 	.ˆDØð .Ø×'Ò'¨Ñ-Ô-Ð-Ð-Ð-ð.àˆqr"   c                 ó`   — d }|D ]&}|r"|                       |¦  «        }|€|}Œ||k     r|}Œ'|pdS r–   r  )r   r‹   rÕ   rš   r”   s        r    rÖ   zGoogleDocstring._get_min_indent  sY   € Øˆ
Øð 	(ð 	(ˆDØð (Ø×)Ò)¨$Ñ/Ô/�ØÐ%Ø!'�J�JØ˜jÒ(Ð(Ø!'�JøØˆ˜QÐr"   rá   r   c                 ó    ‡— ˆfd„|D ¦   «         S )Nc                 ó    •— g | ]
}d ‰z  |z   ‘ŒS )rð   r6   )rÒ   rš   r   s     €r    rÓ   z+GoogleDocstring._indent.<locals>.<listcomp>  s"   ø€ Ð3Ð3Ð3 T��q‘˜DÑ Ð3Ð3Ð3r"   r6   )r   r‹   r   s     `r    rä   zGoogleDocstring._indent  s   ø€ Ø3Ð3Ð3Ð3¨UÐ3Ñ3Ô3Ð3r"   c                 óp   — t          |¦  «        D ]%\  }}||k    r dS |                     ¦   «         s dS Œ&dS ©NTF)rñ   r  )r   rš   r”   ró   r  s        r    r˜   zGoogleDocstring._is_indented  sL   € Ý˜d‘O”Oð 	ð 	‰DˆAˆqØ�FŠ{ˆ{Ø�t�tØ—Y’Y‘[”[ð Ø�u�uðàˆur"   c                 ó„  — |sdS t                                |d         ¦  «        rdS t                               |d         ¦  «        rdS t          |¦  «        dk     s|d                              d¦  «        rdS |                      |d         ¦  «        }|}|dd …         D ]}|r|                      |¦  «        } nŒ||k    S )NFr   Tr¦   rà   r“   )Ú_bullet_list_regexr©   Ú_enumerated_list_regexr   rÜ   r¯   )r   r‹   r”   Únext_indentrš   s        r    râ   zGoogleDocstring._is_list  sÜ   € Øð 	Ø�5Ý×#Ò# E¨!¤HÑ-Ô-ð 	Ø�4Ý!×'Ò'¨¨a¬Ñ1Ô1ð 	Ø�4Ýˆu‰:Œ:˜Š>ˆ>˜U 1œX×.Ò.¨tÑ4Ô4ˆ>Ø�5Ø×!Ò! %¨¤(Ñ+Ô+ˆØˆØ˜!˜"˜"”Ið 	ð 	ˆDØð Ø"×.Ò.¨tÑ4Ô4�Ø�ðð ˜VÒ#Ð#r"   c                 ó¶  — | j                              d¦  «                             ¦   «         }t                               |¦  «        }|rM|                     d¦  «        | j        v r1|                      |¦  «        }|                      d¬¦  «        }||k    S | j	        r<t                               |¦  «        r"| j	        D ]}|                     |¦  «        r dS ŒdS )Nr   rÇ   r“   )r	  TF)ru   r!   rÈ   Ú_google_section_regexr©   r«   rG   r¯   r  rF   Ú_directive_regexÚ
startswith)r   rÉ   r©   Úheader_indentÚsection_indentÚdirective_sections         r    r�   z"GoogleDocstring._is_section_header*  sä   € Ø”+—/’/ !Ñ$Ô$×*Ò*Ñ,Ô,ˆÝ%×+Ò+¨GÑ4Ô4ˆØð 	$�W—]’] 3Ñ'Ô'¨4¬>Ð9Ð9Ø ×,Ò,¨WÑ5Ô5ˆMØ!×5Ò5ÀÐ5ÑCÔCˆNØ! MÒ1Ð1ØÔ%ð 	$Ý×%Ò% gÑ.Ô.ð $Ø)-Ô)Að $ð $Ð%Ø×)Ò)Ð*;Ñ<Ô<ð $Ø#˜t˜tð$àˆur"   c                 ó¸   — | j                              d¦  «        }| j          p8|                      ¦   «         p$| j        o|o|                      || j        ¦  «         S r–   ©ru   r!   r�   rw   r˜   rx   )r   rš   s     r    r—   z!GoogleDocstring._is_section_break8  sk   € ØŒ{�Š˜qÑ!Ô!ˆØ”K�ð GØ×'Ò'Ñ)Ô)ðGàÔ$ð FØðFà×)Ò)¨$°Ô0DÑEÔEÐEð		Hr"   c                 ó0  — | j         j        ��| j         j        D ]û}t          |t          ¦  «        r"| j        | j        |                     ¦   «         <   Œ9|d         dk    r(| j        | j        |d                              ¦   «         <   Œm|d         dk    r(| j        | j        |d                              ¦   «         <   Œ¡| j         	                    |d                              ¦   «         | j        ¦  «        | j        |d                              ¦   «         <   Œúd S d S )Nr“   Úparams_styler   Úreturns_style)
re   Únapoleon_custom_sectionsrp   rq   Ú_parse_custom_generic_sectionrG   rÈ   Ú"_parse_custom_params_style_sectionÚ#_parse_custom_returns_style_sectionr!   )r   Úentrys     r    r‰   z%GoogleDocstring._load_custom_sections@  s  € ØŒ<Ô0Ñ<ØœÔ>ð Sð S�Ý˜e¥SÑ)Ô)ð Sð 59Ô4V�D”N 5§;¢;¡=¤=Ñ1Ð1ð ˜Q”x >Ò1Ð1à ÔCð œ u¨Q¤x§~¢~Ñ'7Ô'7Ñ8Ð8à˜qœ _Ò4Ð4à ÔDð œ u¨Q¤x§~¢~Ñ'7Ô'7Ñ8Ð8ð !œN×.Ò.¨u°Q¬x¯~ª~Ñ/?Ô/?Ø/3Ô/QñSô Sð œ u¨Q¤x§~¢~Ñ'7Ô'7Ñ8Ð8ð# =Ð<ðSð Sr"   c                 óN  — |                       ¦   «         | _        | j        rM| j        dv rDg }	 |                      ¦   «         }n# t
          $ r Y nw xY w| j                             |¦  «         d S | j        �r/|                      ¦   «         r²	 |  	                    ¦   «         }d| _
        |                      ¦   «         | _        t                               |¦  «        r|g|                      ¦   «         z   }n( | j        |                     ¦   «                  |¦  «        }d| _
        d| _        nX# d| _
        d| _        w xY w| j        s*|                      ¦   «         |                       ¦   «         z   }n|                      ¦   «         }| j                             |¦  «         | j        �°-d S d S )N)Ú	attributeÚdataÚpropertyTFr   )r¢   rv   rm   rl   Ú_parse_attribute_docstringr'   rü   ru   r�   rË   rw   r  rx   r  r©   rÂ   rG   rÈ   rŸ   )r   ÚresrÉ   r‹   s       r    rŠ   zGoogleDocstring._parseV  sÐ  € Ø!×0Ò0Ñ2Ô2ˆÔàŒ:ð 		˜$œ*Ð(IÐIÐIð  ˆCðØ×5Ò5Ñ7Ô7��øÝ ð ð ð Ø�ðøøøàÔ×%Ò% cÑ*Ô*Ð*ØˆFàŒkñ 	-Ø×&Ò&Ñ(Ô(ð <ð
-Ø"×:Ò:Ñ<Ô<�GØ*.�DÔ'Ø+/×+CÒ+CÑ+EÔ+E�DÔ(Ý'×-Ò-¨gÑ6Ô6ð IØ!( 	¨D×,IÒ,IÑ,KÔ,KÑ K˜˜à ? ¤¨w¯}ª}©¬Ô ?ÀÑ HÔ H˜à*/�DÔ'Ø+,�DÔ(Ð(øð +0�DÔ'Ø+,�DÔ(Ð,Ð,Ð,Ð,àÔ)ð <Ø ×4Ò4Ñ6Ô6¸×9LÒ9LÑ9NÔ9NÑN�E�Eà ×9Ò9Ñ;Ô;�EØÔ×%Ò% eÑ,Ô,Ð,ð% Œkñ 	-ð 	-ð 	-ð 	-ð 	-s   ­A Á
AÁAÂBD) Ä)D9rÉ   c                 óV   — |                       ¦   «         }|                      ||¦  «        S r$   )rÂ   rì   )r   rè   rÉ   r‹   s       r    r{   z!GoogleDocstring._parse_admonitionx  s)   € à×-Ò-Ñ/Ô/ˆØ×&Ò& z°5Ñ9Ô9Ð9r"   c                 óš   — |                       ¦   «         \  }}|                      dd|¦  «        }|r|                     dd|z  g¦  «         |S )Nr:   ú	:type: %s)r¿   r  rü   )r   r2   r´   r‹   s       r    r/  z*GoogleDocstring._parse_attribute_docstring}  sW   € Ø×5Ò5Ñ7Ô7‰ˆˆuØ×"Ò" 2 r¨5Ñ1Ô1ˆØð 	4Ø�LŠL˜"˜k¨EÑ1Ð2Ñ3Ô3Ð3Øˆr"   c                 ó:  — g }|                       ¦   «         D �]a\  }}}|s|                      |¦  «        }| j        j        rLd|z  }|                     |                      ||¦  «        ¦  «         |r|                     d|›d|›�¦  «         Œv|                     d|z   ¦  «         | j        rd| j        v r|                     d¦  «         |                     d¦  «         |                      dd|¦  «        }|                     |  	                    |d¦  «        ¦  «         |rB|                     d¦  «         |                     |  	                    d	|z  gd¦  «        ¦  «         |                     d¦  «         �Œc| j        j        r|                     d¦  «         |S )
Nz
:ivar %s: z	:vartype rú   z.. attribute:: Únoindexú   :noindex:r:   rê   r3  )
r¼   Ú_lookup_annotationre   Únapoleon_use_ivarrü   rô   r™   ro   r  rä   )r   rÉ   r‹   rm   r2   r´   rý   r»   s           r    r|   z)GoogleDocstring._parse_attributes_section„  s«  € ØˆØ#'×#7Ò#7Ñ#9Ô#9ð 	!ñ 	!ÑˆE�5˜%Øð 7Ø×/Ò/°Ñ6Ô6�ØŒ|Ô-ð !Ø$ uÑ,�Ø—’˜T×/Ò/°°uÑ=Ô=Ñ>Ô>Ð>Øð EØ—L’L�L°e°e°e¸U¸UÐ!CÑDÔDÐDøà—’Ð.°Ñ6Ñ7Ô7Ð7Ø”9ð 1 ¨d¬iÐ!7Ð!7Ø—L’L Ñ0Ô0Ð0Ø—’˜RÑ Ô Ð à×+Ò+¨B°°EÑ:Ô:�Ø—’˜TŸ\š\¨&°!Ñ4Ô4Ñ5Ô5Ð5Øð IØ—L’L Ñ$Ô$Ð$Ø—L’L §¢¨{¸UÑ/BÐ.CÀQÑ!GÔ!GÑHÔHÐHØ—’˜RÑ Ô Ð Ñ ØŒ<Ô)ð 	Ø�LŠL˜ÑÔÐØˆr"   c                 óÔ   — t          d¦  «        t          d¦  «        dœ}| j        j        }|                     |                     ¦   «         |¦  «        }|                      ||¦  «        S )NÚExampleÚExamples)rO   rP   )r   re   Ú$napoleon_use_admonition_for_examplesr!   rÈ   Ú_parse_generic_section)r   rÉ   ÚlabelsÚuse_admonitionÚlabels        r    r}   z'GoogleDocstring._parse_examples_sectionž  s]   € å˜‘|”|Ý˜*™œð
ð 
ˆð œÔJˆØ—
’
˜7Ÿ=š=™?œ?¨GÑ4Ô4ˆØ×*Ò*¨5°.ÑAÔAÐAr"   c                 ó.   — |                       |d¦  «        S )NF)r=  ©r   rÉ   s     r    r'  z-GoogleDocstring._parse_custom_generic_section§  s   € à×*Ò*¨7°EÑ:Ô:Ð:r"   c                 óR   — |                       ||                      ¦   «         ¦  «        S r$   )r  r¼   rB  s     r    r(  z2GoogleDocstring._parse_custom_params_style_section«  s$   € Ø×"Ò" 7¨D×,@Ò,@Ñ,BÔ,BÑCÔCÐCr"   c                 óZ   — |                       d¬¦  «        }|                      ||¦  «        S )NT©rÀ   )rÃ   r  ©r   rÉ   r»   s      r    r)  z3GoogleDocstring._parse_custom_returns_style_section®  s.   € Ø×.Ò.ÀÐ.ÑEÔEˆØ×"Ò" 7¨FÑ3Ô3Ð3r"   c                 ó~   — ddg}ddg}|                       ¦   «         }|                      |d¦  «        }||z   |z   dgz   S )Nz.. rubric:: Usage:r:   z.. code-block:: pythonrê   )rÅ   rä   )r   rÉ   ÚheaderÚblockr‹   s        r    Ú_parse_usage_sectionz$GoogleDocstring._parse_usage_section²  sP   € Ø&¨Ð+ˆØ)¨2Ð.ˆØ×+Ò+Ñ-Ô-ˆØ—’˜U AÑ&Ô&ˆØ˜‰~ Ñ%¨¨Ñ,Ð,r"   r?  c                 óâ   — |                       |                      ¦   «         ¦  «        }|                      |¦  «        }|rd|z  }|                      |d¦  «        }nd|z  }|r|dg|z   dgz   S |dgS )Nz.. admonition:: %srê   z.. rubric:: %sr:   )rë   rÂ   r°   rä   )r   rÉ   r?  r‹   rH  s        r    r=  z&GoogleDocstring._parse_generic_section¹  s‹   € Ø×!Ò! $×"?Ò"?Ñ"AÔ"AÑBÔBˆØ—’˜UÑ#Ô#ˆØð 	0Ø)¨GÑ3ˆFØ—L’L ¨Ñ*Ô*ˆEˆEà%¨Ñ/ˆFØð 	 Ø˜B�< %Ñ'¨2¨$Ñ.Ð.à˜B�<Ðr"   c                 ó¸   — |                       ¦   «         }| j        j        r|                      |dd¬¦  «        S |                      t          d¦  «        |¦  «        S )NÚkeywordÚkwtype)r÷   rø   zKeyword Arguments)r¼   re   Únapoleon_use_keywordrþ   r  r   rF  s      r    r~   z0GoogleDocstring._parse_keyword_arguments_sectionÆ  sh   € Ø×%Ò%Ñ'Ô'ˆØŒ<Ô,ð 	GØ×/Ò/ØØ$Ø"ð 0ñ $ô $ð $ð
 ×&Ò&¥qÐ)<Ñ'=Ô'=¸vÑFÔFÐFr"   c                 óF  — g }|                       d¬¦  «        D ]‡\  }}}|                     d|z  ¦  «         | j        rd| j        v r|                     d¦  «         |r-|                     dg|                      |d¦  «        z   ¦  «         |                     d¦  «         Œˆ|S )NF)r£   z.. method:: %sr5  r6  r:   rê   )r¼   r™   ro   rü   rä   )r   rÉ   r‹   rm   r2   r´   s         r    r   z&GoogleDocstring._parse_methods_sectionÐ  s·   € ØˆØ#'×#7Ò#7À5Ð#7Ñ#IÔ#Ið 	ð 	ÑˆE�5˜%Ø�LŠLÐ)¨EÑ1Ñ2Ô2Ð2ØŒyð -˜Y¨$¬)Ð3Ð3Ø—’˜^Ñ,Ô,Ð,Øð <Ø—’˜b˜T D§L¢L°¸Ñ$:Ô$:Ñ:Ñ;Ô;Ð;Ø�LŠL˜ÑÔÐÐØˆr"   c                 ó`   — | j         j        }|                      t          d¦  «        |¦  «        S )NÚNotes)re   Ú!napoleon_use_admonition_for_notesr=  r   ©r   rÉ   r?  s      r    r€   z$GoogleDocstring._parse_notes_sectionÛ  s(   € ØœÔGˆØ×*Ò*­1¨W©:¬:°~ÑFÔFÐFr"   c                 óÞ   — | j         j        r+|                      d¬¦  «        }|                      |¦  «        S |                      ¦   «         }|                      t          d¦  «        |¦  «        S )NT©r·   zOther Parameters©re   Únapoleon_use_paramr¼   rþ   r  r   rF  s      r    r�   z/GoogleDocstring._parse_other_parameters_sectionß  sj   € ØŒ<Ô*ð 	Fà×)Ò)°4Ð)Ñ8Ô8ˆFØ×/Ò/°Ñ7Ô7Ð7à×)Ò)Ñ+Ô+ˆFØ×&Ò&¥qÐ);Ñ'<Ô'<¸fÑEÔEÐEr"   c                 óÞ   — | j         j        r+|                      d¬¦  «        }|                      |¦  «        S |                      ¦   «         }|                      t          d¦  «        |¦  «        S )NTrV  Ú
ParametersrW  rF  s      r    rz   z)GoogleDocstring._parse_parameters_sectionè  sg   € ØŒ<Ô*ð 	@à×)Ò)°4Ð)Ñ8Ô8ˆFØ×/Ò/°Ñ7Ô7Ð7à×)Ò)Ñ+Ô+ˆFØ×&Ò&¥q¨¡¤¸Ñ?Ô?Ð?r"   c                 óB  — |                       dd¬¦  «        }g }|D ]ë\  }}}| j                             |¦  «        }|r+|                     d¦  «        r|                     d¦  «        }n<t                               |¦  «        r"|                     d¦  «        }||dz   d…         }|rd|z   nd	}|                      |¦  «        }t          |¦  «        rdd
                     |¦  «        z   nd	}	| 	                    d|›d|	›�¦  «         Œì|r| 	                    d	¦  «         |S )NFT)r£   r¤   r?   r   r“   rÙ   rð   r:   z
    z:raisesrÇ   )
r¼   Ú	_name_rgxr©   rª   Ú_xref_regexÚfindrë   rû   r�   r™   )
r   rÉ   r»   r‹   rm   r2   r´   ÚmÚposrµ   s
             r    r„   z%GoogleDocstring._parse_raises_sectionñ  s7  € Ø×%Ò%°ÀDÐ%ÑIÔIˆØˆØ#)ð 
	;ð 
	;ÑˆE�5˜%Ø”×$Ò$ UÑ+Ô+ˆAØð *�Q—W’W˜V‘_”_ð *ØŸš ™œ��Ý×"Ò" 5Ñ)Ô)ð *Ø—j’j ‘o”o�Ø˜c A™g b˜jÔ)�Ø#(Ð0�C˜%‘K�K¨bˆEØ×%Ò% eÑ,Ô,ˆEÝ36°u±:´:ÐE�S˜8Ÿ=š=¨Ñ/Ô/Ñ/Ð/À2ˆFØ�LŠLˆL¨5¨5¨5°&°&Ð9Ñ:Ô:Ð:Ð:Øð 	Ø�LŠL˜ÑÔÐØˆr"   c                 óÞ   — | j         j        r+|                      d¬¦  «        }|                      |¦  «        S |                      ¦   «         }|                      t          d¦  «        |¦  «        S )NTrV  ÚReceivesrW  rF  s      r    r‚   z'GoogleDocstring._parse_receives_section  sf   € ØŒ<Ô*ð 	>à×)Ò)°4Ð)Ñ8Ô8ˆFØ×/Ò/°Ñ7Ô7Ð7à×)Ò)Ñ+Ô+ˆFØ×&Ò&¥q¨¡}¤}°fÑ=Ô=Ð=r"   c                 ó`   — | j         j        }|                      t          d¦  «        |¦  «        S )NÚ
References)re   Ú&napoleon_use_admonition_for_referencesr=  r   rT  s      r    r…   z)GoogleDocstring._parse_references_section  s(   € ØœÔLˆØ×*Ò*­1¨\©?¬?¸NÑKÔKÐKr"   c                 ó†  — |                       ¦   «         }t          |¦  «        dk    }|rdn| j        j        }g }|D ]å\  }}}|r|                      |d|¦  «        }	n|                      |||¦  «        }	|rV|r*|                     |                      d|	¦  «        ¦  «         Œe|                     |                      d|	¦  «        ¦  «         Œ�t          |	¦  «        r)|                     |                      d|	¦  «        ¦  «         |r|r|                     d|z  dg¦  «         Œæ|r|d         r|                     d¦  «         |S )	Nr“   Fr:   z          * z:returns: * z
:returns: z
:rtype: %srÙ   )	rÃ   r   re   Únapoleon_use_rtyper  rü   rô   rû   r™   )
r   rÉ   r»   r  Ú	use_rtyper‹   rm   r2   r´   rý   s
             r    rƒ   z&GoogleDocstring._parse_returns_section  sk  € Ø×.Ò.Ñ0Ô0ˆÝ�F‘”˜a’ˆØ"ÐG�E�E¨¬Ô(Gˆ	Øˆà#)ð 	=ð 	=ÑˆE�5˜%Øð @Ø×*Ò*¨5°"°eÑ<Ô<��à×*Ò*¨5°%¸Ñ?Ô?�àð 	=Øð LØ—L’L ×!3Ò!3°NÀEÑ!JÔ!JÑKÔKÐKÐKà—L’L ×!3Ò!3°NÀEÑ!JÔ!JÑKÔKÐKÐKå�u‘:”:ð JØ—L’L ×!3Ò!3°LÀ%Ñ!HÔ!HÑIÔIÐIØð =˜Yð =Ø—L’L ,°Ñ"6¸Ð!;Ñ<Ô<Ð<øØð 	�U˜2”Yð 	Ø�LŠL˜ÑÔÐØˆr"   c                 ó.   — |                       d|¦  «        S ©NÚseealso)r{   rB  s     r    r†   z'GoogleDocstring._parse_see_also_section*  s   € Ø×%Ò% i°Ñ9Ô9Ð9r"   c                 ól   — |                       t          d¦  «        |                      ¦   «         ¦  «        S )NÚWarns)r  r   r¼   rB  s     r    r‡   z$GoogleDocstring._parse_warns_section-  s*   € Ø×"Ò"¥1 W¡:¤:¨t×/CÒ/CÑ/EÔ/EÑFÔFÐFr"   c                 ót   — |                       d¬¦  «        }|                      t          d¦  «        |¦  «        S )NTrE  ÚYields)rÃ   r  r   rF  s      r    rˆ   z%GoogleDocstring._parse_yields_section0  s4   € Ø×.Ò.ÀÐ.ÑEÔEˆØ×"Ò"¥1 X¡;¤;°Ñ7Ô7Ð7r"   c                 óÌ  — g }g }d}d}t          t                               |¦  «        ¦  «        D ]æ\  }}|r|                     |¦  «         Œt                               |¦  «        }|dz  dk    r‘|r�d}||                     ¦   «         |                     ¦   «         …         }|                     |d |                     ¦   «         …         ¦  «         |                     ||                     ¦   «         d …         ¦  «         ŒÑ|                     |¦  «         Œçd                     |¦  «         	                    ¦   «         |d                     |¦  «         	                    ¦   «         fS )Nr:   Fr¦   r   T)
rñ   Ú_xref_or_code_regexrº   r™   Ú_single_colon_regexÚsearchÚstartÚendr�   r«   )	r   rš   Úbefore_colonÚafter_colonr²   Úfound_colonró   Úsourcer_  s	            r    r§   z)GoogleDocstring._partition_field_on_colon4  sN  € ØˆØˆØˆØˆÝ"Õ#6×#<Ò#<¸TÑ#BÔ#BÑCÔCð 	0ð 	0‰IˆAˆvØð 
0Ø×"Ò" 6Ñ*Ô*Ð*Ð*å'×.Ò.¨vÑ6Ô6�Ø˜‘E˜a’<�< A�<Ø"&�KØ" 1§7¢7¡9¤9¨a¯eªe©g¬gÐ#5Ô6�EØ ×'Ò'¨¨z°·²±	´	¨zÔ(:Ñ;Ô;Ð;Ø×&Ò& v¨a¯eªe©g¬g¨h¨hÔ'7Ñ8Ô8Ð8Ð8à ×'Ò'¨Ñ/Ô/Ð/Ð/à—’˜Ñ%Ô%×+Ò+Ñ-Ô-ØØ—’˜Ñ$Ô$×*Ò*Ñ,Ô,ð.ð 	.r"   Ú	attr_nameÚklassc                 óî   — t          j        d| j        j        z  t          ¦  «         |rKd|vrG|                     d¦  «        r
|dd …         }	 |j        }n# t          $ r
 |j        }Y nw xY wd|›d|›�S |S )Nz!%s._qualify_name() is deprecated.ú.ú~r“   )r`   ra   r(   r*   r   r  r,   ÚAttributeError)r   rz  r{  Úqs       r    Ú_qualify_namezGoogleDocstring._qualify_nameJ  s®   € ÝŒÐ9Ø”nÔ-ñ.Ý/Gñ	Iô 	Ið 	Iàð 	-�S 	Ð)Ð)Ø×#Ò# CÑ(Ô(ð *Ø% a b bœM�	ð#ØÔ&��øÝ!ð #ð #ð #Ø”N���ð#øøøøà ˜q˜q ) )Ð,Ð,ØÐs   ÁA ÁA*Á)A*c                 ó  — |rŠd}t          |¦  «        D ]\  }}|r|} nŒ|dk    rg }d}t          t          t          |¦  «        ¦  «        ¦  «        D ]}||         }|r|} nŒ|dk    s|dz   t          |¦  «        k     r|||dz   …         }|S )NrÙ   r   r“   )rñ   ÚreversedÚranger   )r   r‹   rt  ró   rš   ru  s         r    rë   zGoogleDocstring._strip_emptyW  sÑ   € Øð 	-ØˆEÝ$ UÑ+Ô+ð ð ‘��4Øð Ø�EØ�Eðð ˜Š{ˆ{Ø�ØˆCÝ�e¥C¨¡J¤JÑ/Ô/Ñ0Ô0ð ð �Ø˜Q”x�Øð Ø�CØ�Eðð �qŠyˆy˜C !™G¥c¨%¡j¤jÒ0Ð0Ø˜e C¨!¡G˜mÔ,�Øˆr"   c                 ó\  — | j         j        rŸ| j        dv r–| j        r�t	          | d¦  «        s\t          | j         di ¦  «        }|                     t          | j         di ¦  «        pi ¦  «         t          | j        d |¦  «        | _        || j        v rt          | j        |         ¦  «        S dS )N)rD   rC   Ú	exceptionÚ_annotationsÚautodoc_type_aliasesr®   r:   )
re   Únapoleon_attr_annotationsrl   rn   ry   rÝ   Úupdater   r‡  r   )r   rm   Úlocalnss      r    r7  z"GoogleDocstring._lookup_annotationj  sÁ   € ØŒ<Ô1ð 
	JØŒzÐ=Ð=Ð=À$Ä)Ð=å˜t ^Ñ4Ô4ð QÝ% d¤lÐ4JÈBÑOÔO�GØ—N’N¥7Ø#'¤<Ð1HÈ"ñ$%ô $%ð $+à(*ñ,ô ,ð ,õ )7°t´yÀ$ÈÑ(PÔ(P�DÔ%Ø˜DÔ-Ð-Ð-Ý/°Ô0AÀ%Ô0HÑIÔIÐIàˆrr"   ©NNr:   r:   NN)r“   ©TF)TFF©Fr$   )rõ   rö   )r   )rá   )r   N)Lr*   r+   r,   r-   ÚreÚcompileÚXr\  r
   rq   r   ÚSphinxConfigr   r   rŒ   r‘   r‹   r/   r›   rŸ   r¢   Úboolr   r¶   r¼   r¿   rÃ   rÅ   rË   r¾   rÂ   r°   r¬   rç   rì   rô   rþ   r  r  r  r¯   rã   rÖ   rä   r˜   râ   r�   r—   r‰   rŠ   r{   r/  r|   r}   r'  r(  r)  rJ  r=  r~   r   r€   r�   rz   r„   r‚   r…   rƒ   r†   r‡   rˆ   r§   r	   r�  rë   r7  r6   r"   r    r9   r9   T   s
  € € € € € ð<ð <ð| �”
ð @ØACÄñGô G€Ið QUØACØ15ðJð J %¨¨T°#¬Y¨Ô"7ð JÀð JØðJØ+.ðJØ;>ðJàðJà+.ðJà:>ðJð Jð Jð JðX	'˜ð 	'ð 	'ð 	'ð 	'ð	"�t˜C”yð 	"ð 	"ð 	"ð 	"ð	ð 	¨cð 	¸$¸s¼)ð 	ð 	ð 	ð 	ð T¨#¤Yð ð ð ð ð  S¤	ð ð ð ð ð$ð $¨ð $À4ð $Ø! # s¨D°¬IÐ"5Ô6ð$ð $ð $ð $ð4 LQØ).ðð ¨$ð ÀDð Ø"&ðØ37¸¸cÀ3ÈÈSÌ	Ð>QÔ8RÔ3Sðð ð ð ð¨5°°d¸3´i°Ô+@ð ð ð ð ðð ¸ð Ø&*¨5°°c¸4À¼9Ð1DÔ+EÔ&Fðð ð ð ð0¨¨S¬	ð ð ð ð ð¨ð ð ð ð ð  c¤ð ð ð ð ð-¨$¨s¬)ð -ð -ð -ð -ð9ð 9˜T #œYð 9¨dð 9¸tÀC¼yð 9ð 9ð 9ð 9ð	¨Cð 	°Cð 	ð 	ð 	ð 	ð D¨¤Ið °$°s´)ð ð ð ð ð0¨Sð 0¸¸c¼ð 0ÀtÈCÄyð 0ð 0ð 0ð 0ðð  Cð °°S´	ð ÀCð ÐSWÐX[ÔS\ð ð ð ð ð" MSðð ¨d°5¸¸cÀ4ÈÄ9Ð9LÔ3MÔ.Nð Ø,/ðØFIðà%)¨#¤Yðð ð ð ð" 3ð ¨sð ¸4À¼9ð ÈÈcÌð ð ð ð ð:¨ð °d¸5ÀÀcÈ4ÐPSÌ9ÐATÔ;UÔ6Vð Ø  œIðð ð ð ð&ð ¨cð ¸#ð ð ð ð ð ð ¨ð ð ð ð ð¨¨c¬ð °sð ð ð ð ð	 T¨#¤Yð 	°3ð 	ð 	ð 	ð 	ð4ð 4˜T #œYð 4¨3ð 4°t¸C´yð 4ð 4ð 4ð 4ðð  ð ¨cð ¸$ð ð ð ð ð$˜d 3œið $¨Dð $ð $ð $ð $ð" Dð ð ð ð ðH 4ð Hð Hð Hð HðSð Sð Sð Sð, -ð  -ð  -ð  -ðD:¨Cð :¸#ð :À$ÀsÄ)ð :ð :ð :ð :ð
¨D°¬Ið ð ð ð ð°ð ¸¸c¼ð ð ð ð ð4B¨sð B°t¸C´yð Bð Bð Bð Bð;°Sð ;¸TÀ#¼Yð ;ð ;ð ;ð ;ðD¸#ð DÀ$ÀsÄ)ð Dð Dð Dð Dð4¸3ð 4À4ÈÄ9ð 4ð 4ð 4ð 4ð-¨Cð -°D¸´Ið -ð -ð -ð -ð ¨cð  À4ð  ÈDÐQTÌIð  ð  ð  ð  ðG¸ð GÀÀSÄ	ð Gð Gð Gð Gð	¨cð 	°d¸3´ið 	ð 	ð 	ð 	ðG¨Cð G°D¸´Ið Gð Gð Gð GðF°sð F¸tÀC¼yð Fð Fð Fð Fð@°ð @¸¸c¼ð @ð @ð @ð @ð¨Sð °T¸#´Yð ð ð ð ð$>¨sð >°t¸C´yð >ð >ð >ð >ðL°ð L¸¸c¼ð Lð Lð Lð Lð¨cð °d¸3´ið ð ð ð ð4:¨sð :°t¸C´yð :ð :ð :ð :ðG¨Cð G°D¸´Ið Gð Gð Gð Gð8¨Sð 8°T¸#´Yð 8ð 8ð 8ð 8ð.¨cð .°e¸CÀÀc¸MÔ6Jð .ð .ð .ð .ð, sð °4ð ¸Cð ð ð ð ð $ s¤)ð °°S´	ð ð ð ð ð&¨ð °ð ð ð ð ð ð r"   r9   Útokensc                 óv   ‡‡— t          j        | ¦  «        }dŠˆfd„Šˆfd„}t           ||¦  «        ¦  «        S )N©ÚoptionalÚdefaultc              3   óX  •K  — d}d }	 	 |                       ¦   «         }n# t          $ r Y d S w xY w|dk    r|}Œ1|                     ¦   «         sŒF|‰v r.|                      |¦  «         |�|                      |¦  «         d S |�|V — d }|dk    r|dz  }n|dk    r|dz  }|V — |dk    rd S Œ£)Nr   Tú, ú{r“   ú})r&   Ú
IndexErrorr«   Ú
appendleft)r”  Úopen_bracesÚprevious_tokenÚtokenÚkeywordss       €r    Útakewhile_setz,_recombine_set_tokens.<locals>.takewhile_set~  s  øè è € ØˆØˆð	ðØŸšÑ(Ô(��øÝð ð ð Ø��ðøøøð ˜Š}ˆ}Ø!&�Øà—;’;‘=”=ð Øà˜Ð Ð Ø×!Ò! %Ñ(Ô(Ð(Ø!Ð-Ø×%Ò% nÑ5Ô5Ð5Ø�àÐ)Ø$Ð$Ð$Ð$Ø!%�à˜Š|ˆ|Ø˜qÑ ��Ø˜#’�Ø˜qÑ �àˆKˆKˆKà˜aÒÐØ�ð?	s   Š Ÿ
-¬-c              3   óÚ   •K  — 	 	 |                       ¦   «         }n# t          $ r Y d S w xY w|dk    r6|                      d¦  «         d                      ‰| ¦  «        ¦  «        V — n|V — Œh)NTr›  r:   )r&   r�  rž  r�   )r”  r¡  r£  s     €r    Úcombine_setz*_recombine_set_tokens.<locals>.combine_set¢  s–   øè è € ð
	ðØŸšÑ(Ô(��øÝð ð ð Ø��ðøøøð ˜Š|ˆ|Ø×!Ò! #Ñ&Ô&Ð&Ø—g’g˜m˜m¨FÑ3Ô3Ñ4Ô4Ð4Ð4Ð4Ð4à���ð
	s   † ›
)¨))ÚcollectionsÚdequeÚlist)r”  Útoken_queuer¥  r¢  r£  s      @@r    Ú_recombine_set_tokensrª  z  sf   øø€ ÝÔ# FÑ+Ô+€KØ&€Hð"ð "ð "ð "ð "ðHð ð ð ð õ ��˜KÑ(Ô(Ñ)Ô)Ð)r"   Úspecc                 óZ   ‡— d„ Šˆfd„t                                | ¦  «        D ¦   «         }|S )Nc                 ón   — t                                | ¦  «        r| d d…         }| dd …         }|d|gS | gS )Né   é   rð   )Ú_default_regexr©   )Úitemr˜  Úothers      r    Úpostprocessz(_tokenize_type_spec.<locals>.postprocess³  sH   € Ý×Ò Ñ%Ô%ð 	Ø˜2˜A˜2”hˆGð ˜˜˜”HˆEà˜S %Ð(Ð(à�6ˆMr"   c                 ó4   •— g | ]} ‰|¦  «        D ]}|¯|‘ŒŒS r6   r6   )rÒ   Ú	raw_tokenr±  r³  s      €r    rÓ   z'_tokenize_type_spec.<locals>.<listcomp>¾  sP   ø€ ð ð ð àØ�K 	Ñ*Ô*ðð ð Øð	Øðð ð ð r"   )Ú_token_regexrº   )r«  r”  r³  s     @r    Ú_tokenize_type_specr·  ²  sO   ø€ ð	ð 	ð 	ðð ð ð å%×+Ò+¨DÑ1Ô1ðñ ô €Fð €Mr"   r¡  Úlocationc                 ó4  — d„ }|                       d¦  «        s|                      d¦  «        rd}�næ || ¦  «        s~|                       d¦  «        r|                      d¦  «        sT|                       d¦  «        r|                      d¦  «        s*|                       d¦  «        r|                      d¦  «        rd}�nY|                       d¦  «        r.t                               t	          d	¦  «        | |¬
¦  «         d}�n|                      d¦  «        r-t                               t	          d¦  «        | |¬
¦  «         d}nÔ|                       d¦  «        s|                       d¦  «        r-t                               t	          d¦  «        | |¬
¦  «         d}n}|                      d¦  «        s|                      d¦  «        r-t                               t	          d¦  «        | |¬
¦  «         d}n&| dv rd}nt
                               | ¦  «        rd}nd}|S )Nc                 óH   — 	 t          | ¦  «         dS # t          $ r Y dS w xY wr  )ÚcomplexÚ
ValueError)r¡  s    r    Ú
is_numericz_token_type.<locals>.is_numericÈ  s=   € ð	å�E‰NŒNˆNð �4øõ ð 	ð 	ð 	Ø�5�5ð	øøøs   ‚ “
! !rð   Ú	delimiterr›  rœ  ú"ú'Úliteralz-invalid value set (missing closing brace): %s)r¸  z-invalid value set (missing opening brace): %sz4malformed string literal (missing closing quote): %sz4malformed string literal (missing opening quote): %sr–  ÚcontrolÚ	referencer@   )r  rÜ   Úloggerr_   r   r]  r©   )r¡  r¸  r½  Útype_s       r    Ú_token_typerÆ  Ç  st  € ðð ð ð ×Ò˜ÑÔð , §¢¨sÑ 3Ô 3ð ,Øˆ‰àˆJ�uÑÔð*à×Ò˜cÑ"Ô"ð*à',§~¢~°cÑ':Ô':ð*ð ×Ò˜cÑ"Ô"ð*ð (-§~¢~°cÑ':Ô':ð*ð ×Ò˜cÑ"Ô"ð	*ð (-§~¢~°cÑ':Ô':ð	*ð ˆ‰Ø	×	Ò	˜#Ñ	Ô	ð #Ý�ŠÝÐ>Ñ?Ô?ØØð 	ñ 	
ô 	
ð 	
ð
 ˆ‰Ø	�Š˜Ñ	Ô	ð Ý�ŠÝÐ>Ñ?Ô?ØØð 	ñ 	
ô 	
ð 	
ð
 ˆˆØ	×	Ò	˜#Ñ	Ô	ð  %×"2Ò"2°3Ñ"7Ô"7ð Ý�ŠÝÐEÑFÔFØØð 	ñ 	
ô 	
ð 	
ð
 ˆˆØ	�Š˜Ñ	Ô	ð  §¢¨sÑ 3Ô 3ð Ý�ŠÝÐEÑFÔFØØð 	ñ 	
ô 	
ð 	
ð
 ˆˆØ	Ð)Ð	)Ð	)ð ˆˆÝ	×	Ò	˜5Ñ	!Ô	!ð Øˆˆàˆà€Lr"   c                 óÎ   ‡‡‡‡— d„ Št          | ¦  «        }t          |¦  «        }ˆfd„|D ¦   «         }d„ ˆˆfd„d„ d„ d„ dœŠd	                     ˆfd
„|D ¦   «         ¦  «        }|S )Nc                 ó°   — |                      | | ¦  «        }|t          v r	|dk    rd}n|dk    r|dk    rd}t                               |¦  «        €||z  }|S )Nr5   ú	:obj:`%s`z...z:obj:`%s <Ellipsis>`)r!   Ú_SINGLETONSr]  r©   )r@   r3   Údefault_translationÚtranslations       r    Úconvert_objz-_convert_numpy_type_spec.<locals>.convert_obj  sx   € Ø"×&Ò& s¨CÑ0Ô0ˆð �+Ð%Ð%Ð*=ÀÒ*NÐ*NØ"-ÐÐØ˜EÒ!Ð!Ð&9¸]Ò&JÐ&Jà"8Ðå×Ò˜[Ñ)Ô)Ð1Ø-°Ñ;ˆKàÐr"   c                 ó4   •— g | ]}|t          |‰¦  «        f‘ŒS r6   )rÆ  )rÒ   r¡  r¸  s     €r    rÓ   z,_convert_numpy_type_spec.<locals>.<listcomp>  s8   ø€ ð ð ð àð 
•˜E 8Ñ,Ô,Ð-ðð ð r"   c                 ó   — d| z  S )Nz``%s``r6   ©Úxs    r    ú<lambda>z*_convert_numpy_type_spec.<locals>.<lambda>  s
   € ˜X¨™\€ r"   c                 ó   •—  ‰| ‰d¦  «        S )Nr5   r6   )rÑ  rÍ  r3   s    €€r    rÒ  z*_convert_numpy_type_spec.<locals>.<lambda>  s   ø€ ˜˜ Q¨°mÑDÔD€ r"   c                 ó   — d| z  S )Nz*%s*r6   rÐ  s    r    rÒ  z*_convert_numpy_type_spec.<locals>.<lambda>  s
   € ˜V a™Z€ r"   c                 ó   — | S r$   r6   rÐ  s    r    rÒ  z*_convert_numpy_type_spec.<locals>.<lambda>  ó   € ˜q€ r"   c                 ó   — | S r$   r6   rÐ  s    r    rÒ  z*_convert_numpy_type_spec.<locals>.<lambda>  rÖ  r"   )rÁ  r@   rÂ  r¾  rÃ  r:   c              3   óZ   •K  — | ]%\  }} ‰                      |¦  «        |¦  «        V — Œ&d S r$   )r!   )rÒ   r¡  rÅ  Ú
converterss      €r    ú	<genexpr>z+_convert_numpy_type_spec.<locals>.<genexpr>!  s>   øè è € ÐOÐO¹¸ÀÐ-˜
Ÿš uÑ-Ô-¨eÑ4Ô4ÐOÐOÐOÐOÐOÐOr"   )r·  rª  r�   )	r2   r¸  r3   r”  Úcombined_tokensÚtypesÚ	convertedrÍ  rÙ  s	    ``    @@r    Ú_convert_numpy_type_specrÞ    sº   øøøø€ ðð ð õ ! Ñ'Ô'€FÝ+¨FÑ3Ô3€Oðð ð ð à$ðñ ô €Eð *Ð)ØDÐDÐDÐDÐDØ'Ð'Ø �[Ø �[ðð €Jð —’ÐOÐOÐOÐOÈÐOÑOÔOÑOÔO€IàÐr"   c                   ó`  ‡ — e Zd ZdZ	 	 	 ddeeee         f         dedededed	e	d
e	ddfˆ fd„Z
defd„Zdedefˆ fd„Zddededeeeee         f         fd„Zddedeeeeee         f                  fd„Zdefd„Zdefd„Zdefd„Zdedee         fd„Zdee         dee         fd„Zˆ xZS ) ÚNumpyDocstringaÑ
  Convert NumPy style docstrings to reStructuredText.

    Parameters
    ----------
    docstring : :obj:`str` or :obj:`list` of :obj:`str`
        The docstring to parse, given either as a string or split into
        individual lines.
    config: :obj:`sphinx.ext.napoleon.Config` or :obj:`sphinx.config.Config`
        The configuration settings to use. If not given, defaults to the
        config object on `app`; or if `app` is not given defaults to the
        a new :class:`sphinx.ext.napoleon.Config` object.


    Other Parameters
    ----------------
    app : :class:`sphinx.application.Sphinx`, optional
        Application object representing the Sphinx process.
    what : :obj:`str`, optional
        A string specifying the type of the object to which the docstring
        belongs. Valid values: "module", "class", "exception", "function",
        "method", "attribute".
    name : :obj:`str`, optional
        The fully qualified name of the object.
    obj : module, class, exception, function, method, or attribute
        The object to which the docstring belongs.
    options : :class:`sphinx.ext.autodoc.Options`, optional
        The options given to the directive: an object with attributes
        inherited_members, undoc_members, show_inheritance and noindex that
        are True if the flag option of same name was given to the auto
        directive.


    Example
    -------
    >>> from sphinx.ext.napoleon import Config
    >>> config = Config(napoleon_use_param=True, napoleon_use_rtype=True)
    >>> docstring = '''One line summary.
    ...
    ... Extended description.
    ...
    ... Parameters
    ... ----------
    ... arg1 : int
    ...     Description of `arg1`
    ... arg2 : str
    ...     Description of `arg2`
    ... Returns
    ... -------
    ... str
    ...     Description of return value.
    ... '''
    >>> print(NumpyDocstring(docstring, config))
    One line summary.
    <BLANKLINE>
    Extended description.
    <BLANKLINE>
    :param arg1: Description of `arg1`
    :type arg1: int
    :param arg2: Description of `arg2`
    :type arg2: str
    <BLANKLINE>
    :returns: Description of return value.
    :rtype: str
    <BLANKLINE>

    Methods
    -------
    __str__()
        Return the parsed docstring in reStructuredText format.

        Returns
        -------
        str
            UTF-8 encoded version of the docstring.

    __unicode__()
        Return the parsed docstring in reStructuredText format.

        Returns
        -------
        unicode
            Unicode version of the docstring.

    lines()
        Return the parsed lines of the docstring in reStructuredText format.

        Returns
        -------
        list(str)
            The lines of the docstring in a list.

    Nr:   r;   r<   r=   r>   r?   r@   rA   r   c           	      óf   •— dg| _         t          ¦   «                              |||||||¦  «         d S )Nz
.. index::)rF   r%   rŒ   )	r   r;   r<   r=   r>   r?   r@   rA   r(   s	           €r    rŒ   zNumpyDocstring.__init__ƒ  s9   ø€ ð %1 >ˆÔ Ý‰Œ×Ò˜ F¨C°°t¸SÀ'ÑJÔJÐJÐJÐJr"   c                 óÄ   — 	 | j         �t          j        | j         ¦  «        nd }n# t          $ r d }Y nw xY w| j        }|€|€d S |€d}d                     |d|z  g¦  «        S )Nr:   rÇ   zdocstring of %s)rn   rh   ÚgetfileÚ	TypeErrorrm   r�   )r   Úfilepathr?   s      r    Ú_get_locationzNumpyDocstring._get_location‰  s‰   € ð	Ø59´YÐ5J•w” t¤yÑ1Ô1Ð1ÐPTˆHˆHøÝð 	ð 	ð 	ØˆHˆHˆHð	øøøàŒzˆàÐ  Ø�4ØÐØˆHà�xŠx˜Ð#4°tÑ#;Ð<Ñ=Ô=Ð=s   ‚"% ¥4³4c                 ó²   •‡— t          ¦   «         j        Šd|v r4d                     ˆfd„|                     d¦  «        D ¦   «         ¦  «        S  ‰|¦  «        S )Nrš  c              3   ó.   •K  — | ]} ‰|¦  «        V — Œd S r$   r6   )rÒ   rõ   Úfuncs     €r    rÚ  z9NumpyDocstring._escape_args_and_kwargs.<locals>.<genexpr>›  s+   øè è € ÐGÐG¨U˜T˜T %™[œ[ÐGÐGÐGÐGÐGÐGr"   )r%   r¬   r�   rº   )r   r?   ré  r(   s     @€r    r¬   z&NumpyDocstring._escape_args_and_kwargs—  sZ   øø€ Ý‰wŒwÔ.ˆà�4ˆ<ˆ<Ø—9’9ÐGÐGÐGÐG°d·j²jÀÑ6FÔ6FÐGÑGÔGÑGÔGÐGà�4˜‘:”:Ðr"   TFr£   r¤   c                 óŒ  — | j                              ¦   «         }|r|                      |¦  «        \  }}}n|d}}|                     ¦   «         |                     ¦   «         }}|                      |¦  «        }|r|s|                      |¦  «        }|r|s||}}| j        j        r0t          ||  	                    ¦   «         | j        j
        pi ¬¦  «        }|                      |¦  «        dz   }|                      |                      |¦  «        ¦  «        }|                      || j        ¦  «                             ¦   «         }|||fS )Nr:   )r¸  r3   r“   )ru   r)   r§   r«   r¬   r7  re   r­   rÞ  ræ  r®   r¯   r°   r›   r(   r‹   )	r   r£   r¤   rš   rm   r   r2   r”   r´   s	            r    r¶   zNumpyDocstring._consume_fieldŸ  sN  € àŒ{×ÒÑ!Ô!ˆØð 	$Ø"×<Ò<¸TÑBÔB‰OˆE�1�e�eà �5ˆEØ—{’{‘}”} e§k¢k¡m¤mˆuˆØ×,Ò,¨UÑ3Ô3ˆàð 	3˜eð 	3Ø×+Ò+¨EÑ2Ô2ˆEàð 	(˜uð 	(Ø  %�5ˆEàŒ<Ô1ð 	Ý,ØØ×+Ò+Ñ-Ô-Ø!œ\Ô?ÐEÀ2ðñ ô ˆEð ×!Ò! $Ñ'Ô'¨!Ñ+ˆØ—’˜T×9Ò9¸&ÑAÔAÑBÔBˆØ—’˜u d¤lÑ3Ô3×9Ò9Ñ;Ô;ˆØ�e˜UÐ"Ð"r"   rÀ   c                 ó.   — |                       d¬¦  «        S )NT)r¤   )r¼   )r   rÀ   s     r    rÃ   z'NumpyDocstring._consume_returns_section»  s   € à×#Ò#°Ð#Ñ5Ô5Ð5r"   c                 óž   — | j                              ¦   «         }t                               |¦  «        s| j                              ¦   «          |S r$   )ru   r)   r  r©   rB  s     r    rË   z&NumpyDocstring._consume_section_header¿  sD   € Ø”+×"Ò"Ñ$Ô$ˆÝ×%Ò% gÑ.Ô.ð 	àŒK×ÒÑÔÐØˆr"   c                 ó   — | j                              d¦  «        | j                              d¦  «        }}| j          pB|                      ¦   «         p.ddg||gk    p$| j        o|o|                      || j        ¦  «         S )Nr   r“   r:   r"  )r   Úline1Úline2s      r    r—   z NumpyDocstring._is_section_breakÆ  s•   € Ø”{—’ qÑ)Ô)¨4¬;¯?ª?¸1Ñ+=Ô+=ˆuˆØ”K�ð HØ×'Ò'Ñ)Ô)ðHà�R�˜U E˜NÒ*ðHð Ô$ð GØðGà×)Ò)¨%°Ô1EÑFÔFÐFð	Ir"   c                 ó¦  — | j                              d¦  «        | j                              d¦  «        }}|                     ¦   «         }|| j        v r<t	          |t
          ¦  «        r't          t                               |¦  «        ¦  «        S | j	        r<t                               |¦  «        r"| j	        D ]}|                     |¦  «        r dS ŒdS )Nr   r“   TF)ru   r!   rÈ   rG   rp   rq   r“  Ú_numpy_section_regexr©   rF   r  r  )r   rÉ   Ú	underliner   s       r    r�   z!NumpyDocstring._is_section_headerÏ  sÉ   € Ø!œ[Ÿ_š_¨QÑ/Ô/°´·²ÀÑ1CÔ1C�ˆØ—-’-‘/”/ˆØ�d”nÐ$Ð$­°I½sÑ)CÔ)CÐ$ÝÕ,×2Ò2°9Ñ=Ô=Ñ>Ô>Ð>ØÔ%ð 	$Ý×%Ò% gÑ.Ô.ð $Ø)-Ô)Að $ð $Ð%Ø×)Ò)Ð*;Ñ<Ô<ð $Ø#˜t˜tð$àˆur"   rÉ   c                 ó¢   — |                       ¦   «         }	 |                      |¦  «        S # t          $ r |                      d|¦  «        cY S w xY wrj  )rÂ   Ú _parse_numpydoc_see_also_sectionr¼  rì   )r   rÉ   r‹   s      r    r†   z&NumpyDocstring._parse_see_also_sectionÛ  sc   € Ø×-Ò-Ñ/Ô/ˆð	=Ø×8Ò8¸Ñ?Ô?Ð?øÝð 	=ð 	=ð 	=Ø×*Ò*¨9°eÑ<Ô<Ð<Ð<Ð<ð	=øøøs   –+ « AÁAÚcontentc                 ó@  ‡ ‡‡‡— g Šdt           dt          t           t           f         fˆ fd„Šdt           dt          t                    ddfˆˆfd„}ˆ fd„Šd}g }|D �]•}|                     ¦   «         sŒ‰ j                             |¦  «        }|r¿||                     ¦   «         d…                              ¦   «                              d	¦  «        r~ |||¦  «         |d|                     ¦   «         …         ||                     ¦   «         d…         }}|                     d	d
¦  «        d
                              ¦   «         g}|d         sg }Œó|                     d¦  «        sd |||¦  «         d}d|v r:|                     d¦  «        D ]"}|                     ¦   «         r ||g ¦  «         Œ#�ŒT|                     ¦   «         r|}�Œl|�'| 	                    |                     ¦   «         ¦  «         �Œ— |||¦  «         ‰sg S ˆfd„‰D ¦   «         Šg }d}	‰D ]n\  }
}}|r
d	|›d|
›d�}nd|
z  }|s|	r|dgz  }||gz  }n|dxx         d|z  z  cc<   |r/|‰  
                    d                     |¦  «        g¦  «        z  }d}	Œld}	Œo|dgz  }‰                      d|¦  «        S )a  
        Derived from the NumpyDoc implementation of _parse_see_also.

        See Also
        --------
        func_name : Descriptive text
            continued text
        another_func_name : Descriptive text
        func_name1, func_name2, :meth:`func_name`, func_name3

        Útextr   c                 óÌ   •— ‰j                              | ¦  «        }|r6|                     ¦   «         }|d         €
|d         dfS |d         |d         fS t          d| z  ¦  «        ‚)zMatch ':role:`name`' or 'name'r“   Nrê   r¦   z%s is not a item name)r\  r©   Úgroupsr¼  )r÷  r_  Úgr   s      €r    Úparse_item_namezHNumpyDocstring._parse_numpydoc_see_also_section.<locals>.parse_item_nameð  sj   ø€ à”×$Ò$ TÑ*Ô*ˆAØð &Ø—H’H‘J”J�Ø�Q”4�<Ø˜Qœ4 ˜:Ð%à˜Qœ4  1¤˜:Ð%ÝÐ4°tÑ;Ñ<Ô<Ð<r"   r?   ÚrestNc                 ó€   •— | sd S  ‰| ¦  «        \  } }‰                      | t          |¦  «        |f¦  «         |d d …= d S r$   )r™   r¨  )r?   rü  ÚroleÚitemsrû  s      €€r    Ú	push_itemzBNumpyDocstring._parse_numpydoc_see_also_section.<locals>.push_itemû  sQ   ø€ Øð Ø�Ø(˜¨Ñ.Ô.‰JˆD�$Ø�LŠL˜$¥ T¡
¤
¨DÐ1Ñ2Ô2Ð2Ø�Q�Q�Q���r"   c                 óþ   •— ‰j         j        }|€|s| ||fS |                     | | ¦  «        }‰j                             |¦  «        }|s|||fS |                     ¦   «         }|d         }|d         p|d         }|||fS )Nrþ  r?   Úname2)re   r®   r!   r\  r©   Ú	groupdict)	ré  Údescriptionrþ  r3   Ú
translatedr©   rù  Únew_funcr   s	           €r    Ú	translatezBNumpyDocstring._parse_numpydoc_see_also_section.<locals>.translate  s›   ø€ Øœ<Ô=ˆLØÐ |ÐØ˜[¨$Ð.Ð.à%×)Ò)¨$°Ñ5Ô5ˆJØ”N×(Ò(¨Ñ4Ô4ˆEØð 5Ø! ;°Ð4Ð4à—_’_Ñ&Ô&ˆFØ˜&”>ˆDØ˜f”~Ð8¨°¬ˆHà˜[¨$Ð.Ð.r"   rÇ   r“   r   rð   r¹   c                 ó2   •— g | ]\  }}} ‰|||¦  «        ‘ŒS r6   r6   )rÒ   ré  r  rþ  r  s       €r    rÓ   zCNumpyDocstring._parse_numpydoc_see_also_section.<locals>.<listcomp>1  s=   ø€ ð 
ð 
ð 
á'��k 4ð ˆI�d˜K¨Ñ.Ô.ð
ð 
ð 
r"   Tz:`r   rÉ  r:   rÙ   z, %sFrk  )rq   r   r   r«   r\  r©   ru  r  rº   r™   rä   r�   rì   )r   rõ  r   Úcurrent_funcrü  rš   r_  ré  r‹   Úlast_had_descr?   rÞ   rþ  Úlinkrÿ  rû  r  s   `             @@@r    rô  z/NumpyDocstring._parse_numpydoc_see_also_sectionâ  sc  øøøø€ ð ˆð		=¥#ð 		=­%µµS°¬/ð 		=ð 		=ð 		=ð 		=ð 		=ð 		=ð	�Cð 	¥t­C¤yð 	°Tð 	ð 	ð 	ð 	ð 	ð 	ð 	ð	/ð 	/ð 	/ð 	/ð 	/ð  ˆØˆàð 	*ñ 	*ˆDØ—:’:‘<”<ð Øà”×$Ò$ TÑ*Ô*ˆAØð *�T˜!Ÿ%š%™'œ'˜(˜(”^×)Ò)Ñ+Ô+×6Ò6°sÑ;Ô;ð *Ø�	˜,¨Ñ-Ô-Ð-Ø%)¨(¨1¯5ª5©7¬7¨(¤^°T¸!¿%º%¹'¼'¸(¸(´^˜d�ØŸ
š
 3¨Ñ*Ô*¨1Ô-×3Ò3Ñ5Ô5Ð6�Ø˜A”wð Ø�DøØ—_’_ SÑ)Ô)ð 
*Ø�	˜,¨Ñ-Ô-Ð-Ø#�Ø˜$�;�;Ø $§
¢
¨3¡¤ð 0ð 0˜ØŸ:š:™<œ<ð 0Ø%˜I d¨BÑ/Ô/Ð/øñ0ð —Z’Z‘\”\ð (Ø#'�LùØÐ)Ø—’˜DŸJšJ™LœLÑ)Ô)Ð)ùØˆ	�, Ñ%Ô%Ð%àð 	ØˆIð
ð 
ð 
ð 
à+0ð
ñ 
ô 
ˆð
 ˆØˆØ %ð 	&ð 	&ÑˆD�$˜Øð *ð *Ø%) T T¨4¨4¨4Ð0��à" TÑ)�Øð +�}ð +Ø˜"˜‘�Ø˜$˜‘��à�b�	�	”	˜V d™]Ñ*�	�	‘	Øð &Ø˜Ÿš s§x¢x°¡~¤~Ð&6Ñ7Ô7Ñ7�Ø $��à %��Ø�"�‰ˆà×&Ò& y°%Ñ8Ô8Ð8r"   rŒ  r�  rŽ  )r*   r+   r,   r-   r
   rq   r   r’  r   r   rŒ   ræ  r¬   r“  r   r¶   rÃ   rË   r—   r�   r†   rô  r0   r1   s   @r    rà  rà  &  s)  ø€ € € € € ð[ð [ðx QUØACØ15ðKð K %¨¨T°#¬Y¨Ô"7ð KÀð KØðKØ+.ðKØ;>ðKàðKà+.ðKà:>ðKð Kð Kð Kð Kð Kð>˜sð >ð >ð >ð >ð¨Cð °Cð ð ð ð ð ð ð#ð #¨ð #À4ð #Ø! # s¨D°¬IÐ"5Ô6ð#ð #ð #ð #ð86ð 6¸ð 6Ø&*¨5°°c¸4À¼9Ð1DÔ+EÔ&Fð6ð 6ð 6ð 6ð¨ð ð ð ð ðI 4ð Ið Ið Ið Ið
 Dð 
ð 
ð 
ð 
ð=¨sð =°t¸C´yð =ð =ð =ð =ðg9¸¸S¼	ð g9ÀdÈ3Äið g9ð g9ð g9ð g9ð g9ð g9ð g9ð g9r"   rà  r$   ):r-   r¦  rh   r�  r`   Ú	functoolsr   Útypingr   r   r   r   r   r	   r
   Úsphinx.applicationr   Úsphinx.configr   r’  Úsphinx.deprecationr   Úsphinx.localer   r   Úsphinx.utilr   Úsphinx.util.inspectr   Úsphinx.util.typingr   Ú	getLoggerr*   rÄ  r�  r  r  r¨   rñ  rr  rq  r]  r  r  r¶  r°  rÊ  r§  r   rq   r7   r9   rª  r·  rÆ  ÚdictrÞ  rà  r6   r"   r    ú<module>r     s�  ðØ 3Ð 3à Ð Ð Ð Ø €€€Ø 	€	€	€	Ø €€€Ø Ð Ð Ð Ð Ð Ø @Ð @Ð @Ð @Ð @Ð @Ð @Ð @Ð @Ð @Ð @Ð @Ð @Ð @Ð @Ð @Ð @Ð @à %Ð %Ð %Ð %Ð %Ð %Ø 0Ð 0Ð 0Ð 0Ð 0Ð 0Ø 7Ð 7Ð 7Ð 7Ð 7Ð 7Ø Ð Ð Ð Ð Ð Ð Ð Ø Ð Ð Ð Ð Ð Ø 4Ð 4Ð 4Ð 4Ð 4Ð 4Ø -Ð -Ð -Ð -Ð -Ð -à	ˆÔ	˜8Ñ	$Ô	$€à�2”:˜mÑ,Ô,Ð Ø"˜œ
Ð#4Ñ5Ô5Ð Ø$˜"œ*Ð%AÑBÔBÐ Ø!�r”zÐ"@ÑAÔAÐ Ø �b”j Ñ1Ô1Ð Ø �b”jðñô Ð ð ˆbŒjØ<ñô €ð  �R”ZÐ :Ñ;Ô;Ð Ø#˜œð#ñ$ô $Ð ð ˆrŒzðñô €ð �”Øñô €ð 4€ð ð  ð  ð  ð  ˆKÔñ  ô  ð  ð. CEð 
ð 
˜cð 
°°c¸3°h´ð 
Èð 
ð 
ð 
ð 
ðcð cð cð cð cñ cô cð cðL5* $ s¤)ð 5*°°S´	ð 5*ð 5*ð 5*ð 5*ðp˜cð  d¨3¤ið ð ð ð ð*8ð 8�sð 8 cð 8°Sð 8ð 8ð 8ð 8ðv :>ÐTVð !ð ! Cð !°3ð !ÈTð !Ð[^ð !ð !ð !ð !ðHc9ð c9ð c9ð c9ð c9�_ñ c9ô c9ð c9ð c9ð c9r"   