bustle 0.0.1 → 0.1.0

data/.gitignore

@@ -1,3 +1,5 @@
+.DS_Store
+._*
 *.gem
 *.rbc
 .bundle

data/.rspec

@@ -0,0 +1 @@
+--colour

data/.travis.yml

@@ -0,0 +1,4 @@
+language: ruby
+rvm:
+  - 1.9.2
+  - 1.9.3

data/README.md

@@ -1,4 +1,4 @@
-# Bustle
+# Bustle [![Build Status](https://secure.travis-ci.org/fredwu/bustle.png?branch=master)](http://travis-ci.org/fredwu/bustle) [![Dependency Status](https://gemnasium.com/fredwu/bustle.png)](https://gemnasium.com/fredwu/bustle) [![Code Climate](https://codeclimate.com/badge.png)](https://codeclimate.com/github/fredwu/bustle)
 
 Activities recording and retrieving using a simple Pub/Sub architecture.
 
@@ -7,6 +7,14 @@ The typical use cases are:
 - Timeline (e.g. tracking activities such as posting and commenting for users)
 - Logging
 
+The advantages of Bustle are:
+
+- It is lightweight and simple to use
+- It is largely self-contained and separated from you core app logic
+- It works nicely with ActiveRecord out of box
+- It can be extended to use with other databases
+- It has full unit test coverage
+
 ## Installation
 
 Add this line to your application's Gemfile:
@@ -23,11 +31,6 @@ First of all, you will need to configure Bustle. If you are using Rails, you can
 
 ```ruby
 Bustle.config do |c|
-  # Specify an intepreter strategy for intepreting app data
-  # i.e. what your application uses for persistence
-  # Bustle ships with an ActiveRecord intepreter strategy
-  c.intepreter = Bustle::Intepreter::ActiveRecord
-
   # Specify a storage strategy for storing activities
   # Bustle ships with an ActiveRecord storage strategy
   c.storage = Bustle::Storage::ActiveRecord
@@ -40,34 +43,34 @@ For ActiveRecord, you will need the following migration file:
 class CreateBustleTables < ActiveRecord::Migration
   def change
     create_table :bustle_activities do |t|
-      t.string  :reference_class
-      t.integer :reference_id
+      t.string  :resource_class
+      t.integer :resource_id
       t.string  :action
       t.integer :publisher_id, :null => false
       t.timestamps
     end
 
     create_table :bustle_publishers do |t|
-      t.string  :reference_class, :null => false
-      t.integer :reference_id,    :null => false
+      t.string  :resource_class, :null => false
+      t.integer :resource_id,    :null => false
       t.timestamps
     end
 
     create_table :bustle_subscribers do |t|
-      t.string  :reference_class, :null => false
-      t.integer :reference_id,    :null => false
+      t.string  :resource_class, :null => false
+      t.integer :resource_id,    :null => false
       t.timestamps
     end
 
     create_table :bustle_subscriptions do |t|
       t.integer :publisher_id,  :null => false
-      t.string  :subscriber_id, :null => false
+      t.integer :subscriber_id, :null => false
       t.timestamps
     end
 
     add_index :bustle_activities, :publisher_id
-    add_index :bustle_publishers, [:reference_class, :reference_id], :unique => true
-    add_index :bustle_subscribers, [:reference_class, :reference_id], :unique => true
+    add_index :bustle_publishers, [:resource_class, :resource_id], :unique => true
+    add_index :bustle_subscribers, [:resource_class, :resource_id], :unique => true
     add_index :bustle_subscriptions, :publisher_id
     add_index :bustle_subscriptions, :subscriber_id
     add_index :bustle_subscriptions, [:publisher_id, :subscriber_id], :unique => true
@@ -116,19 +119,19 @@ Bustle::Publishers.add post
 Bustle::Subscriptions.add bustle_publisher, bustle_subscriber
 
 # example
-publisher  = Bustle::Publishers.find(Post.first)
-subscriber = Bustle::Subscribers.find(User.first)
+publisher  = Bustle::Publishers.get(Post.first)
+subscriber = Bustle::Subscribers.get(User.first)
 Bustle::Subscriptions.add publisher, subscriber
 ```
 
 #### Find a Subscriber/Publisher/Subscription
 
 ```ruby
-Bustle::Subscribers.find subscriber
-Bustle::Publishers.find publisher
-Bustle::Subscriptions.find bustle_publisher, bustle_subscriber # => Bustle::Subscription
-Bustle::Subscriptions.find bustle_publisher # => an array of Bustle::Subscription for the publisher
-Bustle::Subscriptions.find bustle_subscriber # => an array of Bustle::Subscription for the subscriber
+Bustle::Subscribers.get subscriber
+Bustle::Publishers.get publisher
+Bustle::Subscriptions.get bustle_publisher, bustle_subscriber # => Bustle::Subscription
+Bustle::Subscriptions.by bustle_publisher # => an array of Bustle::Subscription by the publisher
+Bustle::Subscriptions.for bustle_subscriber # => an array of Bustle::Subscription for the subscriber
 ```
 
 #### Remove a Subscriber/Publisher/Subscription
@@ -142,9 +145,9 @@ Bustle::Subscriptions.remove bustle_publisher, bustle_subscriber
 Or:
 
 ```ruby
-Bustle::Subscribers.find(subscriber).destroy
-Bustle::Publishers.find(publisher).destroy
-Bustle::Subscriptions.find(bustle_publisher, bustle_subscriber).destroy
+Bustle::Subscribers.get(subscriber).destroy
+Bustle::Publishers.get(publisher).destroy
+Bustle::Subscriptions.get(bustle_publisher, bustle_subscriber).destroy
 ```
 
 #### Publish an Activity
@@ -158,7 +161,7 @@ Bustle::Publisher.publish action, activity
 post    = Post.find(1)
 comment = post.comments.add(:content => "I'm a comment")
 Bustle::Publishers.add post
-publisher = Bustle::Publishers.find post
+publisher = Bustle::Publishers.get post
 publisher.publish 'new', comment
 ```
 
@@ -172,7 +175,7 @@ Bustle::Activities.for bustle_subscriber
 Bustle::Subscriber.activities
 
 # example
-subscriber = Bustle::Subscribers.find(User.first)
+subscriber = Bustle::Subscribers.get(User.first)
 subscriber.activities
 ```
 
@@ -184,27 +187,21 @@ Bustle::Activities.by bustle_publisher
 Bustle::Publisher.activities
 
 # example
-publisher = Bustle::Publishers.find(Post.first)
+publisher = Bustle::Publishers.get(Post.first)
 publisher.activities
 ```
 
-##### Activities Filtering
+#### Filtering (for Activities and Subscriptions)
 
 ```ruby
-Bustle::Activities.for(bustle_subscriber).filter :key => :value
+Bustle::Activities.filter :key => :value
+Bustle::Subscriptions.filter :key => :value
 # or
-Bustle::Subscriber.activities.filter :key => :value
+Bustle::Subscriber.activities :key => :value
 
 # example
-subscriber = Bustle::Subscribers.find(User.first)
-subscriber.activities.filter :action => 'new'
-subscriber.activities.by(publisher).filter(:action => 'new')
-```
-
-Activities are normal enumerable objects from your chosen storage, so in ActiveRecord's case, you may use any Arel methods to query the result:
-
-```ruby
-subscriber.activities.filter(:action => 'new').order('created_at ASC').limit(10)
+subscriber = Bustle::Subscribers.get(User.first)
+subscriber.activities :action => 'new'
 ```
 
 ## License

data/bustle.gemspec

@@ -15,7 +15,15 @@ Gem::Specification.new do |gem|
   gem.require_paths = ["lib"]
   gem.version       = Bustle::VERSION
 
+  gem.add_dependency 'activesupport', '>= 3.0'
+  gem.add_dependency 'orm_adapter', '~> 0.1.0'
+
   gem.add_development_dependency 'rake'
   gem.add_development_dependency 'simplecov'
-  gem.add_development_dependency 'minitest-colorize'
+  gem.add_development_dependency 'rspec'
+  gem.add_development_dependency 'factory_girl'
+  gem.add_development_dependency 'database_cleaner'
+  gem.add_development_dependency 'pry'
+  gem.add_development_dependency 'activerecord', '>= 3.0'
+  gem.add_development_dependency 'sqlite3'
 end

data/lib/bustle/activities.rb

@@ -0,0 +1,25 @@
+module Bustle
+  class Activities
+    RESOURCE_NAME = 'Bustle::Activity'
+
+    include Concern::Filterable
+    include Concern::ByPublisher
+
+    class << self
+      def add(publisher, action, activity_resource)
+        Activity.to_adapter.create!(
+          :resource_class => activity_resource.class.name,
+          :resource_id    => activity_resource.id,
+          :action         => action,
+          :publisher_id   => publisher.id
+        )
+      end
+
+      def for(subscriber, conditions = {})
+        publisher_ids = Subscriptions.for(subscriber).map(&:publisher_id)
+
+        filter({ :publisher_id => publisher_ids }.merge(conditions))
+      end
+    end
+  end
+end

data/lib/bustle/concerns/by_publisher.rb

@@ -0,0 +1,11 @@
+module Bustle::Concern
+  module ByPublisher
+    extend ActiveSupport::Concern
+
+    module ClassMethods
+      def by(publisher, conditions = {})
+        filter({ :publisher_id => publisher.id }.merge(conditions))
+      end
+    end
+  end
+end

data/lib/bustle/concerns/filterable.rb

@@ -0,0 +1,11 @@
+module Bustle::Concern
+  module Filterable
+    extend ActiveSupport::Concern
+
+    module ClassMethods
+      def filter(options = {})
+        self::RESOURCE_NAME.constantize.to_adapter.find_all(options)
+      end
+    end
+  end
+end

data/lib/bustle/concerns/for_subscriber.rb

@@ -0,0 +1,11 @@
+module Bustle::Concern
+  module ForSubscriber
+    extend ActiveSupport::Concern
+
+    module ClassMethods
+      def for(subscriber, conditions = {})
+        filter({ :subscriber_id => subscriber.id }.merge(conditions))
+      end
+    end
+  end
+end

data/lib/bustle/concerns/resource_collection.rb

@@ -0,0 +1,25 @@
+module Bustle::Concern
+  module ResourceCollection
+    extend ActiveSupport::Concern
+
+    module ClassMethods
+      def add(resource)
+        self::RESOURCE_NAME.constantize.to_adapter.create!(
+          :resource_class => resource.class.name,
+          :resource_id    => resource.id
+        )
+      end
+
+      def get(resource)
+        self::RESOURCE_NAME.constantize.to_adapter.find_first(
+          :resource_class => resource.class.name,
+          :resource_id    => resource.id
+        )
+      end
+
+      def remove(resource)
+        get(resource).destroy
+      end
+    end
+  end
+end

data/lib/bustle/models/activity.rb

@@ -0,0 +1,4 @@
+module Bustle
+  class Activity < "#{Bustle.storage}::Activity".constantize
+  end
+end

data/lib/bustle/models/publisher.rb

@@ -0,0 +1,11 @@
+module Bustle
+  class Publisher < "#{Bustle.storage}::Publisher".constantize
+    def publish(action, activity_resource)
+      Activities.add self, action, activity_resource
+    end
+
+    def activities(conditions = {})
+      Activities.by(self, conditions)
+    end
+  end
+end

data/lib/bustle/models/subscriber.rb

@@ -0,0 +1,7 @@
+module Bustle
+  class Subscriber < "#{Bustle.storage}::Subscriber".constantize
+    def activities(conditions = {})
+      Activities.for(self, conditions)
+    end
+  end
+end

data/lib/bustle/models/subscription.rb

@@ -0,0 +1,4 @@
+module Bustle
+  class Subscription < "#{Bustle.storage}::Subscription".constantize
+  end
+end

data/lib/bustle/publishers.rb

@@ -0,0 +1,7 @@
+module Bustle
+  class Publishers
+    RESOURCE_NAME = 'Bustle::Publisher'
+
+    include Concern::ResourceCollection
+  end
+end

data/lib/bustle/storage/active_record/activity.rb

@@ -0,0 +1,5 @@
+module Bustle::Storage::ActiveRecord
+  class Activity < ::ActiveRecord::Base
+    self.table_name = 'bustle_activities'
+  end
+end

data/lib/bustle/storage/active_record/publisher.rb

@@ -0,0 +1,5 @@
+module Bustle::Storage::ActiveRecord
+  class Publisher < ::ActiveRecord::Base
+    self.table_name = 'bustle_publishers'
+  end
+end

data/lib/bustle/storage/active_record/subscriber.rb

@@ -0,0 +1,5 @@
+module Bustle::Storage::ActiveRecord
+  class Subscriber < ::ActiveRecord::Base
+    self.table_name = 'bustle_subscribers'
+  end
+end

data/lib/bustle/storage/active_record/subscription.rb

@@ -0,0 +1,5 @@
+module Bustle::Storage::ActiveRecord
+  class Subscription < ::ActiveRecord::Base
+    self.table_name = 'bustle_subscriptions'
+  end
+end

data/lib/bustle/storage/active_record.rb

@@ -0,0 +1,5 @@
+require 'active_record'
+require 'bustle/storage/active_record/activity'
+require 'bustle/storage/active_record/publisher'
+require 'bustle/storage/active_record/subscriber'
+require 'bustle/storage/active_record/subscription'

data/lib/bustle/subscribers.rb

@@ -0,0 +1,7 @@
+module Bustle
+  class Subscribers
+    RESOURCE_NAME = 'Bustle::Subscriber'
+
+    include Concern::ResourceCollection
+  end
+end

data/lib/bustle/subscriptions.rb

@@ -0,0 +1,29 @@
+module Bustle
+  class Subscriptions
+    RESOURCE_NAME = 'Bustle::Subscription'
+
+    include Concern::Filterable
+    include Concern::ByPublisher
+    include Concern::ForSubscriber
+
+    class << self
+      def add(publisher, subscriber)
+        Subscription.to_adapter.create!(
+          :publisher_id  => publisher.id,
+          :subscriber_id => subscriber.id
+        )
+      end
+
+      def get(publisher, subscriber)
+        Subscription.to_adapter.find_first(
+          :publisher_id  => publisher.id,
+          :subscriber_id => subscriber.id
+        )
+      end
+
+      def remove(publisher, subscriber)
+        get(publisher, subscriber).destroy
+      end
+    end
+  end
+end

data/lib/bustle/version.rb

@@ -1,3 +1,3 @@
 module Bustle
-  VERSION = "0.0.1"
+  VERSION = "0.1.0"
 end

data/lib/bustle.rb

@@ -1 +1,31 @@
+require 'active_support/dependencies'
+require 'active_support/concern'
+
 require "bustle/version"
+require "bustle/concerns/filterable"
+require "bustle/concerns/by_publisher"
+require "bustle/concerns/for_subscriber"
+require "bustle/concerns/resource_collection"
+require "bustle/activities"
+require "bustle/publishers"
+require "bustle/subscribers"
+require "bustle/subscriptions"
+
+module Bustle
+  mattr_accessor :storage
+
+  module Storage
+    autoload :ActiveRecord, 'bustle/storage/active_record'
+  end
+
+  def self.config
+    yield self
+
+    require 'bustle/models/activity'
+    require 'bustle/models/publisher'
+    require 'bustle/models/subscriber'
+    require 'bustle/models/subscription'
+
+    require 'orm_adapter'
+  end
+end

data/specs/bustle/activities_spec.rb

@@ -0,0 +1,65 @@
+require_relative '../spec_helper'
+
+module Bustle
+  describe Activities do
+    include_context 'app_resources'
+
+    let(:publisher)   { Publishers.add post }
+    let(:publisher2)  { Publishers.add user }
+    let(:subscriber)  { Subscribers.add post }
+    let(:subscriber2) { Subscribers.add user }
+
+    it "creates an activity" do
+      Activities.add publisher, 'show', comment
+
+      activity = Activity.to_adapter.get(1)
+      activity.resource_class.should  == 'Bustle::Dummy::Comment'
+      activity.resource_id.should == 101
+      activity.action.should == 'show'
+      activity.publisher_id.should == publisher.id
+    end
+
+    context "multiple activities" do
+      before do
+        2.times { Activities.add publisher, 'show', comment }
+        1.times { Activities.add publisher, 'reply', comment }
+        2.times { Activities.add publisher2, 'reply', comment }
+      end
+
+      it "finds all activities" do
+        Activities.filter.count.should == 5
+      end
+
+      context "#by" do
+        it "finds all activities by a publisher" do
+          Activities.by(publisher).count.should == 3
+        end
+
+        it "finds all activities filtered by conditions" do
+          Activities.by(publisher, {
+            :action => 'show'
+          }).count.should == 2
+        end
+      end
+
+      context "#for" do
+        before do
+          Subscriptions.add publisher, subscriber
+          Subscriptions.add publisher, subscriber2
+          Subscriptions.add publisher2, subscriber2
+        end
+
+        it "finds all activities for a subscriber" do
+          Activities.for(subscriber).count.should == 3
+          Activities.for(subscriber2).count.should == 5
+        end
+
+        it "finds all activities filtered by conditions" do
+          Activities.for(subscriber2, {
+            :publisher_id => publisher2.id
+          }).count.should == 2
+        end
+      end
+    end
+  end
+end

data/specs/bustle/models/activity_spec.rb

@@ -0,0 +1,9 @@
+require_relative '../../spec_helper'
+
+module Bustle
+  describe 'Activity' do
+    let(:described_class) { Activity }
+
+    it_behaves_like 'model'
+  end
+end

data/specs/bustle/models/publisher_spec.rb

@@ -0,0 +1,17 @@
+require_relative '../../spec_helper'
+
+module Bustle
+  describe 'Publisher' do
+    let(:described_class) { Publisher }
+
+    include_context 'app_resources'
+    it_behaves_like 'model'
+    it_behaves_like 'has_activities'
+
+    it "is able to publish an activity" do
+      publisher = Publishers.add post
+      publisher.publish 'reply', comment
+      Activity.to_adapter.get(1).action.should == 'reply'
+    end
+  end
+end

data/specs/bustle/models/subscriber_spec.rb

@@ -0,0 +1,11 @@
+require_relative '../../spec_helper'
+
+module Bustle
+  describe 'Subscriber' do
+    let(:described_class) { Subscriber }
+
+    include_context 'app_resources'
+    it_behaves_like 'model'
+    it_behaves_like 'has_activities'
+  end
+end

data/specs/bustle/models/subscription_spec.rb

@@ -0,0 +1,9 @@
+require_relative '../../spec_helper'
+
+module Bustle
+  describe 'Subscription' do
+    let(:described_class) { Subscription }
+
+    it_behaves_like 'model'
+  end
+end

data/specs/bustle/publishers_spec.rb

@@ -0,0 +1,8 @@
+require_relative '../spec_helper'
+
+module Bustle
+  describe Publishers do
+    include_context 'app_resources'
+    it_behaves_like 'resource_collection'
+  end
+end

data/specs/bustle/storage/active_record_spec.rb

@@ -0,0 +1,23 @@
+require_relative '../../spec_helper'
+
+module Bustle::Storage
+  describe ActiveRecord do
+    before(:all) do
+      Bustle.config { |c| c.storage = ActiveRecord }
+    end
+
+    it "loads storage model files" do
+      ActiveRecord.const_defined?(:Activity).should == true
+      ActiveRecord.const_defined?(:Publisher).should == true
+      ActiveRecord.const_defined?(:Subscriber).should == true
+      ActiveRecord.const_defined?(:Subscription).should == true
+    end
+
+    it "has correct table names" do
+      ActiveRecord::Activity.table_name.should == 'bustle_activities'
+      ActiveRecord::Publisher.table_name.should == 'bustle_publishers'
+      ActiveRecord::Subscriber.table_name.should == 'bustle_subscribers'
+      ActiveRecord::Subscription.table_name.should == 'bustle_subscriptions'
+    end
+  end
+end

data/specs/bustle/subscribers_spec.rb

@@ -0,0 +1,8 @@
+require_relative '../spec_helper'
+
+module Bustle
+  describe Subscribers do
+    include_context 'app_resources'
+    it_behaves_like 'resource_collection'
+  end
+end

data/specs/bustle/subscriptions_spec.rb

@@ -0,0 +1,76 @@
+require_relative '../spec_helper'
+
+module Bustle
+  describe Subscriptions do
+    include_context 'app_resources'
+
+    let(:publisher)   { Publishers.add post }
+    let(:publisher2)  { Publishers.add Dummy::Post.create!(:title => '') }
+    let(:subscriber)  { Subscribers.add user }
+    let(:subscriber2) { Subscribers.add Dummy::User.create!(:name => '') }
+
+    before do
+      Subscriptions.add publisher, subscriber
+    end
+
+    it "creates a subscription" do
+      subscription = Subscription.to_adapter.get(1)
+
+      subscription.publisher_id.should  == publisher.id
+      subscription.subscriber_id.should == subscriber.id
+    end
+
+    it "finds a subscription" do
+      subscription = Subscriptions.get publisher, subscriber
+
+      subscription.publisher_id.should  == publisher.id
+      subscription.subscriber_id.should == subscriber.id
+    end
+
+    it "removes a subscription" do
+      subscription = Subscriptions.get publisher, subscriber
+
+      Subscriptions.remove publisher, subscriber
+      Subscriptions.filter.count.should == 0
+    end
+
+    context "finding multiple subscriptions" do
+      before do
+        Subscriptions.add publisher2, subscriber
+        Subscriptions.add publisher, subscriber2
+        Subscriptions.add publisher2, subscriber2
+      end
+
+      it "finds all subscriptions" do
+        Subscriptions.filter.count.should == 4
+      end
+
+      it "finds specific subscriptions" do
+        Subscriptions.filter({
+          :publisher_id  => publisher.id,
+          :subscriber_id => subscriber.id
+        }).count.should == 1
+      end
+
+      it "finds subscriptions by a publisher" do
+        Subscriptions.by(publisher).count.should == 2
+      end
+
+      it "finds subscriptions by a publisher and conditions" do
+        Subscriptions.by(publisher, {
+          :subscriber_id => subscriber2.id
+        }).count.should == 1
+      end
+
+      it "finds subscriptions for a subscriber" do
+        Subscriptions.for(subscriber).count.should == 2
+      end
+
+      it "finds subscriptions for a subscriber and conditions" do
+        Subscriptions.for(subscriber, {
+          :publisher_id => publisher.id
+        }).count.should == 1
+      end
+    end
+  end
+end

data/specs/bustle_spec.rb

@@ -0,0 +1,12 @@
+require_relative 'spec_helper'
+
+describe Bustle do
+  context "configuration" do
+    [:storage].each do |option|
+      it "sets the config option #{option}" do
+        Bustle.config { |c| c.send "#{option}=", 'dummy' }
+        Bustle.send(option).should == 'dummy'
+      end
+    end
+  end
+end

data/specs/spec_helper.rb

@@ -0,0 +1,35 @@
+require 'simplecov'
+SimpleCov.start
+
+require 'rspec/autorun'
+require 'factory_girl'
+require 'database_cleaner'
+require 'pry'
+
+require File.expand_path('../../lib/bustle', __FILE__)
+Dir[File.expand_path('../../specs/support/**/*.rb', __FILE__)].each {|f| require f}
+
+BUSTLE_STORAGES = [
+  Bustle::Storage::ActiveRecord
+]
+
+RSpec.configure do |config|
+  config.include FactoryGirl::Syntax::Methods
+
+  config.before(:suite) do
+    module Bustle::Dummy
+      class User < ActiveRecord::Base; end
+      class Post < ActiveRecord::Base; end
+      class Comment < ActiveRecord::Base; end
+    end
+
+    Bustle.config do |c|
+      c.storage = Bustle::Storage::ActiveRecord
+    end
+  end
+
+  DatabaseCleaner.strategy = :truncation
+  config.before do
+    DatabaseCleaner.clean
+  end
+end

data/specs/support/active_record_tables.rb

@@ -0,0 +1,45 @@
+require 'active_record'
+
+ActiveRecord::Base.establish_connection(:adapter => 'sqlite3', :database => ":memory:")
+
+ActiveRecord::Migration.suppress_messages do
+  ActiveRecord::Schema.define(:version => 0) do
+    create_table :users, :force => true do |t|
+      t.string :name
+    end
+
+    create_table :posts, :force => true do |t|
+      t.string :title
+    end
+
+    create_table :comments, :force => true do |t|
+      t.string :title
+    end
+
+    create_table :bustle_activities, :force => true do |t|
+      t.string  :resource_class
+      t.integer :resource_id
+      t.string  :action
+      t.integer :publisher_id
+      t.timestamps
+    end
+
+    create_table :bustle_publishers, :force => true do |t|
+      t.string  :resource_class
+      t.integer :resource_id
+      t.timestamps
+    end
+
+    create_table :bustle_subscribers, :force => true do |t|
+      t.string  :resource_class
+      t.integer :resource_id
+      t.timestamps
+    end
+
+    create_table :bustle_subscriptions, :force => true do |t|
+      t.integer :publisher_id
+      t.integer :subscriber_id
+      t.timestamps
+    end
+  end
+end

data/specs/support/shared_context/app_resources.rb

@@ -0,0 +1,11 @@
+shared_context 'app_resources' do
+  let(:user)    { Bustle::Dummy::User.create! :name => 'Fred' }
+  let(:post)    { Bustle::Dummy::Post.create! :title => 'hello' }
+  let(:comment) { Bustle::Dummy::Comment.create! :title => 'hi' }
+
+  before do
+    user.update_attribute :id, 42
+    post.update_attribute :id, 69
+    comment.update_attribute :id, 101
+  end
+end

data/specs/support/shared_examples/has_activities.rb

@@ -0,0 +1,17 @@
+shared_examples 'has_activities' do
+  context "activities" do
+    let(:publisher)  { Bustle::Publishers.add post }
+    let(:subscriber) { Bustle::Subscribers.add user }
+
+    before do
+      Bustle::Subscriptions.add publisher, subscriber
+    end
+
+    it "has activities" do
+      2.times { publisher.publish 'show', comment }
+
+      publisher.activities.count.should == 2
+      subscriber.activities.count.should == 2
+    end
+  end
+end

data/specs/support/shared_examples/model.rb

@@ -0,0 +1,38 @@
+shared_examples 'model' do
+  BUSTLE_STORAGES.each do |storage|
+    let(:factory_class) { described_class }
+    let(:factory_name)  { factory_class.to_s.split('::').last.downcase.to_sym }
+
+    before(:all) do
+      Bustle.config { |c| c.storage = storage }
+
+      _factory_class = described_class
+      _factory_name  = factory_name
+
+      FactoryGirl.define do
+        factory _factory_name, :class => _factory_class do
+        end
+      end
+    end
+
+    context "storage #{storage}" do
+      it "has correct parent classes" do
+        described_class.superclass.to_s.should == "#{Bustle.storage}::#{described_class.name.split('::').last}"
+      end
+
+      it "is able to create a new instance" do
+        described_class.to_adapter.respond_to?(:create!).should == true
+      end
+
+      it "is able to destroy itself" do
+        described_class.new.respond_to?(:destroy).should == true
+
+        create factory_name
+        described_class.to_adapter.find_all({}).count.should == 1
+
+        described_class.to_adapter.find_first({}).destroy
+        described_class.to_adapter.find_all({}).count.should == 0
+      end
+    end
+  end
+end

data/specs/support/shared_examples/resource_collection.rb

@@ -0,0 +1,24 @@
+shared_examples 'resource_collection' do
+  let(:resource_class) { described_class::RESOURCE_NAME.constantize.to_adapter }
+
+  before do
+    described_class.add user
+  end
+
+  it "adds a model record" do
+    model = resource_class.get(1)
+    model.resource_class.should == 'Bustle::Dummy::User'
+    model.resource_id.should == 42
+  end
+
+  it "finds a model record" do
+    model = described_class.get user
+    model.resource_class.should == 'Bustle::Dummy::User'
+    model.resource_id.should == 42
+  end
+
+  it "removes a model record" do
+    described_class.remove(user)
+    resource_class.find_all({}).count.should == 0
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: bustle
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.1.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,8 +9,40 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-06-10 00:00:00.000000000 Z
+date: 2012-06-13 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: orm_adapter
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.1.0
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -44,7 +76,87 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: minitest-colorize
+  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: factory_girl
+  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'
+- !ruby/object:Gem::Dependency
+  name: pry
+  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: activerecord
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: sqlite3
   requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
@@ -67,13 +179,47 @@ extensions: []
 extra_rdoc_files: []
 files:
 - .gitignore
+- .rspec
+- .travis.yml
 - Gemfile
 - README.md
 - Rakefile
 - bustle.gemspec
 - lib/bustle.rb
+- lib/bustle/activities.rb
+- lib/bustle/concerns/by_publisher.rb
+- lib/bustle/concerns/filterable.rb
+- lib/bustle/concerns/for_subscriber.rb
+- lib/bustle/concerns/resource_collection.rb
+- lib/bustle/models/activity.rb
+- lib/bustle/models/publisher.rb
+- lib/bustle/models/subscriber.rb
+- lib/bustle/models/subscription.rb
+- lib/bustle/publishers.rb
+- lib/bustle/storage/active_record.rb
+- lib/bustle/storage/active_record/activity.rb
+- lib/bustle/storage/active_record/publisher.rb
+- lib/bustle/storage/active_record/subscriber.rb
+- lib/bustle/storage/active_record/subscription.rb
+- lib/bustle/subscribers.rb
+- lib/bustle/subscriptions.rb
 - lib/bustle/version.rb
-- lib/specs/spec_helper.rb
+- specs/bustle/activities_spec.rb
+- specs/bustle/models/activity_spec.rb
+- specs/bustle/models/publisher_spec.rb
+- specs/bustle/models/subscriber_spec.rb
+- specs/bustle/models/subscription_spec.rb
+- specs/bustle/publishers_spec.rb
+- specs/bustle/storage/active_record_spec.rb
+- specs/bustle/subscribers_spec.rb
+- specs/bustle/subscriptions_spec.rb
+- specs/bustle_spec.rb
+- specs/spec_helper.rb
+- specs/support/active_record_tables.rb
+- specs/support/shared_context/app_resources.rb
+- specs/support/shared_examples/has_activities.rb
+- specs/support/shared_examples/model.rb
+- specs/support/shared_examples/resource_collection.rb
 homepage: https://github.com/fredwu/bustle
 licenses: []
 post_install_message: 
@@ -88,7 +234,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 3392583862411400704
+      hash: 1631565603439208655
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
@@ -97,7 +243,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 3392583862411400704
+      hash: 1631565603439208655
 requirements: []
 rubyforge_project: 
 rubygems_version: 1.8.24

data/lib/specs/spec_helper.rb

@@ -1,8 +0,0 @@
-require 'simplecov'
-SimpleCov.start
-
-require 'minitest-colorize'
-require 'minitest/autorun'
-require 'minitest/spec'
-
-require File.expand_path('../../lib/bustle', __FILE__)