Gemfury

odigos / odigos deb

Repository URL to install this package:
Details
odigos / etc / odigos-vmagent / instrumentations / python / deprecated / __pycache__ / classic.cpython-311.pyc
§

O>gq)ãóèdZddlZddlZddlZddlZddlZ	ddlZdZdZn%#e	$rdZej
¦«dkrdZndZYnwxYwed¦«ed¦«fZGdd	ej
¦«Zd
ZdS)zñ
Classic deprecation warning
===========================

Classic ``@deprecated`` decorator to deprecate old python classes, functions or methods.

.. _The Warnings Filter: https://docs.python.org/3/library/warnings.html#the-warnings-filter
éNééÚPyPyóÚcó:eZdZdZdddedffd	ZdZdZxZS)ÚClassicAdaptera8
    Classic adapter -- *for advanced usage only*

    This adapter is used to get the deprecation message according to the wrapped object type:
    class, function, standard method, static method, or class method.

    This is the base class of the :class:`~deprecated.sphinx.SphinxAdapter` class
    which is used to update the wrapped object docstring.

    You can also inherit this class to change the deprecation message.

    In the following example, we change the message into "The ... is deprecated.":

    .. code-block:: python

       import inspect

       from deprecated.classic import ClassicAdapter
       from deprecated.classic import deprecated


       class MyClassicAdapter(ClassicAdapter):
           def get_deprecated_msg(self, wrapped, instance):
               if instance is None:
                   if inspect.isclass(wrapped):
                       fmt = "The class {name} is deprecated."
                   else:
                       fmt = "The function {name} is deprecated."
               else:
                   if inspect.isclass(instance):
                       fmt = "The class method {name} is deprecated."
                   else:
                       fmt = "The method {name} is deprecated."
               if self.reason:
                   fmt += " ({reason})"
               if self.version:
                   fmt += " -- Deprecated since version {version}."
               return fmt.format(name=wrapped.__name__,
                                 reason=self.reason or "",
                                 version=self.version or "")

    Then, you can use your ``MyClassicAdapter`` class like this in your source code:

    .. code-block:: python

       @deprecated(reason="use another function", adapter_cls=MyClassicAdapter)
       def some_old_function(x, y):
           return x + y
    rNrcó¤|pd|_|pd|_||_||_||_tt|¦« ¦«dS)a
        Construct a wrapper adapter.

        :type  reason: str
        :param reason:
            Reason message which documents the deprecation in your library (can be omitted).

        :type  version: str
        :param version:
            Version of your project which deprecates this feature.
            If you follow the `Semantic Versioning <https://semver.org/>`_,
            the version number has the format "MAJOR.MINOR.PATCH".

        :type  action: Literal["default", "error", "ignore", "always", "module", "once"]
        :param action:
            A warning filter used to activate or not the deprecation warning.
            Can be one of "error", "ignore", "always", "default", "module", or "once".
            If ``None`` or empty, the global filtering mechanism is used.
            See: `The Warnings Filter`_ in the Python documentation.

        :type  category: Type[Warning]
        :param category:
            The warning category to use for the deprecation warning.
            By default, the category class is :class:`~DeprecationWarning`,
            you can inherit this class to define your own deprecation warning category.

        :type  extra_stacklevel: int
        :param extra_stacklevel:
            Number of additional stack levels to consider instrumentation rather than user code.
            With the default value of 0, the warning refers to where the class was instantiated
            or the function was called.

        .. versionchanged:: 1.2.15
            Add the *extra_stacklevel* parameter.
        rN)ÚreasonÚversionÚactionÚcategoryÚextra_stacklevelÚsuperr	Ú__init__)Úselfrrr
rrÚ	__class__s      ú9/tmp/pip-target-qlpkiub5/lib/python/deprecated/classic.pyrzClassicAdapter.__init__VsTøðHl Ø} "ØØ 
Ø 0ÔÝ
ndÑ#Ô#×,Ò,Ñ.Ô.Ð.Ð.Ð.rcóò|tj|¦«rd}nd}ntj|¦«rd}nd}|jr|dz
}|jr|dz
}| |j|jpd|jpd¬	¦«S)
zÿ
        Get the deprecation warning message for the user.

        :param wrapped: Wrapped class or function.

        :param instance: The object to which the wrapped function was bound when it was called.

        :return: The warning message.
        Nz Call to deprecated class {name}.z5Call to deprecated function (or staticmethod) {name}.z'Call to deprecated class method {name}.z!Call to deprecated method {name}.z ({reason})z' -- Deprecated since version {version}.r)Únamerr)ÚinspectÚisclassrrÚformatÚ__name__)rÚwrappedÚinstanceÚfmts    rÚget_deprecated_msgz!ClassicAdapter.get_deprecated_msgsðÐÝwÑ'Ô'ð
NØ8àMåxÑ(Ô(ð
:Ø?à9Ø;ð	!Ø=Ñ CØ<ð	=ØÐ<Ñ<CØzzwÔ/¸¼Ð8IÀrÐSWÔS_ÐSeÐcezÑfÔfÐfrcó8tj¦«r#jfd}t|¦«_n_tj¦«r"t
jfd¦«}|¦«Sttt¦«¦«¦«S)a
        Decorate your class or function.

        :param wrapped: Wrapped class or function.

        :return: the decorated class or function.

        .. versionchanged:: 1.2.4
           Don't pass arguments to :meth:`object.__new__` (other than *cls*).

        .. versionchanged:: 1.2.8
           The warning filter is not set if the *action* parameter is ``None`` or empty.
        có¬ d¦«}tjz}jrgt	j¦«5t	jjj¦«t	j|j|¬¦«ddd¦«n#1swxYwYnt	j|j|¬¦«tj
ur|¦«S|g|¢Ri|¤S©N)rÚ
stacklevel)rÚ_class_stacklevelrr
ÚwarningsÚcatch_warningsÚsimplefilterrÚwarnÚobjectÚ__new__)ÚclsÚargsÚkwargsÚmsgr"Úold_new1rrs     rÚwrapped_clsz,ClassicAdapter.__call__.<locals>.wrapped_cls¬s,øØ×-Ò-¨g°tÑ<Ô<Ý.°Ô1FÑF
Ø;ðVÝ!Ô0Ñ2Ô2ðZðZÝ Ô-¨d¬k¸4¼=ÑIÔIÐIÝ 
 c°D´MÈjÐYÑYÔYÐYðZðZðZñZôZðZðZðZðZðZðZøøøðZðZðZðZøõM #°´
È*ÐUÑUÔUÐUØv~Ð-Ð-Ø#8 C==Ð(àx Ð5 dÐ5Ð5Ð5¨fÐ5Ð5Ð5óÁ<B	Â	B
ÂB
cór ||¦«}tjz}jrgt	j¦«5t	jjj¦«t	j|j|¬¦«ddd¦«n#1swxYwYnt	j|j|¬¦«||i|¤Sr!)	rÚ_routine_stacklevelrr
r$r%r&rr')Úwrapped_Ú	instance_Úargs_Úkwargs_r-r"rs      rÚwrapper_functionz1ClassicAdapter.__call__.<locals>.wrapper_function½søà×-Ò-¨h¸	ÑBÔBÝ0°4Ô3HÑH
Ø;ðVÝ!Ô0Ñ2Ô2ðZðZÝ Ô-¨d¬k¸4¼=ÑIÔIÐIÝ 
 c°D´MÈjÐYÑYÔYÐYðZðZðZñZôZðZðZðZðZðZðZøøøðZðZðZðZøõM #°´
È*ÐUÑUÔUÐUØx Ð2¨'Ð2Ð2Ð2r0)
rrr)ÚstaticmethodÚ	isroutineÚwraptÚ	decoratorÚ	TypeErrorÚreprÚtype)rrr/r7r.s``  @rÚ__call__zClassicAdapter.__call__sÄøøøõ?7Ñ#Ô#ð#	1ØHð
6ð
6ð
6ð
6ð
6ð
6ð
6õ+¨;Ñ7Ô7GOOå
Ô
wÑ
'Ô
'ð	1Ý
_ð	
3ð	
3ð	
3ð	
3ñ_ð	
3ð$Ð# GÑ,Ô,Ð,õD¥ g¡¤Ñ/Ô/Ñ0Ô0Ð0àr)	rÚ
__module__Ú__qualname__Ú__doc__ÚDeprecationWarningrrr?Ú
__classcell__)rs@rr	r	#syøð0ð0ðd!¨"°TÐDVÐijð)/ð)/ð)/ð)/ð)/ð)/ðVgðgðgð43ð3ð3ð3ð3ð3ð3rr	có|r0t|dt¦«r|d|d<|dd}|rDt|d¦«s/tt	t|d¦«¦«¦«|r6| dt¦«}|di|¤}|d}||¦«Stj	tfi|¤S)aö
    This is a decorator which can be used to mark functions
    as deprecated. It will result in a warning being emitted
    when the function is used.

    **Classic usage:**

    To use this, decorate your deprecated function with **@deprecated** decorator:

    .. code-block:: python

       from deprecated import deprecated


       @deprecated
       def some_old_function(x, y):
           return x + y

    You can also decorate a class or a method:

    .. code-block:: python

       from deprecated import deprecated


       class SomeClass(object):
           @deprecated
           def some_old_method(self, x, y):
               return x + y


       @deprecated
       class SomeOldClass(object):
           pass

    You can give a *reason* message to help the developer to choose another function/class,
    and a *version* number to specify the starting version number of the deprecation.

    .. code-block:: python

       from deprecated import deprecated


       @deprecated(reason="use another function", version='1.2.0')
       def some_old_function(x, y):
           return x + y

    The *category* keyword argument allow you to specify the deprecation warning class of your choice.
    By default, :exc:`DeprecationWarning` is used, but you can choose :exc:`FutureWarning`,
    :exc:`PendingDeprecationWarning` or a custom subclass.

    .. code-block:: python

       from deprecated import deprecated


       @deprecated(category=PendingDeprecationWarning)
       def some_old_function(x, y):
           return x + y

    The *action* keyword argument allow you to locally change the warning filtering.
    *action* can be one of "error", "ignore", "always", "default", "module", or "once".
    If ``None``, empty or missing, the global filtering mechanism is used.
    See: `The Warnings Filter`_ in the Python documentation.

    .. code-block:: python

       from deprecated import deprecated


       @deprecated(action="error")
       def some_old_function(x, y):
           return x + y

    The *extra_stacklevel* keyword argument allows you to specify additional stack levels
    to consider instrumentation rather than user code. With the default value of 0, the
    warning refers to where the class was instantiated or the function was called.
    rréNÚadapter_cls©)Ú
isinstanceÚstring_typesÚcallabler<r=r>Úpopr	Ú	functoolsÚpartialÚ
deprecated)r+r,rGÚadapterrs     rrOrOÑsÚð^ð
4 7¥LÑ1Ô1ðØ 7xÑØABBxàð-HT !WÑ%Ô%ð-ÝT $ q¤']]Ñ+Ô+Ñ,Ô,Ð,àð Øjj µÑ?Ô?Ø+Ð'Ð' Ð'Ð'Øq'ØwwÑÔÐåÔZÐ2Ð2¨6Ð2Ð2Ð2r)rBrMrÚplatformr$r:Úwrapt._wrappersr2r#ÚImportErrorÚpython_implementationr>rJÚAdapterFactoryr	rOrHrrú<module>rVsððððÐÐÐØØØàð
ðÐÐÐàÐØÐÐøØðððØÐØ%xÔ%Ñ'Ô'¨6Ò1Ð1ØÐÐàÐøøðøøøðS		44 99Ð%ðkðkðkðkðkUÔ)ñkôkðkð\\3ð\3ð\3ð\3ð\3s!¡AÁA
odigos / odigos deb

Products

About

Resources

Contact Gemfury
