o ¹i„ ã@s<ddlZddlmZGdd„dƒZdd„ZeƒZdd„ZdS) éN)Úcbookc@sBeZdZdZdd„Zdd„Zdd„Zeej dd d 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" cOs|r|rtdƒ‚|p ||_dS)Nz+Only positional or keyword args are allowed)Ú TypeErrorÚparams©ÚselfÚargsÚkwargs©r úO/var/www/edux/Edux_v2/venv/lib/python3.10/site-packages/matplotlib/docstring.pyÚ__init__!szSubstitution.__init__cCs|jr |j|j;_|S©N)Ú__doc__r)rÚfuncr r r Ú__call__&szSubstitution.__call__cOs|jj|i|¤ŽdS)zW Update ``self.params`` (which must be a dict) with the supplied args. N)rÚupdaterr r r r+szSubstitution.updatez3.3zassign to the params attribute)Ú alternativecCs|ƒ}||_|S)a( 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)ÚclsrÚresultr r r Ú from_params1s zSubstitution.from_paramsN) Ú__name__Ú __module__Ú __qualname__rr rrÚ classmethodrÚ deprecatedrr r r r rs rcs‡fdd„}|S)z;Copy a docstring from another source function (if present).csˆjrˆj|_|Sr )r)Útarget©Úsourcer r Údo_copyAszcopy..do_copyr )rrr rr Úcopy?s rcCst |¡|_t|ƒS)z@Dedent *func*'s docstring, then interpolate it with ``interpd``.)ÚinspectÚgetdocrÚinterpd)rr r r Údedent_interpdMs r#)r Ú matplotlibrrrr"r#r r r r Ús  9