B
    ¶ôJdw  ã               @   sT   d dl Z G dd„ dƒZdd„ ZG dd„ deƒZG dd	„ d	eƒZd
d„ Zeƒ  ZZdS )é    Nc               @   s(   e Zd ZdZdd„ Zdd„ Zdd„ ZdS )	ÚSubstitutionaG  
    A decorator that performs %-substitution on an object's docstring.

    This decorator should be robust even if ``obj.__doc__`` is None (for
    example, if -OO was passed to the interpreter).

    Usage: construct a docstring.Substitution with a sequence or dictionary
    suitable for performing substitution; then decorate a suitable function
    with the constructed object, e.g.::

        sub_author_name = Substitution(author='Jason')

        @sub_author_name
        def some_function(x):
            "%(author)s wrote this function"

        # note that some_function.__doc__ is now "Jason wrote this function"

    One can also use positional arguments::

        sub_first_last_names = Substitution('Edgar Allen', 'Poe')

        @sub_first_last_names
        def some_function(x):
            "%s %s wrote the Raven"
    c             O   s"   |r|rt dƒ‚|p| | _}d S )Nz+Only positional or keyword args are allowed)Ú	TypeErrorÚparams)ÚselfÚargsÚkwargsr   © r   úF/var/www/html/venv/lib/python3.7/site-packages/matplotlib/docstring.pyÚ__init__   s    zSubstitution.__init__c             C   s   |j rt |j ¡| j |_ |S )N)Ú__doc__ÚinspectÚcleandocr   )r   Úfuncr   r   r	   Ú__call__$   s    zSubstitution.__call__c             O   s   | j j||Ž dS )zW
        Update ``self.params`` (which must be a dict) with the supplied args.
        N)r   Úupdate)r   r   r   r   r   r	   r   )   s    zSubstitution.updateN)Ú__name__Ú
__module__Ú__qualname__r   r
   r   r   r   r   r   r	   r      s   r   c             c   s*   | V  x|   ¡ D ]}t|ƒE d H  qW d S )N)Ú__subclasses__Ú_recursive_subclasses)ÚclsÚsubclsr   r   r	   r   0   s    r   c               @   s   e Zd Zdd„ ZdS )Ú_ArtistKwdocLoaderc          
      sŽ   |  d¡st|ƒ‚|d tdƒ … ‰ ddlm}m} y‡ fdd„t|ƒD ƒ\}W n, tk
r| } zt|ƒ|‚W d d }~X Y nX |  |||ƒ¡S )Nz:kwdocr   )ÚArtistÚkwdocc                s   g | ]}|j ˆ kr|‘qS r   )r   )Ú.0r   )Únamer   r	   ú
<listcomp>=   s    z2_ArtistKwdocLoader.__missing__.<locals>.<listcomp>)	ÚendswithÚKeyErrorÚlenZmatplotlib.artistr   r   r   Ú
ValueErrorÚ
setdefault)r   Úkeyr   r   r   Úer   )r   r	   Ú__missing__7   s    
z_ArtistKwdocLoader.__missing__N)r   r   r   r%   r   r   r   r	   r   6   s   r   c                   s(   e Zd ZdZdd„ Z‡ fdd„Z‡  ZS )Ú_ArtistPropertiesSubstitutionaÜ  
    A `.Substitution` with two additional features:

    - Substitutions of the form ``%(classname:kwdoc)s`` (ending with the
      literal ":kwdoc" suffix) trigger lookup of an Artist subclass with the
      given *classname*, and are substituted with the `.kwdoc` of that class.
    - Decorating a class triggers substitution both on the class docstring and
      on the class' ``__init__`` docstring (which is a commonly required
      pattern for Artist subclasses).
    c             C   s   t ƒ | _d S )N)r   r   )r   r   r   r	   r
   P   s    z&_ArtistPropertiesSubstitution.__init__c                s0   t ƒ  |¡ t|tƒr,|jtjkr,| |jƒ |S )N)Úsuperr   Ú
isinstanceÚtyper
   Úobject)r   Úobj)Ú	__class__r   r	   r   S   s    
z&_ArtistPropertiesSubstitution.__call__)r   r   r   r   r
   r   Ú__classcell__r   r   )r,   r	   r&   D   s   
r&   c                s   ‡ fdd„}|S )z;Copy a docstring from another source function (if present).c                s   ˆ j rˆ j | _ | S )N)r   )Útarget)Úsourcer   r	   Údo_copy\   s    zcopy.<locals>.do_copyr   )r/   r0   r   )r/   r	   ÚcopyZ   s    r1   )	r   r   r   Údictr   r&   r1   Zdedent_interpdZinterpdr   r   r   r	   Ú<module>   s   ,