modulation 0.20 → 0.21

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e540dd13f308e46a50219db2bafb9b72c692dfc04a43404dcddc85c6117c5f7b
-  data.tar.gz: 64de165287b53651385fb6e520f15d493e360599afb85c90ca90b91af1aa49e8
+  metadata.gz: 1d5bf725c036d3db2d9604cd161f6742c669c392ed09bdeb315a39fd343d4887
+  data.tar.gz: 655000532ad754fd550b913a38cc92adc790761d5b98b6b64a91ad9d1ec61664
 SHA512:
-  metadata.gz: 3b36c16543e39b4f00afe5129e80f430b56f757258b49785c7a22b6abed52896951b43a6fdc97397807bc95da188829622ff398dfbdcf7ea0e48e701aaa4ece6
-  data.tar.gz: ff3a3c843a5c2f5e2401fb55c16f19b39281d05acf71c4e1a9d5b7838e7de571be4c4e41657db438724709c768909a077a43d3aaac826689fa485c2ac05a65c3
+  metadata.gz: f50f8030beb0e9f009735763c183623f20869ff78f10ac592b2ce1d5de11f1168d8f64576801d117e7337f1cdc8d80845db70ede5f090480437f06a42d328e54
+  data.tar.gz: 437c524656fc62ee887ddf69e2a011b5984cd796bfeb0568afdd31296392930525a3752f200d2175deec41b6bbeceef308f0a8bd50609a8ef562f118e2296e1f

data/CHANGELOG.md

@@ -1,3 +1,8 @@
+0.21 2019-02-19
+---------------
+
+* Add support for list of symbols to import in `Kernel#include_from`
+
 0.20 2019-01-16
 ---------------
 

data/README.md

@@ -205,6 +205,16 @@ end
 5.seq(:fib)
 ```
 
+The `include_from` method accepts an optional list of symbols to import:
+
+```ruby
+class Integer
+  include_from './seq.rb', :fib
+end
+
+5.fib
+```
+
 ### Default exports
 
 A module may wish to expose just a single class or constant, in which case it 

data/lib/modulation/core.rb

@@ -56,6 +56,59 @@ module Modulation
       end
     end
 
+    # Adds all or part of a module's methods to a target object
+    # If no symbols are given, all methods are added
+    # @param mod [Module] imported module
+    # @param target [Object] object to add methods to
+    # @param symbols [Array<Symbol>] list of methods to add
+    # @return [void]
+    def add_module_methods(mod, target, *symbols)
+      methods = mod.singleton_class.instance_methods(false)
+      unless symbols.empty?
+        not_exported = symbols.select { |s| s =~ /^[a-z]/ } - methods
+        unless not_exported.empty?
+          raise NameError, "symbol #{not_exported.first.inspect} not exported"
+        end
+        methods = methods & symbols
+      end
+      methods.each do |sym|
+        target.send(:define_method, sym, &mod.method(sym))
+      end
+    end
+  
+    # Adds all or part of a module's constants to a target object
+    # If no symbols are given, all constants are added
+    # @param mod [Module] imported module
+    # @param target [Object] object to add constants to
+    # @param symbols [Array<Symbol>] list of constants to add
+    # @return [void]
+    def add_module_constants(mod, target, *symbols)
+      exported = mod.__module_info[:exported_symbols]
+      unless symbols.empty?
+        not_exported = symbols.select { |s| s =~ /^[A-Z]/ } - exported
+        unless not_exported.empty?
+          raise NameError, "symbol #{not_exported.first.inspect} not exported"
+        end
+        exported = exported & symbols
+      end
+      mod.singleton_class.constants(false).each do |sym|
+        next unless exported.include?(sym)
+        target.const_set(sym, mod.singleton_class.const_get(sym))
+      end
+    end
+
+    # Defines a const_missing method used for auto-importing on a given object
+    # @param receiver [Object] object to receive the const_missing method call
+    # @param auto_import_hash [Hash] a hash mapping constant names to a source
+    #   file and a caller location
+    # @return [void]
+    def define_auto_import_const_missing_method(receiver, auto_import_hash)
+      receiver.singleton_class.define_method(:const_missing) do |sym|
+        (path, caller_location) = auto_import_hash[sym]
+        path ? const_set(sym, import(path, caller_location)) : super
+      end
+    end
+  
     # Creates a new module from a source file
     # @param path [String] source file name
     # @return [Module] module

data/lib/modulation/ext.rb

@@ -28,7 +28,10 @@ class Module
   def auto_import(sym, path = nil, caller_location = caller(1..1).first)
     unless @__auto_import_registry
       a = @__auto_import_registry = {}
-      define_auto_import_const_missing_method(@__auto_import_registry)
+      Modulation.define_auto_import_const_missing_method(
+        self,
+        @__auto_import_registry
+      )
     end
     if path
       @__auto_import_registry[sym] = [path, caller_location]
@@ -42,40 +45,18 @@ class Module
   # @return [void]
   def extend_from(path)
     mod = import(path, caller(1..1).first)
-    add_module_methods(mod, self.class)
-    add_module_constants(mod, self)
+    Modulation.add_module_methods(mod, self.class)
+    Modulation.add_module_constants(mod, self)
   end
 
   # Includes exported methods from the given file name in the receiver
   # The module's methods will be available as instance methods
   # @param path [String] module filename
+  # @param symbols [Array<Symbol>] list of symbols to include
   # @return [void]
-  def include_from(path)
+  def include_from(path, *symbols)
     mod = import(path, caller(1..1).first)
-    add_module_methods(mod, self)
-    add_module_constants(mod, self)
-  end
-
-  private
-
-  def define_auto_import_const_missing_method(auto_import_hash)
-    singleton_class.define_method(:const_missing) do |sym|
-      (path, caller_location) = auto_import_hash[sym]
-      path ? const_set(sym, import(path, caller_location)) : super
-    end
-  end
-
-  def add_module_methods(mod, target)
-    mod.singleton_class.instance_methods(false).each do |sym|
-      target.send(:define_method, sym, &mod.method(sym))
-    end
-  end
-
-  def add_module_constants(mod, target)
-    exported_symbols = mod.__module_info[:exported_symbols]
-    mod.singleton_class.constants(false).each do |sym|
-      next unless exported_symbols.include?(sym)
-      target.const_set(sym, mod.singleton_class.const_get(sym))
-    end
+    Modulation.add_module_methods(mod, self, *symbols)
+    Modulation.add_module_constants(mod, self, *symbols)
   end
 end

data/lib/modulation/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Modulation
-  VERSION = '0.20'
+  VERSION = '0.21'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: modulation
 version: !ruby/object:Gem::Version
-  version: '0.20'
+  version: '0.21'
 platform: ruby
 authors:
 - Sharon Rosner
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-01-16 00:00:00.000000000 Z
+date: 2019-02-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: minitest