'Turn functions and methods into fully controllable objects'


Keywords
ring, methodtools, hack, method
License
BSD-1-Clause
Install
pip install wirerope==0.4.6

Documentation

wirerope

The concepts:

  • :class:`wirerope.rope.WireRope` is a wrapper interface for python callable.
  • Custom :class:`wirerope.wire.Wire` class provides user-defined behavior. A subclass of this class is working similar to a decorator function body.
  • A wire object is associated with a bound method.
  • Rope is dispatching types.

:class:`wirerope.rope.WireRope` is the wrapper for callables. By wrapping a function with WireRope with a custom subclass of the :class:`wirerope.wire.Wire` class, the wire object will be created by each function or bound method.

Wire is the most important part. The given class will be instantiated and bound to each function or bound method - which fits the concept of instance cmethod of human. For example, when f is a free function or staticmethod, the wire also will be a single object. When f is a method or property, wires will be created for each method owner object self. When f is a classmethod, wires will be created for each method owner class cls. Yes, it will detect the owner and bound to it regardless of the calling type.

Rope is internal dispatcher. It will be helpful when creating a complex object for decorated callable instead of simple callable feature.

See also