usable 1.3.0 → 1.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: e880dacf65e19267ebe16ba66d5ec85759f8e17d
-  data.tar.gz: 7bd498ea658d2cff0b13207a27d98df96e740442
+  metadata.gz: 25b327952ba8a139e5c81f640b5d7100f6daabf5
+  data.tar.gz: 234c99e407ef28df46bb024a8656e5a1bce5c19b
 SHA512:
-  metadata.gz: 8b4f4ce971e0f34b25190b69f67c1df97fe6e9b8ce1960d4ce10b2ec5e988f1b74187a0ef9882553be2a4aedd179220534d8e822a0f57c1d5cd068a1862e824f
-  data.tar.gz: fd4f4fdf322c535abea6f95d50ac02dcf3731f3aaa153b12729d2d37acd50b0ee04dca8432132c0adc083760b482e4f42cd081cd9dbc7ea4fc9684034752d017
+  metadata.gz: ed4caf302df5b5f543f31ab9e15bae983d6366ee4c07a71eed728551e6bc22a5d96a1d25eaef5f54e9c513c0195b6773f72f2c044ee1fc49ae2fd3db81e8300d
+  data.tar.gz: b0232a418c5b063d47671ce3944ae6bb4dbbda93d3c278f32474e4595620bdb7ec9ebd8ea3c49cc11738e27d1865e96e068d6a6018c798f99435a9bb0c1f83db

data/README.md

@@ -92,17 +92,24 @@ end
 
 class Example
   extend Usable
-  usable Mixin, only: [:name, :from_spec]
+  usable Mixin
 end
 
 Example.new.from_spec   # => "can be excluded"
 Example.new.from_mixin  # => "always here"
 Example.new.name        # => "defined by Mixin"
-Example.ancestors       # => [Example, Mixin, Example::MixinUsableSpecUsed, Object, Kernel, BasicObject] (ruby -v 2.3.0)
+Example.ancestors       # => [Example, Mixin, Mixin::UsableSpec, Object, Kernel, BasicObject] (ruby -v 2.3.0)
 ```
 
-Notice that Usable assigns the modified module to a constant with the same name as the given module, but with "Used" appended.
-The main module and the spec were both included, but `Mixin` was not modified, so it didn't need a new name.
+## Notes
+
+If the given module is modified by the `:only` option, then Usable will duplicate the module so that it doesn't mutate
+it globally. Duplicating a module returns an anonymous module. But anonymous mods in the ancestor list can be confusing.
+So Usable gives the modified module a name, which is the same name as the original module but with "Used" appended.
+
+```ruby
+Mixin => MixinUsed
+```
 
 ## Installation
 

data/bin/console

@@ -62,7 +62,8 @@ end
 
 class Example
   extend Usable
-  usable Mixin, only: [:name, :from_spec]
+  usable Mixin
+  usable VersionMixin, max_versions: 10
 end
 
 Model.usable PersistenceOverride, method: 'prepend'

data/lib/usable/mod_extender.rb

@@ -1,29 +1,27 @@
 module Usable
   class ModExtender
     attr_reader :name
-    attr_accessor :copy, :mod, :options
+    attr_accessor :copy, :mod, :options, :unwanted
 
     def initialize(mod, options = {})
       @mod = mod
       @options = options
       @options[:method] ||= :include
       if has_spec?
-        @copy = mod.const_get(:UsableSpec).dup
+        @copy = mod.const_get(:UsableSpec)
         @name = "#{mod.name}UsableSpec"
       else
-        @copy = mod.dup
+        @copy = mod
         @name = mod.name
       end
+      @unwanted = options[:only] ? @copy.instance_methods - Array(options[:only]) : []
+      if @unwanted.any?
+        @copy = @copy.dup
+      end
     end
 
-    def call
-      override
-      copy
-    end
-
-    # @note Destructive, as it changes the dup'd mod
+    # @note Destructive, as it changes @copy
     def override
-      unwanted = options[:only] ? copy.instance_methods - Array(options[:only]) : []
       unwanted.each do |method_name|
         copy.send :remove_method, method_name
       end
@@ -32,10 +30,12 @@ module Usable
     # @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)
-      const_name = "#{mod_name}Used"
       override
-      target.send :remove_const, const_name if target.const_defined? const_name, false
-      target.const_set const_name, copy
+      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

data/lib/usable/version.rb

@@ -1,3 +1,3 @@
 module Usable
-  VERSION = "1.3.0".freeze
+  VERSION = "1.3.1".freeze
 end

data/usable.gemspec

@@ -10,7 +10,7 @@ Gem::Specification.new do |spec|
   spec.email         = ["arebuckley@gmail.com"]
 
   spec.summary       = %q{Mounts and configures modules}
-  spec.description   = %q{A simple way to mount and configure your modules. Usable gives you control over which methods are included.}
+  spec.description   = %q{An elegant way to mount and configure your modules. Usable gives you control over which methods are included.}
   spec.homepage      = "https://github.com/ridiculous/usable"
   spec.license       = "MIT"
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: usable
 version: !ruby/object:Gem::Version
-  version: 1.3.0
+  version: 1.3.1
 platform: ruby
 authors:
 - Ryan Buckley
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2016-02-24 00:00:00.000000000 Z
+date: 2016-03-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -58,8 +58,8 @@ dependencies:
     - - "<"
       - !ruby/object:Gem::Version
         version: '4'
-description: A simple way to mount and configure your modules. Usable gives you control
-  over which methods are included.
+description: An elegant way to mount and configure your modules. Usable gives you
+  control over which methods are included.
 email:
 - arebuckley@gmail.com
 executables: []