usable 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: e6ce8a1897bd2183446ed294714d2dbb6bd4f1b3
-  data.tar.gz: 24de43ed69870b8a62906f04a1125db2ba1e84ff
+  metadata.gz: 012d85e8c84454e2b546f05763299d4157d768ac
+  data.tar.gz: 44c5faec64db7d6dcc843c97dbf04601b6900039
 SHA512:
-  metadata.gz: c2d8bd54e08e2c2b46450cb1dc916df6d5915bb526f52f7b50de6d6dcdc6940b19e7380160adc1cf70ec820f6b18110eff225069424dd8f3c815582041b42542
-  data.tar.gz: 663d86bd5095d61a06f639fcb7cf31aa35398c9239353f0418f6d3324c12ada5f8795daee2a89c5baa8ff44459b5a5522616caa251d363a10ac7a13000e61934
+  metadata.gz: e5b18af041a6be1df266076067657767c6dcdbb050c0a71e08cfcc348077966d0a86ffd6607d42ab6cab85e526b7fa1f23f65bc99925c49242f8d9031f39ae7d
+  data.tar.gz: 4297b9a8d18efe624a92a8a03859930f37a937a812f9cb2f662df7260c3036f385206431c28e322a753eb6dee34a26730beebe1ff7725d902937405267929218

data/.gitignore

@@ -7,4 +7,5 @@
 /pkg/
 /spec/reports/
 /tmp/
-*.gem
+*.gem
+.byebug_history

data/Gemfile

@@ -2,3 +2,6 @@ source 'https://rubygems.org'
 
 # Specify your gem's dependencies in usable.gemspec
 gemspec
+
+gem 'object_tracker'
+gem 'byebug'

data/lib/usable/config.rb

@@ -0,0 +1,15 @@
+module Usable
+  class Config < OpenStruct
+    def modules
+      @modules ||= []
+    end
+
+    def available_methods
+      modules.each_with_object({}) do |mod, result|
+        mod.instance_methods.each do |method_name|
+          result[method_name] = mod.instance_method method_name
+        end
+      end
+    end
+  end
+end

data/lib/usable/mod_extender.rb

@@ -0,0 +1,28 @@
+module Usable
+  class ModExtender
+    attr_accessor :copy, :mod, :config
+
+    def initialize(mod, config = OpenStruct.new)
+      @mod = mod
+      @copy = has_spec? ? mod.const_get(:Spec).dup : mod.dup
+      @config = config
+    end
+
+    def call
+      copy.prepend override
+    end
+
+    def override
+      unwanted = config.only ? copy.instance_methods - Array(config.only) : []
+      Module.new do
+        unwanted.each do |method_name|
+          define_method(method_name) { |*| }
+        end
+      end
+    end
+
+    def has_spec?
+      mod.const_defined?(:Spec)
+    end
+  end
+end

data/lib/usable/version.rb

@@ -1,3 +1,3 @@
 module Usable
-  VERSION = "0.2.0".freeze
+  VERSION = "0.3.0".freeze
 end

data/lib/usable.rb

@@ -1,61 +1,42 @@
 require "ostruct"
+require "delegate"
 require "usable/version"
 
 module Usable
+
+  autoload :ModExtender, 'usable/mod_extender'
+  autoload :Config, 'usable/config'
+
   def usable_config
     @usable_config ||= Config.new
   end
-
-  alias_method :config, :usable_config unless method_defined?(:config)
-
+  attr_writer :usable_config
+
+  # @description Configures the +available_methods+ of a module using the given options or block and then includes it on
+  #   the target class. Checks if there is a module named Spec within the given mods namespace and uses the instance of
+  #   methods of that as the +available_methods+
+  #
+  # @example
+  #
+  #   class Example
+  #     extend Usable
+  #     usable VersionKit, only: :save_version
+  #   end
+  #
+  # @note Hides methods
+  # @note We include the primary mod when there is a Spec set because any instance method defined on the mod are not
+  #   configurable and should therefore takes precedence over those defined in the Spec
   def usable(mod, options = {})
     options.each { |k, v| usable_config.public_send "#{k}=", v }
-    if block_given?
-      yield usable_config
-    end
-    wrapped_mod = spec(mod).dup
-    wrapped_mod.prepend build_null_mod(wrapped_mod)
-    usable_config.modules[mod] = wrapped_mod
-    if has_spec?(mod)
-      send :include, mod
-    else
-      send :include, usable_config.modules[mod]
-    end
-  end
-
-  # @description Stub out any "unwanted" methods
-  def build_null_mod(mod)
-    unwanted = usable_config.only ? mod.instance_methods - Array(usable_config.only) : []
-    Module.new do
-      unwanted.each do |method_name|
-        define_method(method_name) { |*| }
-      end
-    end
+    yield usable_config if block_given?
+    mod_ext = ModExtender.new mod, usable_config
+    usable! mod_ext.call
+    usable! mod if mod_ext.has_spec?
   end
 
-  def has_spec?(mod)
-    mod.const_defined?(:Spec)
-  end
-
-  def spec(mod)
-    if has_spec?(mod)
-      mod.const_get(:Spec)
-    else
-      mod
-    end
-  end
-
-  class Config < OpenStruct
-    def available_methods
-      modules.each_with_object({}) do |(_, mod_copy), result|
-        mod_copy.instance_methods.each do |method_name|
-          result[method_name] = mod_copy.instance_method method_name
-        end
-      end
-    end
-
-    def modules
-      @modules ||= {}
-    end
+  # @description Directly include a module whose methods you want made available in +usable_config.available_methods+
+  def usable!(mod)
+    usable_config.modules << mod
+    send :include, mod
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: usable
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Ryan Buckley
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2016-02-01 00:00:00.000000000 Z
+date: 2016-02-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -97,6 +97,8 @@ files:
 - bin/console
 - bin/setup
 - lib/usable.rb
+- lib/usable/config.rb
+- lib/usable/mod_extender.rb
 - lib/usable/scoped.rb
 - lib/usable/version.rb
 - usable.gemspec