ó m[c@`słddlmZmZmZmZddlZddlmZddlZddl Z de fd„ƒYZ de fd„ƒYZ d„Z d „Ze ƒZd „Zd „ZdS( i(tabsolute_importtdivisiontprint_functiontunicode_literalsN(tcbookt SubstitutioncB`s8eZdZd„Zd„Zd„Zed„ƒZRS(u/ 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" cO`s8t|ƒot|ƒ s%tdƒ‚|p.||_dS(Nu+Only positional or keyword args are allowed(tlentAssertionErrortparams(tselftargstkwargs((s3lib/python2.7/site-packages/matplotlib/docstring.pyt__init__'s cC`s |jo|j|j|_|S(N(t__doc__R(R tfunc((s3lib/python2.7/site-packages/matplotlib/docstring.pyt__call__,scO`s|jj||ŽdS(u=Assume self.params is a dict and update it with supplied argsN(Rtupdate(R R R ((s3lib/python2.7/site-packages/matplotlib/docstring.pyR0scC`s|ƒ}||_|S(u( 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((s3lib/python2.7/site-packages/matplotlib/docstring.pyt from_params4s  (t__name__t __module__R R RRt classmethodR(((s3lib/python2.7/site-packages/matplotlib/docstring.pyR s    tAppendercB`s#eZdZdd„Zd„ZRS(uf 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 ucC`s||_||_dS(N(taddendumtjoin(R RR((s3lib/python2.7/site-packages/matplotlib/docstring.pyR Ts cC`s4|j|jg}|jo*|jj|ƒ|_|S(N(R RR(R Rtdocitems((s3lib/python2.7/site-packages/matplotlib/docstring.pyRXs(RRR R R(((s3lib/python2.7/site-packages/matplotlib/docstring.pyRAs cC`s"|jotj|jƒ|_|S(uDedent a docstring (if present)(R Rtdedent(R((s3lib/python2.7/site-packages/matplotlib/docstring.pyR^sc`s‡fd†}|S(u:Copy a docstring from another source function (if present)c`sˆjrˆj|_n|S(N(R (ttarget(tsource(s3lib/python2.7/site-packages/matplotlib/docstring.pytdo_copyfs ((RR((Rs3lib/python2.7/site-packages/matplotlib/docstring.pytcopydscC`s8t|tjƒr(tj r(|j}ntt|ƒƒS(uXA special case of the interpd that first performs a dedent on the incoming docstring(t isinstancettypest MethodTypetsixtPY3tim_functinterpdR(R((s3lib/python2.7/site-packages/matplotlib/docstring.pytdedent_interpdqs c`s ‡fd†S(uOA decorator that will copy the docstring from the source and then dedent itc`sttˆƒ|ƒƒS(N(RR(R(R(s3lib/python2.7/site-packages/matplotlib/docstring.pyt€s((R((Rs3lib/python2.7/site-packages/matplotlib/docstring.pyt copy_dedentys(t __future__RRRRR#t matplotlibRtsysR!tobjectRRRRR&R'R)(((s3lib/python2.7/site-packages/matplotlib/docstring.pyts"   6