has_many_polymorphs 2.10 → 2.11

data/generators/commenting/templates/comment_test.rb

@@ -0,0 +1,12 @@
+require File.dirname(__FILE__) + '/../test_helper'
+
+class CommentTest < Test::Unit::TestCase
+  fixtures :comments, :commentings, <%= commentable_models[0..1].join(", ") -%>
+
+  def test_to_s
+    assert_equal "no1@nowhere.com", <%= model_two -%>.find(2).comments.first.email
+    assert_equal "http://letrails.cn", <%= model_two -%>.find(2).comments.last.url
+    assert_equal "http://fr.ivolo.us", <%= model_two -%>.find(2).comments.first.url
+  end
+  
+end

data/generators/commenting/templates/commenting.rb

@@ -0,0 +1,13 @@
+
+# The Commenting join model. This model is automatically generated and added to your app if you run the commenting generator.
+
+class Commenting < ActiveRecord::Base 
+ 
+  belongs_to :<%= parent_association_name -%><%= ", :foreign_key => \"#{parent_association_name}_id\", :class_name => \"Comment\"" if options[:self_referential] %>
+  belongs_to :commentable, :polymorphic => true
+  
+  # This callback makes sure that an orphaned <tt>Comment</tt> is deleted if it no longer tags anything.
+  def before_destroy
+    <%= parent_association_name -%>.destroy_without_callbacks if <%= parent_association_name -%> and <%= parent_association_name -%>.commentings.count == 1
+  end    
+end

data/generators/commenting/templates/commenting_extensions.rb

@@ -0,0 +1,30 @@
+class ActiveRecord::Base
+  module CommentingExtensions
+
+    def comment_count
+      commentable?
+      self.comments.size
+    end
+
+    def comment_with(attributes)
+      commentable?(true)
+      begin
+        comment = Comment.create(attributes)
+        raise Comment::Error, "Comment could not be saved with" if comment.new_record?
+        comment.commentables << self
+      rescue
+      end
+    end
+
+    private
+    def commentable?(should_raise = false) #:nodoc:
+      unless flag = respond_to?(:<%= parent_association_name -%>s)
+        raise "#{self.class} is not a commentable model" if should_raise
+      end
+      flag
+    end
+  end
+
+  include CommentingExtensions
+end
+

data/generators/commenting/templates/commenting_test.rb

@@ -0,0 +1,30 @@
+require File.dirname(__FILE__) + '/../test_helper'
+
+class CommentingTest < Test::Unit::TestCase
+  fixtures :commentings, :comments, <%= commentable_models[0..1].join(", ") -%>
+
+  def setup
+    @obj1 = <%= model_two %>.find(1)
+    @obj2 = <%= model_two %>.find(2)
+<% if commentable_models.size > 1 -%>
+    @obj3 = <%= model_one -%>.find(1)
+<% end -%>
+    @comment1 = Comment.find(1)  
+    @comment2 = Comment.find(2)  
+    @commenting1 = Commenting.find(1)
+  end
+
+  def test_commentable
+    assert_raises(RuntimeError) do 
+      @commenting1.send(:commentable?, true) 
+    end
+    assert !@commenting1.send(:commentable?)
+<% if commentable_models.size > 1 -%>
+    assert @obj3.send(:commentable?)
+<% end -%>
+<% if options[:self_referential] -%>  
+    assert @comment1.send(:commentable?)
+<% end -%>    
+  end
+    
+end

data/generators/commenting/templates/commentings.yml

@@ -0,0 +1,23 @@
+--- 
+<% if commentable_models.size > 1 -%>
+commentings_003: 
+  <%= parent_association_name -%>_id: "2"
+  id: "3"
+  commentable_type: <%= model_one %>
+  commentable_id: "1"                
+<% end -%>
+commentings_004: 
+  <%= parent_association_name -%>_id: "2"
+  id: "4"
+  commentable_type: <%= model_two %>
+  commentable_id: "2"
+commentings_001: 
+  <%= parent_association_name -%>_id: "1"
+  id: "1"
+  commentable_type: <%= model_two %>
+  commentable_id: "1"
+commentings_002: 
+  <%= parent_association_name -%>_id: "1"
+  id: "2"
+  commentable_type: <%= model_two %>
+  commentable_id: "2"

data/generators/commenting/templates/comments.yml

@@ -0,0 +1,13 @@
+--- 
+comments_001: 
+  id: "1"
+  name: frivolous
+  email: no1@nowhere.com
+  url: http://fr.ivolo.us
+  body: this plugin rocks!
+tags_002: 
+  id: "2"
+  name: yuanyiz
+  email: no1@nowhere.com
+  url: http://letrails.cn
+  body: this plugin has saved my life

data/generators/commenting/templates/migration.rb

@@ -0,0 +1,28 @@
+
+# A migration to add tables for Comment and Commenting. This file is automatically generated and added to your app if you run the commenting generator.
+
+class CreateCommentsAndCommentings < ActiveRecord::Migration
+
+  # Add the new tables.
+  def self.up
+    create_table :comments do |t|
+      t.column :name, :string, :null => false
+      t.column :url, :string
+      t.column :email, :string
+      t.column :body, :text
+    end
+
+    create_table :commentings do |t|
+      t.column :<%= parent_association_name -%>_id, :integer, :null => false
+      t.column :commentable_id, :integer, :null => false
+      t.column :commentable_type, :string, :null => false
+    end
+  end
+
+  # Remove the tables.
+  def self.down
+    drop_table :comments
+    drop_table :commentings
+  end
+
+end

data/generators/tagging/templates/tagging_extensions.rb

@@ -26,13 +26,13 @@ class ActiveRecord::Base #:nodoc:
       outgoing = tag_cast_to_string(outgoing)
   <% if options[:self_referential] %>  
       # because of http://dev.rubyonrails.org/ticket/6466
-      taggings.destroy(taggings.find(:all, :include => :<%= parent_association_name -%>).select do |tagging| 
+      taggings.destroy(*(taggings.find(:all, :include => :<%= parent_association_name -%>).select do |tagging| 
         outgoing.include? tagging.<%= parent_association_name -%>.name
-      end)
+      end))
   <% else -%>   
-      <%= parent_association_name -%>s.delete(<%= parent_association_name -%>s.select do |tag|
+      <%= parent_association_name -%>s.delete(*(<%= parent_association_name -%>s.select do |tag|
         outgoing.include? tag.name    
-      end)
+      end))
   <% end -%>
     end
 
@@ -67,10 +67,6 @@ class ActiveRecord::Base #:nodoc:
       #:startdoc:
     end
     
-    #:stopdoc:
-    alias :<%= parent_association_name -%>s= :tag_with
-    #:startdoc:
-    
     private 
     
     def tag_cast_to_string obj #:nodoc:

data/has_many_polymorphs.gemspec

@@ -1,21 +1,28 @@
 
-# Gem::Specification for Has_many_polymorphs-2.10
+# Gem::Specification for Has_many_polymorphs-2.11
 # Originally generated by Echoe
 
 Gem::Specification.new do |s|
   s.name = %q{has_many_polymorphs}
-  s.version = "2.10"
-  s.date = %q{2007-09-16}
-  s.summary = %q{An ActiveRecord plugin for self-referential and double-sided polymorphic associations.}
-  s.email = %q{}
-  s.homepage = %q{http://blog.evanweaver.com/pages/code#polymorphs}
-  s.rubyforge_project = %q{fauna}
+  s.version = "2.11"
+
+  s.specification_version = 2 if s.respond_to? :specification_version=
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = [""]
+  s.date = %q{2007-12-04}
   s.description = %q{An ActiveRecord plugin for self-referential and double-sided polymorphic associations.}
+  s.email = %q{}
+  s.files = ["CHANGELOG", "examples/hmph.rb", "generators/commenting/commenting_generator.rb", "generators/commenting/templates/comment.rb", "generators/commenting/templates/comment_test.rb", "generators/commenting/templates/commenting.rb", "generators/commenting/templates/commenting_extensions.rb", "generators/commenting/templates/commenting_test.rb", "generators/commenting/templates/commentings.yml", "generators/commenting/templates/comments.yml", "generators/commenting/templates/migration.rb", "generators/tagging/tagging_generator.rb", "generators/tagging/templates/migration.rb", "generators/tagging/templates/tag.rb", "generators/tagging/templates/tag_test.rb", "generators/tagging/templates/tagging.rb", "generators/tagging/templates/tagging_extensions.rb", "generators/tagging/templates/tagging_test.rb", "generators/tagging/templates/taggings.yml", "generators/tagging/templates/tags.yml", "init.rb", "lib/has_many_polymorphs/association.rb", "lib/has_many_polymorphs/autoload.rb", "lib/has_many_polymorphs/base.rb", "lib/has_many_polymorphs/class_methods.rb", "lib/has_many_polymorphs/configuration.rb", "lib/has_many_polymorphs/debugging_tools.rb", "lib/has_many_polymorphs/dependencies.rb", "lib/has_many_polymorphs/rake_task_redefine_task.rb", "lib/has_many_polymorphs/reflection.rb", "lib/has_many_polymorphs/support_methods.rb", "lib/has_many_polymorphs.rb", "LICENSE", "Manifest", "README", "test/fixtures/bow_wows.yml", "test/fixtures/cats.yml", "test/fixtures/eaters_foodstuffs.yml", "test/fixtures/fish.yml", "test/fixtures/frogs.yml", "test/fixtures/keep_your_enemies_close.yml", "test/fixtures/little_whale_pupils.yml", "test/fixtures/people.yml", "test/fixtures/petfoods.yml", "test/fixtures/whales.yml", "test/fixtures/wild_boars.yml", "test/integration/app/app/controllers/addresses_controller.rb", "test/integration/app/app/controllers/application.rb", "test/integration/app/app/controllers/sellers_controller.rb", "test/integration/app/app/controllers/states_controller.rb", "test/integration/app/app/controllers/users_controller.rb", "test/integration/app/app/helpers/addresses_helper.rb", "test/integration/app/app/helpers/application_helper.rb", "test/integration/app/app/helpers/sellers_helper.rb", "test/integration/app/app/helpers/states_helper.rb", "test/integration/app/app/helpers/users_helper.rb", "test/integration/app/app/models/address.rb", "test/integration/app/app/models/citation.rb", "test/integration/app/app/models/citations_item.rb", "test/integration/app/app/models/seller.rb", "test/integration/app/app/models/state.rb", "test/integration/app/app/models/user.rb", "test/integration/app/app/views/addresses/edit.html.erb", "test/integration/app/app/views/addresses/index.html.erb", "test/integration/app/app/views/addresses/new.html.erb", "test/integration/app/app/views/addresses/show.html.erb", "test/integration/app/app/views/layouts/addresses.html.erb", "test/integration/app/app/views/layouts/sellers.html.erb", "test/integration/app/app/views/layouts/states.html.erb", "test/integration/app/app/views/layouts/users.html.erb", "test/integration/app/app/views/sellers/edit.html.erb", "test/integration/app/app/views/sellers/index.html.erb", "test/integration/app/app/views/sellers/new.html.erb", "test/integration/app/app/views/sellers/show.html.erb", "test/integration/app/app/views/states/edit.html.erb", "test/integration/app/app/views/states/index.html.erb", "test/integration/app/app/views/states/new.html.erb", "test/integration/app/app/views/states/show.html.erb", "test/integration/app/app/views/users/edit.html.erb", "test/integration/app/app/views/users/index.html.erb", "test/integration/app/app/views/users/new.html.erb", "test/integration/app/app/views/users/show.html.erb", "test/integration/app/config/boot.rb", "test/integration/app/config/database.yml", "test/integration/app/config/environment.rb", "test/integration/app/config/environments/development.rb", "test/integration/app/config/environments/production.rb", "test/integration/app/config/environments/test.rb", "test/integration/app/config/locomotive.yml", "test/integration/app/config/routes.rb", "test/integration/app/config/ultrasphinx/default.base", "test/integration/app/config/ultrasphinx/development.conf.canonical", "test/integration/app/db/migrate/001_create_users.rb", "test/integration/app/db/migrate/002_create_sellers.rb", "test/integration/app/db/migrate/003_create_addresses.rb", "test/integration/app/db/migrate/004_create_states.rb", "test/integration/app/db/migrate/005_add_capitalization_to_seller.rb", "test/integration/app/db/migrate/006_add_deleted_to_user.rb", "test/integration/app/db/migrate/007_add_lat_and_long_to_address.rb", "test/integration/app/db/migrate/008_create_citations.rb", "test/integration/app/db/migrate/009_create_citations_items.rb", "test/integration/app/db/schema.rb", "test/integration/app/doc/README_FOR_APP", "test/integration/app/generated_models/aquatic_fish.rb", "test/integration/app/generated_models/aquatic_pupils_whale.rb", "test/integration/app/generated_models/aquatic_whale.rb", "test/integration/app/generated_models/beautiful_fight_relationship.rb", "test/integration/app/generated_models/citation.rb", "test/integration/app/generated_models/citations_item.rb", "test/integration/app/generated_models/dog.rb", "test/integration/app/generated_models/eaters_foodstuff.rb", "test/integration/app/generated_models/frog.rb", "test/integration/app/generated_models/kitten.rb", "test/integration/app/generated_models/parentship.rb", "test/integration/app/generated_models/person.rb", "test/integration/app/generated_models/petfood.rb", "test/integration/app/generated_models/polymorph_test_some_model.rb", "test/integration/app/generated_models/seller.rb", "test/integration/app/generated_models/tabby.rb", "test/integration/app/generated_models/user.rb", "test/integration/app/generated_models/wild_boar.rb", "test/integration/app/generators/commenting_generator_test.rb", "test/integration/app/public/404.html", "test/integration/app/public/500.html", "test/integration/app/public/dispatch.cgi", "test/integration/app/public/dispatch.fcgi", "test/integration/app/public/dispatch.rb", "test/integration/app/public/favicon.ico", "test/integration/app/public/images/rails.png", "test/integration/app/public/index.html", "test/integration/app/public/javascripts/application.js", "test/integration/app/public/javascripts/controls.js", "test/integration/app/public/javascripts/dragdrop.js", "test/integration/app/public/javascripts/effects.js", "test/integration/app/public/javascripts/prototype.js", "test/integration/app/public/robots.txt", "test/integration/app/public/stylesheets/scaffold.css", "test/integration/app/Rakefile", "test/integration/app/README", "test/integration/app/script/about", "test/integration/app/script/breakpointer", "test/integration/app/script/console", "test/integration/app/script/destroy", "test/integration/app/script/generate", "test/integration/app/script/performance/benchmarker", "test/integration/app/script/performance/profiler", "test/integration/app/script/plugin", "test/integration/app/script/process/inspector", "test/integration/app/script/process/reaper", "test/integration/app/script/process/spawner", "test/integration/app/script/runner", "test/integration/app/script/server", "test/integration/app/test/fixtures/addresses.yml", "test/integration/app/test/fixtures/citations.yml", "test/integration/app/test/fixtures/citations_items.yml", "test/integration/app/test/fixtures/sellers.yml", "test/integration/app/test/fixtures/states.yml", "test/integration/app/test/fixtures/users.yml", "test/integration/app/test/functional/addresses_controller_test.rb", "test/integration/app/test/functional/sellers_controller_test.rb", "test/integration/app/test/functional/states_controller_test.rb", "test/integration/app/test/functional/users_controller_test.rb", "test/integration/app/test/test_helper.rb", "test/integration/app/test/unit/address_test.rb", "test/integration/app/test/unit/citation_test.rb", "test/integration/app/test/unit/citations_item_test.rb", "test/integration/app/test/unit/seller_test.rb", "test/integration/app/test/unit/state_test.rb", "test/integration/app/test/unit/user_test.rb", "test/models/aquatic/fish.rb", "test/models/aquatic/pupils_whale.rb", "test/models/aquatic/whale.rb", "test/models/beautiful_fight_relationship.rb", "test/models/canine.rb", "test/models/cat.rb", "test/models/dog.rb", "test/models/eaters_foodstuff.rb", "test/models/frog.rb", "test/models/kitten.rb", "test/models/parentship.rb", "test/models/person.rb", "test/models/petfood.rb", "test/models/tabby.rb", "test/models/wild_boar.rb", "test/modules/extension_module.rb", "test/modules/other_extension_module.rb", "test/schema.rb", "test/setup.rb", "test/test_all.rb", "test/test_helper.rb", "test/unit/polymorph_test.rb", "TODO", "has_many_polymorphs.gemspec"]
   s.has_rdoc = true
-  s.authors = [""]
-  s.files = ["TODO", "test/unit/polymorph_test.rb", "test/test_helper.rb", "test/schema.rb", "test/modules/other_extension_module.rb", "test/modules/extension_module.rb", "test/models/wild_boar.rb", "test/models/tabby.rb", "test/models/petfood.rb", "test/models/person.rb", "test/models/parentship.rb", "test/models/kitten.rb", "test/models/frog.rb", "test/models/eaters_foodstuff.rb", "test/models/dog.rb", "test/models/cat.rb", "test/models/canine.rb", "test/models/beautiful_fight_relationship.rb", "test/models/aquatic/whale.rb", "test/models/aquatic/pupils_whale.rb", "test/models/aquatic/fish.rb", "test/fixtures/wild_boars.yml", "test/fixtures/petfoods.yml", "test/fixtures/people.yml", "test/fixtures/keep_your_enemies_close.yml", "test/fixtures/frogs.yml", "test/fixtures/eaters_foodstuffs.yml", "test/fixtures/cats.yml", "test/fixtures/bow_wows.yml", "test/fixtures/aquatic/whales.yml", "test/fixtures/aquatic/little_whale_pupils.yml", "test/fixtures/aquatic/fish.yml", "README", "Manifest", "LICENSE", "lib/has_many_polymorphs.rb", "lib/has_many_polymorphs/support_methods.rb", "lib/has_many_polymorphs/reflection.rb", "lib/has_many_polymorphs/rake_task_redefine_task.rb", "lib/has_many_polymorphs/dependencies.rb", "lib/has_many_polymorphs/debugging_tools.rb", "lib/has_many_polymorphs/configuration.rb", "lib/has_many_polymorphs/class_methods.rb", "lib/has_many_polymorphs/base.rb", "lib/has_many_polymorphs/autoload.rb", "lib/has_many_polymorphs/association.rb", "init.rb", "generators/tagging/templates/tags.yml", "generators/tagging/templates/taggings.yml", "generators/tagging/templates/tagging_test.rb", "generators/tagging/templates/tagging_extensions.rb", "generators/tagging/templates/tagging.rb", "generators/tagging/templates/tag_test.rb", "generators/tagging/templates/tag.rb", "generators/tagging/templates/migration.rb", "generators/tagging/tagging_generator.rb", "CHANGELOG", "has_many_polymorphs.gemspec"]
-  s.test_files = ["test/test_helper.rb"]
-  s.add_dependency(%q<activerecord>, ["> 0.0.0"])
+  s.homepage = %q{http://blog.evanweaver.com/files/doc/fauna/has_many_polymorphs/}
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{fauna}
+  s.rubygems_version = %q{0.9.5}
+  s.summary = %q{An ActiveRecord plugin for self-referential and double-sided polymorphic associations.}
+  s.test_files = ["test/test_all.rb"]
+
+  s.add_dependency(%q<activerecord>, [">= 0"])
 end
 
 
@@ -30,7 +37,7 @@ end
 # Echoe.new("has_many_polymorphs") do |p|  
 #   p.project = "fauna"
 #   p.summary = "An ActiveRecord plugin for self-referential and double-sided polymorphic associations."
-#   p.url = "http://blog.evanweaver.com/pages/code#polymorphs"  
+#   p.url = "http://blog.evanweaver.com/files/doc/fauna/has_many_polymorphs/"  
 #   p.docs_host = "blog.evanweaver.com:~/www/bax/public/files/doc/"  
 #   p.dependencies = ["activerecord"]
 #   p.rdoc_pattern = /polymorphs\/association|polymorphs\/class_methods|polymorphs\/reflection|polymorphs\/autoload|polymorphs\/configuration|README|CHANGELOG|TODO|LICENSE|templates\/migration\.rb|templates\/tag\.rb|templates\/tagging\.rb|templates\/tagging_extensions\.rb/    

data/lib/has_many_polymorphs.rb

@@ -14,16 +14,15 @@ class ActiveRecord::Base
   extend ActiveRecord::Associations::PolymorphicClassMethods 
 end
 
-if ENV['HMP_DEBUG'] or (ENV['RAILS_ENV'] =~ /development|test/ and ENV['USER'] == 'eweaver')
-  _logger_warn "has_many_polymorphs: debug mode enabled"
+if ENV['HMP_DEBUG'] or ENV['RAILS_ENV'] =~ /development|test/ and ENV['USER'] == 'eweaver'
   require 'has_many_polymorphs/debugging_tools' 
 end
 
 if defined? Rails and RAILS_ENV and RAILS_ROOT
-  _logger_warn "has_many_polymorphs: Rails environment detected"
+  _logger_warn "rails environment detected"
   require 'has_many_polymorphs/configuration'
   require 'has_many_polymorphs/dependencies'
   require 'has_many_polymorphs/autoload'
 end
 
-_logger_debug "has_many_polymorphs: loaded ok"
+_logger_debug "loaded ok"

data/lib/has_many_polymorphs/autoload.rb

@@ -1,5 +1,5 @@
 
-require 'initializer'
+require 'initializer' unless defined? Rails::Initializer
 
 class Rails::Initializer #:nodoc:
 
@@ -32,7 +32,7 @@ Note that you can override DEFAULT_OPTIONS via Rails::Configuration#has_many_pol
     def after_initialize_with_autoload
       after_initialize_without_autoload
 
-      _logger_debug "has_many_polymorphs: autoload hook invoked"
+      _logger_debug "autoload hook invoked"
       
       HasManyPolymorphsAutoload.options[:requirements].each do |requirement|
         require requirement
@@ -44,10 +44,10 @@ Note that you can override DEFAULT_OPTIONS via Rails::Configuration#has_many_pol
           if file.grep(/#{HasManyPolymorphsAutoload.options[:methods].join("|")}/).any?
             begin
               model = File.basename(filename)[0..-4].camelize
-              _logger_warn "has_many_polymorphs: preloading parent model #{model}"
+              _logger_warn "preloading parent model #{model}"
               model.constantize
             rescue Object => e
-              _logger_warn "has_many_polymorphs: WARNING; possibly critical error preloading #{model}: #{e.inspect}"
+              _logger_warn "WARNING; possibly critical error preloading #{model}: #{e.inspect}"
             end
           end
         end

data/lib/has_many_polymorphs/class_methods.rb

@@ -208,10 +208,6 @@ The method generates a number of associations aside from the polymorphic one. In
 <tt>:from</tt>:: An array of symbols representing the target models. Required.
 <tt>:as</tt>:: A symbol for the parent's interface in the join--what the parent 'acts as'.
 <tt>:through</tt>:: A symbol representing the class of the join model. Follows Rails defaults if not supplied (the parent and the association names, alphabetized, concatenated with an underscore, and singularized).
-<tt>:foreign_key</tt>:: The column name for the parent's id in the join. 
-<tt>:foreign_type_key</tt>:: The column name for the parent's class name in the join, if the parent itself is polymorphic. Rarely needed.
-<tt>:polymorphic_key</tt>:: The column name for the child's id in the join.
-<tt>:polymorphic_type_key</tt>:: The column name for the child's class name in the join.
 <tt>:dependent</tt>:: Accepts <tt>:destroy</tt>, <tt>:nullify</tt>, <tt>:delete_all</tt>. Controls how the join record gets treated on any associate delete (whether from the polymorph or from an individual collection); defaults to <tt>:destroy</tt>.
 <tt>:skip_duplicates</tt>:: If <tt>true</tt>, will check to avoid pushing already associated records (but also triggering a database load). Defaults to <tt>true</tt>.
 <tt>:rename_individual_collections</tt>:: If <tt>true</tt>, all individual collections are prepended with the polymorph name, and the children's parent collection is appended with "_of_#{association_name}"</tt>. For example, <tt>zoos</tt> becomes <tt>zoos_of_animals</tt>. This is to help avoid method name collisions in crowded classes.
@@ -227,6 +223,10 @@ The method generates a number of associations aside from the polymorphic one. In
 <tt>:offset</tt>:: An integer. Only affects the polymorphic association.
 <tt>:namespace</tt>:: A symbol. Prepended to all the models in the <tt>:from</tt> and <tt>:through</tt> keys. This is especially useful for Camping, which namespaces models by default.
 <tt>:uniq</tt>:: If <tt>true</tt>, the records returned are passed through a pure-Ruby <tt>uniq</tt> before they are returned. Rarely needed.
+<tt>:foreign_key</tt>:: The column name for the parent's id in the join. 
+<tt>:foreign_type_key</tt>:: The column name for the parent's class name in the join, if the parent itself is polymorphic. Rarely needed--if you're thinking about using this, you almost certainly want to use <tt>acts_as_double_polymorphic_join()</tt> instead.
+<tt>:polymorphic_key</tt>:: The column name for the child's id in the join.
+<tt>:polymorphic_type_key</tt>:: The column name for the child's class name in the join.
 
 If you pass a block, it gets converted to a Proc and added to <tt>:extend</tt>. 
 
@@ -239,7 +239,7 @@ Be aware, however, that <tt>NULL != 'Spot'</tt> returns <tt>false</tt> due to SQ
 =end
 
       def has_many_polymorphs (association_id, options = {}, &extension)
-        _logger_debug "has_many_polymorphs: associating #{self}.#{association_id}"
+        _logger_debug "associating #{self}.#{association_id}"
         reflection = create_has_many_polymorphs_reflection(association_id, options, &extension)
         # puts "Created reflection #{reflection.inspect}"
         # configure_dependency_for_has_many(reflection)
@@ -384,7 +384,7 @@ Be aware, however, that <tt>NULL != 'Spot'</tt> returns <tt>false</tt> due to SQ
   
       # model caching         
       def inject_dependencies(association_id, reflection)
-        _logger_debug "has_many_polymorphs: injecting dependencies"
+        _logger_debug "injecting dependencies"
         requirements = [self, reflection.klass].map{|klass| [klass, klass.base_class]}.flatten.uniq
         (all_classes_for(association_id, reflection) - requirements).each do |target_klass|
           Dependencies.inject_dependency(target_klass, *requirements)        
@@ -565,7 +565,7 @@ Be aware, however, that <tt>NULL != 'Spot'</tt> returns <tt>false</tt> due to SQ
         # XXX remove_inappropriate_clauses is not implemented; we'll wait until someone actually needs it
         return unless string
         string = string.dup
-        # _logger_debug "has_many_polymorphs: devolving #{string} for #{klass}"
+        # _logger_debug "devolving #{string} for #{klass}"
         inappropriate_classes = (all_classes_for(association_id, reflection) - # the join class must always be preserved
           [klass, klass.base_class, reflection.klass, reflection.klass.base_class])
         inappropriate_classes.map do |klass|
@@ -579,7 +579,7 @@ Be aware, however, that <tt>NULL != 'Spot'</tt> returns <tt>false</tt> due to SQ
           # XXX clause removal would go here 
           string.gsub!(quoted_reference, "NULL")
         end
-        # _logger_debug "has_many_polymorphs: altered to #{string}"
+        # _logger_debug "altered to #{string}"
         string
       end
       

data/lib/has_many_polymorphs/debugging_tools.rb

@@ -31,6 +31,8 @@ Turns on Rails' default dependency logging.
 
 =end
 
+_logger_warn "debug mode enabled"
+
 class << ActiveRecord::Base
   COLLECTION_METHODS = [:belongs_to, :has_many, :has_and_belongs_to_many, :has_one, 
       :has_many_polymorphs, :acts_as_double_polymorphic_join].each do |method_name|

data/lib/has_many_polymorphs/dependencies.rb

@@ -15,18 +15,23 @@ module Dependencies
     target, requirements = target.to_s, requirements.map(&:to_s)    
     injection_graph[target] = ((injection_graph[target] + requirements).uniq - [target])
     requirements.each {|requirement| mark_for_unload requirement }
-#    _logger_debug "has_many_polymorphs: injection graph: #{injection_graph.inspect}"
+    _logger_debug "injection graph: #{injection_graph.inspect}" if Dependencies.log_activity
   end
 
   # Make sure any dependent constants of the constants added by <tt>yield</tt> are reloaded.
   def new_constants_in_with_injection(*descs, &block) # chain
-#    _logger_debug "has_many_polymorphs: NEW: autoloaded constants: #{autoloaded_constants.inspect}; #{explicitly_unloadable_constants.inspect}" if (autoloaded_constants + explicitly_unloadable_constants).any?
+
+    if Dependencies.log_activity
+      _logger_debug "autoloaded constants: #{autoloaded_constants.inspect}"
+      _logger_debug "explicitly unloadable constants: #{explicitly_unloadable_constants.inspect}" 
+    end
+    
     returning(new_constants_in_without_injection(*descs, &block)) do |found|
-#      _logger_debug "has_many_polymorphs: new constants: #{found.inspect}" if found.any?
+      _logger_debug "new constants: #{found.inspect}" if Dependencies.log_activity and found.any?
       found.each do |constant|
         injection_graph[constant].each do |requirement| 
           requirement.constantize
- #          _logger_debug "has_many_polymorphs: constantized #{requirement}"
+           _logger_debug "constantized #{requirement}" if Dependencies.log_activity
         end
       end    
     end

data/lib/has_many_polymorphs/support_methods.rb

@@ -58,15 +58,17 @@ class Object
 
   # Logger shortcut.
   def _logger_debug s
+    s = "** has_many_polymorphs: #{s}"
     RAILS_DEFAULT_LOGGER.debug(s) if RAILS_DEFAULT_LOGGER
   end  
 
   # Logger shortcut.  
   def _logger_warn s
+    s = "** has_many_polymorphs: #{s}"
     if RAILS_DEFAULT_LOGGER
       RAILS_DEFAULT_LOGGER.warn(s) 
     else
-      $stderr.puts("has_many_polymorphs: #{s}")
+      $stderr.puts(s)
     end    
   end
   

data/test/integration/app/README

@@ -0,0 +1,182 @@
+== Welcome to Rails
+
+Rails is a web-application and persistence framework that includes everything
+needed to create database-backed web-applications according to the
+Model-View-Control pattern of separation. This pattern splits the view (also
+called the presentation) into "dumb" templates that are primarily responsible
+for inserting pre-built data in between HTML tags. The model contains the
+"smart" domain objects (such as Account, Product, Person, Post) that holds all
+the business logic and knows how to persist themselves to a database. The
+controller handles the incoming requests (such as Save New Account, Update
+Product, Show Post) by manipulating the model and directing data to the view.
+
+In Rails, the model is handled by what's called an object-relational mapping
+layer entitled Active Record. This layer allows you to present the data from
+database rows as objects and embellish these data objects with business logic
+methods. You can read more about Active Record in
+link:files/vendor/rails/activerecord/README.html.
+
+The controller and view are handled by the Action Pack, which handles both
+layers by its two parts: Action View and Action Controller. These two layers
+are bundled in a single package due to their heavy interdependence. This is
+unlike the relationship between the Active Record and Action Pack that is much
+more separate. Each of these packages can be used independently outside of
+Rails.  You can read more about Action Pack in
+link:files/vendor/rails/actionpack/README.html.
+
+
+== Getting started
+
+1. At the command prompt, start a new rails application using the rails command
+   and your application name. Ex: rails myapp
+   (If you've downloaded rails in a complete tgz or zip, this step is already done)
+2. Change directory into myapp and start the web server: <tt>script/server</tt> (run with --help for options)
+3. Go to http://localhost:3000/ and get "Welcome aboard: You’re riding the Rails!"
+4. Follow the guidelines to start developing your application
+
+
+== Web Servers
+
+By default, Rails will try to use Mongrel and lighttpd if they are installed, otherwise
+Rails will use the WEBrick, the webserver that ships with Ruby. When you run script/server,
+Rails will check if Mongrel exists, then lighttpd and finally fall back to WEBrick. This ensures
+that you can always get up and running quickly.
+
+Mongrel is a Ruby-based webserver with a C-component (which requires compilation) that is
+suitable for development and deployment of Rails applications. If you have Ruby Gems installed,
+getting up and running with mongrel is as easy as: <tt>gem install mongrel</tt>.
+More info at: http://mongrel.rubyforge.org
+
+If Mongrel is not installed, Rails will look for lighttpd. It's considerably faster than
+Mongrel and WEBrick and also suited for production use, but requires additional
+installation and currently only works well on OS X/Unix (Windows users are encouraged
+to start with Mongrel). We recommend version 1.4.11 and higher. You can download it from
+http://www.lighttpd.net.
+
+And finally, if neither Mongrel or lighttpd are installed, Rails will use the built-in Ruby
+web server, WEBrick. WEBrick is a small Ruby web server suitable for development, but not
+for production.
+
+But of course its also possible to run Rails on any platform that supports FCGI.
+Apache, LiteSpeed, IIS are just a few. For more information on FCGI,
+please visit: http://wiki.rubyonrails.com/rails/pages/FastCGI
+
+
+== Debugging Rails
+
+Have "tail -f" commands running on the server.log and development.log. Rails will
+automatically display debugging and runtime information to these files. Debugging
+info will also be shown in the browser on requests from 127.0.0.1.
+
+
+== Breakpoints
+
+Breakpoint support is available through the script/breakpointer client. This
+means that you can break out of execution at any point in the code, investigate
+and change the model, AND then resume execution! Example:
+
+  class WeblogController < ActionController::Base
+    def index
+      @posts = Post.find(:all)
+      breakpoint "Breaking out from the list"
+    end
+  end
+
+So the controller will accept the action, run the first line, then present you
+with a IRB prompt in the breakpointer window. Here you can do things like:
+
+Executing breakpoint "Breaking out from the list" at .../webrick_server.rb:16 in 'breakpoint'
+
+  >> @posts.inspect
+  => "[#<Post:0x14a6be8 @attributes={\"title\"=>nil, \"body\"=>nil, \"id\"=>\"1\"}>,
+       #<Post:0x14a6620 @attributes={\"title\"=>\"Rails you know!\", \"body\"=>\"Only ten..\", \"id\"=>\"2\"}>]"
+  >> @posts.first.title = "hello from a breakpoint"
+  => "hello from a breakpoint"
+
+...and even better is that you can examine how your runtime objects actually work:
+
+  >> f = @posts.first
+  => #<Post:0x13630c4 @attributes={"title"=>nil, "body"=>nil, "id"=>"1"}>
+  >> f.
+  Display all 152 possibilities? (y or n)
+
+Finally, when you're ready to resume execution, you press CTRL-D
+
+
+== Console
+
+You can interact with the domain model by starting the console through <tt>script/console</tt>.
+Here you'll have all parts of the application configured, just like it is when the
+application is running. You can inspect domain models, change values, and save to the
+database. Starting the script without arguments will launch it in the development environment.
+Passing an argument will specify a different environment, like <tt>script/console production</tt>.
+
+To reload your controllers and models after launching the console run <tt>reload!</tt>
+
+To reload your controllers and models after launching the console run <tt>reload!</tt>
+
+
+
+== Description of contents
+
+app
+  Holds all the code that's specific to this particular application.
+
+app/controllers
+  Holds controllers that should be named like weblogs_controller.rb for
+  automated URL mapping. All controllers should descend from ApplicationController
+  which itself descends from ActionController::Base.
+
+app/models
+  Holds models that should be named like post.rb.
+  Most models will descend from ActiveRecord::Base.
+
+app/views
+  Holds the template files for the view that should be named like
+  weblogs/index.rhtml for the WeblogsController#index action. All views use eRuby
+  syntax.
+
+app/views/layouts
+  Holds the template files for layouts to be used with views. This models the common
+  header/footer method of wrapping views. In your views, define a layout using the
+  <tt>layout :default</tt> and create a file named default.rhtml. Inside default.rhtml,
+  call <% yield %> to render the view using this layout.
+
+app/helpers
+  Holds view helpers that should be named like weblogs_helper.rb. These are generated
+  for you automatically when using script/generate for controllers. Helpers can be used to
+  wrap functionality for your views into methods.
+
+config
+  Configuration files for the Rails environment, the routing map, the database, and other dependencies.
+
+components
+  Self-contained mini-applications that can bundle together controllers, models, and views.
+
+db
+  Contains the database schema in schema.rb.  db/migrate contains all
+  the sequence of Migrations for your schema.
+
+doc
+  This directory is where your application documentation will be stored when generated
+  using <tt>rake doc:app</tt>
+
+lib
+  Application specific libraries. Basically, any kind of custom code that doesn't
+  belong under controllers, models, or helpers. This directory is in the load path.
+
+public
+  The directory available for the web server. Contains subdirectories for images, stylesheets,
+  and javascripts. Also contains the dispatchers and the default HTML files. This should be
+  set as the DOCUMENT_ROOT of your web server.
+
+script
+  Helper scripts for automation and generation.
+
+test
+  Unit and functional tests along with fixtures. When using the script/generate scripts, template
+  test files will be generated for you and placed in this directory.
+
+vendor
+  External libraries that the application depends on. Also includes the plugins subdirectory.
+  This directory is in the load path.