pluginfactory 1.0.7 → 1.0.8

data/spec/pluginfactory_spec.rb

@@ -10,7 +10,7 @@ BEGIN {
 	$LOAD_PATH.unshift( libdir ) unless $LOAD_PATH.include?( libdir )
 }
 
-require 'spec'
+require 'rspec'
 require 'logger'
 require 'pluginfactory'
 
@@ -32,7 +32,6 @@ end
 
 
 describe PluginFactory do
-	include PluginFactory::SpecHelpers
 
 	before( :each ) do
 		setup_logging( :fatal )
@@ -55,11 +54,11 @@ describe PluginFactory do
 
 	it "doesn't error when its log method is called if no logging callback is set" do
 		PluginFactory.logger_callback = nil
-		lambda { PluginFactory.log.debug("msg") }.should_not raise_error()
+		expect { PluginFactory.log.debug("msg") }.to_not raise_error()
 	end
 
 
-	describe "-extended class" do
+	context "-extended class" do
 
 		it "knows about all of its derivatives" do
 			Plugin.derivatives.keys.should include( 'sub' )
@@ -85,19 +84,23 @@ describe PluginFactory do
 				end
 			end
 
+			exception = nil
 			begin
 				Plugin.create('pugilist')
-			rescue ::Exception => err
-				err.backtrace.first.should =~ /#{__FILE__}/
+			rescue ::RuntimeError => err
+				exception = err
 			else
-				fail "Expected an exception to be raised"
+				fail "Expected an exception to be raised."
 			end
+
+			exception.backtrace.first.should =~ /#{__FILE__}/
 		end
 
 		it "will refuse to create an object other than one of its derivatives" do
 			class Doppelgaenger; end
-			lambda { Plugin.create(Doppelgaenger) }.
-				should raise_error( ArgumentError, /is not a descendent of/ )
+			expect {
+				Plugin.create(Doppelgaenger)
+			}.to raise_error( ArgumentError, /is not a descendent of/ )
 		end
 
 
@@ -123,8 +126,9 @@ describe PluginFactory do
 				at_least(6).times.
 				and_return {|path| raise LoadError, "path" }
 
-			lambda { Plugin.create('scintillating') }.
-				should raise_error( FactoryError, /couldn't find a \S+ named \S+.*tried \[/i )
+			expect {
+				Plugin.create('scintillating')
+			}.to raise_error( FactoryError, /couldn't find a \S+ named \S+.*tried \[/i )
 		end
 
 
@@ -132,8 +136,9 @@ describe PluginFactory do
 			# at least 6 -> 3 variants * 2 paths
 			Plugin.should_receive( :require ).and_return( true )
 
-			lambda { Plugin.create('corruscating') }.
-				should raise_error( FactoryError, /Require of '\S+' succeeded, but didn't load a Plugin/i )
+			expect {
+				Plugin.create('corruscating')
+			}.to raise_error( FactoryError, /Require of '\S+' succeeded, but didn't load a Plugin/i )
 		end
 
 
@@ -145,13 +150,14 @@ describe PluginFactory do
 				raise ScriptError, "error while parsing #{path}"
 			}
 
-			lambda { Plugin.create('portable') }.
-				should raise_error( ScriptError, /error while parsing/ )
+			expect {
+				Plugin.create('portable')
+			}.to raise_error( ScriptError, /error while parsing/ )
 		end
 	end
 
 
-	describe "derivative of an extended class" do
+	context "derivative of an extended class" do
 
 		it "knows what type of factory loads it" do
 			TestingPlugin.factory_type.should == 'Plugin'
@@ -159,13 +165,14 @@ describe PluginFactory do
 
 		it "raises a FactoryError if it can't figure out what type of factory loads it" do
 			TestingPlugin.stub!( :ancestors ).and_return( [] )
-			lambda { TestingPlugin.factory_type }.
-				should raise_error( FactoryError, /couldn't find factory base/i )
+			expect {
+				TestingPlugin.factory_type
+			}.to raise_error( FactoryError, /couldn't find factory base/i )
 		end
 	end
 
 
-	describe "derivative of an extended class that isn't named <Something>Plugin" do
+	context "derivative of an extended class that isn't named <Something>Plugin" do
 
 		it "is still creatable via its full name" do
 			Plugin.create( 'blacksheep' ).should be_an_instance_of( BlackSheep )
@@ -174,7 +181,7 @@ describe PluginFactory do
 	end
 
 
-	describe "derivative of an extended class in another namespace" do
+	context "derivative of an extended class in another namespace" do
 
 		it "is still creatable via its derivative name" do
 			Plugin.create( 'loadable' ).should be_an_instance_of( Test::LoadablePlugin )

metadata

@@ -1,120 +1,180 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: pluginfactory
-version: !ruby/object:Gem::Version 
-  hash: 25
-  prerelease: false
-  segments: 
-  - 1
-  - 0
-  - 7
-  version: 1.0.7
+version: !ruby/object:Gem::Version
+  version: 1.0.8
+  prerelease: 
 platform: ruby
-authors: 
-- Martin Chase, Michael Granger
+authors:
+- Martin Chase
+- Michael Granger
 autorequire: 
 bindir: bin
-cert_chain: 
-- |
-  -----BEGIN CERTIFICATE-----
-  MIIDLDCCAhSgAwIBAgIBADANBgkqhkiG9w0BAQUFADA8MQwwCgYDVQQDDANnZWQx
-  FzAVBgoJkiaJk/IsZAEZFgdfYWVyaWVfMRMwEQYKCZImiZPyLGQBGRYDb3JnMB4X
-  DTEwMDkxNjE0NDg1MVoXDTExMDkxNjE0NDg1MVowPDEMMAoGA1UEAwwDZ2VkMRcw
-  FQYKCZImiZPyLGQBGRYHX2FlcmllXzETMBEGCgmSJomT8ixkARkWA29yZzCCASIw
-  DQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBALy//BFxC1f/cPSnwtJBWoFiFrir
-  h7RicI+joq/ocVXQqI4TDWPyF/8tqkvt+rD99X9qs2YeR8CU/YiIpLWrQOYST70J
-  vDn7Uvhb2muFVqq6+vobeTkILBEO6pionWDG8jSbo3qKm1RjKJDwg9p4wNKhPuu8
-  KGue/BFb67KflqyApPmPeb3Vdd9clspzqeFqp7cUBMEpFS6LWxy4Gk+qvFFJBJLB
-  BUHE/LZVJMVzfpC5Uq+QmY7B+FH/QqNndn3tOHgsPadLTNimuB1sCuL1a4z3Pepd
-  TeLBEFmEao5Dk3K/Q8o8vlbIB/jBDTUx6Djbgxw77909x6gI9doU4LD5XMcCAwEA
-  AaM5MDcwCQYDVR0TBAIwADALBgNVHQ8EBAMCBLAwHQYDVR0OBBYEFJeoGkOr9l4B
-  +saMkW/ZXT4UeSvVMA0GCSqGSIb3DQEBBQUAA4IBAQBG2KObvYI2eHyyBUJSJ3jN
-  vEnU3d60znAXbrSd2qb3r1lY1EPDD3bcy0MggCfGdg3Xu54z21oqyIdk8uGtWBPL
-  HIa9EgfFGSUEgvcIvaYqiN4jTUtidfEFw+Ltjs8AP9gWgSIYS6Gr38V0WGFFNzIH
-  aOD2wmu9oo/RffW4hS/8GuvfMzcw7CQ355wFR4KB/nyze+EsZ1Y5DerCAagMVuDQ
-  U0BLmWDFzPGGWlPeQCrYHCr+AcJz+NRnaHCKLZdSKj/RHuTOt+gblRex8FAh8NeA
-  cmlhXe46pZNJgWKbxZah85jIjx95hR8vOI+NAM5iH9kOqK13DrxacTKPhqj5PjwF
-  -----END CERTIFICATE-----
-
-date: 2010-09-27 00:00:00 -07:00
-default_executable: 
-dependencies: []
+cert_chain:
+- !binary |-
+  LS0tLS1CRUdJTiBDRVJUSUZJQ0FURS0tLS0tCk1JSURMRENDQWhTZ0F3SUJB
+  Z0lCQURBTkJna3Foa2lHOXcwQkFRVUZBREE4TVF3d0NnWURWUVFEREFOblpX
+  UXgKRnpBVkJnb0praWFKay9Jc1pBRVpGZ2RmWVdWeWFXVmZNUk13RVFZS0Na
+  SW1pWlB5TEdRQkdSWURiM0puTUI0WApEVEV3TURreE5qRTBORGcxTVZvWERU
+  RXhNRGt4TmpFME5EZzFNVm93UERFTU1Bb0dBMVVFQXd3RFoyVmtNUmN3CkZR
+  WUtDWkltaVpQeUxHUUJHUllIWDJGbGNtbGxYekVUTUJFR0NnbVNKb21UOGl4
+  a0FSa1dBMjl5WnpDQ0FTSXcKRFFZSktvWklodmNOQVFFQkJRQURnZ0VQQURD
+  Q0FRb0NnZ0VCQUx5Ly9CRnhDMWYvY1BTbnd0SkJXb0ZpRnJpcgpoN1JpY0kr
+  am9xL29jVlhRcUk0VERXUHlGLzh0cWt2dCtyRDk5WDlxczJZZVI4Q1UvWWlJ
+  cExXclFPWVNUNzBKCnZEbjdVdmhiMm11RlZxcTYrdm9iZVRrSUxCRU82cGlv
+  bldERzhqU2JvM3FLbTFSaktKRHdnOXA0d05LaFB1dTgKS0d1ZS9CRmI2N0tm
+  bHF5QXBQbVBlYjNWZGQ5Y2xzcHpxZUZxcDdjVUJNRXBGUzZMV3h5NEdrK3F2
+  RkZKQkpMQgpCVUhFL0xaVkpNVnpmcEM1VXErUW1ZN0IrRkgvUXFObmRuM3RP
+  SGdzUGFkTFROaW11QjFzQ3VMMWE0ejNQZXBkClRlTEJFRm1FYW81RGszSy9R
+  OG84dmxiSUIvakJEVFV4NkRqYmd4dzc3OTA5eDZnSTlkb1U0TEQ1WE1jQ0F3
+  RUEKQWFNNU1EY3dDUVlEVlIwVEJBSXdBREFMQmdOVkhROEVCQU1DQkxBd0hR
+  WURWUjBPQkJZRUZKZW9Ha09yOWw0Qgorc2FNa1cvWlhUNFVlU3ZWTUEwR0NT
+  cUdTSWIzRFFFQkJRVUFBNElCQVFCRzJLT2J2WUkyZUh5eUJVSlNKM2pOCnZF
+  blUzZDYwem5BWGJyU2QycWIzcjFsWTFFUEREM2JjeTBNZ2dDZkdkZzNYdTU0
+  ejIxb3F5SWRrOHVHdFdCUEwKSElhOUVnZkZHU1VFZ3ZjSXZhWXFpTjRqVFV0
+  aWRmRUZ3K0x0anM4QVA5Z1dnU0lZUzZHcjM4VjBXR0ZGTnpJSAphT0Qyd211
+  OW9vL1JmZlc0aFMvOEd1dmZNemN3N0NRMzU1d0ZSNEtCL255emUrRXNaMVk1
+  RGVyQ0FhZ01WdURRClUwQkxtV0RGelBHR1dsUGVRQ3JZSENyK0FjSnorTlJu
+  YUhDS0xaZFNLai9SSHVUT3QrZ2JsUmV4OEZBaDhOZUEKY21saFhlNDZwWk5K
+  Z1dLYnhaYWg4NWpJang5NWhSOHZPSStOQU01aUg5a09xSzEzRHJ4YWNUS1Bo
+  cWo1UGp3RgotLS0tLUVORCBDRVJUSUZJQ0FURS0tLS0tCg==
+date: 2012-02-20 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: hoe-mercurial
+  requirement: &70125869528840 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.3.1
+  type: :development
+  prerelease: false
+  version_requirements: *70125869528840
+- !ruby/object:Gem::Dependency
+  name: hoe-highline
+  requirement: &70125869528340 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.0.1
+  type: :development
+  prerelease: false
+  version_requirements: *70125869528340
+- !ruby/object:Gem::Dependency
+  name: hoe-mercurial
+  requirement: &70125869527820 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.3.1
+  type: :development
+  prerelease: false
+  version_requirements: *70125869527820
+- !ruby/object:Gem::Dependency
+  name: hoe-deveiate
+  requirement: &70125869527320 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.0'
+  type: :development
+  prerelease: false
+  version_requirements: *70125869527320
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: &70125869526780 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.10'
+  type: :development
+  prerelease: false
+  version_requirements: *70125869526780
+- !ruby/object:Gem::Dependency
+  name: hoe
+  requirement: &70125869526280 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.13'
+  type: :development
+  prerelease: false
+  version_requirements: *70125869526280
+description: ! 'PluginFactory is a mixin module that turns an including class into
+  a factory for
 
-description: |-
-  PluginFactory is a mixin module that turns an including class into a factory for
   its derivatives, capable of searching for and loading them by name. This is
+
   useful when you have an abstract base class which defines an interface and basic
+
   functionality for a part of a larger system, and a collection of subclasses
+
   which implement the interface for different underlying functionality.
-email: 
+
+
+  An example of where this might be useful is in a program which talks to a
+
+  database. To avoid coupling it to a specific database, you use a Driver class
+
+  which encapsulates your program''s interaction with the database behind a useful
+
+  interface. Now you can create a concrete implementation of the Driver class for
+
+  each kind of database you wish to talk to. If you make the base Driver class a
+
+  PluginFactory, too, you can add new drivers simply by dropping them in a
+
+  directory and using the Driver''s `create` method to instantiate them:'
+email:
 - stillflame@FaerieMUD.org
 - ged@FaerieMUD.org
 executables: []
-
 extensions: []
-
-extra_rdoc_files: 
+extra_rdoc_files:
+- Manifest.txt
+- History.rdoc
+- README.rdoc
+files:
 - ChangeLog
-- README
-- LICENSE
-files: 
+- History.rdoc
+- Manifest.txt
+- README.rdoc
 - Rakefile
-- ChangeLog
-- README
-- LICENSE
-- spec/pluginfactory_spec.rb
-- spec/lib/helpers.rb
 - lib/pluginfactory.rb
-- rake/191_compat.rb
-- rake/dependencies.rb
-- rake/documentation.rb
-- rake/helpers.rb
-- rake/hg.rb
-- rake/manual.rb
-- rake/packaging.rb
-- rake/publishing.rb
-- rake/style.rb
-- rake/svn.rb
-- rake/testing.rb
-- rake/verifytask.rb
-has_rdoc: true
-homepage: http://deveiate.org/projects/PluginFactory/
-licenses: []
-
+- spec/lib/helpers.rb
+- spec/pluginfactory_spec.rb
+- .gemtest
+homepage: http://deveiate.org/projects/PluginFactory
+licenses:
+- BSD
 post_install_message: 
-rdoc_options: 
-- --tab-width=4
-- --show-hash
-- --include
-- .
-- --main=README
-- --title=pluginfactory
-require_paths: 
+rdoc_options:
+- --main
+- README.rdoc
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
+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 
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
-      - 0
-      version: "0"
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
 requirements: []
-
-rubyforge_project: 
-rubygems_version: 1.3.7
+rubyforge_project: pluginfactory
+rubygems_version: 1.8.16
 signing_key: 
 specification_version: 3
-summary: A mixin for making plugin classes
-test_files: 
-- spec/pluginfactory_spec.rb
-- spec/lib/helpers.rb
+summary: PluginFactory is a mixin module that turns an including class into a factory
+  for its derivatives, capable of searching for and loading them by name
+test_files: []

metadata.gz.sig

@@ -1,2 +1 @@
-5���,�Z�ӵ)h�������Z�1q�����~����T|�� �
�6�"��*.<�d:�O��I��=���o�J�x� �|��~͖�-=�z�
-Y�8�?a^� MѼ�}X`�Bke��a��5ä{��֍M�coa9�Mc_}��r�����/gD��KIM�3��j-��N���A��	x���\����o�&�<6Á�M�G����F�(Ț����
B�C�{��]0P�Y5�r(;�`��[/�J��xE.e�ߙj
+*���W��y�K������M�[n��H;�:[2M�B)�\%���!PK���1,���:e۰�V�~:&�uC�e'p	-�Qܮ��ws׋�"a�7'j,D�ᴱJ��O�7���$hnkƜA��X���#6��������o��h�,����T#��f0Ʊ�Z����MiI�l�l���t���zF[T��{��V~TpX>�P�qԬ/�6�;^߫��x�R|Q��w���{���ѫc/��&uf=�6�a�

data/LICENSE

@@ -1,27 +0,0 @@
-Copyright (c) 2008, 2009 Michael Granger and Martin Chase
-All rights reserved.
-
-Redistribution and use in source and binary forms, with or without
-modification, are permitted provided that the following conditions are met:
-
-  * Redistributions of source code must retain the above copyright notice,
-    this list of conditions and the following disclaimer.
-
-  * 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.
-
-  * Neither the name of the author/s, nor the names of the project's
-    contributors may be used to endorse or promote products derived from this
-    software without specific prior written permission.
-
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "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 THE COPYRIGHT OWNER 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.

data/README

@@ -1,200 +0,0 @@
-
-= PluginFactory
-
-PluginFactory is a mixin module that turns an including class into a factory for
-its derivatives, capable of searching for and loading them by name. This is
-useful when you have an abstract base class which defines an interface and basic
-functionality for a part of a larger system, and a collection of subclasses
-which implement the interface for different underlying functionality.
-
-An example of where this might be useful is in a program which talks to a
-database. To avoid coupling it to a specific database, you use a Driver class
-which encapsulates your program's interaction with the database behind a useful
-interface. Now you can create a concrete implementation of the Driver class for
-each kind of database you wish to talk to. If you make the base Driver class a
-PluginFactory, too, you can add new drivers simply by dropping them in a
-directory and using the Driver's <tt>create</tt> method to instantiate them:
-
-== Synopsis
-
-in driver.rb:
-
-  require "PluginFactory"
-
-  class Driver
-  	include PluginFactory
-  	def self::derivative_dirs
-  	   ["drivers"]
-  	end
-  end
-
-in drivers/mysql.rb:
-
-  require 'driver'
-
-  class MysqlDriver < Driver
-  	...implementation...
-  end
-
-in /usr/lib/ruby/1.8/PostgresDriver.rb:
-
-  require 'driver'
-
-  class PostgresDriver < Driver
-  	...implementation...
-  end
-
-elsewhere
-
-  require 'driver'
-
-  config[:driver_type] #=> "mysql"
-  driver = Driver.create( config[:driver_type] )
-  driver.class #=> MysqlDriver
-  pgdriver = Driver.create( "PostGresDriver" )
-
-== How Plugins Are Loaded
-
-The +create+ class method added to your class by PluginFactory searches for your
-module using several different strategies. It tries various permutations of the
-base class's name in combination with the derivative requested. For example,
-assume we want to make a +DataDriver+ base class, and then use plugins to define
-drivers for different kinds of data sources:
-
-  require 'pluginfactory'
-
-  class DataDriver
-	include PluginFactory
-  end
-
-When you attempt to load the 'socket' data-driver class like so:
-
-  DataDriver.create( 'socket' )
-
-PluginFactory searches for modules with the following names:
-
-  'socketdatadriver'
-  'socket_datadriver'
-  'socketDataDriver'
-  'socket_DataDriver'
-  'SocketDataDriver'
-  'Socket_DataDriver'
-  'socket'
-  'Socket'
-
-Obviously the last one will load something other than what is intended, so you
-can also tell PluginFactory that plugins should be loaded from a subdirectory by
-declaring a class method called `derivative_dirs` in the base class. It should
-return an Array that contains a list of subdirectories to try:
-
-  class DataDriver
-	include PluginFactory
-	
-	def self::derivative_dirs
-	  ['drivers']
-	end
-  end
-
-This will change the list that is required to:
-
-  'drivers/socketdatadriver'
-  'drivers/socket_datadriver'
-  'drivers/socketDataDriver'
-  'drivers/socket_DataDriver'
-  'drivers/SocketDataDriver'
-  'drivers/Socket_DataDriver'
-  'drivers/socket'
-  'drivers/Socket'
-
-If you return more than one subdirectory, each of them will be tried in turn:
-
-  class DataDriver
-	include PluginFactory
-	
-	def self::derivative_dirs
-	  ['drivers', 'datadriver']
-	end
-  end
-
-will change the search to include:
-
-  'drivers/socketdatadriver'
-  'drivers/socket_datadriver'
-  'drivers/socketDataDriver'
-  'drivers/socket_DataDriver'
-  'drivers/SocketDataDriver'
-  'drivers/Socket_DataDriver'
-  'drivers/socket'
-  'drivers/Socket'
-  'datadriver/socketdatadriver'
-  'datadriver/socket_datadriver'
-  'datadriver/socketDataDriver'
-  'datadriver/socket_DataDriver'
-  'datadriver/SocketDataDriver'
-  'datadriver/Socket_DataDriver'
-  'datadriver/socket'
-  'datadriver/Socket'
-
-If the plugin is not found, a FactoryError is raised, and the message will list
-all the permutations that were tried.
-
-== Logging
-
-If you need a little more insight into what's going on, PluginFactory exposes a
-logging callback which will be called at various points in the process, and will
-include details on what's being attempted.
-
-You can activate logging by setting PluginFactory.logger_callback to something
-that responds to the #call message. It will be called with two arguments, a
-severity level and a message:
-
-  callback.call( :info, "Something happened" )
-
-This is intended to make it easy to hook up to Logger or anything with a similar
-interface:
-
-  require 'pluginfactory'
-  require 'logger'
-  
-  class DataDriver
-    include PluginFactory
-    
-    @logger = Logger.new( $stderr )
-    @logger.level = Logger::DEBUG
-    PluginFactory.logger_callback = lambda do |severity, msg|
-      @logger.send(severity, msg)
-    end
-  end
-  
-  DataDriver.create( 'ringbuffer' )
-
-this might generate a log that looks like:
-
-  D, [...] DEBUG -- : Loading derivative ringbuffer
-  D, [...] DEBUG -- : Subdirs are: [""]
-  D, [...] DEBUG -- : Path is: ["ringbufferdatadriver", "ringbufferDataDriver", 
-        "ringbuffer"]...
-  D, [...] DEBUG -- : Trying ringbufferdatadriver...
-  D, [...] DEBUG -- : No module at 'ringbufferdatadriver', trying the next 
-        alternative: 'no such file to load -- ringbufferdatadriver'
-  D, [...] DEBUG -- : Trying ringbufferDataDriver...
-  D, [...] DEBUG -- : No module at 'ringbufferDataDriver', trying the next 
-        alternative: 'no such file to load -- ringbufferDataDriver'
-  D, [...] DEBUG -- : Trying ringbuffer...
-  D, [...] DEBUG -- : No module at 'ringbuffer', trying the next alternative: 
-        'no such file to load -- ringbuffer'
-  D, [...] DEBUG -- : fatals = []
-  E, [...] ERROR -- : Couldn't find a DataDriver named 'ringbuffer': 
-        tried ["ringbufferdatadriver", "ringbufferDataDriver", "ringbuffer"]
-
-== Authors
-
-* Martin Chase <stillflame@FaerieMUD.org>
-* Michael Granger <ged@FaerieMUD.org>
-
-:include: LICENSE
-
---
-
-Please see the file LICENSE for licensing details.
-