flip2 1.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 25447912d81c33420156bf08bbbb30b1e82fb60f
+  data.tar.gz: 329f735ba5dc4f9b79141be8e6f61e3e52320713
+SHA512:
+  metadata.gz: 39ba6d8717253a8b1780c59d0b31bed522ba0ce8408212d80e99c1f33a84f85e0d8ee19dc3cc3da69e69aedca8b8694c45dd113377dd25f028b89016096a7716
+  data.tar.gz: f0267a9848aa22d6e43ecfbd8fadd90c0b8dce38572d1e13e6f20a0f8f94d4e2ec8016c3274f067765e62c9622c2bc8c28b2629e83455dd1cea9f99e823bbb43

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/.rspec

@@ -0,0 +1 @@
+--color

data/.travis.yml

@@ -0,0 +1,5 @@
+language: ruby
+rvm:
+  - 2.3.0
+  - 2.2.4
+  - jruby-9.0.5.0

data/Gemfile

@@ -0,0 +1,2 @@
+source "https://rubygems.org"
+gemspec

data/README.md

@@ -0,0 +1,180 @@
+Flip — flip your features
+================
+
+[![Build Status](https://travis-ci.org/pda/flip.png)](https://travis-ci.org/pda/flip)
+
+**Flip** provides a declarative, layered way of enabling and disabling application functionality at run-time.
+
+This gem optimizes for:
+
+* developer ease-of-use,
+* visibility and control for other stakeholders (like marketing); and
+* run-time performance
+
+There are three layers of strategies per feature:
+
+* default
+* database, to flip features site-wide for all users
+* cookie, to flip features just for you (or someone else)
+
+There is also a configurable system-wide default - !Rails.env.production?` works nicely.
+
+Flip has a dashboard UI that's easy to understand and use.
+
+![Feature Flipper Dashboard](https://cloud.githubusercontent.com/assets/828243/4934741/a5773568-65a4-11e4-98d8-5e9a32720b2e.png)
+
+Install
+-------
+
+**Rails 3.0, 3.1 and 3.2+**
+
+    # Gemfile
+    gem "flip"
+    
+    # Generate the model and migration
+    > rails g flip:install
+    
+    # Run the migration
+    > rake db:migrate
+
+    # Include the Feature model, e.g. config/initializers/feature.rb:
+    require 'feature'
+
+Declaring Features
+------------------
+
+```ruby
+# This is the model class generated by rails g flip:install
+class Feature < ActiveRecord::Base
+  extend Flip::Declarable
+
+  # The recommended Flip strategy stack.
+  strategy Flip::CookieStrategy
+  strategy Flip::DatabaseStrategy
+  strategy Flip::DefaultStrategy
+  default false
+
+  # A basic feature declaration.
+  feature :shiny_things
+
+  # Override the system-wide default.
+  feature :world_domination, default: true
+
+  # Enabled half the time..? Sure, we can do that.
+  feature :flakey,
+    default: proc { rand(2).zero? }
+
+  # Provide a description, normally derived from the feature name.
+  feature :something,
+    default: true,
+    description: "Ability to purchase enrollments in courses"
+
+end
+```
+
+
+Checking Features
+-----------------
+
+`Flip.on?` or the dynamic predicate methods are used to check feature state:
+
+```ruby
+Flip.on? :world_domination   # true
+Flip.world_domination?       # true
+
+Flip.on? :shiny_things       # false
+Flip.shiny_things?           # false
+```
+
+Views and controllers use the `feature?(key)` method:
+
+```erb
+<div>
+  <% if feature? :world_domination %>
+    <%= link_to "Dominate World", world_dominations_path %>
+  <% end %>
+</div>
+```
+
+
+Feature Flipping Controllers
+----------------------------
+
+The `Flip::ControllerFilters` module is mixed into the base `ApplicationController` class.  The following controller will respond with 404 Page Not Found to all but the `index` action unless the `:something` feature is enabled:
+
+```ruby
+class SampleController < ApplicationController
+
+  require_feature :something, :except => :index
+
+  def show
+  end
+
+  def index
+  end
+
+end
+```
+
+Dashboard
+---------
+
+The dashboard provides visibility and control over the features.
+
+The gem includes some basic styles:
+
+```haml
+= content_for :stylesheets_head do
+  = stylesheet_link_tag "flip"
+```
+
+You probably don't want the dashboard to be public.  Here's one way of implementing access control.
+
+app/controllers/admin/features_controller.rb:
+
+```ruby
+class Admin::FeaturesController < Flip::FeaturesController
+  before_action :assert_authenticated_as_admin
+end
+```
+
+app/controllers/admin/strategies_controller.rb:
+
+```ruby
+class Admin::StrategiesController < Flip::StrategiesController
+  before_action :assert_authenticated_as_admin
+end
+```
+
+routes.rb:
+
+```ruby
+namespace :admin do
+  resources :features, only: [ :index ] do
+    resources :strategies, only: [ :update, :destroy ]
+  end
+end
+
+mount Flip::Engine => "/admin/features"
+```
+
+Cacheable
+---------
+
+You can optimize your feature to ensure that it doesn't make a ton of feature
+calls by adding Cacheable to your model.
+```ruby
+extend Flip::Cacheable
+```
+
+This will ensure that your features are eager loaded with one call to the database 
+instead of every call to Flip#on? generating a call to the database.  This is
+helpful if you have a larger Rails application and more than a few features
+defined.
+
+To start or reset the cache, just call #start_feature_cache.
+
+
+----
+Created by Paul Annesley
+Copyright © 2011-2013 Learnable Pty Ltd, [MIT Licence](http://www.opensource.org/licenses/mit-license.php).

data/Rakefile

@@ -0,0 +1,11 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+desc "Run all tests"
+task :default => :spec
+
+desc "Run specs"
+task :spec do
+  command = "bundle exec rspec --color --format documentation spec/*_spec.rb"
+  system(command) || raise("specs returned non-zero code")
+end

data/TODO

@@ -0,0 +1,3 @@
+FlipHelper view/controller helper.
+Optimize DatabaseStrategy.
+CookieStrategy::Loader before/after, not around.

data/app/assets/stylesheets/flip.css

@@ -0,0 +1,70 @@
+/* Flip */
+
+.flip {
+  margin: 0;
+}
+
+.flip h1 {
+  color:#666666;
+  font-size: 229%;
+  line-height: 44.928px;
+  margin: 13.5px 0;
+}
+
+.flip th.name, .flip th.description, .flip th.status {
+  visibility: hidden;
+}
+
+.flip td.name {
+  font-family: Monaco, sans-serif;
+  font-weight: bold;
+}
+
+.flip td.name, .flip td.description {
+  vertical-align: top;
+}
+
+.flip th {
+  font-weight: normal;
+  text-align: left;
+  vertical-align: top;
+}
+
+.flip th .description {
+  font-weight: normal;
+  display: block;
+  font-size: 80%;
+}
+
+.flip th, .flip td {
+  padding: 5px 10px;
+  width: 160px;
+  height: 40px;
+}
+
+.flip td.off, .flip td.on, .flip td.pass {
+  text-align: center;
+  text-transform: capitalize;
+}
+
+.flip td.off {
+  background-color: #fbb;
+}
+
+.flip td.on {
+  background-color: #cfc;
+}
+
+.flip td.pass {
+  background-color: #eef;
+}
+
+.flip form {
+  display: inline;
+}
+
+.flip form input[type=submit] {
+  font-size: 80%;
+  padding: 2px 5px;
+  margin: 0;
+}

data/app/controllers/flip/features_controller.rb

@@ -0,0 +1,47 @@
+module Flip
+  class FeaturesController < ApplicationController
+
+    def index
+      @p = FeaturesPresenter.new(FeatureSet.instance)
+    end
+
+    class FeaturesPresenter
+
+      include Flip::Engine.routes.url_helpers
+
+      def initialize(feature_set)
+        @feature_set = feature_set
+      end
+
+      def strategies
+        @feature_set.strategies
+      end
+
+      def definitions
+        @feature_set.definitions
+      end
+
+      def status(definition)
+        @feature_set.on?(definition.key) ? "on" : "off"
+      end
+
+      def default_status(definition)
+        @feature_set.default_for(definition) ? "on" : "off"
+      end
+
+      def strategy_status(strategy, definition)
+        if strategy.knows? definition
+          strategy.on?(definition) ? "on" : "off"
+        end
+      end
+
+      def switch_url(strategy, definition)
+        feature_strategy_path \
+          definition.key,
+          strategy.name.underscore
+      end
+
+    end
+
+  end
+end

data/app/controllers/flip/strategies_controller.rb

@@ -0,0 +1,31 @@
+module Flip
+  class StrategiesController < ApplicationController
+
+    include Flip::Engine.routes.url_helpers
+
+    def update
+      strategy.switch! feature_key, turn_on?
+      redirect_to features_url
+    end
+
+    def destroy
+      strategy.delete! feature_key
+      redirect_to features_url
+    end
+
+    private
+
+    def turn_on?
+      params[:commit] == "Switch On"
+    end
+
+    def feature_key
+      params[:feature_id].to_sym
+    end
+
+    def strategy
+      FeatureSet.instance.strategy(params[:id])
+    end
+
+  end
+end

data/app/helpers/flip_helper.rb

@@ -0,0 +1,9 @@
+# Access to feature-flipping configuration.
+module FlipHelper
+
+  # Whether the given feature is switched on
+  def feature?(key)
+    Flip.on? key
+  end
+
+end

data/app/views/flip/features/index.html.erb

@@ -0,0 +1,62 @@
+<div class="flip">
+  <h1>Feature Flippers</h1>
+
+  <table>
+    <thead>
+      <th class="name">Feature Name</th>
+      <th class="description">Description</th>
+      <th class="status">Status</th>
+      <% @p.strategies.each do |strategy| %>
+        <th>
+          <%= strategy.name %>
+          <span class="description"><%= strategy.description %></span>
+        </th>
+      <% end %>
+      <th>
+        Default
+        <span class="description">The system default when no strategies match.</span>
+      </th>
+    </thead>
+    <tbody>
+    <% @p.definitions.each do |definition| %>
+      <tr>
+        <td class="name"><%= definition.name %></td>
+
+        <td class="description"><%= definition.description %></td>
+
+        <%= content_tag :td, class: @p.status(definition) do %>
+          <%= @p.status definition %>
+        <% end %>
+
+        <% @p.strategies.each do |strategy| %>
+          <%= content_tag :td, class: @p.strategy_status(strategy, definition) || "pass" do %>
+            <%= @p.strategy_status strategy, definition %>
+
+            <% if strategy.switchable? %>
+              <%= form_tag(@p.switch_url(strategy, definition), method: :put) do %>
+                <% unless @p.strategy_status(strategy, definition) == "on" %>
+                  <%= submit_tag "Switch On" %>
+                <% end %>
+                <% unless @p.strategy_status(strategy, definition) == "off" %>
+                  <%= submit_tag "Switch Off" %>
+                <% end %>
+              <% end %>
+              <% unless @p.strategy_status(strategy, definition).blank? %>
+                <%= form_tag(@p.switch_url(strategy, definition), method: :delete) do %>
+                  <%= submit_tag "Delete" %>
+                <% end %>
+              <% end %>
+            <% end %>
+
+          <% end %>
+        <% end %>
+
+        <%= content_tag :td, class: @p.default_status(definition) do %>
+          <%= @p.default_status definition %>
+        <% end %>
+
+      </tr>
+    <% end %>
+    </tbody>
+  </table>
+</div>