loadable 1.2.0

data/.ruby

@@ -0,0 +1,51 @@
+---
+authors:
+- name: Thomas Sawyer
+  email: transfire@gmail.com
+copyrights:
+- holder: Thomas Sawyer, RubyWorks
+  year: '2010'
+  license: BSD-2-Clause
+replacements: []
+conflicts: []
+requirements:
+- name: detroit
+  groups:
+  - build
+  development: true
+- name: minitest
+  groups:
+  - test
+  development: true
+- name: minitap
+  groups:
+  - test
+  development: true
+- name: rake
+  groups:
+  - build
+  development: true
+dependencies: []
+repositories:
+- uri: git://github.com/rubyworks/loadable.git
+  scm: git
+  name: upstream
+resources:
+  home: http://rubyworks.github.com/loadable
+  code: http://github.com/rubyworks/loadable
+load_path:
+- lib
+extra: {}
+source:
+- Profile
+alternatives: []
+revision: 0
+created: '2010-07-21'
+summary: Safely Customize Ruby's Load System
+title: Loadable
+name: loadable
+version: 1.2.0
+description: Loadable modifieds Ruby's load/require system to handle "load wedges",
+  which work much like routes in web frameworks, but in this case determine which
+  files get loaded.
+date: '2011-10-17'

data/.yardopts

@@ -0,0 +1,6 @@
+--protected
+--private
+lib/
+-
+[A-Z]*.*
+log/[A-Z].*

data/COPYING.rdoc

@@ -0,0 +1,31 @@
+= COPYRIGHT NOTICES
+
+== Load System
+
+Copyright:: (c) 2010 Rubyworks, Thomas Sawyer
+License:: BSD-2-Clause
+Wedsite:: http://rubyworks.github.com/wedge
+
+    Copyright 2010 Rubyworks, Thomas Sawyer. All rights reserved.
+
+    Redistribution and use in source and binary forms, with or without modification, are
+    permitted provided that the following conditions are met:
+
+       1. Redistributions of source code must retain the above copyright notice, this list of
+          conditions and the following disclaimer.
+
+       2. Redistributions in binary form must reproduce the above copyright notice, this list
+          of conditions and the following disclaimer in the documentation and/or other materials
+          provided with the distribution.
+
+    THIS SOFTWARE IS PROVIDED BY <COPYRIGHT HOLDER> ``AS IS'' AND ANY EXPRESS OR IMPLIED
+    WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
+    FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL <COPYRIGHT HOLDER> OR
+    CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+    CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+    SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+    ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+    NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
+    ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+    (http://www.spdx.org/licenses/BSD-2-Clause)

data/HISTORY.rdoc

@@ -0,0 +1,46 @@
+= RELEASE HISTORY
+
+== 1.2.0 / 2011-10-15
+
+This release brings an almost complete rewrite of the API and
+a renaming of the project form 'wedge' to 'loadable'. See the
+API documentaiton for details.
+
+Changes:
+
+* Rewrite API almost entirely.
+* Rename project from 'wedge' to 'loadable'.
+* Utilize mixin rather than sublcass for loader classes.
+* OriginalLoader handles Ruby's default load mechanism.
+* New VendorLoader to support development.
+
+
+== 1.1.0 / 2011-07-03
+
+The Ruby wedge is no longer automatuically loaded when using
+`require "wedge"`. Load it manually loaded with `require "wedge/ruby`".
+
+Changes:
+
+* Ruby wedge is not automatically loaded with wedge library.
+
+
+== 1.0.0 / 2010-09-03
+
+This release is simply a maintenance release, updating some project metadata.
+No functionality has been changed.
+
+Changes:
+
+* Uupdate project metadata to latest POM.
+
+
+== 1.0.0 / 2010-08-01
+
+Initial release of Wedge, a tool for easily creating custom
+load managers.
+
+Changes:
+
+* Happy Brithday!
+

data/INFRACTIONS.rdoc

@@ -0,0 +1,401 @@
+= INFRACTIONS
+
+One of the rarely mentioned edge cases with the way in which RubyGems loads
+library files, and in fact the way Ruby's load system works in general, is
+that the _lib space_ is a free for all. Any library can drop any file into
+their package's loadpath (i.e. the lib/ directory) and potentially clobber
+a file of the same name in some one else's library.
+
+Here's an example irb session that demonstrate the issue. Here I already added
+a `matrix.rb` file, the did nothing but <code>puts "HERE!"</code>, to the +cuts+
+gem and installed it.
+
+   require 'rubygems'
+   => true 
+   gem "cuts"
+   => true 
+   require 'matrix'
+   HERE!
+   => true 
+
+Now, a good <i>gem citizen</i> knows to put their scripts in a directory with
+the same name as their gem package, nonetheless you might be surprised to see
+how often this simple but important practice is violated.
+Consequently the order in which such gems are searched becomes of
+paramount importance --something that worked just fine on one machine can
+suddenly stop working on another for no obvious reason.
+
+
+== ISOLATIONISTS
+
+It is also worth noting that the recent crop of gem isolation systems, such as
+Bundler and Isolate, while serving to reduce the likelihood of possible name
+clashes still do not fully remedy the issue. They merely reduce the number to
+gems that could cause the problem for any given dependent application.
+
+
+== SOLUTION
+
+The Ruby and Gem wedges solves the issue entirely by allowing us to load files
+from a single gem and only that gem. It does so by adding a new valid syntax
+to Ruby's #load and #require methods. As an example, let's say we wanted to
+load the troff.rb script from the unroller library.
+
+  require 'unroller:troff'
+
+The colon is used to separate the gem name from the rest of the pathname.
+With this we can be 100% certain that the troff.rb file was required
+from the unroller gem and not a 'troff.rb' file from any other
+gem that might have created a script by the same name.
+
+
+== EXTENT OF THE ISSUE
+
+You might be suprised to find out how many libraries violate the best practice
+of putting all thier scripts in a subdirectory by the same name as the package.
+Just on my development system alone, which really has but a small number of
+gems installed, there are quite a few cases.
+
+ParseTree-2.2.0/lib/:
+
+  composite_sexp_processor.rb
+  parse_tree.rb
+  sexp.rb
+  sexp_processor.rb
+  unified_ruby.rb
+  unique.rb
+
+ParseTree-3.0.3/lib/:
+
+  gauntlet_parsetree.rb
+  parse_tree.rb
+  parse_tree_extensions.rb
+  unified_ruby.rb
+  unique.rb
+
+RedCloth-4.1.9/lib/:
+
+  case_sensitive_require
+  redcloth
+  redcloth.rb
+  redcloth_scan.so
+
+RedCloth-4.2.2/lib/:
+
+  case_sensitive_require
+  redcloth
+  redcloth.rb
+  redcloth_scan.so
+  tasks
+
+ZenTest-4.0.0/lib/:
+  autotest
+  autotest.rb
+  focus.rb
+  functional_test_matrix.rb
+  multiruby.rb
+  unit_diff.rb
+  zentest.rb
+  zentest_mapping.rb
+
+bossman-0.4.1/lib/:
+
+  bossman
+  bossman.rb
+  extensions
+
+builder-2.1.2/lib/:
+
+  blankslate.rb
+  builder
+  builder.rb
+
+chardet-0.9.0/lib/:
+
+  Big5Freq.rb
+  Big5Prober.rb
+  CharDistributionAnalysis.rb
+  CharSetGroupProber.rb
+  CharSetProber.rb
+  CodingStateMachine.rb
+  ESCSM.rb
+  EUCJPProber.rb
+  EUCKRFreq.rb
+  EUCKRProber.rb
+  EUCTWFreq.rb
+  EUCTWProber.rb
+  EscCharSetProber.rb
+  GB2312Freq.rb
+  GB2312Prober.rb
+  HebrewProber.rb
+  JISFreq.rb
+  JapaneseContextAnalysis.rb
+  LangBulgarianModel.rb
+  LangCyrillicModel.rb
+  LangGreekModel.rb
+  LangHebrewModel.rb
+  LangHungarianModel.rb
+  LangThaiModel.rb
+  Latin1Prober.rb
+  MBCSGroupProber.rb
+  MBCSSM.rb
+  MultiByteCharSetProber.rb
+  SBCSGroupProber.rb
+  SJISProber.rb
+  SingleByteCharSetProber.rb
+  UTF8Prober.rb
+  UniversalDetector.rb
+
+eventmachine-0.12.10/lib/:
+
+  em
+  eventmachine.rb
+  evma
+  evma.rb
+  fastfilereaderext.so
+  jeventmachine.rb
+  pr_eventmachine.rb
+  rubyeventmachine.so
+
+grosser-parallel-0.3.1/lib/:
+
+  parallel.rb
+
+hpricot-0.8.1/lib/:
+
+  fast_xs.so
+  hpricot
+  hpricot.rb
+  hpricot_scan.so
+
+html5-0.10.0/lib/:
+
+  core_ext
+  html5
+  html5.rb
+
+http_router-0.2.5/lib/:
+
+  ext
+  http_router
+  http_router.rb
+
+httpclient-2.1.5.2/lib/:
+
+  http-access2
+  http-access2.rb
+  httpclient
+  httpclient.rb
+  tags
+
+linecache-0.43/lib/:
+
+  linecache.rb
+  trace_nums.so
+  tracelines.rb
+
+liquid-2.0.0/lib/:
+
+  extras
+  liquid
+  liquid.rb
+
+mail-2.2.5/lib/:
+
+  VERSION
+  mail
+  mail.rb
+  mail.rbc
+  tasks
+
+maruku-0.5.9/lib/:
+
+  maruku
+  maruku.rb
+  sort_prof.rb
+
+mechanize-0.9.3/lib/:
+
+  mechanize.rb
+  www
+
+memcache-client-1.7.8/lib/:
+
+  continuum_native.rb
+  memcache.rb
+  memcache_util.rb
+
+mocha-0.9.8/lib/:
+
+  mocha
+  mocha.rb
+  mocha_standalone.rb
+  stubba.rb
+
+packr-3.1.0/lib/:
+
+  packr
+  packr.rb
+  string.rb
+
+qed-2.3.0/lib/:
+
+  qed
+  qed.rb
+  qedoc
+
+quality_extensions-1.1.6/lib/:
+
+  Xfind_bug_test.rb
+  quality_extensions
+  quality_extensions.rb
+
+radiant-0.8.2/lib/:
+
+  annotatable.rb
+  autotest
+  generators
+  inheritable_class_attributes.rb
+  local_time.rb
+  login_system.rb
+  method_observer.rb
+  plugins
+  radiant
+  radiant.rb
+  simpleton.rb
+  task_support.rb
+  tasks
+
+rails-2.3.5/lib/:
+
+  code_statistics.rb
+  commands
+  commands.rb
+  console_app.rb
+  console_sandbox.rb
+  console_with_helpers.rb
+  dispatcher.rb
+  fcgi_handler.rb
+  initializer.rb
+  performance_test_help.rb
+  rails
+  rails_generator
+  rails_generator.rb
+  railties_path.rb
+  ruby_version_check.rb
+  rubyprof_ext.rb
+  source_annotation_extractor.rb
+  tasks
+  test_help.rb
+  webrick_server.rb
+
+railties-3.0.0.beta/lib/:
+
+  generators
+  rails
+  rails.rb
+
+ramaze-2010.01/lib/:
+
+  proto
+  ramaze
+  ramaze.rb
+  vendor
+
+rdiscount-1.3.5/lib/:
+
+  markdown.rb
+  rdiscount.rb
+  rdiscount.so
+
+red-3.5.0/lib/:
+
+  javascripts
+  red
+  red.rb
+
+red-4.1.7/lib/:
+
+  red
+  red.rb
+  source
+
+rmagick-2.12.2/lib/:
+
+  RMagick.rb
+  RMagick2.so
+  rvg
+
+ruby-prof-0.7.3/lib/:
+
+  ruby-prof
+  ruby-prof.rb
+  ruby_prof.so
+  unprof.rb
+
+ruby_parser-2.0.4/lib/:
+
+  gauntlet_rubyparser.rb
+  ruby_lexer.rb
+  ruby_parser.rb
+  ruby_parser.y
+  ruby_parser_extras.rb
+
+rubygems-update-1.3.7/lib/:
+
+  gauntlet_rubygems.rb
+  rbconfig
+  rubygems
+  rubygems.rb
+  ubygems.rb
+
+s3sync-1.2.5/lib/:
+
+  HTTPStreaming.rb
+  S3.rb
+  S3_s3sync_mod.rb
+  S3encoder.rb
+  s3config.rb
+  s3try.rb
+  thread_generator.rb
+  version.rb
+
+sexp_processor-3.0.1/lib/:
+
+  composite_sexp_processor.rb
+  sexp.rb
+  sexp_processor.rb
+
+sexp_processor-3.0.3/lib/:
+
+  composite_sexp_processor.rb
+  sexp.rb
+  sexp_processor.rb
+  unique.rb
+
+slim_scrooge-1.0.5/lib/:
+
+  callsite_hash.so
+  slim_scrooge
+  slim_scrooge.rb
+
+treetop-1.2.4/lib/:
+
+  metagrammar.rb
+  treetop
+  treetop.rb
+
+unroller-1.0.0/lib/:
+
+  troff.rb
+  tron.rb
+  unroller.rb
+
+xcb-0.0.1/lib/:
+
+  directory_monitor.rb
+  extreme_continuous_builder.rb
+  notifiers.rb
+  stacking_config.rb
+  xcb_command.rb
+