flipflop 2.0.0

data/test/unit/strategies/default_strategy_test.rb

@@ -0,0 +1,44 @@
+require File.expand_path("../../../test_helper", __FILE__)
+
+describe Flipflop::Strategies::DefaultStrategy do
+  before do
+    Flipflop.configure do
+      feature :one, default: true
+      feature :two
+    end
+  end
+    
+  describe "with defaults" do
+    subject do
+      Flipflop::Strategies::DefaultStrategy.new.freeze
+    end
+
+    it "should have default name" do
+      assert_equal "default", subject.name
+    end
+
+    it "should have no default description" do
+      assert_equal "Uses feature default status.", subject.description
+    end
+
+    it "should not be switchable" do
+      assert_equal false, subject.switchable?
+    end
+
+    it "should have unique key" do
+      assert_match /^\d+$/, subject.key
+    end
+
+    describe "with explicitly defaulted feature" do
+      it "should have feature enabled" do
+        assert_equal true, subject.enabled?(:one)
+      end
+    end
+
+    describe "with implicitly defaulted feature" do
+      it "should not have feature enabled" do
+        assert_equal false, subject.enabled?(:two)
+      end
+    end
+  end
+end

data/test/unit/strategies/lambda_strategy_test.rb

@@ -0,0 +1,137 @@
+require File.expand_path("../../../test_helper", __FILE__)
+
+describe Flipflop::Strategies::LambdaStrategy do
+  subject do
+    Flipflop::Strategies::LambdaStrategy.new.freeze
+  end
+
+  describe "with defaults" do
+    it "should have default name" do
+      assert_equal "lambda", subject.name
+    end
+
+    it "should not have default description" do
+      assert_equal "Resolves feature settings with custom code.",
+        subject.description
+    end
+
+    it "should not be switchable" do
+      assert_equal false, subject.switchable?
+    end
+
+    it "should have unique key" do
+      assert_match /^\d+$/, subject.key
+    end
+  end
+
+  describe "with lambda" do
+    attr_accessor :features
+
+    before do
+      self.features = {}
+    end
+
+    subject do
+      features = self.features
+      Flipflop::Strategies::LambdaStrategy.new(lambda: ->(feature) { features[feature] }).freeze
+    end
+
+    describe "with enabled feature" do
+      before do
+        features[:one] = true
+      end
+
+      it "should have feature enabled" do
+        assert_equal true, subject.enabled?(:one)
+      end
+    end
+
+    describe "with disabled feature" do
+      before do
+        features[:two] = false
+      end
+
+      it "should not have feature enabled" do
+        assert_equal false, subject.enabled?(:two)
+      end
+    end
+
+    describe "with unknown feature" do
+      it "should not know feature" do
+        assert_nil subject.enabled?(:three)
+      end
+    end
+  end
+
+  describe "with request lambda" do
+    subject do
+      Flipflop::Strategies::LambdaStrategy.new(lambda: ->(feature) {
+        request.params[feature]
+      }).freeze
+    end
+
+    before do
+      Flipflop::Strategies::AbstractStrategy::RequestInterceptor.request = create_request
+    end
+
+    after do
+      Flipflop::Strategies::AbstractStrategy::RequestInterceptor.request = nil
+    end
+
+    describe "with enabled feature" do
+      before do
+        subject.send(:request).params[:one] = true
+      end
+
+      it "should have feature enabled" do
+        assert_equal true, subject.enabled?(:one)
+      end
+    end
+  end
+
+  describe "with non conforming parameters" do
+    subject do
+      Flipflop::Strategies::LambdaStrategy.new(lambda: ->() { }).freeze
+    end
+
+    it "should raise error" do
+      assert_raises Flipflop::StrategyError do
+        subject
+      end
+    end
+
+    it "should raise with message" do
+      message = nil
+      begin
+        subject
+      rescue => err
+        message = err.message
+      end
+      assert_equal "Strategy 'lambda' has lambda with arity 0, expected 1 or -1.", message
+    end
+  end
+
+  describe "with non conforming return value" do
+    subject do
+      Flipflop::Strategies::LambdaStrategy.new(lambda: ->(feature) {
+        return feature
+      }).freeze
+    end
+
+    it "should raise error" do
+      assert_raises Flipflop::StrategyError do
+        subject.enabled?(:one)
+      end
+    end
+
+    it "should raise with message" do
+      message = nil
+      begin
+        subject.enabled?(:one)
+      rescue => err
+        message = err.message
+      end
+      assert_equal "Strategy 'lambda' returned invalid result :one for feature 'one'.", message
+    end
+  end
+end

data/test/unit/strategies/query_string_strategy_test.rb

@@ -0,0 +1,70 @@
+require File.expand_path("../../../test_helper", __FILE__)
+
+describe Flipflop::Strategies::QueryStringStrategy do
+  subject do
+    Flipflop::Strategies::QueryStringStrategy.new.freeze
+  end
+
+  describe "in request context" do
+    before do
+      Flipflop::Strategies::AbstractStrategy::RequestInterceptor.request = create_request
+    end
+
+    after do
+      Flipflop::Strategies::AbstractStrategy::RequestInterceptor.request = nil
+    end
+
+    it "should have default name" do
+      assert_equal "query_string", subject.name
+    end
+
+    it "should not have default description" do
+      assert_equal "Interprets query string parameters as features.",
+        subject.description
+    end
+
+    it "should not be switchable" do
+      assert_equal false, subject.switchable?
+    end
+
+    it "should have unique key" do
+      assert_match /^\d+$/, subject.key
+    end
+
+    describe "with enabled feature" do
+      before do
+        subject.send(:request).params[:one] = "1"
+      end
+
+      it "should have feature enabled" do
+        assert_equal true, subject.enabled?(:one)
+      end
+    end
+
+    describe "with disabled feature" do
+      before do
+        subject.send(:request).params[:two] = "0"
+      end
+
+      it "should not have feature enabled" do
+        assert_equal false, subject.enabled?(:two)
+      end
+    end
+
+    describe "with unknown feature" do
+      it "should not know feature" do
+        assert_nil subject.enabled?(:three)
+      end
+    end
+  end
+
+  describe "outside request context" do
+    it "should not know feature" do
+      assert_nil subject.enabled?(:one)
+    end
+
+    it "should not be switchable" do
+      assert_equal false, subject.switchable?
+    end
+  end
+end

data/test/unit/strategies/session_strategy_test.rb

@@ -0,0 +1,101 @@
+require File.expand_path("../../../test_helper", __FILE__)
+
+describe Flipflop::Strategies::SessionStrategy do
+  subject do
+    Flipflop::Strategies::SessionStrategy.new.freeze
+  end
+
+  describe "in request context" do
+    before do
+      Flipflop::Strategies::AbstractStrategy::RequestInterceptor.request = create_request
+    end
+
+    after do
+      Flipflop::Strategies::AbstractStrategy::RequestInterceptor.request = nil
+    end
+
+    it "should have default name" do
+      assert_equal "session", subject.name
+    end
+
+    it "should have default description" do
+      assert_equal "Stores features in the user session. Applies to current user.",
+        subject.description
+    end
+
+    it "should be switchable" do
+      assert_equal true, subject.switchable?
+    end
+
+    it "should have unique key" do
+      assert_match /^\d+$/, subject.key
+    end
+
+    describe "with enabled feature" do
+      before do
+        subject.send(:request).session[:one] = true
+      end
+
+      it "should have feature enabled" do
+        assert_equal true, subject.enabled?(:one)
+      end
+
+      it "should be able to switch feature off" do
+        subject.switch!(:one, false)
+        assert_equal false, subject.enabled?(:one)
+      end
+
+      it "should be able to clear feature" do
+        subject.clear!(:one)
+        assert_nil subject.enabled?(:one)
+      end
+    end
+
+    describe "with disabled feature" do
+      before do
+        subject.send(:request).session[:two] = false
+      end
+
+      it "should not have feature enabled" do
+        assert_equal false, subject.enabled?(:two)
+      end
+
+      it "should be able to switch feature on" do
+        subject.switch!(:two, true)
+        assert_equal true, subject.enabled?(:two)
+      end
+
+      it "should be able to clear feature" do
+        subject.clear!(:two)
+        assert_nil subject.enabled?(:two)
+      end
+    end
+
+    describe "with unsessioned feature" do
+      it "should not know feature" do
+        assert_nil subject.enabled?(:three)
+      end
+
+      it "should be able to switch feature on" do
+        subject.switch!(:three, true)
+        assert_equal true, subject.enabled?(:three)
+      end
+    end
+  end
+
+  describe "outside request context" do
+    it "should not know feature" do
+      assert_nil subject.enabled?(:one)
+    end
+
+    it "should not be switchable" do
+      assert_equal false, subject.switchable?
+    end
+
+    it "should not be able to switch feature on" do
+      assert_raises Flipflop::StrategyError do
+        subject.switch!(:one, true)
+      end
+    end
+  end
+end

data/test/unit/strategies/test_strategy_test.rb

@@ -0,0 +1,76 @@
+require File.expand_path("../../../test_helper", __FILE__)
+
+describe Flipflop::Strategies::TestStrategy do
+  describe "with defaults" do
+    subject do
+      Flipflop::Strategies::TestStrategy.new.freeze
+    end
+
+    it "should have default name" do
+      assert_equal "test", subject.name
+    end
+
+    it "should not have default description" do
+      assert_nil subject.description
+    end
+
+    it "should be switchable" do
+      assert_equal true, subject.switchable?
+    end
+
+    it "should have unique key" do
+      assert_match /^\d+$/, subject.key
+    end
+
+    describe "with enabled feature" do
+      before do
+        subject.switch!(:one, true)
+      end
+
+      it "should have feature enabled" do
+        assert_equal true, subject.enabled?(:one)
+      end
+
+      it "should be able to switch feature off" do
+        subject.switch!(:one, false)
+        assert_equal false, subject.enabled?(:one)
+      end
+
+      it "should be able to clear feature" do
+        subject.clear!(:one)
+        assert_nil subject.enabled?(:one)
+      end
+    end
+
+    describe "with disabled feature" do
+      before do
+        subject.switch!(:two, false)
+      end
+
+      it "should not have feature enabled" do
+        assert_equal false, subject.enabled?(:two)
+      end
+
+      it "should be able to switch feature on" do
+        subject.switch!(:two, true)
+        assert_equal true, subject.enabled?(:two)
+      end
+
+      it "should be able to clear feature" do
+        subject.clear!(:two)
+        assert_nil subject.enabled?(:two)
+      end
+    end
+
+    describe "with unsaved feature" do
+      it "should not know feature" do
+        assert_nil subject.enabled?(:three)
+      end
+
+      it "should be able to switch feature on" do
+        subject.switch!(:three, true)
+        assert_equal true, subject.enabled?(:three)
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,134 @@
+--- !ruby/object:Gem::Specification
+name: flipflop
+version: !ruby/object:Gem::Version
+  version: 2.0.0
+platform: ruby
+authors:
+- Paul Annesley
+- Rolf Timmermans
+- Jippe Holwerda
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-03-17 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '4.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '4.0'
+- !ruby/object:Gem::Dependency
+  name: bootstrap
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 4.0.0.alpha3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 4.0.0.alpha3
+description: Declarative API for specifying features, switchable in declaration, database
+  and cookies.
+email:
+- paul@annesley.cc
+- rolftimmermans@voormedia.com
+- jippeholwerda@voormedia.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .travis.yml
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- app/assets/stylesheets/flipflop.scss
+- app/controllers/concerns/flipflop/environment_filters.rb
+- app/controllers/flipflop/features_controller.rb
+- app/controllers/flipflop/strategies_controller.rb
+- app/models/flipflop/feature.rb
+- app/views/flipflop/features/index.html.erb
+- app/views/layouts/flipflop.html.erb
+- config/routes.rb
+- flipflop.gemspec
+- lib/flipflop.rb
+- lib/flipflop/configurable.rb
+- lib/flipflop/engine.rb
+- lib/flipflop/facade.rb
+- lib/flipflop/feature_cache.rb
+- lib/flipflop/feature_definition.rb
+- lib/flipflop/feature_set.rb
+- lib/flipflop/strategies/abstract_strategy.rb
+- lib/flipflop/strategies/active_record_strategy.rb
+- lib/flipflop/strategies/cookie_strategy.rb
+- lib/flipflop/strategies/default_strategy.rb
+- lib/flipflop/strategies/lambda_strategy.rb
+- lib/flipflop/strategies/query_string_strategy.rb
+- lib/flipflop/strategies/session_strategy.rb
+- lib/flipflop/strategies/test_strategy.rb
+- lib/flipflop/version.rb
+- lib/generators/flipflop/features/USAGE
+- lib/generators/flipflop/features/features_generator.rb
+- lib/generators/flipflop/features/templates/features.rb
+- lib/generators/flipflop/install/install_generator.rb
+- lib/generators/flipflop/migration/USAGE
+- lib/generators/flipflop/migration/migration_generator.rb
+- lib/generators/flipflop/migration/templates/create_features.rb
+- lib/generators/flipflop/routes/USAGE
+- lib/generators/flipflop/routes/routes_generator.rb
+- test/integration/app_test.rb
+- test/integration/dashboard_test.rb
+- test/test_helper.rb
+- test/unit/configurable_test.rb
+- test/unit/feature_cache_test.rb
+- test/unit/feature_definition_test.rb
+- test/unit/feature_set_test.rb
+- test/unit/flipflop_test.rb
+- test/unit/strategies/abstract_strategy_request_test.rb
+- test/unit/strategies/abstract_strategy_test.rb
+- test/unit/strategies/active_record_strategy_test.rb
+- test/unit/strategies/cookie_strategy_test.rb
+- test/unit/strategies/default_strategy_test.rb
+- test/unit/strategies/lambda_strategy_test.rb
+- test/unit/strategies/query_string_strategy_test.rb
+- test/unit/strategies/session_strategy_test.rb
+- test/unit/strategies/test_strategy_test.rb
+homepage: https://github.com/voormedia/flipflop
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.5
+signing_key: 
+specification_version: 4
+summary: A feature flipflopper for Rails web applications.
+test_files: []