wrapt 2.0.0rc4__cp313-cp313-musllinux_1_2_riscv64.whl → 2.0.1__cp313-cp313-musllinux_1_2_riscv64.whl

wrapt/proxies.py

@@ -1,5 +1,8 @@
 """Variants of ObjectProxy for different use cases."""
 
+from collections.abc import Callable
+from types import ModuleType
+
 from .__wrapt__ import BaseObjectProxy
 from .decorators import synchronized
 
@@ -15,6 +18,10 @@ class ObjectProxy(BaseObjectProxy):
     support for special dunder methods for callables, iterators, and async,
     then use `AutoObjectProxy`."""
 
+    @property
+    def __object_proxy__(self):
+        return ObjectProxy
+
     def __new__(cls, *args, **kwargs):
         return super().__new__(cls)
 
@@ -26,7 +33,12 @@ class ObjectProxy(BaseObjectProxy):
 # object and add special dunder methods.
 
 
-def __wrapper_call__(self, *args, **kwargs):
+def __wrapper_call__(*args, **kwargs):
+    def _unpack_self(self, *args):
+        return self, args
+
+    self, args = _unpack_self(*args)
+
     return self.__wrapped__(*args, **kwargs)
 
 
@@ -46,7 +58,7 @@ async def __wrapper_anext__(self):
     return await self.__wrapped__.__anext__()
 
 
-def __wrapper_hint_length__(self):
+def __wrapper_length_hint__(self):
     return self.__wrapped__.__length_hint__()
 
 
@@ -66,8 +78,8 @@ def __wrapper_delete__(self, instance):
     return self.__wrapped__.__delete__(instance)
 
 
-def __wrapper_set_name__(self, name):
-    return self.__wrapped__.__set_name__(name)
+def __wrapper_set_name__(self, owner, name):
+    return self.__wrapped__.__set_name__(owner, name)
 
 
 class AutoObjectProxy(BaseObjectProxy):
@@ -106,7 +118,7 @@ class AutoObjectProxy(BaseObjectProxy):
             namespace["__anext__"] = __wrapper_anext__
 
         if "__length_hint__" in wrapped_attrs and "__length_hint__" not in class_attrs:
-            namespace["__length_hint__"] = __wrapper_hint_length__
+            namespace["__length_hint__"] = __wrapper_length_hint__
 
         # Note that not providing compatibility with generator-based coroutines
         # (PEP 342) here as they are removed in Python 3.11+ and were deprecated
@@ -132,7 +144,7 @@ class AutoObjectProxy(BaseObjectProxy):
         if cls is AutoObjectProxy:
             name = BaseObjectProxy.__name__
 
-        return super().__new__(type(name, (cls,), namespace))
+        return super(AutoObjectProxy, cls).__new__(type(name, (cls,), namespace))
 
     def __wrapped_setattr_fixups__(self):
         """Adjusts special dunder methods on the class as needed based on the
@@ -174,8 +186,8 @@ class AutoObjectProxy(BaseObjectProxy):
 
         if hasattr(self.__wrapped__, "__length_hint__"):
             if "__length_hint__" not in class_attrs:
-                cls.__length_hint__ = __wrapper_hint_length__
-        elif getattr(cls, "__length_hint__", None) is __wrapper_hint_length__:
+                cls.__length_hint__ = __wrapper_length_hint__
+        elif getattr(cls, "__length_hint__", None) is __wrapper_length_hint__:
             delattr(cls, "__length_hint__")
 
         if hasattr(self.__wrapped__, "__await__"):
@@ -214,10 +226,64 @@ class LazyObjectProxy(AutoObjectProxy):
     when it is first needed.
     """
 
-    def __new__(cls, callback=None):
-        return super().__new__(cls, None)
+    def __new__(cls, callback=None, *, interface=...):
+        """Injects special dunder methods into a dynamically created subclass
+        as needed based on the wrapped object.
+        """
+
+        if interface is ...:
+            interface = type(None)
+
+        namespace = {}
+
+        interface_attrs = dir(interface)
+        class_attrs = set(dir(cls))
+
+        if "__call__" in interface_attrs and "__call__" not in class_attrs:
+            namespace["__call__"] = __wrapper_call__
+
+        if "__iter__" in interface_attrs and "__iter__" not in class_attrs:
+            namespace["__iter__"] = __wrapper_iter__
+
+        if "__next__" in interface_attrs and "__next__" not in class_attrs:
+            namespace["__next__"] = __wrapper_next__
+
+        if "__aiter__" in interface_attrs and "__aiter__" not in class_attrs:
+            namespace["__aiter__"] = __wrapper_aiter__
+
+        if "__anext__" in interface_attrs and "__anext__" not in class_attrs:
+            namespace["__anext__"] = __wrapper_anext__
+
+        if (
+            "__length_hint__" in interface_attrs
+            and "__length_hint__" not in class_attrs
+        ):
+            namespace["__length_hint__"] = __wrapper_length_hint__
 
-    def __init__(self, callback=None):
+        # Note that not providing compatibility with generator-based coroutines
+        # (PEP 342) here as they are removed in Python 3.11+ and were deprecated
+        # in 3.8.
+
+        if "__await__" in interface_attrs and "__await__" not in class_attrs:
+            namespace["__await__"] = __wrapper_await__
+
+        if "__get__" in interface_attrs and "__get__" not in class_attrs:
+            namespace["__get__"] = __wrapper_get__
+
+        if "__set__" in interface_attrs and "__set__" not in class_attrs:
+            namespace["__set__"] = __wrapper_set__
+
+        if "__delete__" in interface_attrs and "__delete__" not in class_attrs:
+            namespace["__delete__"] = __wrapper_delete__
+
+        if "__set_name__" in interface_attrs and "__set_name__" not in class_attrs:
+            namespace["__set_name__"] = __wrapper_set_name__
+
+        name = cls.__name__
+
+        return super(AutoObjectProxy, cls).__new__(type(name, (cls,), namespace))
+
+    def __init__(self, callback=None, *, interface=...):
         """Initialize the object proxy with wrapped object as `None` but due
         to presence of special `__wrapped_factory__` attribute addded first,
         this will actually trigger the deferred creation of the wrapped object
@@ -229,6 +295,8 @@ class LazyObjectProxy(AutoObjectProxy):
 
         super().__init__(None)
 
+    __wrapped_initialized__ = False
+
     def __wrapped_factory__(self):
         return None
 
@@ -247,20 +315,37 @@ class LazyObjectProxy(AutoObjectProxy):
             # If it is then just return it, otherwise call the factory to
             # create it.
 
-            try:
-                return object.__getattribute__(self, "__wrapped__")
-            except AttributeError:
-                pass
+            if self.__wrapped_initialized__:
+                return self.__wrapped__
 
             self.__wrapped__ = self.__wrapped_factory__()
 
+            self.__wrapped_initialized__ = True
+
             return self.__wrapped__
 
 
-def lazy_import(name):
-    """Lazily imports a module, returning a `LazyObjectProxy` which will
-    import the module when it is first needed. When name is a dotted name,
-    then the full dotted name is imported and the last component returned.
+def lazy_import(name, attribute=None, *, interface=...):
+    """Lazily imports the module `name`, returning a `LazyObjectProxy` which
+    will import the module when it is first needed. When `name is a dotted name,
+    then the full dotted name is imported and the last module is taken as the
+    target. If `attribute` is provided then it is used to retrieve an attribute
+    from the module.
     """
 
-    return LazyObjectProxy(lambda: __import__(name, fromlist=[""]))
+    if attribute is not None:
+        if interface is ...:
+            interface = Callable
+    else:
+        if interface is ...:
+            interface = ModuleType
+
+    def _import():
+        module = __import__(name, fromlist=[""])
+
+        if attribute is not None:
+            return getattr(module, attribute)
+
+        return module
+
+    return LazyObjectProxy(_import, interface=interface)

wrapt/wrappers.py

@@ -125,6 +125,10 @@ class ObjectProxy(with_metaclass(_ObjectProxyMetaType)):  # type: ignore[misc]
         except AttributeError:
             pass
 
+    @property
+    def __object_proxy__(self):
+        return ObjectProxy
+
     def __self_setattr__(self, name, value):
         object.__setattr__(self, name, value)
 
@@ -364,52 +368,90 @@ class ObjectProxy(with_metaclass(_ObjectProxyMetaType)):  # type: ignore[misc]
         return other | self.__wrapped__
 
     def __iadd__(self, other):
-        self.__wrapped__ += other
-        return self
+        if hasattr(self.__wrapped__, "__iadd__"):
+            self.__wrapped__ += other
+            return self
+        else:
+            return self.__object_proxy__(self.__wrapped__ + other)
 
     def __isub__(self, other):
-        self.__wrapped__ -= other
-        return self
+        if hasattr(self.__wrapped__, "__isub__"):
+            self.__wrapped__ -= other
+            return self
+        else:
+            return self.__object_proxy__(self.__wrapped__ - other)
 
     def __imul__(self, other):
-        self.__wrapped__ *= other
-        return self
+        if hasattr(self.__wrapped__, "__imul__"):
+            self.__wrapped__ *= other
+            return self
+        else:
+            return self.__object_proxy__(self.__wrapped__ * other)
 
     def __itruediv__(self, other):
-        self.__wrapped__ = operator.itruediv(self.__wrapped__, other)
-        return self
+        if hasattr(self.__wrapped__, "__itruediv__"):
+            self.__wrapped__ /= other
+            return self
+        else:
+            return self.__object_proxy__(self.__wrapped__ / other)
 
     def __ifloordiv__(self, other):
-        self.__wrapped__ //= other
-        return self
+        if hasattr(self.__wrapped__, "__ifloordiv__"):
+            self.__wrapped__ //= other
+            return self
+        else:
+            return self.__object_proxy__(self.__wrapped__ // other)
 
     def __imod__(self, other):
-        self.__wrapped__ %= other
+        if hasattr(self.__wrapped__, "__imod__"):
+            self.__wrapped__ %= other
+            return self
+        else:
+            return self.__object_proxy__(self.__wrapped__ % other)
+
         return self
 
     def __ipow__(self, other):  # type: ignore[misc]
-        self.__wrapped__ **= other
-        return self
+        if hasattr(self.__wrapped__, "__ipow__"):
+            self.__wrapped__ **= other
+            return self
+        else:
+            return self.__object_proxy__(self.__wrapped__**other)
 
     def __ilshift__(self, other):
-        self.__wrapped__ <<= other
-        return self
+        if hasattr(self.__wrapped__, "__ilshift__"):
+            self.__wrapped__ <<= other
+            return self
+        else:
+            return self.__object_proxy__(self.__wrapped__ << other)
 
     def __irshift__(self, other):
-        self.__wrapped__ >>= other
-        return self
+        if hasattr(self.__wrapped__, "__irshift__"):
+            self.__wrapped__ >>= other
+            return self
+        else:
+            return self.__object_proxy__(self.__wrapped__ >> other)
 
     def __iand__(self, other):
-        self.__wrapped__ &= other
-        return self
+        if hasattr(self.__wrapped__, "__iand__"):
+            self.__wrapped__ &= other
+            return self
+        else:
+            return self.__object_proxy__(self.__wrapped__ & other)
 
     def __ixor__(self, other):
-        self.__wrapped__ ^= other
-        return self
+        if hasattr(self.__wrapped__, "__ixor__"):
+            self.__wrapped__ ^= other
+            return self
+        else:
+            return self.__object_proxy__(self.__wrapped__ ^ other)
 
     def __ior__(self, other):
-        self.__wrapped__ |= other
-        return self
+        if hasattr(self.__wrapped__, "__ior__"):
+            self.__wrapped__ |= other
+            return self
+        else:
+            return self.__object_proxy__(self.__wrapped__ | other)
 
     def __neg__(self):
         return -self.__wrapped__
@@ -448,8 +490,11 @@ class ObjectProxy(with_metaclass(_ObjectProxyMetaType)):  # type: ignore[misc]
         return other @ self.__wrapped__
 
     def __imatmul__(self, other):
-        self.__wrapped__ @= other
-        return self
+        if hasattr(self.__wrapped__, "__imatmul__"):
+            self.__wrapped__ @= other
+            return self
+        else:
+            return self.__object_proxy__(self.__wrapped__ @ other)
 
     def __len__(self):
         return len(self.__wrapped__)

wrapt-2.0.1.dist-info/METADATA

@@ -0,0 +1,216 @@
+Metadata-Version: 2.4
+Name: wrapt
+Version: 2.0.1
+Summary: Module for decorators, wrappers and monkey patching.
+Home-page: https://github.com/GrahamDumpleton/wrapt
+Author: Graham Dumpleton
+Author-email: Graham Dumpleton <Graham.Dumpleton@gmail.com>
+License: Copyright (c) 2013-2025, Graham Dumpleton
+        All rights reserved.
+        
+        Redistribution and use in source and binary forms, with or without
+        modification, are permitted provided that the following conditions are met:
+        
+        * Redistributions of source code must retain the above copyright notice, this
+          list of conditions and the following disclaimer.
+        
+        * Redistributions in binary form must reproduce the above copyright notice,
+          this list of conditions and the following disclaimer in the documentation
+          and/or other materials provided with the distribution.
+        
+        THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+        AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+        IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+        ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+        LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+        CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+        SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+        INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+        CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+        ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+        POSSIBILITY OF SUCH DAMAGE.
+        
+Project-URL: Homepage, https://github.com/GrahamDumpleton/wrapt
+Project-URL: Bug Tracker, https://github.com/GrahamDumpleton/wrapt/issues/
+Project-URL: Changelog, https://wrapt.readthedocs.io/en/latest/changes.html
+Project-URL: Documentation, https://wrapt.readthedocs.io/
+Keywords: wrapper,proxy,decorator
+Platform: any
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Requires-Python: >=3.8
+Description-Content-Type: text/x-rst
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: setuptools; extra == "dev"
+Dynamic: license-file
+
+wrapt
+=====
+
+|PyPI| |Documentation|
+
+A Python module for decorators, wrappers and monkey patching.
+
+Overview
+--------
+
+The **wrapt** module provides a transparent object proxy for Python, which can be used as the basis for the construction of function wrappers and decorator functions.
+
+The **wrapt** module focuses very much on correctness. It goes way beyond existing mechanisms such as ``functools.wraps()`` to ensure that decorators preserve introspectability, signatures, type checking abilities etc. The decorators that can be constructed using this module will work in far more scenarios than typical decorators and provide more predictable and consistent behaviour.
+
+To ensure that the overhead is as minimal as possible, a C extension module is used for performance critical components. An automatic fallback to a pure Python implementation is also provided where a target system does not have a compiler to allow the C extension to be compiled.
+
+Key Features
+------------
+
+* **Universal decorators** that work with functions, methods, classmethods, staticmethods, and classes
+* **Transparent object proxies** for advanced wrapping scenarios  
+* **Monkey patching utilities** for safe runtime modifications
+* **C extension** for optimal performance with Python fallback
+* **Comprehensive introspection preservation** (signatures, annotations, etc.)
+* **Thread-safe decorator implementations**
+
+Installation
+------------
+
+Install from PyPI using pip::
+
+    pip install wrapt
+
+Supported Python Versions
+--------------------------
+
+* Python 3.8+
+* CPython and PyPy implementations
+
+Documentation
+-------------
+
+For comprehensive documentation, examples, and advanced usage patterns, visit:
+
+* https://wrapt.readthedocs.io/
+
+Quick Start
+-----------
+
+To implement your decorator you need to first define a wrapper function.
+This will be called each time a decorated function is called. The wrapper
+function needs to take four positional arguments:
+
+* ``wrapped`` - The wrapped function which in turns needs to be called by your wrapper function.
+* ``instance`` - The object to which the wrapped function was bound when it was called.
+* ``args`` - The list of positional arguments supplied when the decorated function was called.
+* ``kwargs`` - The dictionary of keyword arguments supplied when the decorated function was called.
+
+The wrapper function would do whatever it needs to, but would usually in
+turn call the wrapped function that is passed in via the ``wrapped``
+argument.
+
+The decorator ``@wrapt.decorator`` then needs to be applied to the wrapper
+function to convert it into a decorator which can in turn be applied to
+other functions.
+
+.. code-block:: python
+
+    import wrapt
+
+    @wrapt.decorator
+    def pass_through(wrapped, instance, args, kwargs):
+        return wrapped(*args, **kwargs)
+
+    @pass_through
+    def function():
+        pass
+
+If you wish to implement a decorator which accepts arguments, then wrap the
+definition of the decorator in a function closure. Any arguments supplied
+to the outer function when the decorator is applied, will be available to
+the inner wrapper when the wrapped function is called.
+
+.. code-block:: python
+
+    import wrapt
+
+    def with_arguments(myarg1, myarg2):
+        @wrapt.decorator
+        def wrapper(wrapped, instance, args, kwargs):
+            return wrapped(*args, **kwargs)
+        return wrapper
+
+    @with_arguments(1, 2)
+    def function():
+        pass
+
+When applied to a normal function or static method, the wrapper function
+when called will be passed ``None`` as the ``instance`` argument.
+
+When applied to an instance method, the wrapper function when called will
+be passed the instance of the class the method is being called on as the
+``instance`` argument. This will be the case even when the instance method
+was called explicitly via the class and the instance passed as the first
+argument. That is, the instance will never be passed as part of ``args``.
+
+When applied to a class method, the wrapper function when called will be
+passed the class type as the ``instance`` argument.
+
+When applied to a class, the wrapper function when called will be passed
+``None`` as the ``instance`` argument. The ``wrapped`` argument in this
+case will be the class.
+
+The above rules can be summarised with the following example.
+
+.. code-block:: python
+
+    import inspect
+
+    @wrapt.decorator
+    def universal(wrapped, instance, args, kwargs):
+        if instance is None:
+            if inspect.isclass(wrapped):
+                # Decorator was applied to a class.
+                return wrapped(*args, **kwargs)
+            else:
+                # Decorator was applied to a function or staticmethod.
+                return wrapped(*args, **kwargs)
+        else:
+            if inspect.isclass(instance):
+                # Decorator was applied to a classmethod.
+                return wrapped(*args, **kwargs)
+            else:
+                # Decorator was applied to an instancemethod.
+                return wrapped(*args, **kwargs)
+
+Using these checks it is therefore possible to create a universal decorator
+that can be applied in all situations. It is no longer necessary to create
+different variants of decorators for normal functions and instance methods,
+or use additional wrappers to convert a function decorator into one that
+will work for instance methods.
+
+In all cases, the wrapped function passed to the wrapper function is called
+in the same way, with ``args`` and ``kwargs`` being passed. The
+``instance`` argument doesn't need to be used in calling the wrapped
+function.
+
+Links
+-----
+
+* **Documentation**: https://wrapt.readthedocs.io/
+* **Source Code**: https://github.com/GrahamDumpleton/wrapt
+* **Bug Reports**: https://github.com/GrahamDumpleton/wrapt/issues/
+* **Changelog**: https://wrapt.readthedocs.io/en/latest/changes.html
+
+.. |PyPI| image:: https://img.shields.io/pypi/v/wrapt.svg?logo=python&cacheSeconds=3600
+   :target: https://pypi.python.org/pypi/wrapt
+.. |Documentation| image:: https://img.shields.io/badge/docs-wrapt.readthedocs.io-blue.svg
+   :target: https://wrapt.readthedocs.io/

wrapt-2.0.1.dist-info/RECORD

@@ -0,0 +1,18 @@
+wrapt/__init__.py,sha256=bAF7Gzqnf_vUBpf5KNFfIm5P9Drm7M0WYlt22W25Q4Y,1540
+wrapt/__init__.pyi,sha256=d3CBY392zYAgBJoUeaRzdOUDbwlHgCxiLROnd4LdSG8,9402
+wrapt/__wrapt__.py,sha256=E_Yo7fIk51_OjMzlqXKtIhvplbYbJIPcTGD20b0GWM8,1431
+wrapt/_wrappers.c,sha256=ux1b_-Me_8QpJ_QRWvCq9jt_1CZ-9TFA-cVSLqi4_Zg,115800
+wrapt/_wrappers.cpython-313-riscv64-linux-musl.so,sha256=i8fjISsthsG5J7nxSb-X4oOHU7OVGo3ZR4Ehi3QlEGg,215560
+wrapt/arguments.py,sha256=q4bxH7GoCXhTCgxy-AEyvSnOq0ovMSHjN7ru3HWxlhA,2548
+wrapt/decorators.py,sha256=ePWsg43Q5uHYSBGvbybwIZpsYdIhLGX9twbGZ7ygous,21091
+wrapt/importer.py,sha256=E16XxhomZuX5jM_JEH4ZO-MYpNou1t5RZLJHWLCtsgM,12135
+wrapt/patches.py,sha256=WJAKwOEeozpqgLAq_BlEu2HWbjMg9yaR65szi8J4GRQ,9907
+wrapt/proxies.py,sha256=0-N74mBM3tsC_zEQ83to3Y5OMqdxEu4BhXs3Hq1GDCU,12517
+wrapt/py.typed,sha256=la67KBlbjXN-_-DfGNcdOcjYumVpKG_Tkw-8n5dnGB4,8
+wrapt/weakrefs.py,sha256=5HehYcKOKsRIghxLwnCZ4EJ67rhc0z1GH__pRILRLDc,4630
+wrapt/wrappers.py,sha256=btpuNklFXdpnWlQVrgib1cY08M5tm1vTSd_XEjfEgxs,34439
+wrapt-2.0.1.dist-info/METADATA,sha256=nbszIjJc0vsh_DVij7b9ct6R9G2VCzVTTPSke5imlvs,8979
+wrapt-2.0.1.dist-info/WHEEL,sha256=4lZF3a-99kvbRXRFbWdTzxXghO36qYYRQD9SUY4TKXE,113
+wrapt-2.0.1.dist-info/top_level.txt,sha256=Jf7kcuXtwjUJMwOL0QzALDg2WiSiXiH9ThKMjN64DW0,6
+wrapt-2.0.1.dist-info/RECORD,,
+wrapt-2.0.1.dist-info/licenses/LICENSE,sha256=mrxBqmuGkMB-3ptEt8YjPQFCkO0eO1zMN-KSKVtdBY8,1304