acts-as-taggable-on-padrino 0.0.1

data/.rspec

@@ -0,0 +1,2 @@
+--colour
+--backtrace

data/CHANGELOG

@@ -0,0 +1,29 @@
+== 2011-06-20
+
+* Converted to Padrino compatible Gem
+
+== 2010-02-17
+* Converted the plugin to be compatible with Rails3
+
+== 2009-12-02
+
+* PostgreSQL is now supported (via morgoth)
+
+== 2008-07-17
+
+* Can now use a named_scope to find tags!
+
+== 2008-06-23
+
+* Can now find related objects of another class (tristanzdunn)
+* Removed extraneous down migration cruft (azabaj)
+
+== 2008-06-09
+
+ * Added support for Single Table Inheritance
+ * Adding gemspec and rails/init.rb for gemified plugin
+
+== 2007-12-12
+
+ * Added ability to use dynamic tag contexts
+ * Fixed missing migration generator

data/Gemfile

@@ -0,0 +1,15 @@
+source :gemcutter
+
+gem 'activerecord', '>= 3.0.0'
+
+group :development, :test do
+  gem 'sqlite3-ruby', :require => 'sqlite3'
+  gem 'mysql'
+  gem 'pg'
+
+  gem 'jeweler'
+
+  gem 'rspec',        '>= 2.0.0'
+  gem 'rcov'
+  gem 'database_cleaner'
+end

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2007 Michael Bleigh and Intridea Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.rdoc

@@ -0,0 +1,194 @@
+= ActsAsTaggableOn
+
+This is a Padrino version of Ben Woosley's version of the below:
+
+This plugin was originally based on Acts as Taggable on Steroids by Jonathan Viney.
+It has evolved substantially since that point, but all credit goes to him for the
+initial tagging functionality that so many people have used.
+
+For instance, in a social network, a user might have tags that are called skills,
+interests, sports, and more. There is no real way to differentiate between tags and
+so an implementation of this type is not possible with acts as taggable on steroids.
+
+Enter Acts as Taggable On. Rather than tying functionality to a specific keyword
+(namely "tags"), acts as taggable on allows you to specify an arbitrary number of
+tag "contexts" that can be used locally or in combination in the same way steroids
+was used.
+
+== Installation
+
+1) Add it to your Gemfile:
+gem 'acts-as-taggable-on-padrino'
+
+2) Install it with bundler
+bundle install
+
+==== Post Installation
+
+From the root of your Padrino App:
+1. padrino rake taggable:create_migration
+2. padrino rake ar:migrate
+
+== Testing
+
+Acts As Taggable On uses RSpec for its test coverage. Inside the plugin
+directory, you can run the specs with:
+
+  rake spec
+
+If you already have RSpec on your application, the specs will run while using:
+
+rake spec:plugins
+
+
+== Usage
+
+    class User < ActiveRecord::Base
+      # Alias for <tt>acts_as_taggable_on :tags</tt>:
+      acts_as_taggable
+      acts_as_taggable_on :skills, :interests
+    end
+
+    @user = User.new(:name => "Bobby")
+    @user.tag_list = "awesome, slick, hefty"      # this should be familiar
+    @user.skill_list = "joking, clowning, boxing" # but you can do it for any context!
+    @user.skill_list                              # => ["joking","clowning","boxing"] as TagList
+    @user.save
+
+    @user.tags # => [<Tag name:"awesome">,<Tag name:"slick">,<Tag name:"hefty">]
+    @user.skills # => [<Tag name:"joking">,<Tag name:"clowning">,<Tag name:"boxing">]
+
+    @frankie = User.create(:name => "Frankie", :skill_list => "joking, flying, eating")
+    User.skill_counts # => [<Tag name="joking" count=2>,<Tag name="clowning" count=1>...]
+    @frankie.skill_counts
+
+=== Finding Tagged Objects
+
+Acts As Taggable On utilizes named_scopes to create an association for tags.
+This way you can mix and match to filter down your results, and it also improves
+compatibility with the will_paginate gem:
+
+    class User < ActiveRecord::Base
+      acts_as_taggable_on :tags
+      named_scope :by_join_date, :order => "created_at DESC"
+    end
+
+    User.tagged_with("awesome").by_date
+    User.tagged_with("awesome").by_date.paginate(:page => params[:page], :per_page => 20)
+
+    # Find a user with matching all tags, not just one
+    User.tagged_with(["awesome", "cool"], :match_all => :true)
+    
+    # Find a user with any of the tags:
+    User.tagged_with(["awesome", "cool"], :any => true)
+
+=== Relationships
+
+You can find objects of the same type based on similar tags on certain contexts.
+Also, objects will be returned in descending order based on the total number of 
+matched tags.
+
+    @bobby = User.find_by_name("Bobby")
+    @bobby.skill_list # => ["jogging", "diving"]
+
+    @frankie = User.find_by_name("Frankie")
+    @frankie.skill_list # => ["hacking"]
+
+    @tom = User.find_by_name("Tom")
+    @tom.skill_list # => ["hacking", "jogging", "diving"]
+
+    @tom.find_related_skills # => [<User name="Bobby">,<User name="Frankie">]
+    @bobby.find_related_skills # => [<User name="Tom">] 
+    @frankie.find_related_skills # => [<User name="Tom">] 
+
+=== Dynamic Tag Contexts
+
+In addition to the generated tag contexts in the definition, it is also possible
+to allow for dynamic tag contexts (this could be user generated tag contexts!)
+
+    @user = User.new(:name => "Bobby")
+    @user.set_tag_list_on(:customs, "same, as, tag, list")
+    @user.tag_list_on(:customs) # => ["same","as","tag","list"]
+    @user.save
+    @user.tags_on(:customs) # => [<Tag name='same'>,...]
+    @user.tag_counts_on(:customs)
+    User.tagged_with("same", :on => :customs) # => [@user]
+
+=== Tag Ownership
+
+Tags can have owners:
+
+    class User < ActiveRecord::Base
+      acts_as_tagger
+    end
+
+    class Photo < ActiveRecord::Base
+      acts_as_taggable_on :locations
+    end
+
+    @some_user.tag(@some_photo, :with => "paris, normandy", :on => :locations)
+    @some_user.owned_taggings
+    @some_user.owned_tags
+    @some_photo.locations_from(@some_user)
+    
+=== Tag cloud calculations
+
+To construct tag clouds, the frequency of each tag needs to be calculated.
+Because we specified +acts_as_taggable_on+ on the <tt>User</tt> class, we can
+get a calculation of all the tag counts by using <tt>User.tag_counts_on(:customs)</tt>. But what if we wanted a tag count for
+an single user's posts? To achieve this we call tag_counts on the association:
+
+  User.find(:first).posts.tag_counts_on(:tags)
+
+A helper is included to assist with generating tag clouds.
+
+Here is an example that generates a tag cloud.
+
+Helper:
+
+  module PostsHelper
+    include ActsAsTaggableOn::TagsHelper
+  end
+
+Controller:
+
+  class PostController < ApplicationController
+    def tag_cloud
+      @tags = Post.tag_counts_on(:tags)
+    end
+  end
+
+View:
+
+  <% tag_cloud(@tags, %w(css1 css2 css3 css4)) do |tag, css_class| %>
+    <%= link_to tag.name, { :action => :tag, :id => tag.name }, :class => css_class %>
+  <% end %>
+
+CSS:
+
+  .css1 { font-size: 1.0em; }
+  .css2 { font-size: 1.2em; }
+  .css3 { font-size: 1.4em; }
+  .css4 { font-size: 1.6em; }
+
+== Contributors
+
+* TomEric (i76) - Maintainer
+* Michael Bleigh - Original Author
+* Szymon Nowak - Rails 3.0 compatibility
+* Jelle Vandebeeck - Rails 3.0 compatibility
+* Brendan Lim - Related Objects
+* Pradeep Elankumaran - Taggers
+* Sinclair Bain - Patch King
+
+=== Patch Contributors
+
+* tristanzdunn - Related objects of other classes
+* azabaj - Fixed migrate down
+* Peter Cooper - named_scope fix
+* slainer68 - STI fix
+* harrylove - migration instructions and fix-ups
+* lawrencepit - cached tag work
+* sobrinho - fixed tag_cloud helper
+
+Copyright (c) 2007-2010 Michael Bleigh (http://mbleigh.com/) and Intridea Inc. (http://intridea.com/), released under the MIT license

data/Rakefile

@@ -0,0 +1,33 @@
+begin # Rspec 2.0
+  require 'rspec/core/rake_task'
+
+  desc 'Default: run specs'
+  task :default => :spec  
+  RSpec::Core::RakeTask.new do |t|
+    t.pattern = "spec/**/*_spec.rb"
+  end
+  
+  RSpec::Core::RakeTask.new('rcov') do |t|
+    t.pattern = "spec/**/*_spec.rb"
+    t.rcov = true
+    t.rcov_opts = ['--exclude', 'spec']
+  end
+
+rescue LoadError
+  puts "Rspec not available. Install it with: gem install rspec"  
+end
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gemspec|
+    gemspec.name = "acts-as-taggable-on-padrino"
+    gemspec.summary = "ActsAsTaggableOnPadrino is a tagging plugin for Padrino that provides multiple tagging contexts on a single model."
+    gemspec.description = "With ActsAsTaggableOnPadrino, you could tag a single model on several contexts, such as skills, interests, and awards. It also provides other advanced functionality."
+    gemspec.email = "john.knott@gmail.com"
+    gemspec.homepage = "http://github.com/johnknott/acts-as-taggable-on-padrino"
+    gemspec.authors = ["Michael Bleigh","John Knott"]
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler not available. Install it with: gem install jeweler"
+end

data/VERSION

@@ -0,0 +1 @@
+0.0.1

data/acts-as-taggable-on-padrino.gemspec

@@ -0,0 +1,94 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{acts-as-taggable-on-padrino}
+  s.version = "0.0.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Michael Bleigh", "John Knott"]
+  s.date = %q{2011-06-29}
+  s.description = %q{With ActsAsTaggableOnPadrino, you could tag a single model on several contexts, such as skills, interests, and awards. It also provides other advanced functionality.}
+  s.email = %q{john.knott@gmail.com}
+  s.extra_rdoc_files = [
+    "README.rdoc"
+  ]
+  s.files = [
+    ".rspec",
+    "CHANGELOG",
+    "Gemfile",
+    "MIT-LICENSE",
+    "README.rdoc",
+    "Rakefile",
+    "VERSION",
+    "acts-as-taggable-on-padrino.gemspec",
+    "lib/acts-as-taggable-on-padrino.rb",
+    "lib/acts_as_taggable_on_padrino/tag.rb",
+    "lib/acts_as_taggable_on_padrino/taggable.rb",
+    "lib/acts_as_taggable_on_padrino/taggable/cache.rb",
+    "lib/acts_as_taggable_on_padrino/taggable/collection.rb",
+    "lib/acts_as_taggable_on_padrino/taggable/core.rb",
+    "lib/acts_as_taggable_on_padrino/taggable/ownership.rb",
+    "lib/acts_as_taggable_on_padrino/taggable/related.rb",
+    "lib/acts_as_taggable_on_padrino/taggable/tag_list.rb",
+    "lib/acts_as_taggable_on_padrino/tagger.rb",
+    "lib/acts_as_taggable_on_padrino/tagging.rb",
+    "lib/acts_as_taggable_on_padrino/tags_helper.rb",
+    "lib/tasks/generate_migration.rb",
+    "lib/tasks/templates/migration.rb",
+    "spec/acts_as_taggable_on_padrino/acts_as_taggable_on_spec.rb",
+    "spec/acts_as_taggable_on_padrino/acts_as_tagger_spec.rb",
+    "spec/acts_as_taggable_on_padrino/tag_list_spec.rb",
+    "spec/acts_as_taggable_on_padrino/tag_spec.rb",
+    "spec/acts_as_taggable_on_padrino/taggable_spec.rb",
+    "spec/acts_as_taggable_on_padrino/tagger_spec.rb",
+    "spec/acts_as_taggable_on_padrino/tagging_spec.rb",
+    "spec/acts_as_taggable_on_padrino/tags_helper_spec.rb",
+    "spec/bm.rb",
+    "spec/database.yml.sample",
+    "spec/models.rb",
+    "spec/schema.rb",
+    "spec/spec_helper.rb",
+    "uninstall.rb"
+  ]
+  s.homepage = %q{http://github.com/johnknott/acts-as-taggable-on-padrino}
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.6.2}
+  s.summary = %q{ActsAsTaggableOnPadrino is a tagging plugin for Padrino that provides multiple tagging contexts on a single model.}
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<activerecord>, [">= 3.0.0"])
+      s.add_development_dependency(%q<sqlite3-ruby>, [">= 0"])
+      s.add_development_dependency(%q<mysql>, [">= 0"])
+      s.add_development_dependency(%q<pg>, [">= 0"])
+      s.add_development_dependency(%q<jeweler>, [">= 0"])
+      s.add_development_dependency(%q<rspec>, [">= 2.0.0"])
+      s.add_development_dependency(%q<rcov>, [">= 0"])
+      s.add_development_dependency(%q<database_cleaner>, [">= 0"])
+    else
+      s.add_dependency(%q<activerecord>, [">= 3.0.0"])
+      s.add_dependency(%q<sqlite3-ruby>, [">= 0"])
+      s.add_dependency(%q<mysql>, [">= 0"])
+      s.add_dependency(%q<pg>, [">= 0"])
+      s.add_dependency(%q<jeweler>, [">= 0"])
+      s.add_dependency(%q<rspec>, [">= 2.0.0"])
+      s.add_dependency(%q<rcov>, [">= 0"])
+      s.add_dependency(%q<database_cleaner>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<activerecord>, [">= 3.0.0"])
+    s.add_dependency(%q<sqlite3-ruby>, [">= 0"])
+    s.add_dependency(%q<mysql>, [">= 0"])
+    s.add_dependency(%q<pg>, [">= 0"])
+    s.add_dependency(%q<jeweler>, [">= 0"])
+    s.add_dependency(%q<rspec>, [">= 2.0.0"])
+    s.add_dependency(%q<rcov>, [">= 0"])
+    s.add_dependency(%q<database_cleaner>, [">= 0"])
+  end
+end
+

data/lib/acts-as-taggable-on-padrino.rb

@@ -0,0 +1,41 @@
+require "active_record"
+require 'active_support/core_ext/class/attribute_accessors'
+
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+
+require "acts_as_taggable_on_padrino/taggable"
+require "acts_as_taggable_on_padrino/taggable/core"
+require "acts_as_taggable_on_padrino/taggable/collection"
+require "acts_as_taggable_on_padrino/taggable/cache"
+require "acts_as_taggable_on_padrino/taggable/ownership"
+require "acts_as_taggable_on_padrino/taggable/related"
+require "acts_as_taggable_on_padrino/taggable/tag_list"
+
+require "acts_as_taggable_on_padrino/tagger"
+require "acts_as_taggable_on_padrino/tag"
+require "acts_as_taggable_on_padrino/tags_helper"
+require "acts_as_taggable_on_padrino/tagging"
+
+$LOAD_PATH.shift
+
+ActiveRecord::Base.extend ActsAsTaggableOn::Taggable
+ActiveRecord::Base.extend ActsAsTaggableOn::Tagger
+ActiveRecord::Base.extend ActsAsTaggableOn::Tag
+ActiveRecord::Base.extend ActsAsTaggableOn::Tagging
+
+if defined?(Padrino::Helpers::TagHelpers)
+  Padrino::Helpers::TagHelpers.send :include, ActsAsTaggableOn::TagsHelper
+end
+
+module ActsAsTaggableOn
+  def like_operator
+    @like_operator ||= (ActiveRecord::Base.connection.adapter_name == 'PostgreSQL' ? 'ILIKE' : 'LIKE')
+  end
+  module_function :like_operator
+end
+
+begin
+  require 'padrino-gen'
+  Padrino::Tasks.files << Dir[File.dirname(__FILE__) + "/tasks/**/*.rb"]
+rescue LoadError
+end

data/lib/acts_as_taggable_on_padrino/tag.rb

@@ -0,0 +1,72 @@
+module ActsAsTaggableOn
+  module Tag
+    def acts_as_tag(opts = {})
+      opts.assert_valid_keys :tagging
+      tagging_class_name = opts[:tagging] || 'Tagging'
+
+      class_eval do
+        attr_accessible :name
+
+        ### ASSOCIATIONS:
+
+        has_many :taggings, :dependent => :destroy, :class_name => tagging_class_name
+
+        ### VALIDATIONS:
+        validates_presence_of :name
+        validates_uniqueness_of :name
+
+        ### SCOPES:
+        scope :named, lambda {|name| where(["name #{ActsAsTaggableOn.like_operator} ?", name]) }
+        scope :named_any, lambda {|list| where(list.map { |tag| sanitize_sql(["name #{ActsAsTaggableOn.like_operator} ?", tag.to_s]) }.join(" OR ")) }
+        scope :named_like, lambda {|name| where(["name #{ActsAsTaggableOn.like_operator} ?", "%#{name}%"]) }
+        scope :named_like_any, lambda {|list| where(list.map { |tag| sanitize_sql(["name #{ActsAsTaggableOn.like_operator} ?", "%#{tag.to_s}%"]) }.join(" OR ")) }
+      end
+
+      include ActsAsTaggableOn::Tag::InstanceMethods
+      extend ActsAsTaggableOn::Tag::ClassMethods
+    end
+
+    module ClassMethods
+      def find_or_create_with_like_by_name(name)
+        named_like(name).first || create(:name => name)
+      end
+
+      def find_or_create_all_with_like_by_name(*list)
+        list = list.flatten
+        return [] if list.empty?
+
+        existing_tags = named_any(list)
+        new_tag_names = list.reject do |name|
+                          name = comparable_name(name)
+                          existing_tags.any? { |tag| comparable_name(tag.name) == name }
+                        end
+        created_tags  = new_tag_names.map { |name| create(:name => name) }
+
+        existing_tags + created_tags
+      end
+
+      def names
+        all.map {|tag| tag.name }
+      end
+
+    private
+      def comparable_name(str)
+        RUBY_VERSION >= "1.9" ? str.downcase : str.mb_chars.downcase
+      end
+    end
+
+    module InstanceMethods
+      def ==(object)
+        super || (object.is_a?(self.class) && name == object.name)
+      end
+
+      def to_s
+        name
+      end
+
+      def count
+        read_attribute(:count).to_i
+      end
+    end
+  end
+end