wrapt

2.1.2 · active · verified Sat Mar 28

wrapt is a Python module designed for decorators, wrappers, and monkey patching. It emphasizes correctness and transparency, ensuring that decorators preserve introspectability and function signatures. The current version is 2.1.2, with a release cadence that reflects active maintenance and updates.

Warnings

breaking In Python 3.13, the behavior of @classmethod.__get__() was reverted to its pre-3.9 state, affecting decorators applied inside @classmethod.
Fix: Apply decorators outside of @classmethod to ensure correct behavior.
gotcha Using a decorated class with super() requires accessing the original wrapped class to avoid issues.
Fix: Use super(OriginalClass, self).__init__() instead of super().__init__() within decorated classes.
gotcha Deriving from a decorated class necessitates using the original wrapped class as the base to prevent inheritance issues.
Fix: Use Base.__wrapped__ as the base class when deriving from a decorated class.
gotcha Using issubclass() on abstract classes decorated with wrapt can raise TypeError due to Python's handling of abstract base classes.
Fix: Avoid using issubclass() on decorated abstract classes or access the original class using __wrapped__.
gotcha Uninstalling wrapt improperly can lead to Python runtime errors, especially if other packages depend on it.
Fix: Ensure wrapt is reinstalled correctly if uninstallation causes issues, particularly when other packages rely on it.

Install

pip install wrapt Install wrapt

Imports

decorator
```
from wrapt import decorator
```
The correct import is directly from wrapt; importing from wrapt.decorators is incorrect.

Quickstart

This example demonstrates creating a simple pass-through decorator using wrapt.

import wrapt

@wrapt.decorator
def pass_through(wrapped, instance, args, kwargs):
    return wrapped(*args, **kwargs)

@pass_through
def function():
    print("Function executed")

function()

view raw JSON →