HEX

File: //opt/alt/python27/lib64/python2.7/site-packages/matplotlib/docstring.pyc
�
�)�Uc@smddlmZdefd��YZdefd��YZd�Zd�Ze�Zd�Zd	�Z	d
S(i����(tcbooktSubstitutioncBs8eZdZd�Zd�Zd�Zed��ZRS(sO
    A decorator to take a function's docstring and perform string
    substitution on it.
    
    This decorator should be robust even if func.__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"
    cOs,|o	|std��|p"||_dS(Ns+Only positional or keyword args are allowed(tAssertionErrortparams(tselftargstkwargs((sG/opt/alt/python27/lib64/python2.7/site-packages/matplotlib/docstring.pyt__init__scCs |jo|j|j|_|S(N(t__doc__R(Rtfunc((sG/opt/alt/python27/lib64/python2.7/site-packages/matplotlib/docstring.pyt__call__#scOs|jj||�dS(s=Assume self.params is a dict and update it with supplied argsN(Rtupdate(RRR((sG/opt/alt/python27/lib64/python2.7/site-packages/matplotlib/docstring.pyR'scCs|�}||_|S(s(
        In the case where the params is a mutable sequence (list or dictionary)
        and it may change before this class is called, one may explicitly use
        a reference to the params rather than using *args or **kwargs which will
        copy the values and not reference them.
        (R(tclsRtresult((sG/opt/alt/python27/lib64/python2.7/site-packages/matplotlib/docstring.pytfrom_params+s		(t__name__t
__module__RRR
RtclassmethodR(((sG/opt/alt/python27/lib64/python2.7/site-packages/matplotlib/docstring.pyRs
			tAppendercBs#eZdZdd�Zd�ZRS(sv
    A function decorator that will append an addendum to the docstring
    of the target function.
    
    This decorator should be robust even if func.__doc__ is None
    (for example, if -OO was passed to the interpreter).
    
    Usage: construct a docstring.Appender with a string to be joined to
    the original docstring. An optional 'join' parameter may be supplied
    which will be used to join the docstring and addendum. e.g.
    
    add_copyright = Appender("Copyright (c) 2009", join='
')
    
    @add_copyright
    def my_dog(has='fleas'):
        "This docstring will have a copyright below"
        pass
    tcCs||_||_dS(N(taddendumtjoin(RRR((sG/opt/alt/python27/lib64/python2.7/site-packages/matplotlib/docstring.pyRJs	cCs1|j|jg}|jo'dj|�|_|S(NR(RRR(RR	tdocitems((sG/opt/alt/python27/lib64/python2.7/site-packages/matplotlib/docstring.pyR
Ns(RRRRR
(((sG/opt/alt/python27/lib64/python2.7/site-packages/matplotlib/docstring.pyR7scCs"|jotj|j�|_|S(sDedent a docstring (if present)(RRtdedent(R	((sG/opt/alt/python27/lib64/python2.7/site-packages/matplotlib/docstring.pyRSscs�fd�}|S(s:Copy a docstring from another source function (if present)cs�jr�j|_n|S(N(R(ttarget(tsource(sG/opt/alt/python27/lib64/python2.7/site-packages/matplotlib/docstring.pytdo_copyZs	((RR((RsG/opt/alt/python27/lib64/python2.7/site-packages/matplotlib/docstring.pytcopyXscCstt|��S(sXA special case of the interpd that first performs a dedent on
    the incoming docstring(tinterpdR(R	((sG/opt/alt/python27/lib64/python2.7/site-packages/matplotlib/docstring.pytdedent_interpddscs
�fd�S(sOA decorator that will copy the docstring from the source and
    then dedent itcstt��|��S(N(RR(R(R(sG/opt/alt/python27/lib64/python2.7/site-packages/matplotlib/docstring.pyt<lambda>ps((R((RsG/opt/alt/python27/lib64/python2.7/site-packages/matplotlib/docstring.pytcopy_dedentisN(
t
matplotlibRtobjectRRRRRRR(((sG/opt/alt/python27/lib64/python2.7/site-packages/matplotlib/docstring.pyt<module>s4