micheles/decorator
Decorator
The project is a Python metaprogramming toolkit designed to build signature-preserving function decorators, generic dispatch functions, and context managers without losing metadata. It provides utilities for constructing custom function wrappers and converting generator functions or context managers into reusable decorators that automatically wrap execution blocks.
The library supports multi-argument generic function dispatch by routing calls based on runtime argument types and virtual base classes, complete with abstract base class and virtual ancestor resolution. It also includes capabilities for asynchronous coroutine decoration, class-to-decorator conversion, parameterized decorator factories, and upgrading third-party or legacy implementations to retain original function signatures, docstrings, and annotations.
Additional features encompass dynamic function generation tools for programmatically building new functions with custom names, signatures, and body templates at runtime. It also provides resource access state management wrappers that block execution or return alternative messages when target resources are unavailable.
Features
- Function Decorators - Builds custom Python function decorators that preserve original signatures, docstrings, and metadata without complex closure patterns.
- Asynchronous Coroutine Decorators - Decorates asynchronous coroutine functions while preserving their execution semantics and inspection compatibility.
- Generator Context Transformers - Converts generator functions and context managers into signature-preserving decorators that wrap execution blocks.
- Function Signatures - Retains original function signatures, docstrings, annotations, and metadata across decorated functions for accurate runtime introspection.
- Generic - Maintains a lookup table of specialized implementations supporting inheritance hierarchies and virtual base classes.
- Python Decorator Libraries - Provides utilities for building signature-preserving function decorators, generic dispatch functions, and context managers without losing metadata.
- Multi-Argument Dispatchers - Routes function calls to specialized implementations based on the runtime types of multiple positional arguments.
- Metaprogramming - Constructs and transforms functions dynamically at runtime with custom names, signatures, and annotations for advanced metaprogramming tasks.
- Multi-Argument Generic Dispatches - Dispatches function calls to specialized implementations based on the runtime types of chosen function arguments, supporting virtual base classes.
- Python Generic Function Dispatchers - Implements generic functions in Python that route execution based on the runtime types of one or more arguments.
- Runtime Type Dispatching - Routes function calls to specialized implementations dynamically by evaluating the runtime types of specified positional arguments.
- Generator-to-Context Converters - Transforms generator functions into context managers that act as signature-preserving execution decorators.
- Context Manager Function Wrappers - Converts Python generator functions and context managers into signature-preserving decorators that automatically wrap execution blocks.
- Reusable Function Wrappers - Defines reusable function wrappers that alter or enhance the behavior of target functions without modifying source code.
- Signature Metadata Propagations - Copies original docstrings, annotations, and parameter specifications directly onto wrapper functions to maintain tool inspection compatibility.
- Class-Based Decorators - Transforms class definitions into callable decorators that instantiate the class or execute logic when applied to target functions.
- Decorator Factories - Constructs parameterized decorator factories that accept configuration arguments for flexible function modification.
- Dynamic Function Generators - Constructs new functions programmatically at runtime with custom names, signatures, and body templates for advanced metaprogramming tasks.
- Context Managers - Provides a metaprogramming toolkit that converts generator functions and context managers into reusable signature-preserving function decorators.
Star history
How this analysis was created: This summary and feature list were written by an AI model that read the project's README and public documentation pages. Each feature links to the documentation it came from; stars, license and language come straight from the GitHub API. The model does not read the source code, and the analysis is refreshed when the project is re-analysed. Learn more on our About page.
