modulation 0.19 → 0.20

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 213cf5d64fdb238b965b7c625c0bc513da79cc9866c52c4051c02bc309c93eec
-  data.tar.gz: fffb3da5ee7f10934e6386da7fa01611934ba217ee6df33a6e6d6f7715148352
+  metadata.gz: e540dd13f308e46a50219db2bafb9b72c692dfc04a43404dcddc85c6117c5f7b
+  data.tar.gz: 64de165287b53651385fb6e520f15d493e360599afb85c90ca90b91af1aa49e8
 SHA512:
-  metadata.gz: 11c410d6b8eacff67ba95484189121e7d6488c88e3a2278e4fa6b241f341a17c5dd5a4c281809567e321a6d2933d0fd519685b890eb0419d8db2e4b4aed60a5c
-  data.tar.gz: c0f58c853854d576325b9fdf45b9dba78d69cf8e373807b6d656733fd7d4192673eb3bdf6cb6ccce8b33ae131b3c70ac2f98da1d00fa0625fe2d55fcc686338e
+  metadata.gz: 3b36c16543e39b4f00afe5129e80f430b56f757258b49785c7a22b6abed52896951b43a6fdc97397807bc95da188829622ff398dfbdcf7ea0e48e701aaa4ece6
+  data.tar.gz: ff3a3c843a5c2f5e2401fb55c16f19b39281d05acf71c4e1a9d5b7838e7de571be4c4e41657db438724709c768909a077a43d3aaac826689fa485c2ac05a65c3

data/CHANGELOG.md

@@ -1,3 +1,8 @@
+0.20 2019-01-16
+---------------
+
+* Add import_all method
+
 0.19 2019-01-05
 ---------------
 

data/README.md

@@ -82,6 +82,7 @@ easy to understand.
 - Can be used to [write gems](#writing-gems-using-modulation).
 - Facilitates [unit-testing](#unit-testing-modules) of private methods and
   constants.
+- Can load all source files in directory at once.
 
 ## Installing Modulation
 
@@ -171,6 +172,39 @@ user = User.new(...)
 > **Note about paths**: module paths are always relative to the file
 > calling the `import` method, just like `require_relative`.
 
+### Importing all source files in a directory
+
+To load all source files in a directory you can use `import_all`:
+
+```ruby
+import_all('./ext') # will load ./ext/kernel, ./ext/socket etc 
+```
+
+### Importing methods into classes and modules
+
+Modulation provides the `extend_from` and `include_from` methods to include
+imported methods in classes and modules:
+
+```ruby
+module Sequences
+  extend_from('./seq.rb')
+end
+
+Sequences.fib(5)
+
+# extend integers
+require 'modulation'
+class Integer
+  include_from('./seq.rb')
+
+  def seq(kind)
+    send(kind, self)
+  end
+end
+
+5.seq(:fib)
+```
+
 ### Default exports
 
 A module may wish to expose just a single class or constant, in which case it 
@@ -210,31 +244,6 @@ config = import('./config')
 db.connect(config[:host], config[:port])
 ```
 
-### Importing methods into classes and modules
-
-Modulation provides the `extend_from` and `include_from` methods to include
-imported methods in classes and modules:
-
-```ruby
-module Sequences
-  extend_from('./seq.rb')
-end
-
-Sequences.fib(5)
-
-# extend integers
-require 'modulation'
-class Integer
-  include_from('./seq.rb')
-
-  def seq(kind)
-    send(kind, self)
-  end
-end
-
-5.seq(:fib)
-```
-
 ### Accessing a module's root namespace from nested modules within itself
 
 The special constant `MODULE` allows you to access the containing module from

data/lib/modulation/core.rb

@@ -45,6 +45,17 @@ module Modulation
       end
     end
 
+    # Imports all source files in given directory
+    # @ param path [String] relative directory path
+    # @param caller_location [String] caller location
+    # @return [Array] array of module objects
+    def import_all(path, caller_location = caller(1..1).first)
+      abs_path = Paths.absolute_dir_path(path, caller_location)
+      Dir["#{abs_path}/**/*.rb"].map do |fn|
+        @loaded_modules[fn] || create_module_from_file(fn)
+      end
+    end
+
     # Creates a new module from a source file
     # @param path [String] source file name
     # @return [Module] module

data/lib/modulation/ext.rb

@@ -2,13 +2,21 @@
 
 # Kernel extensions
 module Kernel
-  # Returns an encapsulated imported module.
+  # Imports a module
   # @param path [String] module file name
   # @param caller_location [String] caller location
-  # @return [Class] module facade
+  # @return [Module] module object
   def import(path, caller_location = caller(1..1).first)
     Modulation.import(path, caller_location)
   end
+
+  # Imports all modules in given directory
+  # @param path [String] directory path
+  # @param caller_location [String] caller location
+  # @return [Array] array of module objects
+  def import_all(path, caller_location = caller(1..1).first)
+    Modulation.import_all(path, caller_location)
+  end
 end
 
 # Module extensions

data/lib/modulation/paths.rb

@@ -20,6 +20,18 @@ module Modulation
         check_path(path)
       end
 
+      # Computes and verifies the absolute directory path
+      # @param path String] unqualified path
+      # @param caller_location [String] caller location
+      # @return [String] absolute directory path
+      def absolute_dir_path(path, caller_location)
+        caller_file = caller_location[CALLER_FILE_REGEXP, 1]
+        return nil unless caller_file
+
+        path = File.expand_path(path, File.dirname(caller_file))
+        File.directory?(path) ? path : (raise "Invalid directory #{path}")
+      end
+
       # Checks that the given path references an existing file, adding the .rb
       # extension if needed
       # @param path [String] absolute file path (with/without .rb extension)

data/lib/modulation/version.rb

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

metadata

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