fancy_require 1.0

data/.autotest

@@ -0,0 +1,8 @@
+# -*- ruby -*-
+
+require 'autotest/restart'
+
+Autotest.add_hook :initialize do |at|
+  at.testlib = 'minitest/unit'
+end
+

data/History.txt

@@ -0,0 +1,6 @@
+=== 1.0 / 2010-08-20
+
+* Major enhancement
+
+  * Birthday!
+

data/Manifest.txt

@@ -0,0 +1,8 @@
+.autotest
+History.txt
+Manifest.txt
+README.txt
+Rakefile
+lib/fancy_require.rb
+test/lookup/toad.rb
+test/test_fancy_require.rb

data/README.txt

@@ -0,0 +1,46 @@
+= fancy_require
+
+* http://seattlerb.rubyforge.org/fancy_require
+
+== DESCRIPTION:
+
+Perform fancy requiring by adding a custom object to the load path.  This
+allows you to escape the harsh strictures directory-based lookup provided by
+$LOAD_PATH.
+
+== SYNOPSIS:
+
+See FancyRequire
+
+== REQUIREMENTS:
+
+None
+
+== INSTALL:
+
+  gem install fancy_require
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2010 Eric Hodel
+
+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,15 @@
+# -*- ruby -*-
+
+require 'rubygems'
+require 'hoe'
+
+Hoe.spec 'fancy_require' do
+  developer 'Eric Hodel', 'drbrain@segment7.net'
+
+  self.testlib = :minitest
+  self.rubyforge_name = 'seattlerb'
+
+  extra_dev_deps << ['minitest', '~> 1.5']
+end
+
+# vim: syntax=Ruby

data/lib/fancy_require.rb

@@ -0,0 +1,118 @@
+require 'rubygems'
+
+##
+# FancyRequire allows you to push an object onto $LOAD_PATH that will find
+# files to load.  You can use this to implement fancier require behavior
+# without overriding Kernel#require.
+#
+# The lookup object you push onto $LOAD_PATH must respond to #path_for.  The
+# feature being required (file name) will be passed in by FancyRequire.
+#
+# The lookup object must return the path to the feature, true, false or nil.
+#
+# If nil is returned FancyRequire will continue to search down the load path.
+#
+# If true or false are returned the lookup object handled loading the file and
+# recording it in $LOADED_FEATURES.  The boolean will be returned as plain
+# require.
+#
+# == Example
+#
+# The easiest way to use FancyRequire is to require it everywhere (which
+# includes it in Object):
+#
+#   require 'fancy_require/everywhere'
+#
+# Then create a LookUp object and add it to the load path.  This LookUp object
+# looks in a 'lookup' directory under the current path.
+#
+#   class LookUp
+#     def initialize directory
+#       @directory = directory
+#     end
+#
+#     def path_for feature
+#       Dir["#{Dir.pwd}/#{directory}/lookup/#{feature}{#{FancyRequire::SUFFIX_GLOB}}"].first
+#     end
+#   end
+#
+#   $LOAD_PATH.unshift LookUp.new 'test'
+#
+# Then require works like normal.
+#
+#   require 'toad' # looks for ./test/lookup/toad.rb
+
+module FancyRequire
+
+  ##
+  # The version of FancyRequire you're using... not that I know why you're
+  # using FancyRequire
+
+  VERSION = '1.0'
+
+  ##
+  # Dir#glob list of ruby file suffixes
+
+  SUFFIX_GLOB = Gem.suffixes.join ','
+
+  ##
+  # Regexp list of ruby file suffixes
+
+  SUFFIX_RE = Regexp.union Gem.suffixes
+
+  ##
+  # Replacement for Kernel#require
+  #
+  # NOTE: this method is not 100% compatible with ruby
+
+  def require feature
+    return false if loaded? feature # 1.8
+
+    path = nil
+
+    $LOAD_PATH.each do |obj|
+      path = case obj
+             when String then
+               Dir["#{obj}/#{feature}{#{FancyRequire::SUFFIX_GLOB}}"].find do |item|
+                 File.file? item
+               end
+             else
+               obj.path_for feature
+             end
+
+      case path
+      when true, false
+        return path
+      else
+        break if path
+      end
+    end
+
+    raise LoadError, "no such file to load -- #{feature}" unless path
+
+    return false if loaded? path # 1.9
+
+    load path
+
+    if RUBY_VERSION > '1.9' then
+      $LOADED_FEATURES << path
+    else
+      $LOADED_FEATURES << File.basename(path)
+    end
+
+    true
+  end
+
+  ##
+  # Is +feature+ already in $LOADED_FEATURES?
+  #
+  # NOTE: this method is not 100% compatible with ruby
+
+  def loaded? feature
+    $LOADED_FEATURES.any? do |path|
+      path =~ /^#{feature}#{SUFFIX_RE}$/
+    end
+  end
+
+end
+

data/test/test_fancy_require.rb

@@ -0,0 +1,65 @@
+require "minitest/autorun"
+require "fancy_require"
+
+class LookUp
+
+  def path_for feature
+    case feature
+    when 'true'  then true
+    when 'false' then false
+    when 'nil'   then nil
+    else
+      Dir["#{Dir.pwd}/test/lookup/#{feature}{#{FancyRequire::SUFFIX_GLOB}}"].first
+    end
+  end
+
+end
+
+class TestFancyRequire < MiniTest::Unit::TestCase
+
+  include FancyRequire
+
+  def setup
+    @loaded_features = $LOADED_FEATURES.dup
+    @load_path = $LOAD_PATH.dup
+  end
+
+  def teardown
+    $LOADED_FEATURES.replace @loaded_features
+    $LOAD_PATH.replace @load_path
+  end
+
+  def test_require
+    $LOAD_PATH.unshift LookUp.new
+
+    assert require 'toad'
+
+    assert_match %r%toad\.rb$%, $LOADED_FEATURES.last
+  end
+
+  def test_require_false
+    $LOAD_PATH.unshift LookUp.new
+
+    assert_equal false, require('false')
+
+    refute_match %r%false$%, $LOADED_FEATURES.last
+  end
+
+  def test_require_nil
+    $LOAD_PATH.unshift LookUp.new
+
+    assert_raises LoadError do
+      require 'nil'
+    end
+  end
+
+  def test_require_true
+    $LOAD_PATH.unshift LookUp.new
+
+    assert_equal true, require('true')
+
+    refute_match %r%true$%, $LOADED_FEATURES.last
+  end
+
+end
+

metadata

@@ -0,0 +1,147 @@
+--- !ruby/object:Gem::Specification 
+name: fancy_require
+version: !ruby/object:Gem::Version 
+  hash: 15
+  prerelease: false
+  segments: 
+  - 1
+  - 0
+  version: "1.0"
+platform: ruby
+authors: 
+- Eric Hodel
+autorequire: 
+bindir: bin
+cert_chain: 
+- |
+  -----BEGIN CERTIFICATE-----
+  MIIDNjCCAh6gAwIBAgIBADANBgkqhkiG9w0BAQUFADBBMRAwDgYDVQQDDAdkcmJy
+  YWluMRgwFgYKCZImiZPyLGQBGRYIc2VnbWVudDcxEzARBgoJkiaJk/IsZAEZFgNu
+  ZXQwHhcNMDcxMjIxMDIwNDE0WhcNMDgxMjIwMDIwNDE0WjBBMRAwDgYDVQQDDAdk
+  cmJyYWluMRgwFgYKCZImiZPyLGQBGRYIc2VnbWVudDcxEzARBgoJkiaJk/IsZAEZ
+  FgNuZXQwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCbbgLrGLGIDE76
+  LV/cvxdEzCuYuS3oG9PrSZnuDweySUfdp/so0cDq+j8bqy6OzZSw07gdjwFMSd6J
+  U5ddZCVywn5nnAQ+Ui7jMW54CYt5/H6f2US6U0hQOjJR6cpfiymgxGdfyTiVcvTm
+  Gj/okWrQl0NjYOYBpDi+9PPmaH2RmLJu0dB/NylsDnW5j6yN1BEI8MfJRR+HRKZY
+  mUtgzBwF1V4KIZQ8EuL6I/nHVu07i6IkrpAgxpXUfdJQJi0oZAqXurAV3yTxkFwd
+  g62YrrW26mDe+pZBzR6bpLE+PmXCzz7UxUq3AE0gPHbiMXie3EFE0oxnsU3lIduh
+  sCANiQ8BAgMBAAGjOTA3MAkGA1UdEwQCMAAwCwYDVR0PBAQDAgSwMB0GA1UdDgQW
+  BBS5k4Z75VSpdM0AclG2UvzFA/VW5DANBgkqhkiG9w0BAQUFAAOCAQEAHagT4lfX
+  kP/hDaiwGct7XPuVGbrOsKRVD59FF5kETBxEc9UQ1clKWngf8JoVuEoKD774dW19
+  bU0GOVWO+J6FMmT/Cp7nuFJ79egMf/gy4gfUfQMuvfcr6DvZUPIs9P/TlK59iMYF
+  DIOQ3DxdF3rMzztNUCizN4taVscEsjCcgW6WkUJnGdqlu3OHWpQxZBJkBTjPCoc6
+  UW6on70SFPmAy/5Cq0OJNGEWBfgD9q7rrs/X8GGwUWqXb85RXnUVi/P8Up75E0ag
+  14jEc90kN+C7oI/AGCBN0j6JnEtYIEJZibjjDJTSMWlUKKkj30kq7hlUC2CepJ4v
+  x52qPcexcYZR7w==
+  -----END CERTIFICATE-----
+
+date: 2010-08-27 00:00:00 +09:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rubyforge
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 7
+        segments: 
+        - 2
+        - 0
+        - 4
+        version: 2.0.4
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: minitest
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 5
+        segments: 
+        - 1
+        - 5
+        version: "1.5"
+  type: :development
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: hoe
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 21
+        segments: 
+        - 2
+        - 6
+        - 1
+        version: 2.6.1
+  type: :development
+  version_requirements: *id003
+description: |-
+  Perform fancy requiring by adding a custom object to the load path.  This
+  allows you to escape the harsh strictures directory-based lookup provided by
+  $LOAD_PATH.
+email: 
+- drbrain@segment7.net
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- History.txt
+- Manifest.txt
+- README.txt
+files: 
+- .autotest
+- History.txt
+- Manifest.txt
+- README.txt
+- Rakefile
+- lib/fancy_require.rb
+- test/lookup/toad.rb
+- test/test_fancy_require.rb
+has_rdoc: true
+homepage: http://seattlerb.rubyforge.org/fancy_require
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --main
+- README.txt
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: seattlerb
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Perform fancy requiring by adding a custom object to the load path
+test_files: 
+- test/test_fancy_require.rb

metadata.gz.sig

@@ -0,0 +1,2 @@
+QK�����%����!]�܏T���V�j\���v�[�L��E9G�ۜ
�$p��lo���Jn��Ata���C�RE�r™�;���.	�(Zp%������m�  3���iM]*vcA���\KM`��,�`�+"�@�G[kK�\�6�!ɖ�4HX�!��]
����Nz�D
+�D$g�q�<�u�#�#C��APZ��l�|�