reverse-require 0.1.0

data/History.txt

@@ -0,0 +1,9 @@
+=== 0.1.0 / 2008-04-24
+
+* Fixed a bug where the paths of RubyGems were not being saved, preventing
+  reverse_require from properly loading files from gems.
+
+=== 0.0.9 / 2008-04-13
+
+* Initial release.
+

data/Manifest.txt

@@ -0,0 +1,10 @@
+History.txt
+Manifest.txt
+README.txt
+Rakefile
+lib/reverse_require.rb
+lib/reverse_require/version.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

@@ -0,0 +1,55 @@
+= ReverseRequire
+
+* http://reverserequire.rubyforge.org/
+* Postmodern Modulus III (postmodern.mod3@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 '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.
+
+== FEATURES/PROBLEMS:
+
+* Require files from all the related gems of a RubyGem.
+
+== REQUIREMENTS:
+
+* RubyGems
+
+== INSTALL:
+
+  $ sudo gem install reverserequire
+
+== LICENSE:
+
+The MIT License
+
+Copyright (c) 2008 Hal Brodigan
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/Rakefile

@@ -0,0 +1,13 @@
+# -*- ruby -*-
+
+require 'rubygems'
+require 'hoe'
+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.remote_rdoc_dir = ''
+end
+
+# vim: syntax=Ruby

data/lib/reverse_require.rb

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

data/lib/reverse_require/extensions.rb

@@ -0,0 +1 @@
+require 'reverse_require/extensions/kernel'

data/lib/reverse_require/extensions/kernel.rb

@@ -0,0 +1,13 @@
+require 'reverse_require/reverse_require'
+
+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.
+  #
+  def reverse_require(ruby_gem,sub_path)
+    ReverseRequire.require_for(ReverseRequire.gems_of(ruby_gem),sub_path)
+  end
+end

data/lib/reverse_require/gems.rb

@@ -0,0 +1,76 @@
+require 'rubygems'
+
+module ReverseRequire
+  class Gems < Hash
+    #
+    # Creates a new Gems object containing the gems which depend upon
+    # the RubyGem of the specified _name_.
+    #
+    def self.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[gem_path] = gem_spec
+        end
+      end
+
+      return gems
+    end
+
+    #
+    # Returns a new Gems object containing the names and paths from the
+    # gems which match the specified _block_.
+    #
+    def select(&block)
+      gems = Gems.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
+
+      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

@@ -0,0 +1,27 @@
+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|
+      gem(gem_spec.name,gem_spec.version)
+      require File.expand_path(File.join(path,lib_path))
+    end
+
+    return was_loaded.include?(true)
+  end
+end

data/lib/reverse_require/version.rb

@@ -0,0 +1,3 @@
+module ReverseRequire
+  VERSION = '0.1.0'
+end

metadata

@@ -0,0 +1,75 @@
+--- !ruby/object:Gem::Specification 
+name: reverse-require
+version: !ruby/object:Gem::Version 
+  version: 0.1.0
+platform: ruby
+authors: 
+- Postmodern Modulus III
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-10-02 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: hoe
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.7.0
+    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."
+email: 
+- postmodern.mod3@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- History.txt
+- Manifest.txt
+- README.txt
+files: 
+- History.txt
+- Manifest.txt
+- README.txt
+- Rakefile
+- lib/reverse_require.rb
+- lib/reverse_require/version.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: 
+rdoc_options: 
+- --main
+- README.txt
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: reverserequire
+rubygems_version: 1.2.0
+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
+test_files: 
+- test/test_agates.rb