horde-rails 0.0.1

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format progress

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in horde.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Dorren Chen
+
+MIT License
+
+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.md

@@ -0,0 +1,103 @@
+# Horde
+
+Horde is a gem to help you implement social networking features in your app, like follow a user, favorite a photo, and comment on an article, etc.
+
+## Usage
+Say your app has typical models like User, Article, Category, etc.
+
+```ruby
+  # ----- setup models
+  class User
+    include Horde::Actor
+
+    include Horde::Actions::Follow   # allow one user follow another user
+  end
+
+  class Article
+    include Horde::Actions::All   # all actions that can be performed on this model.
+
+    # or selectively, a few of them
+    #   include Horde::Actions::Comment
+    #   include Horde::Actions::Favorite
+    #   include Horde::Actions::Follow
+    #   include Horde::Actions::Rate
+  end
+
+  # ----- case 1: favoriting
+  favorite = user.favorite(article)      # saved in 'horde_favorites' table
+  favorite.favoriter                     # --> user
+  favorite.target                        # --> article
+  favorite.favorited_article             # --> same article
+
+  article.favorites                      # --> [favorite]
+  article.favoriters                     # --> [user]
+  user.created_favorites                 # --> [favorite], could point to any target, article, photo.
+  user.favorited_articles                # --> [article], this user's favorited articles
+
+
+  # ----- case 2: commenting
+  comment  = user.comment(article, :comment => 'luv it')  # saved in 'horde_comments' table
+  comment.commenter                      # --> user
+  comment.target                         # --> article
+  comment.commented_article              # --> same article
+
+  article.comments                       # --> [comment]
+  article.commenters                     # --> [user]
+  user.created_comments                  # --> [comment] 
+  user.commented_articles                # --> [article]
+
+
+  # ----- case 3: rating
+  rate = user.rate(article, :score => 10)
+  rate.rater                             # --> user
+  rate.target                            # --> article
+  rate.rated_article                     # --> same article
+  
+  article.rates                          # --> [rate]
+  article.raters                         # --> [user]
+  user.created_rates                     # --> [rate]
+  user.rated_articles                    # --> [article]
+```
+
+How do you notify commenters when new comment is posted for an article?
+```ruby
+  class Article
+    after_comment  :notify_commenters
+    after_favorite :do_something
+    after_rate     :do_something_else
+
+    def notify_commenters(comment)
+      msg = "#{comment.commenter.login} just commented on article '#{self.title}'"
+      emails = commenters.map &:email
+      # email all users
+    end
+  end
+```
+
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'horde'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install horde
+
+
+copy db/migrate/timestamp_horde_setup.rb to your app. I haven't figure
+out how to use generator.
+
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Added some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,7 @@
+#!/usr/bin/env rake
+require 'bundler/setup' 
+require "bundler/gem_tasks"
+require 'sinatra/activerecord/rake'
+
+require "horde"
+require_relative "spec/support/db_config"

data/db/migrate/20120714150229_horde_setup.rb

@@ -0,0 +1,56 @@
+class HordeSetup < ActiveRecord::Migration
+  def up
+    create_table :horde_favorites do |t|
+      t.string :actor_id,    :limit => 64
+      t.string :target_type, :limit => 64
+      t.string :target_id,   :limit => 64
+
+      t.timestamps
+    end
+    add_index :horde_favorites, :actor_id
+    add_index :horde_favorites, [:target_id, :target_type]
+
+
+    create_table :horde_follows do |t|
+      t.string :actor_id,    :limit => 64
+      t.string :target_type, :limit => 64
+      t.string :target_id,   :limit => 64
+
+      t.timestamps
+    end
+    add_index :horde_follows, :actor_id
+    add_index :horde_follows, [:target_id, :target_type]
+
+
+    create_table :horde_comments do |t|
+      t.string :actor_id,    :limit => 64
+      t.string :target_type, :limit => 64
+      t.string :target_id,   :limit => 64
+      t.string :comment,     :limit => 2048
+      t.integer :abuse_count, :default => 0
+
+      t.timestamps
+    end
+    add_index :horde_comments, :actor_id
+    add_index :horde_comments, [:target_id, :target_type]
+    add_index :horde_comments, :abuse_count
+
+
+    create_table :horde_rates do |t|
+      t.string :actor_id,    :limit => 64
+      t.string :target_type, :limit => 64
+      t.string :target_id,   :limit => 64
+      t.integer :score
+
+      t.timestamps
+    end
+    add_index :horde_rates, :actor_id
+    add_index :horde_rates, [:target_id, :target_type]
+  end
+
+  def down
+    drop_table :horde_favorites
+    drop_table :horde_comments
+    drop_table :horde_rates
+  end
+end

data/db/migrate/20120714184427_test_models.rb

@@ -0,0 +1,33 @@
+class TestModels < ActiveRecord::Migration
+  def up
+    create_table :users do |t|
+      t.string :login,      :limit => 64
+      t.string :email,      :limit => 64
+      t.string :first_name, :limit => 64
+      t.string :last_name,  :limit => 64
+
+      t.timestamps
+    end
+
+    create_table :articles do |t|
+      t.string :title
+      t.string :body
+      t.string :author_id
+
+      t.timestamps
+    end
+
+    create_table :photos do |t|
+      t.string :name
+      t.string :author_id
+
+      t.timestamps
+    end
+  end
+
+  def down
+    drop_table :users
+    drop_table :articles
+    drop_table :photos
+  end
+end

data/horde.gemspec

@@ -0,0 +1,26 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/horde/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["Dorren Chen"]
+  gem.email         = ["dorrenchen@gmail.com"]
+  gem.description   = %q{A ruby gem providing social networking features for rails app.}
+  gem.summary       = %q{A ruby gem providing social networking features for rails app.}
+  gem.homepage      = ""
+
+  gem.files         = `git ls-files`.split($\)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.name          = "horde-rails"
+  gem.require_paths = ["lib"]
+  gem.version       = Horde::VERSION
+
+  gem.add_dependency "mysql2"
+  gem.add_dependency 'activerecord'
+  gem.add_dependency 'activesupport'
+  gem.add_dependency "sinatra-activerecord"
+  gem.add_dependency "hooks"
+  gem.add_development_dependency 'debugger'
+  gem.add_development_dependency 'rspec'
+  gem.add_development_dependency "database_cleaner"
+end

data/lib/horde.rb

@@ -0,0 +1,16 @@
+require "active_record"
+require "hooks"
+require "horde/version"
+require "horde/core_ext/string"
+require "horde/setting"
+require "horde/actions/base"
+require "horde/actions/comment"
+require "horde/actions/favorite"
+require "horde/actions/follow"
+require "horde/actions/rate"
+require "horde/base"
+require "horde/actor"
+require "horde/actions"
+
+module Horde
+end

data/lib/horde/actions.rb

@@ -0,0 +1,14 @@
+module Horde
+  module Actions
+    module All
+      extend ActiveSupport::Concern
+      included do
+        include ::Horde::Actions::Comment
+        include ::Horde::Actions::Favorite
+        include ::Horde::Actions::Follow
+        include ::Horde::Actions::Rate
+      end
+    end
+  end
+end
+

data/lib/horde/actions/base.rb

@@ -0,0 +1,11 @@
+module Horde
+  module Actions
+    class Base < ActiveRecord::Base
+      self.abstract_class = true
+
+      belongs_to :target, :polymorphic => true
+
+      validates_presence_of :actor_id, :target_id, :target_type
+    end
+  end
+end

data/lib/horde/actions/comment.rb

@@ -0,0 +1,96 @@
+module Horde
+  class Comment < Actions::Base
+    self.table_name = 'horde_comments'
+
+    validates_presence_of :comment
+  end
+
+  module Actions
+    module Comment
+      extend ActiveSupport::Concern
+      included do
+        include CommentMethods::TargetMethods
+      end
+    end
+
+    module CommentMethods
+      # methods for user, usually User class in your app.
+      module ActorMethods
+        extend ActiveSupport::Concern
+        included do
+          has_many :created_comments, 
+                   :class_name => "Horde::Comment",
+                   :foreign_key => :actor_id
+        end
+
+        # user comment something.
+        def comment(target, options = {})
+          params = {:actor_id => self.id, 
+                    :target_id => target.id,
+                    :target_type => target.class.name
+                   }.merge(options)
+          comment = ::Horde::Comment.create(params)
+          target.run_hook(:after_comment, comment)
+
+          comment
+        end
+      end
+
+      # methods for something to be commented, like article, photo, etc.
+      # if your model is Article. Then you'll get following methods
+      #
+      #   article.comments           # --> [comment]
+      #   article.commenters          # --> [user]
+      #   
+      #   comment.commenter          # --> user
+      #   comment.commented_article  # --> article
+      #
+      #   user.commented_articles     # --> [article]
+      module TargetMethods
+        extend ActiveSupport::Concern
+        included do
+          has_many :comments, 
+                   :class_name => "Horde::Comment",
+                   :as => :target,
+                   :order => "created_at DESC"
+
+          has_many :commenters, 
+                   :through => :comments
+
+          create_comment_associations
+
+          include Hooks
+          define_hook :after_comment
+        end
+
+        module ClassMethods
+          def create_comment_associations
+            target_class_name = self.name   # like "Article", "Photo"
+            assn_name = "commented_#{target_class_name.tableize}"   # "commented_articles"
+
+            # define belongs_to here because Setting.actor_clas_name has not been set
+            ::Horde::Comment.belongs_to :commenter, 
+                                :foreign_key => :actor_id,
+                                :class_name => Horde::Setting.actor_class_name
+
+            # comment.commented_article, this is created for
+            # user.commented_articles to work.
+            ::Horde::Comment.belongs_to assn_name.singularize.to_sym, 
+                                :foreign_key => :target_id,
+                                :class_name => target_class_name
+
+            Horde::Setting.actor_class_name.constantize.instance_eval do
+              include ActorMethods
+
+              # user.commented_articles
+              has_many assn_name, 
+                       :through => :created_comments,
+                       :source => assn_name.singularize,
+                       :conditions => {:"horde_comments.target_type" => target_class_name}
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/horde/actions/favorite.rb

@@ -0,0 +1,93 @@
+module Horde
+  class Favorite < Actions::Base
+    self.table_name = 'horde_favorites'
+  end
+
+  module Actions
+    module Favorite
+      extend ActiveSupport::Concern
+      included do
+        include FavoriteMethods::TargetMethods
+      end
+    end
+
+    module FavoriteMethods
+      # methods for user, usually User class in your app.
+      module ActorMethods
+        extend ActiveSupport::Concern
+        included do
+          has_many :created_favorites, 
+                   :class_name => "Horde::Favorite",
+                   :foreign_key => :actor_id
+        end
+
+        # user favorite something.
+        def favorite(target, options = {})
+          params = {:actor_id => self.id, 
+                    :target_id => target.id,
+                    :target_type => target.class.name
+                   }.merge(options)
+          fav = ::Horde::Favorite.create(params)
+          target.run_hook(:after_favorite, fav)
+
+          fav
+        end
+      end
+
+      # methods for something to be favorited, like article, photo, etc.
+      # if your model is Article. Then you'll get following methods
+      #
+      #   article.favorites           # --> [favorite]
+      #   article.favoriters          # --> [user]
+      #   
+      #   favorite.favoriter          # --> user
+      #   favorite.favorited_article  # --> article
+      #
+      #   user.favorited_articles     # --> [article]
+      module TargetMethods
+        extend ActiveSupport::Concern
+        included do
+          has_many :favorites, 
+                   :class_name => "Horde::Favorite",
+                   :as => :target
+
+          has_many :favoriters, 
+                   :through => :favorites
+
+          create_favorite_associations
+
+          include Hooks
+          define_hook :after_favorite
+        end
+
+        module ClassMethods
+          def create_favorite_associations
+            target_class_name = self.name   # like "Article", "Photo"
+            assn_name = "favorited_#{target_class_name.tableize}"   # "favorited_articles"
+
+            # define belongs_to here because Setting.actor_clas_name has not been set
+            ::Horde::Favorite.belongs_to :favoriter, 
+                                :foreign_key => :actor_id,
+                                :class_name => Horde::Setting.actor_class_name
+
+            # favorite.favorited_article, this is created for
+            # user.favorited_articles to work.
+            ::Horde::Favorite.belongs_to assn_name.singularize.to_sym, 
+                                :foreign_key => :target_id,
+                                :class_name => target_class_name
+
+            Horde::Setting.actor_class_name.constantize.instance_eval do
+              include ActorMethods
+
+              # user.favorited_articles
+              has_many assn_name, 
+                       :through => :created_favorites,
+                       :source => assn_name.singularize,
+                       :conditions => {:"horde_favorites.target_type" => target_class_name}
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/horde/actions/follow.rb

@@ -0,0 +1,93 @@
+module Horde
+  class Follow < Actions::Base
+    self.table_name = 'horde_follows'
+  end
+
+  module Actions
+    module Follow
+      extend ActiveSupport::Concern
+      included do
+        include FollowMethods::TargetMethods
+      end
+    end
+
+    module FollowMethods
+      # methods for user, usually User class in your app.
+      module ActorMethods
+        extend ActiveSupport::Concern
+        included do
+          has_many :created_follows, 
+                   :class_name => "Horde::Follow",
+                   :foreign_key => :actor_id
+        end
+
+        # user follow something.
+        def follow(target, options = {})
+          params = {:actor_id => self.id, 
+                    :target_id => target.id,
+                    :target_type => target.class.name
+                   }.merge(options)
+          follow = ::Horde::Follow.create(params)
+          target.run_hook(:after_follow, follow)
+
+          follow
+        end
+      end
+
+      # methods for something to be followed, like article, photo, etc.
+      # if your model is Article. Then you'll get following methods
+      #
+      #   article.follows           # --> [follow]
+      #   article.followers          # --> [user]
+      #   
+      #   follow.follower          # --> user
+      #   follow.followed_article  # --> article
+      #
+      #   user.followed_articles     # --> [article]
+      module TargetMethods
+        extend ActiveSupport::Concern
+        included do
+          has_many :follows, 
+                   :class_name => "Horde::Follow",
+                   :as => :target
+
+          has_many :followers, 
+                   :through => :follows
+
+          create_follow_associations
+
+          include Hooks
+          define_hook :after_follow
+        end
+
+        module ClassMethods
+          def create_follow_associations
+            target_class_name = self.name   # like "Article", "Photo"
+            assn_name = "followed_#{target_class_name.tableize}"   # "followed_articles"
+
+            # define belongs_to here because Setting.actor_clas_name has not been set
+            ::Horde::Follow.belongs_to :follower, 
+                                :foreign_key => :actor_id,
+                                :class_name => Horde::Setting.actor_class_name
+
+            # follow.followed_article, this is created for
+            # user.followed_articles to work.
+            ::Horde::Follow.belongs_to assn_name.singularize.to_sym, 
+                                :foreign_key => :target_id,
+                                :class_name => target_class_name
+
+            Horde::Setting.actor_class_name.constantize.instance_eval do
+              include ActorMethods
+
+              # user.followed_articles
+              has_many assn_name, 
+                       :through => :created_follows,
+                       :source => assn_name.singularize,
+                       :conditions => {:"horde_follows.target_type" => target_class_name}
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/horde/actions/rate.rb

@@ -0,0 +1,95 @@
+module Horde
+  class Rate < Actions::Base
+    self.table_name = 'horde_rates'
+
+    validates_presence_of :score
+  end
+
+  module Actions
+    module Rate
+      extend ActiveSupport::Concern
+      included do
+        include RateMethods::TargetMethods
+      end
+    end
+
+    module RateMethods
+      # methods for user, usually User class in your app.
+      module ActorMethods
+        extend ActiveSupport::Concern
+        included do
+          has_many :created_rates, 
+                   :class_name => "Horde::Rate",
+                   :foreign_key => :actor_id
+        end
+
+        # user rate something.
+        def rate(target, options = {})
+          params = {:actor_id => self.id, 
+                    :target_id => target.id,
+                    :target_type => target.class.name
+                   }.merge(options)
+          rate = ::Horde::Rate.create(params)
+          target.run_hook(:after_rate, rate)
+
+          rate
+        end
+      end
+
+      # methods for something to be rated, like article, photo, etc.
+      # if your model is Article. Then you'll get following methods
+      #
+      #   article.rates           # --> [rate]
+      #   article.raters          # --> [user]
+      #   
+      #   rate.rater          # --> user
+      #   rate.rated_article  # --> article
+      #
+      #   user.rated_articles     # --> [article]
+      module TargetMethods
+        extend ActiveSupport::Concern
+        included do
+          has_many :rates, 
+                   :class_name => "Horde::Rate",
+                   :as => :target
+
+          has_many :raters, 
+                   :through => :rates
+
+          create_rate_associations
+
+          include Hooks
+          define_hook :after_rate
+        end
+
+        module ClassMethods
+          def create_rate_associations
+            target_class_name = self.name   # like "Article", "Photo"
+            assn_name = "rated_#{target_class_name.tableize}"   # "rated_articles"
+
+            # define belongs_to here because Setting.actor_clas_name has not been set
+            ::Horde::Rate.belongs_to :rater, 
+                                :foreign_key => :actor_id,
+                                :class_name => Horde::Setting.actor_class_name
+
+            # rate.rated_article, this is created for
+            # user.rated_articles to work.
+            ::Horde::Rate.belongs_to assn_name.singularize.to_sym, 
+                                :foreign_key => :target_id,
+                                :class_name => target_class_name
+
+            Horde::Setting.actor_class_name.constantize.instance_eval do
+              include ActorMethods
+
+              # user.rated_articles
+              has_many assn_name, 
+                       :through => :created_rates,
+                       :source => assn_name.singularize,
+                       :conditions => {:"horde_rates.target_type" => target_class_name}
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/horde/actor.rb

@@ -0,0 +1,12 @@
+module Horde
+  module Actor
+    extend ActiveSupport::Concern
+    included do
+      # set it so it can be used in defining associations later
+      if Horde::Setting.actor_class_name.nil?
+        Horde::Setting.actor_class_name = self.name
+      end
+    end
+    
+  end
+end

data/lib/horde/core_ext/string.rb

@@ -0,0 +1,13 @@
+class String
+  # actorize("comment")  # --> commenter
+  # actorize("vote")     # --> voter
+  def actorize
+    self =~ /e$/ ? self + "r" : self + "er"
+  end
+
+  # past_tense("comment")  # --> commented
+  # past_tense("vote")     # --> voted
+  def past_tense
+    self =~ /e$/ ? self + "d" : self + "ed"
+  end
+end

data/lib/horde/setting.rb

@@ -0,0 +1,7 @@
+module Horde
+  class Setting
+    class << self
+      attr_accessor :actor_class_name
+    end
+  end
+end

data/lib/horde/version.rb

@@ -0,0 +1,3 @@
+module Horde
+  VERSION = "0.0.1"
+end

data/spec/comment_spec.rb

@@ -0,0 +1,41 @@
+require 'spec_helper'
+
+describe "commenting" do
+  before(:each) do
+    @user  = User.create(:login => 'john', :first_name => 'John', :last_name => 'Doe')
+    @user2 = User.create(:login => 'jane', :first_name => 'Jane', :last_name => 'Doe')
+    @article = Article.create(:title => 'article 1', :author_id => @user2.id)
+    @photo = Photo.create(:name => 'photo 1', :author_id => @user2.id)
+    @user.comment(@article, :comment => "great article")
+  end
+
+  it "should work for actor" do
+    comment = Horde::Comment.first
+    comment.should_not be_nil
+
+    comment.target.should == @article
+    @user.created_comments.should include comment
+  end
+
+  it "should find comment by class" do
+    comment = Horde::Comment.first
+    comment.commented_article.should == @article
+    @user.commented_articles.should == [@article]
+  end
+
+  it "should comment photo" do
+    @user.comment(@photo, :comment => 'nic pic')
+    @user.commented_photos.should == [@photo]
+  end
+
+  it "should work for target" do
+    @article.comments.should_not be_empty
+    @article.commenters.should include @user
+  end
+
+  it "should run callback" do
+    article2 = double("Article", :id => 2, :title => 'article 2', :author_id => @user2.id)
+    article2.should_receive(:run_hook)
+    @user.comment(article2)
+  end
+end

data/spec/favorite_spec.rb

@@ -0,0 +1,41 @@
+require 'spec_helper'
+
+describe "favoriting" do
+  before(:each) do
+    @user  = User.create(:login => 'john', :first_name => 'John', :last_name => 'Doe')
+    @user2 = User.create(:login => 'jane', :first_name => 'Jane', :last_name => 'Doe')
+    @article = Article.create(:title => 'article 1', :author_id => @user2.id)
+    @photo = Photo.create(:name => 'photo 1', :author_id => @user2.id)
+    @user.favorite(@article)
+  end
+
+  it "should work for actor" do
+    fav = Horde::Favorite.first
+    fav.should_not be_nil
+
+    fav.target.should == @article
+    @user.created_favorites.should include fav
+  end
+
+  it "should find favorite by class" do
+    fav = Horde::Favorite.first
+    fav.favorited_article.should == @article
+    @user.favorited_articles.should == [@article]
+  end
+
+  it "should favorite photo" do
+    @user.favorite(@photo)
+    @user.favorited_photos.should == [@photo]
+  end
+
+  it "should work for target" do
+    @article.favorites.should_not be_empty
+    @article.favoriters.should include @user
+  end
+
+  it "should run callback" do
+    article2 = double("Article", :id => 2, :title => 'article 2', :author_id => @user2.id)
+    article2.should_receive(:run_hook)
+    @user.favorite(article2)
+  end
+end

data/spec/follow_spec.rb

@@ -0,0 +1,55 @@
+require 'spec_helper'
+
+describe "following" do
+  before(:each) do
+    @user  = User.create(:login => 'john', :first_name => 'John', :last_name => 'Doe')
+    @user2 = User.create(:login => 'jane', :first_name => 'Jane', :last_name => 'Doe')
+    @article = Article.create(:title => 'article 1', :author_id => @user2.id)
+    @photo = Photo.create(:name => 'photo 1', :author_id => @user2.id)
+    @user.follow(@article)
+  end
+
+  it "should work for actor" do
+    follow = Horde::Follow.first
+    follow.should_not be_nil
+
+    follow.target.should == @article
+    @user.created_follows.should include follow
+  end
+
+  it "should find follow by class" do
+    follow = Horde::Follow.first
+    follow.followed_article.should == @article
+    @user.followed_articles.should == [@article]
+  end
+
+  it "should follow photo" do
+    @user.follow(@photo)
+    @user.followed_photos.should == [@photo]
+  end
+
+  it "should work for target" do
+    @article.follows.should_not be_empty
+    @article.followers.should include @user
+  end
+
+  it "should run callback" do
+    article2 = double("Article", :id => 2, :title => 'article 2', :author_id => @user2.id)
+    article2.should_receive(:run_hook)
+    @user.follow(article2)
+  end
+
+  it "should follow user" do
+    follow = @user.follow(@user2)
+
+    follow.target.should == @user2
+    follow.followed_user.should == @user2
+    follow.follower.should == @user
+
+    @user.created_follows.should include follow
+    @user.followed_users.should == [@user2]
+
+    @user2.follows.should == [follow]
+    @user2.followers.should == [@user]
+  end
+end

data/spec/rate_spec.rb

@@ -0,0 +1,41 @@
+require 'spec_helper'
+
+describe "rating" do
+  before(:each) do
+    @user  = User.create(:login => 'john', :first_name => 'John', :last_name => 'Doe')
+    @user2 = User.create(:login => 'jane', :first_name => 'Jane', :last_name => 'Doe')
+    @article = Article.create(:title => 'article 1', :author_id => @user2.id)
+    @photo = Photo.create(:name => 'photo 1', :author_id => @user2.id)
+    @user.rate(@article, :score => 5)
+  end
+
+  it "should work for actor" do
+    rate = Horde::Rate.first
+    rate.should_not be_nil
+
+    rate.target.should == @article
+    @user.created_rates.should include rate
+  end
+
+  it "should find rate by class" do
+    rate = Horde::Rate.first
+    rate.rated_article.should == @article
+    @user.rated_articles.should == [@article]
+  end
+
+  it "should rate photo" do
+    @user.rate(@photo, :score => 5)
+    @user.rated_photos.should == [@photo]
+  end
+
+  it "should work for target" do
+    @article.rates.should_not be_empty
+    @article.raters.should include @user
+  end
+
+  it "should run callback" do
+    article2 = double("Article", :id => 2, :title => 'article 2', :author_id => @user2.id)
+    article2.should_receive(:run_hook)
+    @user.rate(article2)
+  end
+end

data/spec/setting_spec.rb

@@ -0,0 +1,11 @@
+require 'spec_helper'
+
+describe "Setting" do
+  before(:each) do
+  end
+
+  it "should save actor_class_name to setting" do
+    Horde::Setting.actor_class_name.should == 'User'
+  end
+end
+

data/spec/spec_helper.rb

@@ -0,0 +1,40 @@
+require 'debugger'
+require 'database_cleaner'
+require 'horde'
+
+Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each {|f| require f}
+
+# This file was generated by the `rspec --init` command. Conventionally, all
+# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
+# Require this file using `require "spec_helper"` to ensure that it is only
+# loaded once.
+#
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+RSpec.configure do |config|
+  config.treat_symbols_as_metadata_keys_with_true_values = true
+  config.run_all_when_everything_filtered = true
+  config.filter_run :focus
+
+  # Run specs in random order to surface order dependencies. If you find an
+  # order dependency and want to debug it, you can fix the order by providing
+  # the seed, which is printed after each run.
+  #     --seed 1234
+  config.order = 'random'
+
+  # --- database cleaner config
+  config.before(:suite) do
+    ActiveRecord::Base.logger = nil
+    DatabaseCleaner.strategy = :truncation #:transaction doesn't clean 
+    DatabaseCleaner.clean_with(:truncation)
+  end
+
+  config.before(:each) do
+    DatabaseCleaner.start
+    ActiveRecord::Base.logger = Logger.new(STDOUT)
+  end
+
+  config.after(:each) do
+    ActiveRecord::Base.logger = nil
+    DatabaseCleaner.clean
+  end
+end

data/spec/string_ext_spec.rb

@@ -0,0 +1,29 @@
+require 'spec_helper'
+
+describe 'actorize' do
+  it "should work on follow" do
+    "follow".actorize.should == "follower"
+  end
+
+  it "should work on favorite" do
+    "favorite".actorize.should == "favoriter"
+  end
+
+  it "should work on rate" do
+    "rate".actorize.should == "rater"
+  end
+end
+
+describe 'past_tense' do
+  it "should work on follow" do
+    "follow".past_tense.should == "followed"
+  end
+
+  it "should work on favorite" do
+    "favorite".past_tense.should == "favorited"
+  end
+
+  it "should work on rate" do
+    "rate".past_tense.should == "rated"
+  end
+end

data/spec/support/database.yml

@@ -0,0 +1,9 @@
+test:
+  adapter: mysql2
+  encoding: utf8
+  reconnect: false
+  database: horde_test
+  pool: 1
+  username: root
+  password: 
+  socket: /opt/local/var/run/mysql5/mysqld.sock

data/spec/support/db_config.rb

@@ -0,0 +1,6 @@
+require 'logger'
+ActiveRecord::Base.logger = Logger.new(STDOUT)
+
+db_yml = File.expand_path('../database.yml', __FILE__)
+db_config = YAML.load_file(db_yml)['test']
+ActiveRecord::Base.establish_connection(db_config)

data/spec/support/test_models.rb

@@ -0,0 +1,18 @@
+class User < ActiveRecord::Base
+  include Horde::Actor
+  include Horde::Actions::Follow
+end
+
+class Article < ActiveRecord::Base
+  include Horde::Actions::All
+
+  after_favorite :email_author
+
+  def email_author(fav)
+    "#{fav.favoriter.login} favorited article #{self.title}"
+  end
+end
+
+class Photo < ActiveRecord::Base
+  include Horde::Actions::All
+end

metadata

@@ -0,0 +1,220 @@
+--- !ruby/object:Gem::Specification
+name: horde-rails
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Dorren Chen
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-07-15 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: mysql2
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: activerecord
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: sinatra-activerecord
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: hooks
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: debugger
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: database_cleaner
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: A ruby gem providing social networking features for rails app.
+email:
+- dorrenchen@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- db/migrate/20120714150229_horde_setup.rb
+- db/migrate/20120714184427_test_models.rb
+- horde.gemspec
+- lib/horde.rb
+- lib/horde/actions.rb
+- lib/horde/actions/base.rb
+- lib/horde/actions/comment.rb
+- lib/horde/actions/favorite.rb
+- lib/horde/actions/follow.rb
+- lib/horde/actions/rate.rb
+- lib/horde/actor.rb
+- lib/horde/base.rb
+- lib/horde/core_ext/string.rb
+- lib/horde/setting.rb
+- lib/horde/version.rb
+- spec/comment_spec.rb
+- spec/favorite_spec.rb
+- spec/follow_spec.rb
+- spec/rate_spec.rb
+- spec/setting_spec.rb
+- spec/spec_helper.rb
+- spec/string_ext_spec.rb
+- spec/support/database.yml
+- spec/support/db_config.rb
+- spec/support/test_models.rb
+homepage: ''
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: 4029953517073986462
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: 4029953517073986462
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: A ruby gem providing social networking features for rails app.
+test_files:
+- spec/comment_spec.rb
+- spec/favorite_spec.rb
+- spec/follow_spec.rb
+- spec/rate_spec.rb
+- spec/setting_spec.rb
+- spec/spec_helper.rb
+- spec/string_ext_spec.rb
+- spec/support/database.yml
+- spec/support/db_config.rb
+- spec/support/test_models.rb