§
    _÷#dÀ?  ã                   óH  — d Z ddlmZ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 ddlmZ ddlmZ dd	lmZ dd
lmZ erddlmZ  ej        e¦  «        Zdej        de fd„Z! G d„ d¦  «        Z" G d„ de"¦  «        Z# G d„ de#¦  «        Z$ G d„ d¦  «        Z%dS )z¨Utility code for "Doc fields".

"Doc fields" are reST field lists in object descriptions that will
be domain-specifically transformed to a more appealing presentation.
é    )ÚTYPE_CHECKINGÚAnyÚDictÚListÚTupleÚTypeÚUnionÚcast)Únodes)ÚNode)ÚInliner)Úaddnodes)ÚBuildEnvironment)Ú__)Úlogging)ÚTextlikeNode)ÚObjectDescriptionÚnodeÚreturnc                 óî   — t          | ¦  «        dk    rdS t          | ¦  «        dk    r*| dd…         D ]}t          |t          j        ¦  «        s dS Œ t          | d         t          j        ¦  «        rdS dS )zCTrue if the node only contains one paragraph (and system messages).r   Fé   NT)ÚlenÚ
isinstancer   Úsystem_messageÚ	paragraph)r   Úsubnodes     ú7/usr/lib/python3/dist-packages/sphinx/util/docfields.pyÚ_is_single_paragraphr      s   € å
ˆ4�y„y�A‚~€~ØˆuÝ	ˆT‰Œ�QŠˆØ˜A˜B˜B”xð 	ð 	ˆGÝ˜g¥uÔ';Ñ<Ô<ð Ø�u�uðå�$�q”'�5œ?Ñ+Ô+ð ØˆtØˆ5ó    c                   óˆ  — e Zd ZdZdZdZ	 	 ddedeedf         d	ed
edededdfd„Z	e
j        ddddfdedededee         dededededefd„Ze
j        ddddfdedededee         dededededee         fd„Zdedee         deeee         f         fd„Z	 	 ddeeee         f         dedededededej        fd„ZdS ) ÚFielda¼  A doc field that is never grouped.  It can have an argument or not, the
    argument can be linked using a specified *rolename*.  Field should be used
    for doc fields that usually don't occur more than once.

    The body can be linked using a specified *bodyrolename* if the content is
    just a single inline or text node.

    Example::

       :returns: description of the return value
       :rtype: description of the return type
    F© NTÚnameÚnames.ÚlabelÚhas_argÚrolenameÚbodyrolenamer   c                 óZ   — || _         || _        || _        || _        || _        || _        d S ©N)r#   r$   r%   r&   r'   r(   )Úselfr#   r$   r%   r&   r'   r(   s          r   Ú__init__zField.__init__5   s3   € àˆŒ	ØˆŒ
ØˆŒ
ØˆŒØ ˆŒØ(ˆÔÐÐr   ÚdomainÚtargetÚ	innernodeÚcontnodeÚenvÚinlinerÚlocationc	           	      óT  — |€J ‚|d u |d u k    sJ ||f¦   «         ‚|s|p |||¦  «        S |                      |¦  «                             |¦  «        }	|	�|€’|	€<|�:t          d¦  «        }
t                               t          |
¦  «        |||¬¦  «         t          j        d|d||¬¦  «        }||p |||¦  «        z  }|                      |¦  «                             |¦  «         |S t          j	        |¦  «        d         } |	|||||i g ¦  «        \  }}t          j        |dg|¢R Ž S )Nz]Problem in %s domain: field is supposed to use role '%s', but that role is not in the domain.)r3   Ú F)Ú	refdomainÚrefexplicitÚreftypeÚ	reftargetr   )Ú
get_domainÚroler   ÚloggerÚwarningr   Úpending_xrefÚprocess_field_xrefr   Úget_source_liner   Úinline)r+   r'   r-   r.   r/   r0   r1   r2   r3   r;   ÚmsgÚrefnodeÚlinenoÚnsÚmessagess                  r   Ú	make_xrefzField.make_xref>   sq  € ð
 ˆˆˆØ˜4� X°Ð%5Ò6Ð6Ð6¸À(Ð8KÑ6Ô6Ð6Øð 	9ØÐ8˜y˜y¨°Ñ8Ô8Ð8ð �~Š~˜fÑ%Ô%×*Ò*¨8Ñ4Ô4ˆØˆ<˜7˜?Øˆ| Ð 3Ýð Qñ Rô R�å—’�r #™wœw¨°À8�ÑLÔLÐLÝÔ+¨B¸&ÈeØ4<ÈðPñ Pô PˆGà�xÐ< 9 9¨V°VÑ#<Ô#<Ñ<ˆGØ�NŠN˜6Ñ"Ô"×5Ò5°gÑ>Ô>Ð>ØˆNÝÔ(¨Ñ2Ô2°1Ô5ˆØ�t˜H f¨f°f¸gÀrÈ2ÑNÔN‰ˆˆHÝŒ|˜F BÐ,¨Ð,Ð,Ð,Ð,r   c	           
      ó<   — |                       ||||||||¦  «        gS r*   )rG   )	r+   r'   r-   r.   r/   r0   r1   r2   r3   s	            r   Ú
make_xrefszField.make_xrefsX   s0   € ð —’˜x¨°¸ÀHØ" G¨Xñ7ô 7ð 8ð 	8r   ÚfieldargÚcontentc                 ó
   — ||fS r*   r"   )r+   rJ   rK   s      r   Ú
make_entryzField.make_entry_   s   € Ø˜'Ð"Ð"r   ÚtypesÚitemc                 ó  — |\  }}t          j        d| j        ¦  «        }	|rU|	t          j        d¦  «        z  }	|	                     |                      | j        ||t           j        |||¬¦  «        ¦  «         t          |¦  «        dk    r¾t          |d         t           j        ¦  «        s_t          |d         t           j	        ¦  «        r~t          |d         ¦  «        dk    ret          |d         d         t           j        ¦  «        r?|                      | j
        ||d                              ¦   «         |d         |||¬¦  «        }t          j        dt          j        ddg|¢R Ž ¦  «        }
t          j        d|	|
¦  «        S )Nr5   ú ©r1   r2   r3   r   r   )r0   r1   r2   r3   )r   Ú
field_namer%   ÚTextÚextendrI   r'   r   r   rA   r(   ÚastextÚ
field_bodyr   Úfield)r+   rN   r-   rO   r1   r2   r3   rJ   rK   Ú	fieldnameÚ	fieldbodys              r   Ú
make_fieldzField.make_fieldb   sv  € ð !Ñˆ�'ÝÔ$ R¨¬Ñ4Ô4ˆ	Øð 	[Ø�œ C™œÑ(ˆIØ×Ò˜TŸ_š_¨T¬]¸FØ-5µu´zØ14¸gÐPXð -ñ Zô Zñ [ô [ð [õ ˆw‰<Œ<˜1ÒÐÝ˜7 1œ:¥u¤zÑ2Ô2ð å˜G AœJ­¬Ñ5Ô5ð å:=¸gÀa¼j¹/¼/ÈQÒ:NÐ:NÝ˜G AœJ qœM­5¬:Ñ6Ô6ð ;Oà—o’o dÔ&7¸Ø&-¨a¤j×&7Ò&7Ñ&9Ô&9ÀGÈAÄJØ*-°wÈð &ñ Sô SˆGõ Ô$ R­¬¸¸RÐ)JÀ'Ð)JÐ)JÐ)JÑKÔKˆ	ÝŒ{˜2˜y¨)Ñ4Ô4Ð4r   )r"   NTNN©NNN)Ú__name__Ú
__module__Ú__qualname__Ú__doc__Ú
is_groupedÚis_typedÚstrr   Úboolr,   r   Úliteral_emphasisr   r   r   r   r   rG   r   rI   rM   r   r   rX   r[   r"   r   r   r!   r!   %   s%  € € € € € ðð ð €JØ€HàLPØQUð)ð )˜Sð )¨¨s°C¨x¬ð )Àcð )Øð)Ø14ð)ØKNð)ØZ^ð)ð )ð )ð )ð 3;Ô2KØ#'ÀØ%)¸Dð-ð - #ð -¨sð -¸Cð -Ø! ,Ô/ð-à ð-à.>ð-ð #ð-ð 6:ð-ð FJð-ð -ð -ð -ð6 4<Ô3LØ$(À$Ø&*¸Tð8ð 8 3ð 8°ð 8¸Sð 8Ø" <Ô0ð8à!ð8à/?ð8ð $ð8ð 7;ð8ð GKÈ4Äjð8ð 8ð 8ð 8ð# 3ð #°°d´ð #ÀÀcÈ4ÐPTÌ:ÀoÔ@Vð #ð #ð #ð #ð 9=Ø=Að5ð 5  S¨$¨t¬* _Ô 5ð 5¸sð 5Øð5Ø%5ð5à#ð5à6:ð5àFKÄkð5ð 5ð 5ð 5ð 5ð 5r   r!   c                   ó´   ‡ — e Zd ZdZdZej        Z	 	 ddede	edf         d	ed
ede
ddfˆ fd„Z	 	 ddeeee         f         dede	dedededej        fd„Zˆ xZS )ÚGroupedFielda×  
    A doc field that is grouped; i.e., all fields of that type will be
    transformed into one field with its body being a bulleted list.  It always
    has an argument.  The argument can be linked using the given *rolename*.
    GroupedField should be used for doc fields that can occur more than once.
    If *can_collapse* is true, this field will revert to a Field if only used
    once.

    Example::

       :raises ErrorClass: description when it is raised
    Tr"   NFr#   r$   .r%   r'   Úcan_collapser   c                 ó`   •— t          ¦   «                              |||d|¦  «         || _        d S )NT)Úsuperr,   rh   )r+   r#   r$   r%   r'   rh   Ú	__class__s         €r   r,   zGroupedField.__init__ˆ   s1   ø€ å‰Œ×Ò˜˜u e¨T°8Ñ<Ô<Ð<Ø(ˆÔÐÐr   rN   r-   Úitemsr1   r2   r3   c                 ó¤  — t          j        d| j        ¦  «        }|                      ¦   «         }|D ]Š\  }	}
t          j        ¦   «         }|                     |                      | j        ||	t          j	        |||¬¦  «        ¦  «         |t          j
        d¦  «        z  }||
z  }|t          j        d|¦  «        z  }Œ‹t          |¦  «        dk    rX| j        rQt          t           j        |d         ¦  «        }t          j        d|d         ¦  «        }t          j        d||¦  «        S t          j        d|¦  «        }t          j        d||¦  «        S )Nr5   rR   ú -- r   r   )r   rS   r%   Ú	list_typer   rU   rI   r'   r   Úliteral_strongrT   Ú	list_itemr   rh   r
   rW   rX   )r+   rN   r-   rl   r1   r2   r3   rY   ÚlistnoderJ   rK   Úparrq   rZ   s                 r   r[   zGroupedField.make_field�   s?  € õ Ô$ R¨¬Ñ4Ô4ˆ	Ø—>’>Ñ#Ô#ˆØ!&ð 	1ð 	1ÑˆH�gÝ”/Ñ#Ô#ˆCØ�JŠJ�t—’ t¤}°f¸hÝ'/Ô'>Ø+.¸È(ð 'ñ Tô Tñ Uô Uð Uð •5”:˜fÑ%Ô%Ñ%ˆCØ�7‰NˆCØ�œ¨¨CÑ0Ô0Ñ0ˆHˆHåˆu‰:Œ:˜Š?ˆ?˜tÔ0ˆ?Ý�Uœ_¨h°q¬kÑ:Ô:ˆIÝÔ(¨¨Y°q¬\Ñ:Ô:ˆIÝ”;˜r 9¨iÑ8Ô8Ð8åÔ$ R¨Ñ2Ô2ˆ	ÝŒ{˜2˜y¨)Ñ4Ô4Ð4r   )r"   NNFr\   )r]   r^   r_   r`   ra   r   Úbullet_listro   rc   r   rd   r,   r   r   r   r   r   rX   r[   Ú__classcell__©rk   s   @r   rg   rg   x   sü   ø€ € € € € ðð ð €JØÔ!€IàLPØ<Að)ð )˜Sð )¨¨s°C¨x¬ð )Àcð )Øð)Ø59ð)ØFJð)ð )ð )ð )ð )ð )ð :>Ø=Að5ð 5  S¨$¨t¬* _Ô 5ð 5¸sð 5Øð5Ø&6ð5à#ð5à6:ð5àFKÄkð5ð 5ð 5ð 5ð 5ð 5ð 5ð 5r   rg   c                   óÀ   ‡ — e Zd ZdZdZ	 	 	 ddedeedf         d	eedf         d
ededededdfˆ fd„Z	 	 dde	ee
e         f         dedededededej        fd„Zˆ xZS )Ú
TypedFieldaa  
    A doc field that is grouped and has type information for the arguments.  It
    always has an argument.  The argument can be linked using the given
    *rolename*, the type using the given *typerolename*.

    Two uses are possible: either parameter and type description are given
    separately, using a field from *names* and one from *typenames*,
    respectively, or both are given using a field from *names*, see the example.

    Example::

       :param foo: description of parameter foo
       :type foo:  SomeClass

       -- or --

       :param SomeClass foo: description of parameter foo
    Tr"   NFr#   r$   .Ú	typenamesr%   r'   Útyperolenamerh   r   c                 ón   •— t          ¦   «                              |||||¦  «         || _        || _        d S r*   )rj   r,   ry   rz   )	r+   r#   r$   ry   r%   r'   rz   rh   rk   s	           €r   r,   zTypedField.__init__¹   s:   ø€ õ 	‰Œ×Ò˜˜u e¨X°|ÑDÔDÐDØ"ˆŒØ(ˆÔÐÐr   rN   r-   rl   r1   r2   r3   c           	      óÂ  ‡ ‡‡‡‡‡— dt           dt           dt          j        fˆˆˆˆˆ ˆfd„}t          j        d‰ j        ¦  «        }t          |¦  «        dk    r‰ j        r|d         \  }	}
 ||	|
¦  «        }n>‰                      ¦   «         }|D ]'\  }	}
|t          j        d ||	|
¦  «        ¦  «        z  }Œ(t          j	        d|¦  «        }t          j
        d||¦  «        S )NrJ   rK   r   c                 óŽ  •— t          j        ¦   «         }|                     ‰	                     ‰	j        ‰| t
          j        ‰¬¦  «        ¦  «         | ‰
v rÔ|t          j        d¦  «        z  }‰
                     | ¦  «        }t          |¦  «        dk    ryt          |d         t           j        ¦  «        rY|d                              ¦   «         }|                     ‰	                     ‰	j        ‰|t
          j        ‰‰‰¬¦  «        ¦  «         n||z  }|t          j        d¦  «        z  }|t          j        d¦  «        z  }||z  }|S )N)r1   z (r   r   rR   ú)rn   )r   r   rU   rI   r'   r   rp   rT   Úpopr   r   rV   rz   re   )rJ   rK   rs   Ú	fieldtypeÚtypenamer-   r1   r2   r3   r+   rN   s        €€€€€€r   Úhandle_itemz*TypedField.make_field.<locals>.handle_itemÃ   sI  ø€ Ý”/Ñ#Ô#ˆCØ�JŠJ�t—’ t¤}°f¸hÝ'/Ô'>ÀCð 'ñ Iô Iñ Jô Jð Jà˜5Ð Ð Ø•u”z $Ñ'Ô'Ñ'�ð "ŸIšI hÑ/Ô/�	Ý�y‘>”> QÒ&Ð&­:°iÀ´lÅEÄJÑ+OÔ+OÐ&Ø(¨œ|×2Ò2Ñ4Ô4�HØ—J’J˜tŸš¨tÔ/@À&È(Ý/7Ô/HÈcØ7>Èð  /ñ  Sô  Sñ Tô Tð Tð Tð ˜9Ñ$�CØ•u”z #‘”Ñ&�Ø•5”:˜fÑ%Ô%Ñ%ˆCØ�7‰NˆCØˆJr   r5   r   r   )rc   r   r   rS   r%   r   rh   ro   rq   rW   rX   )r+   rN   r-   rl   r1   r2   r3   r‚   rY   rJ   rK   ÚbodynoderZ   s   ``` ```      r   r[   zTypedField.make_fieldÀ   s  øøøøøø€ ð	¥#ð 	µð 	½¼ð 	ð 	ð 	ð 	ð 	ð 	ð 	ð 	ð 	ð 	ð 	õ, Ô$ R¨¬Ñ4Ô4ˆ	Ýˆu‰:Œ:˜Š?ˆ?˜tÔ0ˆ?Ø % a¤ÑˆH�gØ(˜[¨°7Ñ;Ô;ˆHˆHà—~’~Ñ'Ô'ˆHØ%*ð Pð PÑ!�˜'Ø�EœO¨B°°¸HÀgÑ0NÔ0NÑOÔOÑO��ÝÔ$ R¨Ñ2Ô2ˆ	ÝŒ{˜2˜y¨)Ñ4Ô4Ð4r   )r"   r"   NNNFr\   )r]   r^   r_   r`   rb   rc   r   rd   r,   r   r   r   r   r   r   rX   r[   ru   rv   s   @r   rx   rx   ¤   s  ø€ € € € € ðð ð$ €Hà\^ØNRØ&+ð)ð )˜Sð )¨¨s°C¨x¬ð )È%ÐPSÐUXÐPXÌ/ð )Øð)Ø.1ð)ØHKð)à#ð)à04ð)ð )ð )ð )ð )ð )ð :>Ø=Að"5ð "5  S¨$¨t¬* _Ô 5ð "5¸sð "5Øð"5Ø&6ð"5à#ð"5à6:ð"5àFKÄkð"5ð "5ð "5ð "5ð "5ð "5ð "5ð "5r   rx   c                   óz   — e Zd ZU dZeeeeef         f         e	d<   dd„Z
dej        ddfd	„Zdej        ddfd
„ZdS )ÚDocFieldTransformerz�
    Transforms field lists in "doc field" syntax into better-looking
    equivalents, using the field type definitions given on a domain.
    ÚtypemapÚ	directiver   r   Nc                 óF   — || _         |                     ¦   «         | _        d S r*   )r‡   Úget_field_type_mapr†   )r+   r‡   s     r   r,   zDocFieldTransformer.__init__ì   s    € Ø"ˆŒà ×3Ò3Ñ5Ô5ˆŒˆˆr   r   c                 ón   — |D ]1}t          |t          j        ¦  «        r|                      |¦  «         Œ2dS )z,Transform all field list children of a node.N)r   r   Ú
field_listÚ	transform)r+   r   Úchilds      r   Útransform_allz!DocFieldTransformer.transform_allñ   sE   € ð ð 	&ð 	&ˆEÝ˜%¥Ô!1Ñ2Ô2ð &Ø—’˜uÑ%Ô%Ð%øð	&ð 	&r   c           
      óÊ
  — | j         }g }i }i }t          t          t          j                 |¦  «        D �]l}t          |¦  «        dk    sJ ‚t          t          j        |d         ¦  «        }t          t          j        |d         ¦  «        }	 |                     ¦   «          	                    dd¦  «        \  }	}
n&# t          $ r |                     ¦   «         d}
}	Y nw xY w|                     |	d¦  «        \  }}t          |¦  «        r(t          t          j        |d         ¦  «        }|j        }n|j        }|�|j        t!          |
¦  «        k    �r–|	dd…                              ¦   «         |	dd…         z   }|
r|d|
z   z  }t          j        |¦  «        |d<   |                     |¦  «         |�r4|�r1|�r.t          |¦  «        dk    �rt)          |d         t          j        ¦  «        rút          t*          |¦  «        }|d                              ¦   «         }|                     |j        | j        j        ||d         | j        j        j        j        j        ¬¦  «        }t          |¦  «        rJt          t          j        |d         ¦  «        }|                     ¦   «          |                     |¦  «         n*|                     ¦   «          |t          j        ddg|¢R Ž z  }�Œ³|j         }|r)d	„ |D ¦   «         }|r|| !                    |i ¦  «        |
<   �Œå|j"        rY	 |
 #                    dd¦  «        \  }}t          j        |¦  «        g| !                    |i ¦  «        |<   |}
n# t          $ r Y nw xY wt          j$        |j%        d
¬¦  «        }|j&        j        |_        |j&        j'        |_'        |j&        j(        |_(        ||z  }|j)        rž||v r:t          tT          tV          t          tX          f         |||                  ¦  «        }n,t          |¦  «        ||<   |g |f}|                     |¦  «         | -                    |
|g¦  «        }|d                              |¦  «         �Œ=| -                    |
|g¦  «        }|                     |||f¦  «         �Œnt          j.        ¦   «         }|D ]—}t)          |t          j        ¦  «        r||z  }Œ"|\  }}}|                     |j         i ¦  «        }| j        j        j        j        j        }| j        j        j/        } || 0                    || j        j        ||| |¬¦  «        z  }Œ˜| 1                    |¦  «         dS )z%Transform a single field list *node*.é   r   r   Nr5   )NNrQ   )r0   r1   c                 ó^   — g | ]*}t          |t          j        t          j        f¦  «        ¯(|‘Œ+S r"   )r   r   ÚInlinerT   )Ú.0Úns     r   ú
<listcomp>z1DocFieldTransformer.transform.<locals>.<listcomp>:  s0   € Ð[Ð[Ð[ µ¸AÅÄÍeÌjÐ?YÑ1ZÔ1ZÐ[˜1Ð[Ð[Ð[r   T)ÚtranslatablerR   )2r†   r
   r   r   rX   r   rS   rW   rV   ÚsplitÚ
ValueErrorÚgetr   r   Úchildrenr&   rd   ÚupperrT   Úappendr   rx   rI   rz   r‡   r-   ÚstateÚdocumentÚsettingsr1   ÚclearrU   r#   Ú
setdefaultrb   ÚrsplitrA   Ú	rawsourceÚparentÚsourceÚlinera   r   r!   r   rM   r‹   r2   r[   Úreplace_self)!r+   r   r†   ÚentriesÚgroupindicesrN   rX   rS   rW   Úfieldtype_namerJ   ÚtypedescÚis_typefieldr   rK   Únew_fieldnameÚtyped_fieldr.   Úxrefsr�   ÚargtypeÚargnameÚtranslatable_contentÚgroupÚ	new_entryÚnew_listÚentryr€   rl   r3   Ú
fieldtypesr1   r2   s!                                    r   rŒ   zDocFieldTransformer.transformø   s´  € à”,ˆàEGˆØ')ˆØ!#ˆõ �$�uœ{Ô+¨TÑ2Ô2ð ]	=ñ ]	=ˆEÝ�u‘:”: ’?�?�?�?Ý�eÔ.°°a´Ñ9Ô9ˆJÝ�eÔ.°°a´Ñ9Ô9ˆJðCà+5×+<Ò+<Ñ+>Ô+>×+DÒ+DÀTÈ1Ñ+MÔ+MÑ(�  øÝð Cð Cð Cà+5×+<Ò+<Ñ+>Ô+>À ���ðCøøøð &-§[¢[°ÀÑ%NÔ%NÑ"ˆH�lõ $ JÑ/Ô/ð .Ý ¥¤°*¸Q´-Ñ@Ô@�	Ø#Ô,��à$Ô-�ð Ð 8Ô#3µt¸H±~´~Ò#EÑ#Eð !/¨q°¨sÔ 3× 9Ò 9Ñ ;Ô ;¸nÈQÈRÈRÔ>PÑ P�Øð 4Ø! S¨8¡^Ñ3�MÝ %¤
¨=Ñ 9Ô 9�
˜1‘Ø—’˜uÑ%Ô%Ð%ð ñ F ñ F°'ñ FÝ˜G™œ¨Ò)Ñ)­j¸À¼ÅUÄZÑ.PÔ.PÐ)Ý"&¥z°8Ñ"<Ô"<�KØ$ QœZ×.Ò.Ñ0Ô0�FØ'×2Ò2Ø#Ô0ØœÔ-ØØ!(¨¤Ø œNÔ0Ô9ÔBÔFð 3ñ ô �Eõ ,¨JÑ7Ô7ð FÝ$(­¬¸*ÀQ¼-Ñ$HÔ$H˜	Ø!ŸšÑ)Ô)Ð)Ø!×(Ò(¨Ñ/Ô/Ð/Ð/à"×(Ò(Ñ*Ô*Ð*Ø"¥e¤o°b¸"Ð&E¸uÐ&EÐ&EÐ&EÑE˜
áà”}ˆHð ð ð \Ð[ gÐ[Ñ[Ô[�Øð GØ?F�E×$Ò$ X¨rÑ2Ô2°8Ñ<Ùð Ô ð 'ð'Ø'/§¢°t¸QÑ'?Ô'?Ñ$�G˜Wõ
 œ GÑ,Ô,Ð-ð ×$Ò$ X¨rÑ2Ô2°7Ñ;à&�H�Høõ "ð ð ð Ø�Dðøøøõ $)¤<°
Ô0DØ=Að$Cñ $Cô $CÐ à,6Ô,=Ô,FÐ Ô)Ø*4Ô*;Ô*BÐ Ô'Ø(2Ô(9Ô(>Ð Ô%Ø  GÑ+Ð ð Ô"ð =Ø˜|Ð+Ð+Ý ¥¥u­dµDÐ'8Ô!9¸7À<ÐPXÔCYÔ;ZÑ[Ô[�E�Eå-0°©\¬\�L Ñ*Ø% r¨5Ð1�EØ—N’N 5Ñ)Ô)Ð)Ø$×/Ò/°Ð;OÐ:PÑQÔQ�	Ø�a”—’ 	Ñ*Ô*Ð*Ñ*à$×/Ò/°Ð;OÐ:PÑQÔQ�	Ø—’ ¨)°UÐ;Ñ<Ô<Ð<Ñ<õ Ô#Ñ%Ô%ˆØð 
	^ð 
	^ˆEÝ˜%¥¤Ñ-Ô-ð 	^à˜EÑ!��à-2Ñ*�	˜5 (Ø"ŸYšY y¤~°rÑ:Ô:�
Ø”nÔ*Ô3Ô<Ô@�Øœ.Ô.Ô6�Ø˜I×0Ò0°¸T¼^Ô=RÐTYØ58À'ÐT\ð 1ñ ^ô ^ñ ^��ð 	×Ò˜(Ñ#Ô#Ð#Ð#Ð#s$   Â+B8Â8 CÃCÌ M(Í(
M5Í4M5)r‡   r   r   N)r]   r^   r_   r`   r   rc   r   r!   rd   Ú__annotations__r,   r   Údesc_contentrŽ   r   r‹   rŒ   r"   r   r   r…   r…   å   s§   € € € € € € ðð ð �#�u˜U D˜[Ô)Ð)Ô*Ð*Ð*Ñ*ð6ð 6ð 6ð 6ð
& (Ô"7ð &¸Dð &ð &ð &ð &ðv$˜eÔ.ð v$°4ð v$ð v$ð v$ð v$ð v$ð v$r   r…   N)&r`   Útypingr   r   r   r   r   r   r	   r
   Údocutilsr   Údocutils.nodesr   Údocutils.parsers.rst.statesr   Úsphinxr   Úsphinx.environmentr   Úsphinx.localer   Úsphinx.utilr   Úsphinx.util.typingr   Úsphinx.directivesr   Ú	getLoggerr]   r<   rW   rd   r   r!   rg   rx   r…   r"   r   r   ú<module>rÅ      sò  ððð ð
 LÐ KÐ KÐ KÐ KÐ KÐ KÐ KÐ KÐ KÐ KÐ KÐ KÐ KÐ KÐ KÐ KÐ KÐ KÐ Kà Ð Ð Ð Ð Ð Ø Ð Ð Ð Ð Ð Ø /Ð /Ð /Ð /Ð /Ð /à Ð Ð Ð Ð Ð Ø /Ð /Ð /Ð /Ð /Ð /Ø Ð Ð Ð Ð Ð Ø Ð Ð Ð Ð Ð Ø +Ð +Ð +Ð +Ð +Ð +àð 4Ø3Ð3Ð3Ð3Ð3Ð3à	ˆÔ	˜8Ñ	$Ô	$€ð
˜uÔ/ð 
°Dð 
ð 
ð 
ð 
ðP5ð P5ð P5ð P5ð P5ñ P5ô P5ð P5ðf)5ð )5ð )5ð )5ð )5�5ñ )5ô )5ð )5ðX>5ð >5ð >5ð >5ð >5�ñ >5ô >5ð >5ðBI$ð I$ð I$ð I$ð I$ñ I$ô I$ð I$ð I$ð I$r   