spree 0.7.1 → 0.8.0

data/vendor/plugins/has_many_polymorphs/README

@@ -1,205 +0,0 @@
-Has_many_polymorphs
-
-An ActiveRecord plugin for self-referential and double-sided polymorphic associations.
-
-== License
-
-Copyright 2006-2008 Cloudburst, LLC. Licensed under the AFL 3. See the included LICENSE file. 
-
-The public certificate for the gem is here[http://rubyforge.org/frs/download.php/25331/evan_weaver-original-public_cert.pem]. 
-
-If you use this software, please {make a donation}[http://blog.evanweaver.com/donate/], or {recommend Evan}[http://www.workingwithrails.com/person/7739-evan-weaver] at Working with Rails.
-
-== Description
-
-This plugin lets you define self-referential and double-sided polymorphic associations in your models. It is an extension of <tt>has_many :through</tt>.
-
-“Polymorphic” means an association can freely point to any of several unrelated model classes, instead of being tied to one particular class.
-
-== Features
-
-* self-references
-* double-sided polymorphism
-* efficient database usage
-* STI support
-* namespace support
-* automatic individual and reverse associations
-
-The plugin also includes a generator for a tagging system, a common use case (see below).
-
-== Requirements
-
-* Rails 1.2.3 or greater
-
-= Usage
-
-== Installation
-
-To install the Rails plugin, run:
-  script/plugin install git://github.com/fauna/has_many_polymorphs.git
-
-There's also a gem version. To install it instead, run: 
-  sudo gem install has_many_polymorphs
-  
-If you are using the gem, make sure to add <tt>require 'has_many_polymorphs'</tt> to <tt>environment.rb</tt>, before Rails::Initializer block.
-
-== Configuration
-
-Setup the parent model as so:
-
-  class Kennel < ActiveRecord::Base
-    has_many_polymorphs :guests, :from => [:dogs, :cats, :birds]
-  end
-
-The join model:
-
-  class GuestsKennel < ActiveRecord::Base
-    belongs_to :kennel
-    belongs_to :guest, :polymorphic => true
-  end
-
-One of the child models:
-
-  class Dog < ActiveRecord::Base
-    # nothing
-  end
-
-For your parent and child models, you don't need any special fields in your migration. For the join model (GuestsKennel), use a migration like so:
-
-  class CreateGuestsKennels < ActiveRecord::Migration
-    def self.up
-      create_table :guests_kennels do |t|
-        t.references :guest, :polymorphic => true
-        t.references :kennel
-      end
-    end
-  
-    def self.down
-      drop_table :guests_kennels
-    end
-  end
-
-See ActiveRecord::Associations::PolymorphicClassMethods for more configuration options.
-
-== Helper methods example
-
-  >> k = Kennel.find(1)
-  #<Kennel id: 1, name: "Happy Paws">
-  >> k.guests.map(&:class) 
-  [Dog, Cat, Cat, Bird]
-  
-  >> k.guests.push(Cat.create); k.cats.size
-  3
-  >> k.guests << Cat.create; k.cats.size
-  4
-  >> k.guests.size
-  6
-
-  >> d = k.dogs.first
-  #<Dog id: 3, name: "Rover">
-  >> d.kennels 
-  [#<Kennel id: 1, name: "Happy Paws">]
-  
-  >> k.guests.delete(d); k.dogs.size
-  0
-  >> k.guests.size
-  5  
-  
-Note that the parent method is always plural, even if there is only one parent (<tt>Dog#kennels</tt>, not <tt>Dog#kennel</tt>).
-
-See ActiveRecord::Associations::PolymorphicAssociation for more helper method details.
-
-= Extras
-
-== Double-sided polymorphism
-
-Double-sided relationships are defined on the join model:
-
-  class Devouring < ActiveRecord::Base
-    belongs_to :guest, :polymorphic => true
-    belongs_to :eaten, :polymorphic => true
-  
-    acts_as_double_polymorphic_join(
-      :guests =>[:dogs, :cats], 
-      :eatens => [:cats, :birds]
-    )       
-  end
-  
-Now, dogs and cats can eat birds and cats. Birds can't eat anything (they aren't <tt>guests</tt>) and dogs can't be eaten by anything (since they aren't <tt>eatens</tt>). The keys stand for what the models are, not what they do. 
-
-In this case, each guest/eaten relationship is called a Devouring.
-
-In your migration, you need to declare both sides as polymorphic:
-
-  class CreateDevourings < ActiveRecord::Migration
-    def self.up
-      create_table :devourings do |t|
-        t.references :guest, :polymorphic => true
-        t.references :eaten, :polymorphic => true
-      end
-    end
-  
-    def self.down
-      drop_table :devourings
-    end
-  end
-
-See ActiveRecord::Associations::PolymorphicClassMethods for more.
-
-== Tagging generator
-
-Has_many_polymorphs includes a tagging system generator. Run:
-  script/generate tagging Dog Cat [...MoreModels...]
-
-This adds a migration and new Tag and Tagging models in <tt>app/models</tt>. It configures Tag with an appropriate <tt>has_many_polymorphs</tt> call against the models you list at the command line. It also adds the file <tt>lib/tagging_extensions.rb</tt> and <tt>requires</tt> it in <tt>environment.rb</tt>. 
-
-Tests will also be generated. 
-
-Once you've run the generator, you can tag records as follows:
-
-  >> d = Dog.create(:name => "Rover")
-  #<Dog id: 3, name: "Rover">
-  >> d.tag_list
-  ""
-  >> d.tag_with "fierce loud"
-  #<Dog id: 3, name: "Rover">
-  >> d.tag_list
-  "fierce loud"
-  >> c = Cat.create(:name => "Chloe")
-  #<Cat id: 1, name: "Chloe">
-  >> c.tag_with "fierce cute"
-  #<Cat id: 1, name: "Chloe">
-  >> c.tag_list
-  "cute fierce"
-  >> Tag.find_by_name("fierce").taggables 
-  [#<Cat id: 1, name: "Chloe">, #<Dog id: 3, name: "Rover">]
-
-The generator accepts the optional flag <tt>--skip-migration</tt> to skip generating a migration (for example, if you are converting from <tt>acts_as_taggable</tt>). It also accepts the flag <tt>--self-referential</tt> if you want to be able to tag tags.
-
-See ActiveRecord::Base::TaggingExtensions, Tag, and Tagging for more.
-
-== Troubleshooting
-
-Some debugging tools are available in <tt>lib/has_many_polymorphs/debugging_tools.rb</tt>.
-
-If you are having trouble, think very carefully about how your model classes, key columns, and table names relate. You may have to explicitly specify options on your join model such as <tt>:class_name</tt>, <tt>:foreign_key</tt>, or <tt>:as</tt>. The included tests are a good place to look for examples.
-
-Note that because of the way Rails reloads model classes, the plugin can sometimes bog down your development server. Set <tt>config.cache_classes = true</tt> in <tt>config/environments/development.rb</tt> to avoid this. 
-
-== Reporting problems
-
-The support forum is here[http://rubyforge.org/forum/forum.php?forum_id=16450].
-
-Patches and contributions are very welcome. Please note that contributors are required to assign copyright for their additions to Cloudburst, LLC.
-
-== Further resources
-
-* http://blog.evanweaver.com/articles/2007/08/15/polymorphs-tutorial
-* http://blog.evanweaver.com/articles/2007/02/22/polymorphs-25-total-insanity-branch
-* http://blog.evanweaver.com/articles/2007/02/09/how-to-find-the-most-popular-tags
-* http://blog.evanweaver.com/articles/2007/01/13/growing-up-your-acts_as_taggable
-* http://blog.evanweaver.com/articles/2006/12/02/polymorphs-19
-* http://blog.evanweaver.com/articles/2006/11/05/directed-double-polymorphic-associations
-* http://blog.evanweaver.com/articles/2006/11/04/namespaced-model-support-in-has_many_polymorphs
-* http://blog.evanweaver.com/articles/2006/09/26/sti-support-in-has_many_polymorphs
-* http://blog.evanweaver.com/articles/2006/09/11/make-polymorphic-children-belong-to-only-one-parent

data/vendor/plugins/has_many_polymorphs/Rakefile

@@ -1,28 +0,0 @@
-
-require 'echoe'
-
-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/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/    
-  p.require_signed = true
-  p.clean_pattern += ["**/ruby_sess*", "**/generated_models/**"]
-  p.test_pattern = ["test/unit/*_test.rb", "test/integration/*_test.rb", "test/generator/*_test.rb"]
-end
-
-desc "Run all the tests for every database adapter" 
-task "test_all" do
-  ['mysql', 'postgresql', 'sqlite3'].each do |adapter|
-    ENV['DB'] = adapter
-    ENV['PRODUCTION'] = nil
-    STDERR.puts "#{'='*80}\nDevelopment mode for #{adapter}\n#{'='*80}"
-    system("rake test:multi_rails:all")
-  
-    ENV['PRODUCTION'] = '1'
-    STDERR.puts "#{'='*80}\nProduction mode for #{adapter}\n#{'='*80}"
-    system("rake test:multi_rails:all")    
-  end
-end

data/vendor/plugins/has_many_polymorphs/TODO

@@ -1,2 +0,0 @@
-
-* Tag cloud method

data/vendor/plugins/has_many_polymorphs/examples/hmph.rb

@@ -1,69 +0,0 @@
-require 'camping'
-require 'has_many_polymorphs'
-
-Camping.goes :Hmph
-
-module Hmph::Models
-  class GuestsKennel < Base
-    belongs_to :kennel
-    belongs_to :guest, :polymorphic => true
-  end
-
-  class Dog < Base
-  end
-
-  class Cat < Base
-  end
-
-  class Bird < Base
-  end
-  
-  class Kennel < Base
-    has_many_polymorphs :guests, 
-      :from => [:dogs, :cats, :birds],
-      :through => :guests_kennels,
-      :namespace => :"hmph/models/"      
-  end  
-
-  class InitialSchema < V 1.0
-    def self.up
-      create_table :hmph_kennels do |t|
-        t.column :created_at, :datetime
-        t.column :modified_at, :datetime
-        t.column :name, :string, :default => 'Anonymous Kennel'
-      end
-
-      create_table :hmph_guests_kennels do |t|
-        t.column :guest_id, :integer
-        t.column :guest_type, :string
-        t.column :kennel_id, :integer
-      end
-
-      create_table :hmph_dogs do |t|
-        t.column :name, :string, :default => 'Fido'
-      end
-
-      create_table :hmph_cats do |t|
-        t.column :name, :string, :default => 'Morris'
-      end
-
-      create_table :hmph_birds do |t|
-        t.column :name, :string, :default => 'Polly'
-      end
-    end
-
-    def self.down
-      drop_table :hmph_kennels
-      drop_table :hmph_guests_kennels
-      drop_table :hmph_dogs
-      drop_table :hmph_cats
-      drop_table :hmph_birds
-    end
-  end
-end
-
-module Hmph::Controllers
-end
-
-module Hmph::Views
-end

data/vendor/plugins/has_many_polymorphs/generators/tagging/tagging_generator.rb

@@ -1,97 +0,0 @@
-require 'ruby-debug' and Debugger.start if ENV['USER'] == 'eweaver'
-
-class TaggingGenerator < Rails::Generator::NamedBase
-  default_options :skip_migration => false
-  default_options :self_referential => false
-  attr_reader :parent_association_name
-  attr_reader :taggable_models
-
-  def initialize(runtime_args, runtime_options = {})
-    parse!(runtime_args, runtime_options)
-    
-    @parent_association_name = (runtime_args.include?("--self-referential") ? "tagger" : "tag")
-    @taggable_models = runtime_args.reject{|opt| opt =~ /^--/}.map do |taggable|
-      ":" + taggable.underscore.pluralize
-    end
-    @taggable_models += [":tags"] if runtime_args.include?("--self-referential") 
-    @taggable_models.uniq!
-        
-    verify @taggable_models
-    hacks     
-    runtime_args.unshift("placeholder")
-    super
-  end
-  
-  def verify models
-    puts "** Warning: only one taggable model specified; tests may not run properly." if models.size < 2
-    models.each do |model|
-      model = model[1..-1].classify
-      next if model == "Tag" # don't load ourselves when --self-referential is used
-      self.class.const_get(model) rescue puts "** Error: model #{model[1..-1].classify} could not be loaded." or exit
-    end
-  end
-  
-  def hacks    
-    # add the extension require in environment.rb
-    phrase = "require 'tagging_extensions'"
-    filename = "#{RAILS_ROOT}/config/environment.rb"
-    unless (open(filename) do |file|
-      file.grep(/#{Regexp.escape phrase}/).any?
-    end)
-      open(filename, 'a+') do |file|
-        file.puts "\n" + phrase + "\n"
-      end
-    end
-  end
-  
-  def manifest
-    record do |m|
-      m.class_collisions class_path, class_name, "#{class_name}Test"
-
-      m.directory File.join('app/models', class_path)
-      m.directory File.join('test/unit', class_path)
-      m.directory File.join('test/fixtures', class_path)
-      m.directory File.join('test/fixtures', class_path)
-      m.directory File.join('lib')
-
-      m.template 'tag.rb', File.join('app/models', class_path, "tag.rb")
-      m.template 'tag_test.rb', File.join('test/unit', class_path, "tag_test.rb")
-      m.template 'tags.yml', File.join('test/fixtures', class_path, "tags.yml")
-      
-      m.template 'tagging.rb', File.join('app/models', class_path, "tagging.rb")
-      m.template 'tagging_test.rb', File.join('test/unit', class_path, "tagging_test.rb")
-      m.template 'taggings.yml', File.join('test/fixtures', class_path, "taggings.yml")
-      
-      m.template 'tagging_extensions.rb', File.join('lib', 'tagging_extensions.rb')
-
-      unless options[:skip_migration]
-        m.migration_template 'migration.rb', 'db/migrate',
-          :migration_file_name => "create_tags_and_taggings"
-      end
-      
-    end
-  end
-
-  protected
-    def banner
-      "Usage: #{$0} generate tagging [TaggableModelA TaggableModelB ...]"
-    end
-
-    def add_options!(opt)
-      opt.separator ''
-      opt.separator 'Options:'
-      opt.on("--skip-migration", 
-             "Don't generate a migration file for this model") { |v| options[:skip_migration] = v }
-      opt.on("--self-referential",
-             "Allow tags to tag themselves.") { |v| options[:self_referential] = v }
-    end
-    
-    # Useful for generating tests/fixtures
-    def model_one
-      taggable_models[0][1..-1].classify
-    end
-    
-    def model_two
-      taggable_models[1][1..-1].classify rescue model_one
-    end
-end

data/vendor/plugins/has_many_polymorphs/generators/tagging/templates/migration.rb

@@ -1,28 +0,0 @@
-
-# A migration to add tables for Tag and Tagging. This file is automatically generated and added to your app if you run the tagging generator included with has_many_polymorphs.
-
-class CreateTagsAndTaggings < ActiveRecord::Migration
-
-  # Add the new tables.
-  def self.up
-    create_table :tags do |t|
-      t.column :name, :string, :null => false
-    end
-    add_index :tags, :name, :unique => true
-
-    create_table :taggings do |t|
-      t.column :<%= parent_association_name -%>_id, :integer, :null => false
-      t.column :taggable_id, :integer, :null => false
-      t.column :taggable_type, :string, :null => false
-      # t.column :position, :integer # Uncomment this if you need to use <tt>acts_as_list</tt>.
-    end
-    add_index :taggings, [:<%= parent_association_name -%>_id, :taggable_id, :taggable_type], :unique => true    
-  end
-
-  # Remove the tables.
-  def self.down
-    drop_table :tags
-    drop_table :taggings
-  end
-
-end

data/vendor/plugins/has_many_polymorphs/generators/tagging/templates/tag.rb

@@ -1,39 +0,0 @@
-
-# The Tag model. This model is automatically generated and added to your app if you run the tagging generator included with has_many_polymorphs.
-
-class Tag < ActiveRecord::Base
-
-  DELIMITER = " " # Controls how to split and join tagnames from strings. You may need to change the <tt>validates_format_of parameters</tt> if you change this.
-
-  # If database speed becomes an issue, you could remove these validations and rescue the ActiveRecord database constraint errors instead.
-  validates_presence_of :name
-  validates_uniqueness_of :name, :case_sensitive => false
-  
-  # Change this validation if you need more complex tag names.
-  validates_format_of :name, :with => /^[a-zA-Z0-9\_\-]+$/, :message => "can not contain special characters"
-  
-  # Set up the polymorphic relationship.
-  has_many_polymorphs :taggables, 
-    :from => [<%= taggable_models.join(", ") %>], 
-    :through => :taggings, 
-    :dependent => :destroy,
-<% if options[:self_referential] -%>    :as => :<%= parent_association_name -%>,
-<% end -%>
-    :skip_duplicates => false, 
-    :parent_extend => proc {
-      # Defined on the taggable models, not on Tag itself. Return the tagnames associated with this record as a string.
-      def to_s
-        self.map(&:name).sort.join(Tag::DELIMITER)
-      end
-    }
-    
-  # Callback to strip extra spaces from the tagname before saving it. If you allow tags to be renamed later, you might want to use the <tt>before_save</tt> callback instead.
-  def before_create 
-    self.name = name.downcase.strip.squeeze(" ")
-  end
-  
-  # Tag::Error class. Raised by ActiveRecord::Base::TaggingExtensions if something goes wrong.
-  class Error < StandardError
-  end
-    
-end