class DuckPuncher::Duck
Attributes
Public Class Methods
@param target [String,Class] Class or module to punch @param mod [String,Module] The module that defines the extensions @param [Hash] options to modify the duck punch
method behavior @option options :only [Symbol, Array<Symbol>] list of methods to extend onto the target (the module must have these defined) @option options :method [Symbol,String] the method used to apply the module, e.g. :extend (:include) @option options :before [Proc] A hook that is called with the target class before punch
@option options :after [Proc] A hook that is called with the target class after punch
# File lib/duck_puncher/duck.rb, line 12 def initialize(target, mod, options = {}) @options = options @target = DuckPuncher.lookup_constant(target) @mod = DuckPuncher.lookup_constant(mod) end
Public Instance Methods
@param [Hash] opts to modify punch @option options :target [Class] Specifies the class to be punched (overrides @target) @option options :only [Array,Symbol] Specifies the methods to extend onto the current object @option options :method [Symbol,String] Specifies if the methods should be included or prepended (:include) @return [Class] The class that was just punched
# File lib/duck_puncher/duck.rb, line 23 def call(opts = {}) opts = options.merge(opts) targets = Array(opts[:target] || self.target) targets.each do |target| opts[:before].call(target) if opts[:before] punches = Array(opts[:only] || Ducks::Module.instance_method(:local_methods).bind(mod).call) unless target.is_a?(::Module) fail ArgumentError, "Invalid target #{target}. Please pass a module as :target" end DuckPuncher.logger.info %Q(#{target}#{" <-- #{mod.name}#{punches}" if punches.any?}) extender = Usable::ModExtender.new(mod, only: opts.delete(:only), method: opts.delete(:method)) extender.call target opts[:after].call(target) if opts[:after] end targets end