B ¶ôJdw ã@sTddlZGdd„dƒZdd„ZGdd„deƒZGdd „d eƒZd d „ZeƒZZdS) éNc@s(eZdZdZdd„Zdd„Zdd„ZdS) Ú 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Úkwargsr©rúF/var/www/html/venv/lib/python3.7/site-packages/matplotlib/docstring.pyÚ__init__szSubstitution.__init__cCs|jrt |j¡|j|_|S)N)Ú__doc__ÚinspectÚcleandocr)rÚfuncrrr Ú__call__$szSubstitution.__call__cOs|jj||ŽdS)zW Update ``self.params`` (which must be a dict) with the supplied args. N)rÚupdate)rrrrrr r)szSubstitution.updateN)Ú__name__Ú __module__Ú __qualname__r r rrrrrr rsrccs*|Vx| ¡D]}t|ƒEdHqWdS)N)Ú__subclasses__Ú_recursive_subclasses)ÚclsÚsubclsrrr r0src@seZdZdd„ZdS)Ú_ArtistKwdocLoaderc sŽ| d¡st|ƒ‚|dtdƒ …‰ddlm}m}y‡fdd„t|ƒDƒ\}Wn,tk r|}zt|ƒ|‚Wdd}~XYnX| |||ƒ¡S)Nz:kwdocr)ÚArtistÚkwdoccsg|]}|jˆkr|‘qSr)r)Ú.0r)Únamerr ú =sz2_ArtistKwdocLoader.__missing__..) ÚendswithÚKeyErrorÚlenZmatplotlib.artistrrrÚ ValueErrorÚ setdefault)rÚkeyrrrÚer)rr Ú __missing__7s z_ArtistKwdocLoader.__missing__N)rrrr%rrrr r6srcs(eZdZdZdd„Z‡fdd„Z‡ZS)Ú_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). cCs tƒ|_dS)N)rr)rrrr r Psz&_ArtistPropertiesSubstitution.__init__cs0tƒ |¡t|tƒr,|jtjkr,||jƒ|S)N)ÚsuperrÚ isinstanceÚtyper Úobject)rÚobj)Ú __class__rr rSs  z&_ArtistPropertiesSubstitution.__call__)rrrr r rÚ __classcell__rr)r,r r&Ds r&cs‡fdd„}|S)z;Copy a docstring from another source function (if present).csˆjrˆj|_|S)N)r )Útarget)Úsourcerr Údo_copy\szcopy..do_copyr)r/r0r)r/r ÚcopyZs r1) r rrÚdictrr&r1Zdedent_interpdZinterpdrrrr Ús ,