active_record_rollout 0.0.1

data/spec/lib/active_record/rollout/flag_spec.rb

@@ -0,0 +1,8 @@
+require "spec_helper"
+
+describe ActiveRecord::Rollout::Flag do
+  it { should belong_to :feature }
+  it { should validate_presence_of :feature_id }
+  it { should validate_presence_of :flaggable_type }
+  it { should allow_mass_assignment_of :flaggable_type }
+end

data/spec/lib/active_record/rollout/flaggable_flag_spec.rb

@@ -0,0 +1,8 @@
+require "spec_helper"
+
+describe ActiveRecord::Rollout::FlaggableFlag do
+  it { should be_a ActiveRecord::Rollout::Flag }
+  it { should belong_to :flaggable }
+  it { should validate_presence_of :flaggable_id }
+  it { should allow_mass_assignment_of :flaggable }
+end

data/spec/lib/active_record/rollout/flaggable_spec.rb

@@ -0,0 +1,149 @@
+require "spec_helper"
+
+describe ActiveRecord::Rollout::Flaggable do
+  subject { User.new }
+
+  describe "#flaggable_find!" do
+    context "when a non-default find_by is not specified" do
+      it "finds by id" do
+        User.should_receive(:find_by_id!).with(1)
+        User.flaggable_find!(1)
+      end
+    end
+
+    context "when a non-default find_by is not specified" do
+      class Foo < ActiveRecord::Base
+        acts_as_flaggable find_by: :email
+      end
+
+      it "finds by id" do
+        Foo.should_receive(:find_by_email!).with("user@example.com")
+        Foo.flaggable_find!("user@example.com")
+      end
+    end
+  end
+
+  describe "#has_feature?" do
+    let(:user) { User.create(name: "foo") }
+    let(:feature) { ActiveRecord::Rollout::Feature.create(name: "bar") }
+
+    it "memoizes found features" do
+      ActiveRecord::Rollout::Feature.stub(:find_by_name) { feature }
+      feature.flaggable_flags.create(flaggable: user)
+
+      feature.should_receive(:match?).with(user).and_return(true)
+      user.has_feature?(:bar)
+
+      feature.should_not_receive(:match?).with(user)
+      user.has_feature?(:bar)
+    end
+
+    context "when given a block" do
+      context "and the user is flagged in" do
+        before do
+          feature.flaggable_flags.create(flaggable: user)
+        end
+
+        it "calls the block" do
+          foo = "foo"
+          user.has_feature?(:bar) { foo = "bar" }
+          foo.should eq "bar"
+        end
+
+        it "returns the match" do
+          foo = "foo"
+
+          if user.has_feature? :not_feature do
+          end; else
+            foo = "bar"
+          end
+
+          foo.should eq "bar"
+        end
+
+        context "when the block raises an exception" do
+          it "increments the failure_count of the feature" do
+            begin
+              user.has_feature? :bar do
+                raise "This is an exception"
+              end
+            rescue
+              feature.reload.failure_count.should eq 1
+            end
+          end
+
+          it "raises the exception" do
+            expect do
+              user.has_feature? :bar do
+                raise "This is an exception"
+              end
+            end.to raise_error "This is an exception"
+          end
+        end
+      end
+
+      context "and the user is not flagged in" do
+        it "does not call the block" do
+          foo = "foo"
+          user.has_feature?(:bar) { foo = "bar" }
+          foo.should eq "foo"
+        end
+      end
+    end
+
+    context "when the user is not flagged in" do
+      it "returns false" do
+        user.has_feature?(:bar).should be_false
+      end
+    end
+
+    context "when the user is flagged in" do
+      context "and the user is opted out" do
+        before do
+          feature.flaggable_flags.create(flaggable: user)
+          feature.opt_out_flags.create(flaggable: user)
+        end
+
+        it "returns false" do
+          user.has_feature?(:bar).should be_false
+        end
+      end
+
+      context "and the user is not opted out" do
+        context "and the user is flagged in individually" do
+          before do
+            feature.flaggable_flags.create(flaggable: user)
+          end
+
+          it "returns true" do
+            user.has_feature?(:bar).should be_true
+          end
+        end
+
+        context "and the user is flagged in as a percentage" do
+          before do
+            feature.percentage_flags.create(flaggable_type: "User", percentage: 100)
+          end
+
+          it "returns true" do
+            user.has_feature?(:bar).should be_true
+          end
+        end
+
+        context "and the user is flagged in via a group" do
+          before do
+            ActiveRecord::Rollout::Feature.define_user_group "name_foo" do |user|
+              user.name == "foo"
+            end
+
+            feature.group_flags.create(flaggable_type: "User", group_name: "name_foo")
+          end
+
+          it "returns true" do
+            user.has_feature?(:bar).should be_true
+          end
+        end
+      end
+    end
+  end
+end

data/spec/lib/active_record/rollout/group_flag_spec.rb

@@ -0,0 +1,7 @@
+require "spec_helper"
+
+describe ActiveRecord::Rollout::GroupFlag do
+  it { should be_a ActiveRecord::Rollout::Flag }
+  it { should validate_presence_of :group_name }
+  it { should allow_mass_assignment_of :group_name }
+end

data/spec/lib/active_record/rollout/opt_out_flag_spec.rb

@@ -0,0 +1,8 @@
+require "spec_helper"
+
+describe ActiveRecord::Rollout::OptOutFlag do
+  it { should be_a ActiveRecord::Rollout::Flag }
+  it { should belong_to :flaggable }
+  it { should validate_presence_of :flaggable_id }
+  it { should allow_mass_assignment_of :flaggable}
+end

data/spec/lib/active_record/rollout/percentage_flag_spec.rb

@@ -0,0 +1,10 @@
+require "spec_helper"
+
+describe ActiveRecord::Rollout::PercentageFlag do
+  subject { ActiveRecord::Rollout::PercentageFlag.new(feature_id: 1, flaggable_type: "User") }
+
+  it { should be_a ActiveRecord::Rollout::Flag }
+  it { should validate_numericality_of(:percentage).is_greater_than(0).is_less_than_or_equal_to(100) }
+  it { should allow_mass_assignment_of :percentage }
+  it { should validate_uniqueness_of :feature_id }
+end

data/spec/lib/tasks/rollout_rake_spec.rb

@@ -0,0 +1,162 @@
+require "spec_helper"
+
+describe "rollout:create" do
+  include_context "rake"
+
+  it "creates the given feature" do
+    ActiveRecord::Rollout::Feature.should_receive(:find_or_create_by_name!).with("foo")
+    subject.invoke("foo")
+  end
+end
+
+describe "rollout:destroy" do
+  include_context "rake"
+
+  let(:feature) { ActiveRecord::Rollout::Feature.create(name: "foo") }
+
+  it "destroys the given feature" do
+    ActiveRecord::Rollout::Feature.should_receive(:find_by_name!).with(feature.name).and_return(feature)
+    feature.should_receive(:destroy)
+    subject.invoke("foo")
+  end
+end
+
+describe "rollout:activate" do
+  include_context "rake"
+
+  let(:user) { User.create(name: "foo") }
+  let!(:feature) { ActiveRecord::Rollout::Feature.create(name: "foo") }
+
+  it "activates the feature for the record" do
+    ActiveRecord::Rollout::Feature.should_receive(:add_record_to_feature).with(user, "foo")
+    subject.invoke("foo", "User", user.id.to_s)
+  end
+
+  it "does not require a class if defined_flaggable_class is set" do
+    ActiveRecord::Rollout::Feature.should_receive(:add_record_to_feature).with(user, "foo")
+    ActiveRecord::Rollout::Feature.instance_variable_set "@default_flaggable_class_name", "User"
+    expect { subject.invoke("foo", user.id.to_s) }.to_not raise_error
+  end
+end
+
+describe "rollout:deactivate" do
+  include_context "rake"
+
+  let(:user) { User.create(name: "foo") }
+  let!(:feature) { ActiveRecord::Rollout::Feature.create(name: "foo") }
+
+  it "deactivates the feature for the record" do
+    ActiveRecord::Rollout::Feature.should_receive(:remove_record_from_feature).with(user, "foo")
+    subject.invoke("foo", "User", user.id.to_s)
+  end
+
+  it "does not require a class if defined_flaggable_class is set" do
+    ActiveRecord::Rollout::Feature.should_receive(:remove_record_from_feature).with(user, "foo")
+    ActiveRecord::Rollout::Feature.instance_variable_set "@default_flaggable_class_name", "User"
+    expect { subject.invoke("foo", user.id.to_s) }.to_not raise_error
+  end
+end
+
+describe "rollout:opt_out" do
+  include_context "rake"
+
+  let(:user) { User.create(name: "foo") }
+  let!(:feature) { ActiveRecord::Rollout::Feature.create(name: "foo") }
+
+  it "deactivates the feature for the record" do
+    ActiveRecord::Rollout::Feature.should_receive(:opt_record_out_of_feature).with(user, "foo")
+    subject.invoke("foo", "User", user.id.to_s)
+  end
+
+  it "does not require a class if defined_flaggable_class is set" do
+    ActiveRecord::Rollout::Feature.should_receive(:opt_record_out_of_feature).with(user, "foo")
+    ActiveRecord::Rollout::Feature.instance_variable_set "@default_flaggable_class_name", "User"
+    expect { subject.invoke("foo", user.id.to_s) }.to_not raise_error
+  end
+end
+
+describe "rollout:un_opt_out" do
+  include_context "rake"
+
+  let(:user) { User.create(name: "foo") }
+  let!(:feature) { ActiveRecord::Rollout::Feature.create(name: "foo") }
+
+  it "deactivates the feature for the record" do
+    ActiveRecord::Rollout::Feature.should_receive(:un_opt_record_out_of_feature).with(user, "foo")
+    subject.invoke("foo", "User", user.id.to_s)
+  end
+
+  it "does not require a class if defined_flaggable_class is set" do
+    ActiveRecord::Rollout::Feature.should_receive(:un_opt_record_out_of_feature).with(user, "foo")
+    ActiveRecord::Rollout::Feature.instance_variable_set "@default_flaggable_class_name", "User"
+    expect { subject.invoke("foo", user.id.to_s) }.to_not raise_error
+  end
+end
+
+describe "rollout:activate_group" do
+  include_context "rake"
+
+  let!(:feature) { ActiveRecord::Rollout::Feature.create(name: "foo") }
+
+  it "activates the feature for the group" do
+    ActiveRecord::Rollout::Feature.should_receive(:add_group_to_feature).with("User", "admins", "foo")
+    subject.invoke("foo", "User", "admins")
+  end
+
+  it "does not require a class if defined_flaggable_class is set" do
+    ActiveRecord::Rollout::Feature.should_receive(:add_group_to_feature).with("User", "admins", "foo")
+    ActiveRecord::Rollout::Feature.instance_variable_set "@default_flaggable_class_name", "User"
+    expect { subject.invoke("foo", "admins") }.to_not raise_error
+  end
+end
+
+describe "rollout:deactivate_group" do
+  include_context "rake"
+
+  let!(:feature) { ActiveRecord::Rollout::Feature.create(name: "foo") }
+
+  it "deactivates the feature for the group" do
+    ActiveRecord::Rollout::Feature.should_receive(:remove_group_from_feature).with("User", "admins", "foo")
+    subject.invoke("foo", "User", "admins")
+  end
+
+  it "does not require a class if defined_flaggable_class is set" do
+    ActiveRecord::Rollout::Feature.should_receive(:remove_group_from_feature).with("User", "admins", "foo")
+    ActiveRecord::Rollout::Feature.instance_variable_set "@default_flaggable_class_name", "User"
+    expect { subject.invoke("foo", "admins") }.to_not raise_error
+  end
+end
+
+describe "rollout:activate_percentage" do
+  include_context "rake"
+
+  let!(:feature) { ActiveRecord::Rollout::Feature.create(name: "foo") }
+
+  it "activates the feature for the percentage" do
+    ActiveRecord::Rollout::Feature.should_receive(:add_percentage_to_feature).with("User", 50, "foo")
+    subject.invoke("foo", "User", "50")
+  end
+
+  it "does not require a class if defined_flaggable_class is set" do
+    ActiveRecord::Rollout::Feature.should_receive(:add_percentage_to_feature).with("User", 50, "foo")
+    ActiveRecord::Rollout::Feature.instance_variable_set "@default_flaggable_class_name", "User"
+    expect { subject.invoke("foo", "50") }.to_not raise_error
+  end
+end
+
+describe "rollout:deactivate_percentage" do
+  include_context "rake"
+
+  let!(:feature) { ActiveRecord::Rollout::Feature.create(name: "foo") }
+
+  it "deactivates the feature for the percentage" do
+    ActiveRecord::Rollout::Feature.should_receive(:remove_percentage_from_feature).with("User", "foo")
+    subject.invoke("foo", "User")
+  end
+
+  it "does not require a class if defined_flaggable_class is set" do
+    ActiveRecord::Rollout::Feature.should_receive(:remove_percentage_from_feature).with("User", "foo")
+    ActiveRecord::Rollout::Feature.instance_variable_set "@default_flaggable_class_name", "User"
+    expect { subject.invoke("foo") }.to_not raise_error
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,40 @@
+require "rails"
+require "active_record"
+require "active_record/rollout"
+require "shoulda-matchers"
+require "generators/templates/migration"
+require "support/shared_contexts/rake"
+require "pry"
+
+class User < ActiveRecord::Base
+  acts_as_flaggable
+end
+
+class Organization < ActiveRecord::Base
+  acts_as_flaggable
+end
+
+RSpec.configure do |config|
+  config.before :suite do
+    ActiveRecord::Base.establish_connection \
+      adapter: "sqlite3",
+      database: File.dirname(__FILE__) + "/spec.sqlite3"
+
+    require File.dirname(__FILE__) + "/support/schema.rb"
+  end
+
+  config.before :each do
+    SetupActiveRecordRollout.migrate :up
+    ActiveRecord::Schema.migrate :up
+  end
+
+  config.after :each do
+    SetupActiveRecordRollout.migrate :down
+    ActiveRecord::Schema.migrate :down
+  end
+
+  config.after :each do
+    ActiveRecord::Rollout::Feature.instance_variable_set "@defined_groups", {}
+    ActiveRecord::Rollout::Feature.instance_variable_set "@default_flaggable_class_name", nil
+  end
+end

data/spec/support/schema.rb

@@ -0,0 +1,13 @@
+ActiveRecord::Schema.define do
+  self.verbose = false
+
+  create_table :users, force: true do |t|
+    t.string :name
+    t.timestamps
+  end
+
+  create_table :organizations, force: true do |t|
+    t.string :name
+    t.timestamps
+  end
+end

data/spec/support/shared_contexts/rake.rb

@@ -0,0 +1,20 @@
+require "rake"
+
+# Hat tip: http://robots.thoughtbot.com/test-rake-tasks-like-a-boss
+shared_context "rake" do
+  let(:rake)      { Rake::Application.new }
+  let(:task_name) { self.class.top_level_description }
+  let(:task_path) { File.join(File.dirname(__FILE__), "../../../lib/tasks/#{task_name.split(":").first}") }
+  subject         { rake[task_name] }
+
+  def loaded_files_excluding_current_rake_file
+    $".reject { |file| file == "#{task_path}.rake" }
+  end
+
+  before do
+    Rake.application = rake
+    Rake.application.rake_require(task_path, [Rails.root.to_s], loaded_files_excluding_current_rake_file)
+
+    Rake::Task.define_task(:environment)
+  end
+end

metadata

@@ -0,0 +1,222 @@
+--- !ruby/object:Gem::Specification
+name: active_record_rollout
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Jonathan Clem
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-12-17 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activerecord
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.2'
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.2'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec-rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: shoulda-matchers
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: sqlite3-ruby
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: pry-debugger
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Rollouts (feature flags) for ActiveRecord models.
+email:
+- jonathan@heroku.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .travis.yml
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- active_record_rollout.gemspec
+- lib/active_record/rollout.rb
+- lib/active_record/rollout/acts_as_flaggable.rb
+- lib/active_record/rollout/feature.rb
+- lib/active_record/rollout/flag.rb
+- lib/active_record/rollout/flaggable.rb
+- lib/active_record/rollout/flaggable_flag.rb
+- lib/active_record/rollout/group_flag.rb
+- lib/active_record/rollout/opt_out_flag.rb
+- lib/active_record/rollout/percentage_flag.rb
+- lib/active_record/rollout/version.rb
+- lib/generators/active_record_rollout_generator.rb
+- lib/generators/templates/active_record_rollout.rb
+- lib/generators/templates/migration.rb
+- lib/tasks/rollout.rake
+- spec/integration/flag_rollout_spec.rb
+- spec/integration/group_rollout_spec.rb
+- spec/integration/percentage_rollout_spec.rb
+- spec/lib/active_record/rollout/acts_as_flaggable_spec.rb
+- spec/lib/active_record/rollout/feature_spec.rb
+- spec/lib/active_record/rollout/flag_spec.rb
+- spec/lib/active_record/rollout/flaggable_flag_spec.rb
+- spec/lib/active_record/rollout/flaggable_spec.rb
+- spec/lib/active_record/rollout/group_flag_spec.rb
+- spec/lib/active_record/rollout/opt_out_flag_spec.rb
+- spec/lib/active_record/rollout/percentage_flag_spec.rb
+- spec/lib/tasks/rollout_rake_spec.rb
+- spec/spec_helper.rb
+- spec/support/schema.rb
+- spec/support/shared_contexts/rake.rb
+homepage: https://github.com/jclem/active_record_rollout
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: 1.9.3
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.14
+signing_key: 
+specification_version: 4
+summary: Rollouts (feature flags) for ActiveRecord models.
+test_files:
+- spec/integration/flag_rollout_spec.rb
+- spec/integration/group_rollout_spec.rb
+- spec/integration/percentage_rollout_spec.rb
+- spec/lib/active_record/rollout/acts_as_flaggable_spec.rb
+- spec/lib/active_record/rollout/feature_spec.rb
+- spec/lib/active_record/rollout/flag_spec.rb
+- spec/lib/active_record/rollout/flaggable_flag_spec.rb
+- spec/lib/active_record/rollout/flaggable_spec.rb
+- spec/lib/active_record/rollout/group_flag_spec.rb
+- spec/lib/active_record/rollout/opt_out_flag_spec.rb
+- spec/lib/active_record/rollout/percentage_flag_spec.rb
+- spec/lib/tasks/rollout_rake_spec.rb
+- spec/spec_helper.rb
+- spec/support/schema.rb
+- spec/support/shared_contexts/rake.rb
+has_rdoc: