rdp-require_all 1.1.0.1

data/CHANGES

@@ -0,0 +1,13 @@
+1.1.0:
+
+* Add require_rel (require_all relative to the current file)
+* Fix bug in auto-appending .rb ala require
+
+1.0.1:
+
+* Allow require_all to take a directory name as an argument
+
+1.0.0:
+
+* Initial release (was originally load_glob, converted to require_all which is
+  a lot cooler, seriously trust me)

data/LICENSE

@@ -0,0 +1,58 @@
+Ruby is copyrighted free software by Yukihiro Matsumoto <matz@netlab.co.jp>.
+You can redistribute it and/or modify it under either the terms of the GPL
+(see COPYING.txt file), or the conditions below:
+
+  1. You may make and give away verbatim copies of the source form of the
+     software without restriction, provided that you duplicate all of the
+     original copyright notices and associated disclaimers.
+
+  2. You may modify your copy of the software in any way, provided that
+     you do at least ONE of the following:
+
+       a) place your modifications in the Public Domain or otherwise
+          make them Freely Available, such as by posting said
+	  modifications to Usenet or an equivalent medium, or by allowing
+	  the author to include your modifications in the software.
+
+       b) use the modified software only within your corporation or
+          organization.
+
+       c) rename any non-standard executables so the names do not conflict
+	  with standard executables, which must also be provided.
+
+       d) make other distribution arrangements with the author.
+
+  3. You may distribute the software in object code or executable
+     form, provided that you do at least ONE of the following:
+
+       a) distribute the executables and library files of the software,
+	  together with instructions (in the manual page or equivalent)
+	  on where to get the original distribution.
+
+       b) accompany the distribution with the machine-readable source of
+	  the software.
+
+       c) give non-standard executables non-standard names, with
+          instructions on where to get the original software distribution.
+
+       d) make other distribution arrangements with the author.
+
+  4. You may modify and include the part of the software into any other
+     software (possibly commercial).  But some files in the distribution
+     are not written by the author, so that they are not under this terms.
+
+     They are gc.c(partly), utils.c(partly), regex.[ch], st.[ch] and some
+     files under the ./missing directory.  See each file for the copying
+     condition.
+
+  5. The scripts and library files supplied as input to or produced as 
+     output from the software do not automatically fall under the
+     copyright of the software, but belong to whomever generated them, 
+     and may be sold commercially, and may be aggregated with this
+     software.
+
+  6. THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR
+     IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
+     WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+     PURPOSE.
+

data/README.textile

@@ -0,0 +1,83 @@
+h1. require_all
+
+A wonderfully simple way to load your code.
+
+Tired of futzing around with require statements everywhere, littering your code
+with <code>require File.dirname(__FILE__)</code> crap?  What if you could just 
+point something at a big directory full of code and have everything just 
+automagically load regardless of the dependency structure?  
+
+Wouldn't that be nice?  Well, now you can!
+
+ <code>require 'require_all'</code>
+
+You can use require_all in a multitude of different ways.
+
+The easiest way to use require_all is to just point it at a directory
+containing a bunch of .rb files:
+
+ <code>require_all 'lib'</code>
+
+This will find all the .rb files under the lib directory (including all 
+subdirectories as well) and load them.
+
+The proper order to in which to load them is determined automatically.  If the 
+dependencies between the matched files are unresolvable, it will throw the 
+first unresolvable NameError.
+
+You can also give it a glob, which will enumerate all the matching files: 
+
+ <code>require_all 'lib/**/*.rb'</code>
+
+It will also accept an array of files:
+
+ <code>require_all Dir.glob("blah/**/*.rb").reject { |f| stupid_file? f }</code>
+ 
+Or if you want, just list the files directly as arguments:
+
+ <code>require_all 'lib/a.rb', 'lib/b.rb', 'lib/c.rb', 'lib/d.rb'</code>
+
+Still have the require File.dirname(__FILE__) blues?  The require_all gem also
+provides a require_rel statement which requires files to relative to the 
+current file.  So you can replace statements like:
+
+ <code>require File.dirname(__FILE__) + '/foobar'</code>
+
+with just a simple require_rel:
+
+ <code>require_rel 'foobar'</code>
+ 
+Even better, require_rel still has the full power of require_all, so you can
+use require_rel to load entire directories of code too.  If "foobar" is a
+directory this will load all the .rb files found under that directory with
+automagic dependency handling.
+ 
+It's just that easy!  Code loading shouldn't be hard.
+
+h2. Methodology
+
+I didn't invent the approach this gem uses.  It was shamelessly stolen from
+Merb (which apparently stole it from elsewhere).  Here's how it works:  
+
+# Enumerate the files to be loaded
+# Try to load all of the files.  If we encounter a NameError loading a 
+  particular file, store that file in a "try to load it later" list.
+# If all the files loaded, great, we're done!  If not, go through the
+  "try to load it later" list again rescuing NameErrors the same way.
+# If we walk the whole "try to load it later" list and it doesn't shrink
+  at all, we've encountered an unresolvable dependency.  In this case,
+  require_all will rethrow the first NameError it encountered.
+
+h2. Questions? Comments? Concerns?
+
+You can reach the author on github or freenode: "tarcieri"
+
+Or by email: "tony@medioh.com":mailto:tony@medioh.com
+
+Got issues with require_all to report?  Post 'em here:
+
+"Github Tracker":http://github.com/tarcieri/require_all/issues
+
+h2. License
+
+MIT (see the LICENSE file for details)

data/Rakefile

@@ -0,0 +1,12 @@
+require 'rake'
+require 'rake/clean'
+
+Dir['tasks/**/*.rake'].each { |task| load task }
+
+task :default => :spec
+
+task :clean do
+  %w[pkg coverage].each do |dir|
+    rm_rf dir
+  end
+end

data/lib/require_all.rb

@@ -0,0 +1,140 @@
+#--
+# Copyright (C)2009 Tony Arcieri
+# You can redistribute this under the terms of the MIT license
+# See file LICENSE for details
+#++
+
+module RequireAll
+  # A wonderfully simple way to load your code.
+  #
+  # The easiest way to use require_all is to just point it at a directory
+  # containing a bunch of .rb files.  These files can be nested under 
+  # subdirectories as well:
+  #
+  #  require_all 'lib'
+  #
+  # This will find all the .rb files under the lib directory and load them.
+  # The proper order to load them in will be determined automatically.
+  #
+  # If the dependencies between the matched files are unresolvable, it will 
+  # throw the first unresolvable NameError.
+  #
+  # You can also give it a glob, which will enumerate all the matching files: 
+  #
+  #  require_all 'lib/**/*.rb'
+  #
+  # It will also accept an array of files:
+  #
+  #  require_all Dir.glob("blah/**/*.rb").reject { |f| stupid_file(f) }
+  # 
+  # Or if you want, just list the files directly as arguments:
+  #
+  #  require_all 'lib/a.rb', 'lib/b.rb', 'lib/c.rb', 'lib/d.rb'
+  #
+  def require_all(*args)
+    # Handle passing an array as an argument
+    args.flatten!
+    
+    if args.size > 1
+      # Expand files below directories
+      files = args.map do |path|
+        if File.directory? path
+          Dir[File.join(path, '**', '*.rb')]
+        else
+          path
+        end
+      end.flatten
+    else
+      arg = args.first
+      begin
+        # Try assuming we're doing plain ol' require compat
+        stat = File.stat(arg)
+        
+        if stat.file?
+          files = [arg]
+        elsif stat.directory?
+          files = Dir.glob File.join(arg, '**', '*.rb')
+        else
+          raise ArgumentError, "#{arg} isn't a file or directory"
+        end
+      rescue Errno::ENOENT
+        # If the stat failed, maybe we have a glob!
+        files = Dir.glob arg
+        
+        # Maybe it's an .rb file and the .rb was omitted
+        if File.file?(arg + '.rb')
+          require(arg + '.rb')
+          return true
+        end
+        
+        # If we ain't got no files, the glob failed
+        raise LoadError, "no such file to load -- #{arg}" if files.empty?
+      end
+    end
+
+    # If there's nothing to load, you're doing it wrong!
+    raise LoadError, "no files to load" if files.empty?
+    
+    files.map! { |file| File.expand_path file }
+    files.sort!
+            
+    begin
+      failed = []
+      first_name_error = nil
+      
+      # Attempt to load each file, rescuing which ones raise NameError for
+      # undefined constants.  Keep trying to successively reload files that 
+      # previously caused NameErrors until they've all been loaded or no new
+      # files can be loaded, indicating unresolvable dependencies.
+      files.each do |file|
+        begin
+          require file
+        rescue NameError => ex
+          failed << file
+          first_name_error ||= ex
+        rescue ArgumentError => ex
+          # Work around ActiveSuport freaking out... *sigh*
+          #
+          # ActiveSupport sometimes throws these exceptions and I really
+          # have no idea why.  Code loading will work successfully if these
+          # exceptions are swallowed, although I've run into strange 
+          # nondeterministic behaviors with constants mysteriously vanishing.
+          # I've gone spelunking through dependencies.rb looking for what 
+          # exactly is going on, but all I ended up doing was making my eyes 
+          # bleed.
+          #
+          # FIXME: If you can understand ActiveSupport's dependencies.rb 
+          # better than I do I would *love* to find a better solution
+          raise unless ex.message["is not missing constant"]
+          
+          STDERR.puts "Warning: require_all swallowed ActiveSupport 'is not missing constant' error"
+          STDERR.puts ex.backtrace[0..9]
+        end
+      end
+      
+      # If this pass didn't resolve any NameErrors, we've hit an unresolvable
+      # dependency, so raise one of the exceptions we encountered.
+      if failed.size == files.size
+        raise first_name_error
+      else
+        files = failed
+      end
+    end until failed.empty?
+    
+    true
+  end
+  
+  # Works like require_all, but paths are relative to the caller rather than 
+  # the current working directory
+  def require_rel(*paths)
+    # Handle passing an array as an argument
+    paths.flatten!
+    
+    source_directory = File.dirname caller.first.sub(/:\d+$/, '')
+    paths.each do |path|
+      require_all File.join(source_directory, path)
+    end
+  end
+end
+
+include RequireAll

data/require_all.gemspec

@@ -0,0 +1,26 @@
+require 'rubygems'
+
+GEMSPEC = Gem::Specification.new do |s|
+  s.name = "rdp-require_all"
+  s.version = "1.1.0.1"
+  s.authors = "Tony Arcieri"
+  s.email = "tony@medioh.com"
+  s.date = "2009-07-18"
+  s.summary = "A wonderfully simple way to load your code"
+  s.platform = Gem::Platform::RUBY
+
+  # Gem contents
+  s.files = Dir.glob("{lib,spec}/**/*") + ['Rakefile', 'require_all.gemspec']
+
+  # RubyForge info
+  s.homepage = "http://github.com/tarcieri/require_all"
+  s.rubyforge_project = "codeforpeople"
+
+  # RDoc settings
+  s.has_rdoc = true
+  s.rdoc_options = %w(--title require_all --main README.textile --line-numbers)
+  s.extra_rdoc_files = ["LICENSE", "README.textile", "CHANGES"]
+
+  # Extensions
+  s.extensions = FileList["ext/**/extconf.rb"].to_a
+end

data/spec/fixtures/relative/a.rb

@@ -0,0 +1,2 @@
+class RelativeA
+end

data/spec/fixtures/relative/b/b.rb

@@ -0,0 +1,5 @@
+require_rel '../a'
+require_rel '../c'
+
+class RelativeB
+end

data/spec/fixtures/relative/c/c.rb

@@ -0,0 +1,2 @@
+class RelativeC
+end

data/spec/fixtures/resolvable/a.rb

@@ -0,0 +1 @@
+class A < C; end

data/spec/fixtures/resolvable/b.rb

@@ -0,0 +1 @@
+class B < A; end

data/spec/fixtures/resolvable/c.rb

@@ -0,0 +1 @@
+class C; end

data/spec/fixtures/resolvable/d.rb

@@ -0,0 +1 @@
+class D < C; end

data/spec/fixtures/unresolvable/a.rb

@@ -0,0 +1 @@
+class A < C; end

data/spec/fixtures/unresolvable/b.rb

@@ -0,0 +1 @@
+class B < A; end

data/spec/fixtures/unresolvable/c.rb

@@ -0,0 +1 @@
+class C < Nonexistent; end

data/spec/fixtures/unresolvable/d.rb

@@ -0,0 +1 @@
+class D < C; end

data/spec/require_all_spec.rb

@@ -0,0 +1,57 @@
+require File.dirname(__FILE__) + '/../lib/require_all.rb'
+
+describe "require_all" do    
+  describe "dependency resolution" do
+    it "handles load ordering when dependencies are resolvable" do
+      require_all File.dirname(__FILE__) + '/fixtures/resolvable/*.rb'
+    
+      defined?(A).should == "constant"
+      defined?(B).should == "constant"
+      defined?(C).should == "constant"
+      defined?(D).should == "constant"
+    end
+  
+    it "raises NameError if dependencies can't be resolved" do
+      proc do 
+        require_all File.dirname(__FILE__) + '/fixtures/unresolvable/*.rb'
+      end.should raise_error(NameError)
+    end
+  end
+  
+  describe "syntactic sugar" do
+    before :each do
+      @base_dir = File.dirname(__FILE__) + '/fixtures/resolvable'
+      @file_list = ['b.rb', 'c.rb', 'a.rb', 'd.rb'].map { |f| "#{@base_dir}/#{f}" }   
+    end
+    
+    it "works like a drop-in require replacement" do
+      require_all(@base_dir + '/c').should be_true
+    end
+    
+    it "accepts lists of files" do
+      require_all(@file_list).should be_true
+    end
+    
+    it "is totally cool with a splatted list of arguments" do
+      require_all(*@file_list).should be_true
+    end
+    
+    it "will load all .rb files under a directory without a trailing slash" do
+      require_all(@base_dir).should be_true
+    end
+    
+    it "will load all .rb files under a directory with a trailing slash" do
+      require_all("#{@base_dir}/").should be_true
+    end
+  end
+end
+
+describe "require_rel" do
+  it "provides require_all functionality relative to the current file" do
+    require File.dirname(__FILE__) + '/fixtures/relative/b/b'
+    
+    defined?(RelativeA).should == "constant"
+    defined?(RelativeB).should == "constant"
+    defined?(RelativeC).should == "constant"
+  end
+end

metadata

@@ -0,0 +1,78 @@
+--- !ruby/object:Gem::Specification 
+name: rdp-require_all
+version: !ruby/object:Gem::Version 
+  version: 1.1.0.1
+platform: ruby
+authors: 
+- Tony Arcieri
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-07-18 00:00:00 -06:00
+default_executable: 
+dependencies: []
+
+description: 
+email: tony@medioh.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.textile
+- CHANGES
+files: 
+- lib/require_all.rb
+- spec/fixtures/relative/a.rb
+- spec/fixtures/relative/b/b.rb
+- spec/fixtures/relative/c/c.rb
+- spec/fixtures/resolvable/a.rb
+- spec/fixtures/resolvable/b.rb
+- spec/fixtures/resolvable/c.rb
+- spec/fixtures/resolvable/d.rb
+- spec/fixtures/unresolvable/a.rb
+- spec/fixtures/unresolvable/b.rb
+- spec/fixtures/unresolvable/c.rb
+- spec/fixtures/unresolvable/d.rb
+- spec/require_all_spec.rb
+- Rakefile
+- require_all.gemspec
+- LICENSE
+- README.textile
+- CHANGES
+has_rdoc: true
+homepage: http://github.com/tarcieri/require_all
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --title
+- require_all
+- --main
+- README.textile
+- --line-numbers
+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: codeforpeople
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: A wonderfully simple way to load your code
+test_files: []
+