Python's function decorators for Ruby.
gem install method_decorators
Using a decorator
Extend MethodDecorators in a class where you want to use them, and then stick
+DecoratorName before your method declaration to decorate the method.
class Math extend MethodDecorators +MethodDecorators::Memoized def fib(n) if n <= 1 1 else fib(n - 1) * fib(n - 2) end end end
You can also decorate with an instance of a decorator, rather than the class. This is useful for configuring specific options for the decorator.
class ExternalService extend MethodDecorators +MethodDecorators::Retry.new(3) def request ... end end
You can also set multiple decorators for your methods. Each decorator executes within the previously declared decorator. i.e. they are nested, as expected to be.
class ExternalService extend MethodDecorators +MethodDecorators::Retry.new(3) +MethodDecorators::Within.new(2.seconds) def request ... end end
Include these with
require 'method_decorators/name_of_decorator', or all at once with
- Memoize - caches the result of the method for each arg combination it's called with
- Retry - retries the method up to n (passed in to the constructor) times if the method errors
- Within - times outs if a request doesn't complete within n seconds
- Precondition - raises an error if the precondition (passed as a block) is not met
Defining a decorator
class Transactional < MethodDecorators::Decorator def call(wrapped, this, *args, &blk) ActiveRecord::Base.transaction do wrapped.call(*args, &blk) end end end
MethodDecorators is available under the MIT license and is freely available for all use, including personal, commercial, and academic. See LICENSE for details.