Contents

module Usable
  class ModExtender
    SPEC = :UsableSpec
    CLASS_MODULE = :ClassMethods

    attr_reader :name
    attr_accessor :copy, :mod, :options, :unwanted

    def initialize(mod, options = {})
      @mod = mod
      @options = options
      @options[:method] ||= :include
      if has_spec?
        @copy = mod.const_get SPEC
        @name = "#{mod.name}UsableSpec"
      else
        @copy = mod
        @name = mod.name
      end
      @unwanted = options[:only] ? @copy.instance_methods - Array(options[:only]) : []
      if @unwanted.any?
        @copy = @copy.dup
      end
    end

    # @note Destructive, as it changes @copy
    def override
      unwanted.each do |method_name|
        copy.send :remove_method, method_name
      end
    end

    # @description Directly include a module whose methods you want made available in +usable_config.available_methods+
    #   Gives the module a name when including so that it shows up properly in the list of ancestors
    def use!(target)
      override
      if copy.name.nil?
        const_name = "#{mod_name}Used"
        target.send :remove_const, const_name if target.const_defined? const_name, false
        target.const_set const_name, copy
      end
      target.usable_config.modules << copy
      target.send options[:method], copy
    end

    # @description Includes or prepends the original module onto the target
    def use_original!(target)
      return unless has_spec?
      target.usable_config.modules << mod
      target.send options[:method], mod
    end

    # @description Extends the target with the module's ClassMethod mod
    def use_class_methods!(target)
      return unless mod.const_defined? CLASS_MODULE
      target.extend mod.const_get CLASS_MODULE
    end

    def has_spec?
      mod.const_defined? SPEC
    end

    def mod_name
      if name
        name.split('::').last
      else
        "UsableMod#{Time.now.strftime('%s')}"
      end
    end
  end
end

Version data entries

1 entries across 1 versions & 1 rubygems

Version	Path
usable-1.4.0	lib/usable/mod_extender.rb