socialization 0.4.0 → 0.5.0.beta

data/README.rdoc

@@ -1,186 +0,0 @@
-= Socialization
-
-Socialization is a Ruby Gem that allows any model to Follow, Like and/or Mention any other model. This is accomplished through double polymorphic relationships, but you don't need to know that since all the complexity is hidden from you.
-
-The Follow feature is similar to Twitter's Follow. For example, John follows Jane. Unlike Facebook's "friendship", Follow is a one-way concept. The fact that John follows Jane doesn't mean that Jane follows John.
-
-The Like feature works just like a Facebook Like. For example, John likes Pulp Fiction.
-
-The Mention feature was written with Facebook mentions in mind. For example, John mentions Jane in a comment. Typically, Jane would be highlighted in the comment user interface and possibly notified that John mentioned her. This Facebook feature is occasionally called Tagging, although tagging is generally something {entirely different}[http://en.wikipedia.org/wiki/Tag_(metadata)].
-
-{<img src="https://secure.travis-ci.org/cmer/socialization.png" />}[http://travis-ci.org/cmer/socialization]
-
-== Installation
-
-=== Rails 3
-
-Add the gem to the gemfile:
-  gem "socialization"
-
-Run the generator:
-  rails generate socialization -s
-
-This will generate three migration files and threww models named Follow, Like and Mention. You may delete the Follow, Like or Mention model and migration if you don't need that functionality in your application.
-
-=== Rails 2.3.x Support
-
-This gem requires Rails 3 or better. Sorry!
-
-== Usage
-
-=== Setup
-
-Allow a model to be followed:
-  class Celebrity < ActiveRecord::Base
-    ...
-    acts_as_followable
-    ...
-  end
-
-Allow a model to be a follower:
-  class User < ActiveRecord::Base
-    ...
-    acts_as_follower
-    ...
-  end
-
-
-Allow a model to be liked:
-  class Movie < ActiveRecord::Base
-    ...
-    acts_as_likeable
-    ...
-  end
-
-Allow a model to like:
-  class User < ActiveRecord::Base
-    ...
-    acts_as_liker
-    ...
-  end
-
-Allow a model to be mentioned:
-  class User < ActiveRecord::Base
-    ...
-    acts_as_mentionable
-    ...
-  end
-
-Allow a model to mention:
-  class Comment < ActiveRecord::Base
-    ...
-    acts_as_mentioner
-    ...
-  end
-
-Or a more complex case where users can like and follow each other:
-  class User < ActiveRecord::Base
-    ...
-    acts_as_follower
-    acts_as_followable
-    acts_as_liker
-    acts_as_likeable
-    acts_as_mentionable
-    ...
-  end
-
----
-
-=== acts_as_follower Methods
-
-Follow something
-  user.follow!(celebrity)
-
-Stop following
-  user.unfollow!(celebrity)
-
-Is following?
-  user.follows?(celebrity)
-
----
-
-=== acts_as_followable Methods
-
-Find out if an objects follows
-  celebrity.followed_by?(user)
-
-All followers
-  celebrity.followers(User)
-
----
-
-=== acts_as_liker Methods
-
-Like something
-  user.like!(movie)
-
-Stop liking
-  user.unlike!(movie)
-
-Likes?
-  user.likes?(movie)
-
----
-
-=== acts_as_likeable Methods
-
-Find out if an objects likes
-  movie.liked_by?(user)
-
-All likers
-  movie.likers(User)
-
-=== acts_as_mentioner Methods
-
-<b>Note that a "mentioner" is the object containing the mention and not necessarily the actor. For example, John mentions Jane in a comment. The mentioner is the comment object, NOT John.</b>
-
-Mention something
-  comment.mention!(user)
-
-Remove mention
-  comment.unmention!(user)
-
-Mentions?
-  comment.mentions?(user)
-
----
-
-=== acts_as_mentionable Methods
-
-Find out if an objects mentions
-  user.mentioned_by?(comment)
-
-All mentioners
-  user.mentioners(Comment)
-
----
-
-== Demo App
-
-For your convenience, I have added a demo app in demo/demo_app. It does not have a web UI, but you can play with Socialization in the Rails console. It should also help you figure out hown to use Socialization in the Real World.
-
-To use the demo app:
-
-  $ cd demo/demo_app
-  $ bundle
-  $ rake db:migrate
-  $ rake db:seed
-  $ rails console
-
-
-== Note on Patches/Pull Requests
-
-* Fork the project.
-* Make your feature addition or bug fix.
-* Add tests for it. This is important so I don't break it in a future version unintentionally.
-* Send me a pull request. Bonus points for topic branches.
-
-== Similar Projects
-
-acts_as_follower[https://github.com/tcocca/acts_as_follower] is a similar project that I only discovered when I was 95% finished writing the first version of Socialization. I initially intended to name this project acts_as_follower only to find out the name was taken. You might want to check it out as well so see which one suits your needs better. Socialization is simpler, supports "Likes" and "Mentions" and easilly extendable; acts_as_follower has more "Follow" features, however.
-
-
-== Copyright
-
-Copyright (c) 2012 Carl Mercier --  Released under the MIT license.
-

data/demo/demo_app/app/models/follow.rb

@@ -1,3 +0,0 @@
-class Follow < ActiveRecord::Base
-  acts_as_follow_store
-end

data/demo/demo_app/app/models/like.rb

@@ -1,3 +0,0 @@
-class Like < ActiveRecord::Base
-  acts_as_like_store
-end

data/demo/demo_app/app/models/mention.rb

@@ -1,3 +0,0 @@
-class Mention < ActiveRecord::Base
-  acts_as_mention_store
-end

data/demo/demo_app/doc/README_FOR_APP

@@ -1,2 +0,0 @@
-Use this README file to introduce your application and point to useful places in the API for learning more.
-Run "rake doc:app" to generate API documentation for your models, controllers, helpers, and libraries.

data/gemfiles/activerecord30.gemfile

@@ -1,6 +0,0 @@
-# This file was generated by Appraisal
-
-source "http://rubygems.org"
-
-gem "activerecord", "~> 3.0.10"
-

data/gemfiles/activerecord30.gemfile.lock

@@ -1,23 +0,0 @@
-GEM
-  remote: http://rubygems.org/
-  specs:
-    activemodel (3.0.11)
-      activesupport (= 3.0.11)
-      builder (~> 2.1.2)
-      i18n (~> 0.5.0)
-    activerecord (3.0.11)
-      activemodel (= 3.0.11)
-      activesupport (= 3.0.11)
-      arel (~> 2.0.10)
-      tzinfo (~> 0.3.23)
-    activesupport (3.0.11)
-    arel (2.0.10)
-    builder (2.1.2)
-    i18n (0.5.0)
-    tzinfo (0.3.31)
-
-PLATFORMS
-  ruby
-
-DEPENDENCIES
-  activerecord (~> 3.0.10)

data/gemfiles/activerecord31.gemfile

@@ -1,6 +0,0 @@
-# This file was generated by Appraisal
-
-source "http://rubygems.org"
-
-gem "activerecord", "~> 3.1.1"
-

data/gemfiles/activerecord31.gemfile.lock

@@ -1,25 +0,0 @@
-GEM
-  remote: http://rubygems.org/
-  specs:
-    activemodel (3.1.3)
-      activesupport (= 3.1.3)
-      builder (~> 3.0.0)
-      i18n (~> 0.6)
-    activerecord (3.1.3)
-      activemodel (= 3.1.3)
-      activesupport (= 3.1.3)
-      arel (~> 2.2.1)
-      tzinfo (~> 0.3.29)
-    activesupport (3.1.3)
-      multi_json (~> 1.0)
-    arel (2.2.2)
-    builder (3.0.0)
-    i18n (0.6.0)
-    multi_json (1.1.0)
-    tzinfo (0.3.31)
-
-PLATFORMS
-  ruby
-
-DEPENDENCIES
-  activerecord (~> 3.1.1)

data/gemfiles/activerecord32.gemfile

@@ -1,6 +0,0 @@
-# This file was generated by Appraisal
-
-source "http://rubygems.org"
-
-gem "activerecord", "~> 3.2.1"
-

data/gemfiles/activerecord32.gemfile.lock

@@ -1,25 +0,0 @@
-GEM
-  remote: http://rubygems.org/
-  specs:
-    activemodel (3.2.1)
-      activesupport (= 3.2.1)
-      builder (~> 3.0.0)
-    activerecord (3.2.1)
-      activemodel (= 3.2.1)
-      activesupport (= 3.2.1)
-      arel (~> 3.0.0)
-      tzinfo (~> 0.3.29)
-    activesupport (3.2.1)
-      i18n (~> 0.6)
-      multi_json (~> 1.0)
-    arel (3.0.1)
-    builder (3.0.0)
-    i18n (0.6.0)
-    multi_json (1.1.0)
-    tzinfo (0.3.31)
-
-PLATFORMS
-  ruby
-
-DEPENDENCIES
-  activerecord (~> 3.2.1)

data/generators/socialization/USAGE

@@ -1 +0,0 @@
-Generates the Follow, Like and Mention models as well as their migrations.

data/generators/socialization/socialization_generator.rb

@@ -1,15 +0,0 @@
-class SocializationGenerator < Rails::Generator::Base
-  def manifest
-    record do |m|
-      m.template 'model_follow.rb',  'app/models/follow.rb'
-      m.template 'model_like.rb',    'app/models/like.rb'
-      m.template 'model_mention.rb', 'app/models/mention.rb'
-
-      m.migration_template 'migration_follows.rb', 'db/migrate',  :migration_file_name => 'create_follows'
-      sleep 1  # force unique migration timestamp
-      m.migration_template 'migration_likes.rb', 'db/migrate',    :migration_file_name => 'create_likes'
-      sleep 1  # force unique migration timestamp
-      m.migration_template 'migration_mentions.rb', 'db/migrate', :migration_file_name => 'create_mentions'
-    end
-  end
-end

data/generators/socialization/templates/model_follow.rb

@@ -1,3 +0,0 @@
-class Follow < ActiveRecord::Base
-  acts_as_follow_store
-end

data/generators/socialization/templates/model_like.rb

@@ -1,3 +0,0 @@
-class Like < ActiveRecord::Base
-  acts_as_like_store
-end

data/generators/socialization/templates/model_mention.rb

@@ -1,3 +0,0 @@
-class Mention < ActiveRecord::Base
-  acts_as_mention_store
-end

data/lib/socialization/follow_store.rb

@@ -1,14 +0,0 @@
-module Socialization
-  module FollowStore
-    extend ActiveSupport::Concern
-
-    included do
-      belongs_to :follower,   :polymorphic => true
-      belongs_to :followable, :polymorphic => true
-
-      validates_uniqueness_of :followable_type, :scope => [:followable_id, :follower_type, :follower_id], :message => 'You cannot follow the same thing twice.'
-
-      def self.human_attribute_name(*args); ''; end
-    end
-  end
-end

data/lib/socialization/followable.rb

@@ -1,34 +0,0 @@
-module ActiveRecord
-  class Base
-    def is_followable?
-      false
-    end
-  end
-end
-
-module Socialization
-  module Followable
-    extend ActiveSupport::Concern
-
-    included do
-      # A following is the Follow record of the follower following self.
-      has_many :followings, :as => :followable, :dependent => :destroy, :class_name => 'Follow'
-
-      def is_followable?
-        true
-      end
-
-      def followed_by?(follower)
-        raise ArgumentError, "#{follower} is not a follower!" unless follower.is_follower?
-        !self.followings.where(:follower_type => follower.class.to_s, :follower_id => follower.id).empty?
-      end
-
-      def followers(klass)
-        klass = klass.to_s.singularize.camelize.constantize unless klass.is_a?(Class)
-        klass.joins("INNER JOIN follows ON follows.follower_id = #{klass.to_s.tableize}.id AND follows.follower_type = '#{klass.to_s}'").
-              where("follows.followable_type = '#{self.class.to_s}'").
-              where("follows.followable_id   =  #{self.id}")
-      end
-    end
-  end
-end

data/lib/socialization/follower.rb

@@ -1,50 +0,0 @@
-module ActiveRecord
-  class Base
-    def is_follower?
-      false
-    end
-  end
-end
-
-module Socialization
-  module Follower
-    extend ActiveSupport::Concern
-
-    included do
-      # A follow is the Follow record of self following a followable record.
-      has_many :follows, :as => :follower, :dependent => :destroy, :class_name => 'Follow'
-
-      def is_follower?
-        true
-      end
-
-      def follow!(followable)
-        raise ArgumentError, "#{followable} is not followable!" unless followable.is_followable?
-        raise ArgumentError, "#{self} cannot follow itself!" unless self != followable
-        Follow.create!({ :follower => self, :followable => followable }, :without_protection => true)
-      end
-
-      def unfollow!(followable)
-        ff = followable.followings.where(:follower_type => self.class.to_s, :follower_id => self.id)
-        unless ff.empty?
-          ff.each { |f| f.destroy }
-        else
-          raise ActiveRecord::RecordNotFound
-        end
-      end
-
-      def follows?(followable)
-        raise ArgumentError, "#{followable} is not followable!" unless followable.is_followable?
-        !self.follows.where(:followable_type => followable.class.to_s, :followable_id => followable.id).empty?
-      end
-
-      def followees(klass)
-        klass = klass.to_s.singularize.camelize.constantize unless klass.is_a?(Class)
-        klass.joins("INNER JOIN follows ON follows.followable_id = #{klass.to_s.tableize}.id AND follows.followable_type = '#{klass.to_s}'").
-              where("follows.follower_type = '#{self.class.to_s}'").
-              where("follows.follower_id   =  #{self.id}")
-
-      end
-    end
-  end
-end