o t€#g`ã@s`ddlZddlmZdd„ZGdd„dƒZGdd „d eƒZGd d „d eƒZd d „ZeƒZ Z dS)éNé)Ú_apicó‡fdd„}|S)aà Decorator for defining the kwdoc documentation of artist properties. This decorator can be applied to artist property setter methods. The given text is stored in a private attribute ``_kwarg_doc`` on the method. It is used to overwrite auto-generated documentation in the *kwdoc list* for artists. The kwdoc list is used to document ``**kwargs`` when they are properties of an artist. See e.g. the ``**kwargs`` section in `.Axes.text`. The text should contain the supported types, as well as the default value if applicable, e.g.: @_docstring.kwarg_doc("bool, default: :rc:`text.usetex`") def set_usetex(self, usetex): See Also -------- matplotlib.artist.kwdoc cs ˆ|_|S©N)Ú _kwarg_doc)Úfunc©Útext©úz/var/www/static.ux5.de/https/Moving-Object-Detection-with-OpenCV/env/lib/python3.10/site-packages/matplotlib/_docstring.pyÚ decoratorszkwarg_doc..decoratorr )r r r rr Ú kwarg_docs r c@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 r Ú__init__=szSubstitution.__init__cCs|jr t |j¡|j|_|Sr)Ú__doc__ÚinspectÚcleandocr)rrr r r Ú__call__BszSubstitution.__call__cOs|jj|i|¤ŽdS)zW Update ``self.params`` (which must be a dict) with the supplied args. N)rÚupdaterr r r rGszSubstitution.updateN)Ú__name__Ú __module__Ú __qualname__rrrrr r r r r"s  rc@seZdZdd„ZdS)Ú_ArtistKwdocLoaderc s†| d¡s t|ƒ‚|dtdƒ …‰ddlm}m}z‡fdd„t |¡Dƒ\}Wnty:}zt|ƒ|‚d}~ww|  |||ƒ¡S)Nz:kwdocr)ÚArtistÚkwdoccsg|] }|jˆkr|‘qSr )r)Ú.0Úcls©Únamer r Ú Us ÿz2_ArtistKwdocLoader.__missing__..) ÚendswithÚKeyErrorÚlenÚmatplotlib.artistrr rÚrecursive_subclassesÚ ValueErrorÚ setdefault)rÚkeyrr r"Úer r#r Ú __missing__Os  €ÿz_ArtistKwdocLoader.__missing__N)rrrr/r r r r rNs rcs(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ƒ|_dSr)rr)rr r r rhs z&_ArtistPropertiesSubstitution.__init__cs0tƒ |¡t|tƒr|jtjkr||jƒ|Sr)ÚsuperrÚ isinstanceÚtyperÚobject)rÚobj©Ú __class__r r rks  z&_ArtistPropertiesSubstitution.__call__)rrrrrrÚ __classcell__r r r6r r0\s r0cr)z;Copy a docstring from another source function (if present).csˆjrˆj|_|Sr)r)Útarget©Úsourcer r Údo_copytszcopy..do_copyr )r;r<r r:r Úcopyrs r=) rÚrr rÚdictrr0r=Údedent_interpdÚinterpdr r r r Ús ,