if_statement 0.1.0

data/.gitignore

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

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2011 [name of plugin creator]
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,50 @@
+# IfStatement
+
+> a colossally stupid Rails feature flipper plugin
+
+IfStatement executes code based on whether it meets some condition. A condition evaluates to false by default. The evaluation can be done in models, controllers, helpers, or anywhere that includes `IfStatement::Features`.
+
+## Why
+
+Because none of the existing ones worked exactly like I wanted. Also, I hadn't written a Rails plugin before.
+
+## Usage
+
+in a view
+
+``` erb
+<%= feature :nuts do %>
+<ul>
+    <li>Almonds</li>
+    <li>Walnuts</li>
+    <li>Hazelnuts</li>
+</ul>
+<% end %>
+```
+
+everywhere else
+
+``` ruby
+feature :nuke do
+    kill_everyone!
+end
+```
+
+## Setting what these thing evalute to
+
+The best place for now would be `config/initializers/if_statement.rb`:
+
+``` ruby
+IfStatement.setup do
+    set(:nuts) { current_person.has_no :allergies }
+    set :nuke, Rails.env.production?
+end
+```
+
+## Probably better bets
+
+* [Rollout](https://github.com/jamesgolick/rollout)
+* [Dolphin](https://github.com/grillpanda/dolphin)
+* [Feature Flipper](https://github.com/qype/feature_flipper)
+
+Copyright (c) 2011 Andrew Lunny, released under the MIT license

data/Rakefile

@@ -0,0 +1,25 @@
+require 'rubygems'
+require 'rake'
+require 'rake/testtask'
+require 'rdoc/task'
+require 'rspec/core'
+require 'rspec/core/rake_task'
+require 'bundler/gem_helper'
+Bundler::GemHelper.install_tasks
+
+desc 'Default: run unit tests.'
+task :default => :spec
+
+desc 'Run the if_statement specs'
+RSpec::Core::RakeTask.new(:spec) do |t|
+  t.pattern = './spec/**/*_spec.rb'
+end
+
+desc 'Generate documentation for the if_statement plugin.'
+RDoc::Task.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'IfStatement'
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/if_statement.gemspec

@@ -0,0 +1,20 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "if_statement/version"
+
+Gem::Specification.new do |s|
+  s.name        = "if_statement"
+  s.version     = IfStatement::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Andrew Lunny"]
+  s.email       = ["alunny@gmail.com"]
+  s.homepage    = "http://rubygems.org/gems/if_statement"
+  s.summary     = %q{Dumb Rails Feature Flipper}
+  s.description = %q{A feature flipper. Designed to be a Rails plugin}
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.require_paths = ["lib"]
+
+  s.add_development_dependency "rspec", "~> 2.6.0"
+end

data/install.rb

@@ -0,0 +1 @@
+# Install hook code here

data/lib/if_statement/features.rb

@@ -0,0 +1,26 @@
+module IfStatement
+  module Features
+    # executes &block if feature identifier is enabled
+    def feature identifier, &block
+      if feature? identifier
+        if respond_to? :with_output_buffer
+          with_output_buffer &block
+        else
+          yield
+        end
+      end
+      #"OH HAI"
+      #yield if feature? identifier
+    end
+
+    # checks whether identifier is enabled in current env
+    def feature? identifier
+      value = IfStatement.read identifier
+      if value.respond_to? :call
+        !!instance_eval(&value)
+      else
+        value
+      end
+    end
+  end
+end

data/lib/if_statement/import.rb

@@ -0,0 +1,6 @@
+# import the IfStatement methods into the core Rails classes
+ActionController::Base.send :include, IfStatement::Features
+
+ActiveRecord::Base.send :include, IfStatement::Features
+
+ActionView::Base.send :include, IfStatement::Features

data/lib/if_statement/version.rb

@@ -0,0 +1,3 @@
+module IfStatement
+  VERSION = "0.1.0"
+end

data/lib/if_statement.rb

@@ -0,0 +1,42 @@
+require 'if_statement/version'
+require 'if_statement/features'
+
+module IfStatement
+  class << self
+    # set up a bunch of features
+    #
+    # usage
+    #    IfStatement.setup do
+    #       set :messaging, true
+    #       set(:admin) { current_user.admin? }
+    #    end
+    def setup &block
+      def set identifier, value=nil, &block
+        define identifier, value, &block
+      end
+
+      class_eval(&block)
+    end
+
+    # define a specific feature
+    #   give a boolean value, or a block
+    def define identifier, value=nil, &block
+      identifier = identifier.to_sym
+      if block
+        features[identifier] = block
+      else
+        features[identifier] = !!value
+      end
+    end
+
+    # reads the current value of identifier
+    def read identifier
+      value = features[identifier]
+      value.nil? ? false : value
+    end
+
+    def features
+      @features ||= {}
+    end
+  end
+end

data/rails/init.rb

@@ -0,0 +1,2 @@
+require "if_statement"
+require "if_statement/import"

data/spec/if_statement_features_spec.rb

@@ -0,0 +1,81 @@
+require 'spec_helper'
+
+class User
+  include IfStatement::Features
+
+  def admin?
+    true
+  end
+end
+
+def one_hundred!
+  10 * 10
+end
+
+class View
+  include IfStatement::Features
+
+  def with_output_buffer
+  end
+end
+
+IfStatement.define(:dummy, true)
+IfStatement.define(:count) { 7 + 5 }
+IfStatement.define(:admin) { admin? }
+IfStatement.define(:falsy) { true and false }
+
+describe "IfStatement::Features" do
+  before do
+    @user = User.new
+    @view = View.new
+  end
+
+  describe "#feature?" do
+    it "should return the value of a Boolean feature" do
+      @user.feature?(:dummy).should be_true
+    end
+
+    it "should evaluate the result of a block argument as truthy" do
+      @user.feature?(:count).should == true
+    end
+
+    it "should give the block argument access to its methods" do
+      @user.feature?(:admin).should == true
+    end
+  end
+
+  describe "#feature" do
+    describe "when the feature is enabled" do
+      it "should call with_output_buffer if it's available" do
+        @view.should_receive(:with_output_buffer)
+
+        @view.feature(:dummy) { nil }
+      end
+
+      it "should execute the block otherwise" do
+        actual = @user.feature :admin do
+          one_hundred!
+        end
+
+        actual.should == 100
+      end
+    end
+
+    it "should return nil if the feature is disabled" do
+      actual = @user.feature :falsy do
+        one_hundred!
+      end
+
+      actual.should be_nil
+    end
+
+    it "should return nil if the feature is undefined" do
+      actual = @user.feature :not_defined do
+        one_hundred!
+      end
+
+      actual.should be_nil
+    end
+
+  end
+end

data/spec/if_statement_spec.rb

@@ -0,0 +1,61 @@
+require 'spec_helper'
+
+describe "IfStatement" do
+  describe "#setup" do
+    it "should set Boolean arguments" do
+      IfStatement.setup do
+        set :messaging, true
+      end
+
+      IfStatement.features[:messaging].should be_true
+    end
+
+    it "should set block arguments" do
+      block = Proc.new { 1 + 2 }
+      IfStatement.setup do
+        set :addition, &block
+      end
+
+      IfStatement.features[:addition].should == block
+    end
+  end
+
+  describe "#define" do
+    it "should accept a boolean value" do
+      IfStatement.define :sidebar, false
+
+      IfStatement.features[:sidebar].should_not be_nil
+      IfStatement.features[:sidebar].should be_false
+    end
+
+    it "should accept a block" do
+      block = Proc.new { 1 + 2 }
+      IfStatement.define :addition, &block
+
+      IfStatement.features[:addition].should == block
+    end
+
+    it "should force the identifier to a symbol" do
+      IfStatement.define 'odeo', true
+
+      IfStatement.features['odeo'].should be_nil
+      IfStatement.features[:odeo].should be_true
+    end
+  end
+
+  describe "#read" do
+    it "should return false for nil values" do
+      undefined = IfStatement.read(:not_defined)
+
+      undefined.should_not be_nil
+      undefined.should be_false
+    end
+
+    it "should return the block for block values" do
+      block = Proc.new { 3 + 4 }
+      IfStatement.define :seven, &block
+
+      IfStatement.read(:seven).should == block
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1 @@
+require 'if_statement'

data/uninstall.rb

@@ -0,0 +1 @@
+# Uninstall hook code here

metadata

@@ -0,0 +1,99 @@
+--- !ruby/object:Gem::Specification 
+name: if_statement
+version: !ruby/object:Gem::Version 
+  hash: 27
+  prerelease: 
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- Andrew Lunny
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-06-29 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 23
+        segments: 
+        - 2
+        - 6
+        - 0
+        version: 2.6.0
+  type: :development
+  version_requirements: *id001
+description: A feature flipper. Designed to be a Rails plugin
+email: 
+- alunny@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- MIT-LICENSE
+- README.md
+- Rakefile
+- if_statement.gemspec
+- install.rb
+- lib/if_statement.rb
+- lib/if_statement/features.rb
+- lib/if_statement/import.rb
+- lib/if_statement/version.rb
+- rails/init.rb
+- spec/if_statement_features_spec.rb
+- spec/if_statement_spec.rb
+- spec/spec_helper.rb
+- uninstall.rb
+has_rdoc: true
+homepage: http://rubygems.org/gems/if_statement
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.6.2
+signing_key: 
+specification_version: 3
+summary: Dumb Rails Feature Flipper
+test_files: 
+- spec/if_statement_features_spec.rb
+- spec/if_statement_spec.rb
+- spec/spec_helper.rb