RubyGems - taxonomy - Versions diffs - 0.0.1 - Mend

taxonomy 0.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (68) hide show

data/MIT-LICENSE +20 -0
data/README.rdoc +28 -0
data/Rakefile +31 -0
data/lib/generators/taxonomy/migration/migration_generator.rb +39 -0
data/lib/generators/taxonomy/migration/templates/active_record/migration.rb +36 -0
data/lib/tasks/taxonomy_tasks.rake +4 -0
data/lib/taxonomy.rb +25 -0
data/lib/taxonomy/group_helper.rb +12 -0
data/lib/taxonomy/has_tagger.rb +52 -0
data/lib/taxonomy/has_taxonomy.rb +502 -0
data/lib/taxonomy/tag.rb +485 -0
data/lib/taxonomy/tag_list.rb +97 -0
data/lib/taxonomy/tagging.rb +12 -0
data/lib/taxonomy/tags_helper.rb +13 -0
data/lib/taxonomy/version.rb +3 -0
data/spec/dummy/Rakefile +7 -0
data/spec/dummy/app/controllers/application_controller.rb +3 -0
data/spec/dummy/app/helpers/application_helper.rb +2 -0
data/spec/dummy/app/models/altered_inheriting_taggable_model.rb +3 -0
data/spec/dummy/app/models/inheriting_taggable_model.rb +2 -0
data/spec/dummy/app/models/other_taggable_model.rb +4 -0
data/spec/dummy/app/models/post.rb +2 -0
data/spec/dummy/app/models/taggable_model.rb +6 -0
data/spec/dummy/app/models/taggable_user.rb +3 -0
data/spec/dummy/app/models/treed_model.rb +3 -0
data/spec/dummy/app/models/untaggable_model.rb +2 -0
data/spec/dummy/app/views/layouts/application.html.erb +14 -0
data/spec/dummy/config.ru +4 -0
data/spec/dummy/config/application.rb +45 -0
data/spec/dummy/config/boot.rb +10 -0
data/spec/dummy/config/database.yml +19 -0
data/spec/dummy/config/environment.rb +5 -0
data/spec/dummy/config/environments/development.rb +30 -0
data/spec/dummy/config/environments/production.rb +60 -0
data/spec/dummy/config/environments/test.rb +39 -0
data/spec/dummy/config/initializers/backtrace_silencers.rb +7 -0
data/spec/dummy/config/initializers/inflections.rb +10 -0
data/spec/dummy/config/initializers/mime_types.rb +5 -0
data/spec/dummy/config/initializers/secret_token.rb +7 -0
data/spec/dummy/config/initializers/session_store.rb +8 -0
data/spec/dummy/config/initializers/wrap_parameters.rb +14 -0
data/spec/dummy/config/locales/en.yml +5 -0
data/spec/dummy/config/routes.rb +58 -0
data/spec/dummy/db/migrate/20111221004133_create_posts.rb +8 -0
data/spec/dummy/db/migrate/20111221023928_taxonomy_migration.rb +35 -0
data/spec/dummy/db/migrate/20111221024100_create_bulk.rb +18 -0
data/spec/dummy/db/schema.rb +65 -0
data/spec/dummy/db/test.sqlite3 +0 -0
data/spec/dummy/log/test.log +100915 -0
data/spec/dummy/public/404.html +26 -0
data/spec/dummy/public/422.html +26 -0
data/spec/dummy/public/500.html +26 -0
data/spec/dummy/public/favicon.ico +0 -0
data/spec/dummy/script/rails +6 -0
data/spec/factories/posts.rb +6 -0
data/spec/generators/taxonomy/migration/migration_generator_spec.rb +22 -0
data/spec/models/post_spec.rb +5 -0
data/spec/spec_helper.rb +30 -0
data/spec/taxonomy/group_helper_spec.rb +21 -0
data/spec/taxonomy/has_tagger_spec.rb +113 -0
data/spec/taxonomy/has_taxonomy_spec.rb +226 -0
data/spec/taxonomy/tag_list_spec.rb +70 -0
data/spec/taxonomy/tag_spec.rb +462 -0
data/spec/taxonomy/taggable_spec.rb +262 -0
data/spec/taxonomy/tagger_spec.rb +40 -0
data/spec/taxonomy/tagging_spec.rb +25 -0
data/spec/taxonomy/tags_helper_spec.rb +29 -0
metadata +225 -0

data/spec/dummy/public/404.html ADDED Viewed

@@ -0,0 +1,26 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <title>The page you were looking for doesn't exist (404)</title>
+  <style type="text/css">
+    body { background-color: #fff; color: #666; text-align: center; font-family: arial, sans-serif; }
+    div.dialog {
+      width: 25em;
+      padding: 0 4em;
+      margin: 4em auto 0 auto;
+      border: 1px solid #ccc;
+      border-right-color: #999;
+      border-bottom-color: #999;
+    }
+    h1 { font-size: 100%; color: #f00; line-height: 1.5em; }
+  </style>
+</head>
+<body>
+  <!-- This file lives in public/404.html -->
+  <div class="dialog">
+    <h1>The page you were looking for doesn't exist.</h1>
+    <p>You may have mistyped the address or the page may have moved.</p>
+  </div>
+</body>
+</html>

data/spec/dummy/public/422.html ADDED Viewed

@@ -0,0 +1,26 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <title>The change you wanted was rejected (422)</title>
+  <style type="text/css">
+    body { background-color: #fff; color: #666; text-align: center; font-family: arial, sans-serif; }
+    div.dialog {
+      width: 25em;
+      padding: 0 4em;
+      margin: 4em auto 0 auto;
+      border: 1px solid #ccc;
+      border-right-color: #999;
+      border-bottom-color: #999;
+    }
+    h1 { font-size: 100%; color: #f00; line-height: 1.5em; }
+  </style>
+</head>
+<body>
+  <!-- This file lives in public/422.html -->
+  <div class="dialog">
+    <h1>The change you wanted was rejected.</h1>
+    <p>Maybe you tried to change something you didn't have access to.</p>
+  </div>
+</body>
+</html>

data/spec/dummy/public/500.html ADDED Viewed

@@ -0,0 +1,26 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <title>We're sorry, but something went wrong (500)</title>
+  <style type="text/css">
+    body { background-color: #fff; color: #666; text-align: center; font-family: arial, sans-serif; }
+    div.dialog {
+      width: 25em;
+      padding: 0 4em;
+      margin: 4em auto 0 auto;
+      border: 1px solid #ccc;
+      border-right-color: #999;
+      border-bottom-color: #999;
+    }
+    h1 { font-size: 100%; color: #f00; line-height: 1.5em; }
+  </style>
+</head>
+<body>
+  <!-- This file lives in public/500.html -->
+  <div class="dialog">
+    <h1>We're sorry, but something went wrong.</h1>
+    <p>We've been notified about this issue and we'll take a look at it shortly.</p>
+  </div>
+</body>
+</html>

data/spec/dummy/public/favicon.ico ADDED Viewed

File without changes

data/spec/dummy/script/rails ADDED Viewed

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# This command will automatically be run when you run "rails" with Rails 3 gems installed from the root of your application.
+APP_PATH = File.expand_path('../../config/application',  __FILE__)
+require File.expand_path('../../config/boot',  __FILE__)
+require 'rails/commands'

data/spec/factories/posts.rb ADDED Viewed

@@ -0,0 +1,6 @@
+# Read about factories at http://github.com/thoughtbot/factory_girl
+FactoryGirl.define do
+  factory :post do
+  end
+end

data/spec/generators/taxonomy/migration/migration_generator_spec.rb ADDED Viewed

@@ -0,0 +1,22 @@
+require 'spec_helper'
+# Generators are not automatically loaded by Rails
+require 'generators/taxonomy/migration/migration_generator'
+describe Taxonomy::MigrationGenerator do
+  # Tell the generator where to put its output (what it thinks of as Rails.root)
+  destination File.expand_path("../../../../../tmp", __FILE__)
+  before do
+    prepare_destination
+    Rails::Generators.options[:rails][:orm] = :active_record
+  end
+  describe 'no arguments' do
+    before { run_generator  }
+    describe 'db/migrate/taxonomy_migration.rb' do
+      subject { file('db/migrate/taxonomy_migration.rb') }
+      it { should be_a_migration }
+    end
+  end
+end

data/spec/models/post_spec.rb ADDED Viewed

@@ -0,0 +1,5 @@
+require 'spec_helper'
+describe Post do
+  pending "add some examples to (or delete) #{__FILE__}"
+end

data/spec/spec_helper.rb ADDED Viewed

@@ -0,0 +1,30 @@
+# This file is copied to spec/ when you run 'rails generate rspec:install'
+ENV["RAILS_ENV"] ||= 'test'
+# require File.expand_path("../../config/environment", __FILE__)
+require 'ruby-debug'
+require File.expand_path(File.dirname(__FILE__) + "/dummy/config/environment", __FILE__)
+require 'rspec/rails'
+require 'factory_girl_rails'
+require 'ammeter/init'
+# Requires supporting ruby files with custom matchers and macros, etc,
+# in spec/support/ and its subdirectories.
+# Dir[Rails.root.join("spec/support/**/*.rb")].each {|f| require f}
+Dir[File.dirname(__FILE__) + "/support/**/*.rb"].each {|f| require f}
+Dir[File.dirname(__FILE__) + "/factories/**/*.rb"].each {|f| require f}
+RSpec.configure do |config|
+  # == Mock Framework
+  #
+  # If you prefer to use mocha, flexmock or RR, uncomment the appropriate line:
+  #
+  # config.mock_with :mocha
+  # config.mock_with :flexmock
+  # config.mock_with :rr
+  # If you're not using ActiveRecord, or you'd prefer not to run each of your
+  # examples within a transaction, remove the following line or assign false
+  # instead of true.
+  config.use_transactional_fixtures = true
+end

data/spec/taxonomy/group_helper_spec.rb ADDED Viewed

@@ -0,0 +1,21 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+describe "Group Helper" do
+  before(:each) do
+    # clean_database!
+  end
+  describe "grouped_column_names_for method" do
+    before(:each) do
+      @taggable = TaggableModel.new(:name => "Bob Jones")
+    end
+    it "should return all column names joined for Tag GROUP clause" do
+      @taggable.grouped_column_names_for(Tag).should == "tags.id, tags.parent_id, tags.lft, tags.rgt, tags.name, tags.context, tags.slug"
+    end
+    it "should return all column names joined for TaggableModel GROUP clause" do
+      @taggable.grouped_column_names_for(TaggableModel).should == "taggable_models.id, taggable_models.name, taggable_models.type"
+    end
+  end
+end

data/spec/taxonomy/has_tagger_spec.rb ADDED Viewed

@@ -0,0 +1,113 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+describe "acts_as_tagger" do
+  before(:each) do
+    # clean_database!
+  end
+  context "Tagger Method Generation" do
+    before(:each) do
+      @tagger = TaggableUser.new()
+    end
+    it "should add #is_tagger? query method to the class-side" do
+      TaggableUser.should respond_to(:is_tagger?)
+    end
+    it "should return true from the class-side #is_tagger?" do
+      TaggableUser.is_tagger?.should be_true
+    end
+    it "should return false from the base #is_tagger?" do
+      ActiveRecord::Base.is_tagger?.should be_false
+    end
+    it "should add #is_tagger? query method to the singleton" do
+      @tagger.should respond_to(:is_tagger?)
+    end
+    it "should add #tag method on the instance-side" do
+      @tagger.should respond_to(:tag)
+    end
+    it "should generate an association for #owned_taggings and #owned_tags" do
+      @tagger.should respond_to(:owned_taggings, :owned_tags)
+    end
+  end
+  describe "#tag" do
+    context 'when called with a non-existent tag context' do
+      before(:each) do
+        @tagger = TaggableUser.new()
+        @taggable = TaggableModel.new(:name=>"Richard Prior")
+      end
+      it "should by default not throw an exception " do
+        @taggable.tag_list_on(:foo).should be_empty
+        lambda {
+          @tagger.tag(@taggable, :with=>'this, and, that', :on=>:foo)
+        }.should_not raise_error
+      end
+      it 'should by default create the tag context on-the-fly' do
+        @taggable.tag_list_on(:here_ond_now).should be_empty
+        @tagger.tag(@taggable, :with=>'that', :on => :here_ond_now)
+        @taggable.tag_list_on(:here_ond_now).should_not include('that')
+        @taggable.all_tags_list_on(:here_ond_now).should include('that')
+      end
+      it "should show all the tag list when both public and owned tags exist" do
+        @taggable.tag_list = 'ruby, python'
+        @tagger.tag(@taggable, :with => 'java, lisp', :on => :tags)
+        @taggable.all_tags_on(:tags).map(&:name).sort.should == %w(ruby python java lisp).sort
+      end
+      it "should not add owned tags to the common list" do
+        @taggable.tag_list = 'ruby, python'
+        @tagger.tag(@taggable, :with => 'java, lisp', :on => :foo)
+        @tagger.tag(@taggable, :with => '', :on => :foo)
+        @taggable.tag_list.should == %w(ruby python)
+      end
+      it "should throw an exception when the default is over-ridden" do
+        @taggable.tag_list_on(:foo_boo).should be_empty
+        lambda {
+          @tagger.tag(@taggable, :with=>'this, and, that', :on=>:foo_boo, :force=>false)
+        }.should raise_error
+      end
+      it "should not create the tag context on-the-fly when the default is over-ridden" do
+        @taggable.tag_list_on(:foo_boo).should be_empty
+        @tagger.tag(@taggable, :with=>'this, and, that', :on=>:foo_boo, :force=>false) rescue
+        @taggable.tag_list_on(:foo_boo).should be_empty
+      end
+    end
+    context "when called by multiple tagger's" do
+      before(:each) do
+        @user_x = TaggableUser.create(:name => "User X")
+        @user_y = TaggableUser.create(:name => "User Y")
+        @taggable = TaggableModel.create(:name => 'has_taxonomy_on', :tag_list => 'plugin')
+        @user_x.tag(@taggable, :with => 'ruby, rails',  :on => :tags)
+        @user_y.tag(@taggable, :with => 'ruby, plugin', :on => :tags)
+        @user_y.tag(@taggable, :with => '', :on => :tags)
+        @user_y.tag(@taggable, :with => '', :on => :tags)
+      end
+      it "should delete owned tags" do
+        @user_y.owned_tags.should == []
+      end
+      it "should not delete other taggers tags" do
+        @user_x.owned_tags.should have(2).items
+      end
+      it "should not delete original tags" do
+        @taggable.all_tags_list_on(:tags).should include('plugin')
+      end
+    end
+  end
+end

data/spec/taxonomy/has_taxonomy_spec.rb ADDED Viewed

@@ -0,0 +1,226 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+describe "Acts As Taxonomy" do
+  before(:each) do
+    # clean_database!
+  end
+  it "should provide a class method 'taggable?' that is false for untaggable models" do
+    UntaggableModel.should_not be_taggable
+  end
+  describe "Treed Taggings Method Generation" do
+    before(:each) do
+      [TreedModel, Tag, Tagging].each(&:delete_all)
+      @taggable = TreedModel.new(:name => "Bob Jones")
+    end
+    it "should respond 'true' to tag_type_treed?" do
+      TreedModel.should be_categories_treed
+    end
+  end
+  describe "Taggable Method Generation" do
+    before(:each) do
+      [TaggableModel, Tag, Tagging, TaggableUser].each(&:delete_all)
+      @taggable = TaggableModel.new(:name => "Bob Jones")
+    end
+    it "should respond 'true' to taggable?" do
+      @taggable.class.should be_taggable
+    end
+    it "should respond 'false' to tag_type_treed?" do
+      TaggableModel.should_not be_skills_treed
+    end
+    it "should create a class attribute for tag types" do
+      @taggable.class.should respond_to(:tag_types)
+    end
+    it "should create an instance attribute for tag types" do
+      @taggable.should respond_to(:tag_types)
+    end
+    it "should generate an association for each tag type" do
+      @taggable.should respond_to(:tags, :skills, :languages)
+    end
+    it "should generate a cached column checker for each tag type" do
+     TaggableModel.should respond_to(:caching_tag_list?, :caching_skill_list?, :caching_language_list?)
+    end
+    it "should add tagged_with and tag_counts to singleton" do
+      TaggableModel.should respond_to(:find_tagged_with, :tag_counts)
+    end
+    it "should add saving of tag lists and cached tag lists to the instance" do
+      @taggable.should respond_to(:save_cached_tag_list)
+      @taggable.should respond_to(:save_tags)
+    end
+    it "should generate a tag_list accessor/setter for each tag type" do
+      @taggable.should respond_to(:tag_list, :skill_list, :language_list)
+      @taggable.should respond_to(:tag_list=, :skill_list=, :language_list=)
+    end
+  end
+  describe "Single Table Inheritance" do
+    before do
+      @taggable = TaggableModel.new(:name => "taggable")
+      @inherited_same = InheritingTaggableModel.new(:name => "inherited same")
+      @inherited_different = AlteredInheritingTaggableModel.new(:name => "inherited different")
+    end
+    it "should pass on tag contexts to STI-inherited models" do
+      @inherited_same.should respond_to(:tag_list, :skill_list, :language_list)
+      @inherited_different.should respond_to(:tag_list, :skill_list, :language_list)
+    end
+    it "should have tag contexts added in altered STI models" do
+      @inherited_different.should respond_to(:part_list)
+    end
+  end
+  describe "Reloading" do
+    it "should save a model instantiated by Model.find" do
+      taggable = TaggableModel.create!(:name => "Taggable")
+      found_taggable = TaggableModel.find(taggable.id)
+      found_taggable.save
+    end
+  end
+  describe "Related Objects" do
+    it "should find related objects based on tag names on context" do
+      taggable1 = TaggableModel.create!(:name => "Taggable 1")
+      taggable2 = TaggableModel.create!(:name => "Taggable 2")
+      taggable3 = TaggableModel.create!(:name => "Taggable 3")
+      taggable1.tag_list = "one, two"
+      taggable1.save
+      taggable2.tag_list = "three, four"
+      taggable2.save
+      taggable3.tag_list = "one, four"
+      taggable3.save
+      taggable1.find_related_tags.should include(taggable3)
+      taggable1.find_related_tags.should_not include(taggable2)
+    end
+    it "should find other related objects based on tag names on context" do
+      taggable1 = TaggableModel.create!(:name => "Taggable 1")
+      taggable2 = OtherTaggableModel.create!(:name => "Taggable 2")
+      taggable3 = OtherTaggableModel.create!(:name => "Taggable 3")
+      taggable1.tag_list = "one, two"
+      taggable1.save
+      taggable2.tag_list = "three, four"
+      taggable2.save
+      taggable3.tag_list = "one, four"
+      taggable3.save
+      taggable1.find_related_tags_for(OtherTaggableModel).should include(taggable3)
+      taggable1.find_related_tags_for(OtherTaggableModel).should_not include(taggable2)
+    end
+    it "should not include the object itself in the list of related objects" do
+      taggable1 = TaggableModel.create!(:name => "Taggable 1")
+      taggable2 = TaggableModel.create!(:name => "Taggable 2")
+      taggable1.tag_list = "one"
+      taggable1.save
+      taggable2.tag_list = "one, two"
+      taggable2.save
+      taggable1.find_related_tags.should include(taggable2)
+      taggable1.find_related_tags.should_not include(taggable1)
+    end
+  end
+  describe "Matching Contexts" do
+    it "should find objects with tags of matching contexts" do
+      taggable1 = TaggableModel.create!(:name => "Taggable 1")
+      taggable2 = TaggableModel.create!(:name => "Taggable 2")
+      taggable3 = TaggableModel.create!(:name => "Taggable 3")
+      taggable1.offering_list = "one, two"
+      taggable1.save!
+      taggable2.need_list = "one, two"
+      taggable2.save!
+      taggable3.offering_list = "one, two"
+      taggable3.save!
+      taggable1.find_matching_contexts(:offerings, :needs).should include(taggable2)
+      taggable1.find_matching_contexts(:offerings, :needs).should_not include(taggable3)
+    end
+    it "should find other related objects with tags of matching contexts" do
+      taggable1 = TaggableModel.create!(:name => "Taggable 1")
+      taggable2 = OtherTaggableModel.create!(:name => "Taggable 2")
+      taggable3 = OtherTaggableModel.create!(:name => "Taggable 3")
+      taggable1.offering_list = "one, two"
+      taggable1.save
+      taggable2.need_list = "one, two"
+      taggable2.save
+      taggable3.offering_list = "one, two"
+      taggable3.save
+      taggable1.find_matching_contexts_for(OtherTaggableModel, :offerings, :needs).should include(taggable2)
+      taggable1.find_matching_contexts_for(OtherTaggableModel, :offerings, :needs).should_not include(taggable3)
+    end
+    it "should not include the object itself in the list of related objects" do
+      taggable1 = TaggableModel.create!(:name => "Taggable 1")
+      taggable2 = TaggableModel.create!(:name => "Taggable 2")
+      taggable1.tag_list = "one"
+      taggable1.save
+      taggable2.tag_list = "one, two"
+      taggable2.save
+      taggable1.find_related_tags.should include(taggable2)
+      taggable1.find_related_tags.should_not include(taggable1)
+    end
+  end
+  describe 'Tagging Contexts' do
+    it 'should eliminate duplicate tagging contexts ' do
+      TaggableModel.has_taxonomy_on(:skills, :skills)
+      TaggableModel.tag_types.count("skills").should == 1
+    end
+    it "should not contain embedded/nested arrays" do
+      TaggableModel.has_taxonomy_on([:array], [:array])
+      TaggableModel.tag_types.count([:array]).should == 0
+    end
+    it "should _flatten_ the content of arrays" do
+      TaggableModel.has_taxonomy_on([:array], [:array])
+      TaggableModel.tag_types.count("array").should == 1
+    end
+    it "should not raise an error when passed nil" do
+      lambda {
+        TaggableModel.has_taxonomy_on()
+      }.should_not raise_error
+    end
+    it "should not raise an error when passed [nil]" do
+      lambda {
+        TaggableModel.has_taxonomy_on([nil])
+      }.should_not raise_error
+    end
+  end
+end