reverse-require 0.1.2 → 0.2.0

data/History.txt

@@ -1,3 +1,10 @@
+=== 0.2.0 / 2008-11-23
+
+* Use the new Gem.find_files method provided by RubyGems >= 1.3.0. Using
+  Gem.find_files in reverse_require has greatly decreased the executation
+  time of reverse_require.
+* Added the require_all method, which is an alias to reverse_require.
+
 === 0.1.2 / 2008-10-22
 
 * Fixed a bug where ReverseRequire.require_for would try to activate

data/Manifest.txt

@@ -1,10 +1,11 @@
 History.txt
 Manifest.txt
 README.txt
+TODO.txt
 Rakefile
 lib/reverse_require.rb
 lib/reverse_require/version.rb
+lib/reverse_require/exceptions.rb
+lib/reverse_require/exceptions/rubygems_version_exception.rb
 lib/reverse_require/extensions.rb
 lib/reverse_require/extensions/kernel.rb
-lib/reverse_require/gems.rb
-lib/reverse_require/reverse_require.rb

data/README.txt

@@ -1,29 +1,30 @@
 = ReverseRequire
 
 * http://reverserequire.rubyforge.org/
-* Postmodern Modulus III (postmodern.mod3@gmail.com)
+* Postmodern (postmodern.mod3 at gmail.com)
 
 == DESCRIPTION:
 
-reverse_require requires specific files from the gems which depend on a
-certain RubyGem and contain the specified path. Using reverse_require one
-can allow others to easily extend the functionality of a RubyGem. Simply add
-reverse_require into the code of your RubyGem:
+reverse_require will require all files ending with a specified path from
+within previously installed RubyGems. By using reverse_require in your
+code-base, it allows developers to extend the functionality of your
+code-base, by merely adding specially named files to their own RubyGems.
+Simply use reverse_require in the code-base that you'd like to be extendable:
 
-  reverse_require 'my_gem', 'some/path'
+  reverse_require 'some/path'
 
-Then other gems which depend upon +my_gem+ merely have to provide
-<tt>some/path</tt> within their <tt>lib/</tt> directory, and
-reverse_require will load them all at run-time. This ability makes
-designing plug-in systems for a RubyGem trivial.
+The <tt>some/path.rb</tt> files within the <tt>lib/</tt> directories of
+other RubyGems will then be loaded. This functionality makes designing
+plug-in systems ontop of RubyGems trivial.
 
 == FEATURES/PROBLEMS:
 
-* Require files from all the related gems of a RubyGem.
+* Require files ending with a specified path from previously installed
+  RubyGems.
 
 == REQUIREMENTS:
 
-* RubyGems
+* RubyGems >= 1.3.0
 
 == INSTALL:
 

data/Rakefile

@@ -6,7 +6,7 @@ require './lib/reverse_require/version.rb'
 
 Hoe.new('reverse-require', ReverseRequire::VERSION) do |p|
   p.rubyforge_name = 'reverserequire'
-  p.developer('Postmodern Modulus III','postmodern.mod3@gmail.com')
+  p.developer('Postmodern','postmodern.mod3@gmail.com')
   p.remote_rdoc_dir = ''
 end
 

data/TODO.txt

@@ -0,0 +1,2 @@
+== TODO:
+

data/lib/reverse_require.rb

@@ -1,3 +1,2 @@
-require 'reverse_require/reverse_require'
 require 'reverse_require/extensions'
 require 'reverse_require/version'

data/lib/reverse_require/exceptions.rb

@@ -0,0 +1 @@
+require 'reverse_require/exceptions/rubygems_version_exception'

data/lib/reverse_require/exceptions/rubygems_version_exception.rb

@@ -0,0 +1,4 @@
+module ReverseRequire
+  class RubyGemsVersionException < RuntimeError
+  end
+end

data/lib/reverse_require/extensions/kernel.rb

@@ -1,13 +1,35 @@
-require 'reverse_require/reverse_require'
+require 'reverse_require/exceptions/rubygems_version_exception'
 
 module Kernel
   #
-  # Requires certain files from the gems which depend on the
-  # specified _ruby_gem_ and contain the specified _sub_path_.
-  # If no gems contain the specified _sub_path_, +false+ will be
-  # returned.
+  # Requires all files from previously installed RubyGems that
+  # end with the specified _path_. If no RubyGems contain the
+  # specified _path_, +false+ will be returned.
   #
-  def reverse_require(ruby_gem,sub_path)
-    ReverseRequire.require_for(ReverseRequire.gems_of(ruby_gem),sub_path)
+  #   reverse_require 'ronin/models'
+  #   # => true
+  #
+  def reverse_require(path)
+    major, minor, rev = Gem::RubyGemsVersion.split('.').map { |i| i.to_i }
+
+    if (major == 1 && minor == 2)
+      raise(ReverseRequire::RubyGemsVersionException,"RubyGems >= 1.3.0 is required for reverse_require",caller)
+    end
+
+    was_loaded = false
+
+    Gem.find_files(path).reverse_each do |path|
+      begin
+        if File.file?(path)
+          was_loaded ||= require path
+        end
+      rescue
+        next
+      end
+    end
+
+    return was_loaded
   end
+
+  alias require_all reverse_require
 end

data/lib/reverse_require/version.rb

@@ -1,3 +1,3 @@
 module ReverseRequire
-  VERSION = '0.1.2'
+  VERSION = '0.2.0'
 end

metadata

@@ -1,15 +1,15 @@
 --- !ruby/object:Gem::Specification 
 name: reverse-require
 version: !ruby/object:Gem::Version 
-  version: 0.1.2
+  version: 0.2.0
 platform: ruby
 authors: 
-- Postmodern Modulus III
+- Postmodern
 autorequire: 
 bindir: bin
 cert_chain: []
 
-date: 2008-10-22 00:00:00 -07:00
+date: 2008-11-23 00:00:00 -08:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -20,9 +20,9 @@ dependencies:
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        version: 1.8.0
+        version: 1.8.2
     version: 
-description: "reverse_require requires specific files from the gems which depend on a certain RubyGem and contain the specified path. Using reverse_require one can allow others to easily extend the functionality of a RubyGem. Simply add reverse_require into the code of your RubyGem:  reverse_require 'my_gem', 'some/path'  Then other gems which depend upon +my_gem+ merely have to provide <tt>some/path</tt> within their <tt>lib/</tt> directory, and reverse_require will load them all at run-time. This ability makes designing plug-in systems for a RubyGem trivial."
+description: "reverse_require will require all files ending with a specified path from within previously installed RubyGems. By using reverse_require in your code-base, it allows developers to extend the functionality of your code-base, by merely adding specially named files to their own RubyGems. Simply use reverse_require in the code-base that you'd like to be extendable:  reverse_require 'some/path'  The <tt>some/path.rb</tt> files within the <tt>lib/</tt> directories of other RubyGems will then be loaded. This functionality makes designing plug-in systems ontop of RubyGems trivial."
 email: 
 - postmodern.mod3@gmail.com
 executables: []
@@ -33,17 +33,19 @@ extra_rdoc_files:
 - History.txt
 - Manifest.txt
 - README.txt
+- TODO.txt
 files: 
 - History.txt
 - Manifest.txt
 - README.txt
+- TODO.txt
 - Rakefile
 - lib/reverse_require.rb
 - lib/reverse_require/version.rb
+- lib/reverse_require/exceptions.rb
+- lib/reverse_require/exceptions/rubygems_version_exception.rb
 - lib/reverse_require/extensions.rb
 - lib/reverse_require/extensions/kernel.rb
-- lib/reverse_require/gems.rb
-- lib/reverse_require/reverse_require.rb
 has_rdoc: true
 homepage: http://reverserequire.rubyforge.org/
 post_install_message: 
@@ -67,9 +69,9 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: reverserequire
-rubygems_version: 1.3.0
+rubygems_version: 1.3.1
 signing_key: 
 specification_version: 2
-summary: reverse_require requires specific files from the gems which depend on a certain RubyGem and contain the specified path
+summary: reverse_require will require all files ending with a specified path from within previously installed RubyGems
 test_files: []
 

data/lib/reverse_require/gems.rb

@@ -1,147 +0,0 @@
-require 'rubygems'
-
-module ReverseRequire
-  class Gems
-
-    # Paths of the gems
-    attr_reader :paths
-
-    # Gem specifications
-    attr_reader :gem_specs
-
-    #
-    # Creates a new empty Gems object.
-    #
-    def initialize
-      @paths = []
-      @gem_specs = []
-    end
-
-    #
-    # Creates a new Gems object containing the gems which depend upon
-    # the RubyGem of the specified _name_.
-    #
-    def Gems.depending_on(name)
-      name = name.to_s
-      spec_dir = File.join(Gem.dir,'specifications')
-      gems = Gems.new
-
-      Gem::SourceIndex.from_installed_gems(spec_dir).each do |path,gem_spec|
-        deps = gem_spec.dependencies.map { |dep| dep.name }
-        
-        if deps.include?(name)
-          gem_path = File.expand_path(File.join(Gem.dir,'gems',path))
-
-          gems.enqueue(gem_path,gem_spec)
-        end
-      end
-
-      return gems
-    end
-
-    #
-    # Returns the number of paths and gem specs.
-    #
-    def length
-      return 0 if (@paths.empty? || @gem_specs.empty?)
-      return [@paths.length, @gem_specs.length].min
-    end
-
-    #
-    # Returns the gem spec with the specified gem _path_.
-    #
-    def [](path)
-      @gem_specs[@paths.index(path)]
-    end
-
-    #
-    # Adds the specified _gem_spec_ with the specified gem _path_.
-    #
-    def []=(path,gem_spec)
-      if @paths.include?(path)
-        @gem_specs[@paths.index(path)] = gem_spec
-      else
-        @paths << path
-        @gem_specs << gem_spec
-      end
-
-      return gem_spec
-    end
-
-    #
-    # Enqueues the specified _gem_spec_ with the specified gem _path_.
-    #
-    def enqueue(path,gem_spec)
-      if @paths.include?(path)
-        @gem_specs[@paths.index(path)] = gem_spec
-      else
-        @paths.unshift(path)
-        @gem_specs.unshift(gem_spec)
-      end
-
-      return self
-    end
-
-    #
-    # Iterates over each path and gem spec, passing each to the given
-    # _block_.
-    #
-    def each(&block)
-      length.times do |i|
-        block.call(@paths[i], @gem_specs[i])
-      end
-
-      return self
-    end
-
-    #
-    # Returns a new Gems object containing the names and paths from the
-    # gems which match the specified _block_.
-    #
-    def select(&block)
-      gems = self.class.new
-
-      each do |path,gem_spec|
-        if block.call(path,gem_spec)
-          gems[path] = gem_spec
-        end
-      end
-
-      return gems
-    end
-
-    #
-    # Invokes the given _block_ once for each name and path of the gems.
-    # Returns an +Array+ containing the values returned by the _block_.
-    # If no _block_ is given, an empty +Array+ will be returned.
-    #
-    def map(&block)
-      mapped = []
-
-      each do |path,gem_spec|
-        if block
-          mapped << block.call(path,gem_spec)
-        end
-      end
-
-      return mapped
-    end
-
-    #
-    # Returns a new Gems object containing the gems which contain the
-    # specified _sub_path_.
-    #
-    #   gems.with_path('some/path') # => {...}
-    #
-    def with_path(sub_path)
-      if File.extname(sub_path).empty?
-        sub_path += '.rb'
-      end
-
-      return select do |path,gem_spec|
-        File.exists?(File.expand_path(File.join(path,sub_path)))
-      end
-    end
-
-  end
-end

data/lib/reverse_require/reverse_require.rb

@@ -1,38 +0,0 @@
-require 'reverse_require/gems'
-
-module ReverseRequire
-  #
-  # Returns a new Gems object containing the gems which depend upon
-  # the RubyGem of the specified _name_.
-  #
-  def ReverseRequire.gems_of(name)
-    Gems.depending_on(name)
-  end
-
-  #
-  # Requires certain files from the _gems_ that contain the specified
-  # _sub_path_. If no gems contain the specified _sub_path_, +false+ will be
-  # returned.
-  #
-  def ReverseRequire.require_for(gems,sub_path)
-    lib_path = File.join('lib',sub_path)
-
-    was_loaded = gems.with_path(lib_path).map do |path,gem_spec|
-      activated = Gem.loaded_specs.any? do |active_path,activated_spec|
-        activated_spec.name == gem_spec.name &&
-          activated_spec.version != gem_spec.version
-      end
-
-      unless activated
-        begin
-          gem(gem_spec.name,gem_spec.version)
-          require File.expand_path(File.join(path,lib_path))
-        rescue Gem::Exception
-          next
-        end
-      end
-    end
-
-    return was_loaded.include?(true)
-  end
-end