enphase-arturo 1.3.2

data/lib/arturo/middleware.rb

@@ -0,0 +1,60 @@
+module Arturo
+  # A Rack middleware that requires a feature to be present. By default,
+  # checks feature availability against an `arturo.recipient` object
+  # in the `env`. If that object is missing, this middleware always fails,
+  # even if the feature is available for everyone.
+  #
+  # ## Usage
+  #
+  #     use Arturo::Middleware, :feature => :foo
+  #
+  # ## Options
+  #
+  #  * feature -- the name of the feature to require, as a Symbol; required
+  #
+  #  * recipient -- the key in the `env` hash under which the feature
+  #                 recipient can be found; defaults to "arturo.recipient".
+  #  * on_unavailable -- a Rack-like object
+  #                      (has `#call(Hash) -> [status, headers, body]`) that
+  #                      is called when the feature is unavailable; defaults
+  #                      to returning `[ 404, {}, ['Not Found'] ]`.
+  class Middleware
+
+    MISSING_FEATURE_ERROR = "Cannot create an Arturo::Middleware without a :feature"
+
+    DEFAULT_RECIPIENT_KEY = 'arturo.recipient'
+
+    DEFAULT_ON_UNAVAILABLE = lambda { |env| [ 404, {}, ['Not Found'] ] }
+
+    def initialize(app, options = {})
+      @app = app
+      @feature = options[:feature]
+      raise ArgumentError.new(MISSING_FEATURE_ERROR) unless @feature
+      @recipient_key = options[:recipient] || DEFAULT_RECIPIENT_KEY
+      @on_unavailable = options[:on_unavailable] || DEFAULT_ON_UNAVAILABLE
+    end
+
+    def call(env)
+      if enabled_for_recipient?(env)
+        @app.call(env)
+      else
+        fail(env)
+      end
+    end
+
+    private
+
+    def enabled_for_recipient?(env)
+      ::Arturo.feature_enabled_for?(@feature, recipient(env))
+    end
+
+    def recipient(env)
+      env[@recipient_key]
+    end
+
+    def fail(env)
+      @on_unavailable.call(env)
+    end
+
+  end
+end

data/lib/arturo/special_handling.rb

@@ -0,0 +1,62 @@
+module Arturo
+
+  # Adds whitelist and blacklist support to individual features by name.
+  # Blacklists override whitelists. (In the world of Apache, Features
+  # are "(deny,allow)".)
+  # @example
+  #   # allow admins:
+  #   Arturo::Feature.whitelist(:some_feature) do |user|
+  #     user.is_admin?
+  #   end
+  #
+  #   # disallow for small accounts:
+  #   Arturo::Feature.blacklist(:another_feature) do |user|
+  #     user.account.small?
+  #   end
+  #
+  # Blacklists and whitelists can be defined before the feature exists
+  # and are not persisted, so they are best defined in initializers.
+  # This is particularly important if your application runs in several
+  # different processes or on several servers.
+  module SpecialHandling
+
+    def self.included(base)
+      base.extend Arturo::SpecialHandling::ClassMethods
+    end
+
+    module ClassMethods
+      def whitelists
+        @whitelists ||= {}
+      end
+
+      def blacklists
+        @blacklists ||= {}
+      end
+
+      def whitelist(feature_symbol, &block)
+        whitelists[feature_symbol.to_sym] = block
+      end
+
+      def blacklist(feature_symbol, &block)
+        blacklists[feature_symbol.to_sym] = block
+      end
+    end
+
+    protected
+
+    def whitelisted?(feature_recipient)
+      x_listed?(self.class.whitelists, feature_recipient)
+    end
+
+    def blacklisted?(feature_recipient)
+      x_listed?(self.class.blacklists, feature_recipient)
+    end
+
+    def x_listed?(list_map, feature_recipient)
+      list = list_map[self.symbol.to_sym]
+      list.present? && list.call(feature_recipient)
+    end
+
+  end
+
+end

data/lib/arturo/test_support.rb

@@ -0,0 +1,30 @@
+Arturo.instance_eval do
+
+  # Enable a feature; create it if necessary.
+  # For use in testing. Not auto-required on load. To load,
+  #
+  #   require 'arturo/test_support'
+  #
+  # @param [Symbol, String] name the feature name
+  def enable_feature!(name)
+    feature = Arturo::Feature.to_feature(name)
+    if feature
+      feature.update_attributes(:deployment_percentage => 100)
+    else
+      Arturo::Feature.create!(:symbol => name, :deployment_percentage => 100)
+    end
+  end
+
+  # Disable a feature if it exists.
+  # For use in testing. Not auto-required on load. To load,
+  #
+  #   require 'arturo/test_support'
+  #
+  # @param [Symbol, String] name the feature name
+  def disable_feature!(name)
+    if (feature = Arturo::Feature.to_feature(name))
+      feature.update_attributes(:deployment_percentage => 0)
+    end
+  end
+
+end

data/lib/generators/arturo/assets_generator.rb

@@ -0,0 +1,18 @@
+require 'rails/generators'
+
+module Arturo
+  class AssetsGenerator < Rails::Generators::Base
+    def self.source_root
+      File.join(File.dirname(__FILE__), 'templates')
+    end
+
+    def copy_assets
+      copy_file 'arturo.css',                 'public/stylesheets/arturo.css', :force => true
+      copy_file 'arturo_customizations.css',  'public/stylesheets/arturo_customizations.css', :skip => true
+      copy_file 'arturo.js',                  'public/javascripts/arturo.js'
+      copy_file 'semicolon.png',              'public/images/semicolon.png'
+    end
+
+  end
+end
+

data/lib/generators/arturo/initializer_generator.rb

@@ -0,0 +1,13 @@
+require 'rails/generators'
+
+module Arturo
+  class InitializerGenerator < Rails::Generators::Base
+    def self.source_root
+      File.join(File.dirname(__FILE__), 'templates')
+    end
+
+    def copy_initializer_file
+      copy_file "initializer.rb", "config/initializers/arturo_initializer.rb"
+    end
+  end
+end

data/lib/generators/arturo/migration_generator.rb

@@ -0,0 +1,27 @@
+require 'rails/generators'
+require 'rails/generators/migration'
+
+module Arturo
+  class MigrationGenerator < Rails::Generators::Base
+    include Rails::Generators::Migration
+
+    def self.source_root
+      File.join(File.dirname(__FILE__), 'templates')
+    end
+
+     # Implement the required interface for Rails::Generators::Migration.
+     # taken from
+     # http://github.com/rails/rails/blob/master/activerecord/lib/generators/active_record.rb
+    def self.next_migration_number(dirname) #:nodoc:
+      if ActiveRecord::Base.timestamped_migrations
+        Time.now.utc.strftime("%Y%m%d%H%M%S")
+      else
+        "%.3d" % (current_migration_number(dirname) + 1)
+      end
+    end
+
+    def create_migration_file
+      migration_template 'migration.rb', 'db/migrate/create_features.rb'
+    end
+  end
+end

data/lib/generators/arturo/routes_generator.rb

@@ -0,0 +1,15 @@
+require 'rails/generators'
+
+module Arturo
+  class RoutesGenerator < Rails::Generators::Base
+
+    def add_mount
+      if Arturo::Engine.respond_to?(:routes)
+        route "mount Arturo::Engine => ''"
+      else
+        puts "This version of Rails doesn't support Engine-specific routing. Nothing to do."
+      end
+    end
+
+  end
+end

data/lib/generators/arturo/templates/arturo.css

@@ -0,0 +1,67 @@
+/*
+  WARNING:
+
+  Do not edit this file. Any changes you make to this file will be overwritten
+  when you regenerate the arturo assets (which happens when you upgrade the gem).
+  Instead, make customizations to arturo_customizations.css.
+ */
+
+.features code.symbol:before { content: ":"; }
+
+.features { border-collapse: collapse; }
+
+.features thead tr:last-child th { border-bottom: 1px solid; }
+.features tfoot tr:first-child th { border-top: 1px solid; }
+
+.features th, .features td {
+  margin: 0;
+  padding: 0.5em 1.5em;
+  text-align: left;
+}
+
+input.deployment_percentage[type=range] { width: 200px; }
+
+output.deployment_percentage.no_js { display: none; }
+output.deployment_percentage { margin-left: 1em; }
+output.deployment_percentage:after { content: "%"; }
+
+.features a[rel=edit] { visibility: hidden; }
+.features tr:hover a[rel=edit] { visibility: inherit; }
+
+.features tfoot th {
+  text-align: right;
+}
+
+.features tfoot th * + * {
+  margin-left: 2em;
+}
+
+.feature_new label, .feature_edit label { font-weight: bold; }
+
+.feature_new  label, .feature_new  .errors,
+.feature_edit label, .feature_edit .errors {
+  display: block;
+}
+
+.feature_new  label + input, .feature_new  label + textarea, .feature_new  label + select, 
+.feature_edit label + input, .feature_edit label + textarea, .feature_edit label + select {
+  margin-top: 0.5em;
+}
+
+.feature_new  input + label, .feature_new  textarea + label, .feature_new  select + label, 
+.feature_edit input + label, .feature_edit textarea + label, .feature_edit select + label {
+  margin-top: 1.5em;
+}
+
+.feature_new input[type=text], .feature_edit input[type=text] { padding: 0.5em; }
+
+.feature_new  input.symbol, .feature_edit input.symbol {
+  background: transparent url('/images/semicolon.png') no-repeat 3px 4px;
+  font-family: "DejaVu Sans Mono", "Droid Sans Mono", "Mondale", monospace;
+  padding-left: 9px;
+}
+
+.feature_new .errors, .feature_edit .errors { color: red; }
+.feature_new :invalid { border-color: red; }
+
+.feature_new footer, .feature_edit footer { margin-top: 2em; }

data/lib/generators/arturo/templates/arturo.js

@@ -0,0 +1,23 @@
+if (typeof(jQuery) === 'function') {
+  jQuery.arturo = {
+    agentSupportsHTML5Output: ('for' in jQuery('<output />')),
+
+    linkAndShowOutputs: function() {
+      if (jQuery.arturo.agentSupportsHTML5Output) {
+        jQuery('.features output,.feature_new output,.feature_edit output').each(function(i, output) {
+          var output = jQuery(output);
+          var input = jQuery('#' + output.attr('for'));
+          input.change(function() {
+            console.log('input value changed to ' + input.val());
+            output.val(input.val());
+          });
+          output.removeClass('no_js');
+        });
+      }
+    }
+  };
+  
+  jQuery(function() {
+    jQuery.arturo.linkAndShowOutputs();
+  });
+}

data/lib/generators/arturo/templates/arturo_customizations.css

@@ -0,0 +1 @@
+/* Make any customizations to the Arturo styles here */

data/lib/generators/arturo/templates/initializer.rb

@@ -0,0 +1,29 @@
+require 'arturo'
+
+# Configure who may manage features here.
+# The following is the default implementation.
+# Arturo::FeatureManagement.class_eval do
+#   def may_manage_features?
+#     current_user.present? && current_user.admin?
+#   end
+# end
+
+# Configure what receives features here.
+# The following is the default implementation.
+# Arturo::FeatureAvailability.class_eval do
+#   def feature_recipient
+#     current_user
+#   end
+# end
+
+# Whitelists and Blacklists:
+#
+# Enable feature one for all admins:
+# Arturo::Feature.whitelist(:feature_one) do |user|
+#   user.admin?
+# end
+#
+# Disable feature two for all small accounts:
+# Arturo::Feature.blacklist(:feature_two) do |user|
+#   user.account.small?
+# end

data/lib/generators/arturo/templates/migration.rb

@@ -0,0 +1,17 @@
+require 'active_support/core_ext'
+
+class CreateFeatures < ActiveRecord::Migration
+  def self.up
+    create_table :features do |t|
+      t.string   :symbol, :null => false
+      t.integer  :deployment_percentage, :null => false
+      #Any additional fields here
+
+      t.timestamps
+    end
+  end
+
+  def self.down
+    drop_table :features
+  end
+end

metadata

@@ -0,0 +1,156 @@
+--- !ruby/object:Gem::Specification
+name: enphase-arturo
+version: !ruby/object:Gem::Version
+  version: 1.3.2
+  prerelease: 
+platform: ruby
+authors:
+- James A. Rosen
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-01-26 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: &2177639760 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *2177639760
+- !ruby/object:Gem::Dependency
+  name: mocha
+  requirement: &2177639360 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *2177639360
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: &2177638900 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *2177638900
+- !ruby/object:Gem::Dependency
+  name: redgreen
+  requirement: &2177638400 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.2'
+  type: :development
+  prerelease: false
+  version_requirements: *2177638400
+- !ruby/object:Gem::Dependency
+  name: sqlite3-ruby
+  requirement: &2177637900 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: *2177637900
+- !ruby/object:Gem::Dependency
+  name: factory_girl
+  requirement: &2177637440 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: *2177637440
+- !ruby/object:Gem::Dependency
+  name: timecop
+  requirement: &2177636980 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.3'
+  type: :development
+  prerelease: false
+  version_requirements: *2177636980
+description: Enphase specific fork. Deploy features incrementally to your users
+email: james.a.rosen@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/arturo/controller_filters.rb
+- lib/arturo/engine.rb
+- lib/arturo/feature_availability.rb
+- lib/arturo/feature_caching.rb
+- lib/arturo/feature_factories.rb
+- lib/arturo/feature_management.rb
+- lib/arturo/middleware.rb
+- lib/arturo/special_handling.rb
+- lib/arturo/test_support.rb
+- lib/arturo.rb
+- lib/generators/arturo/assets_generator.rb
+- lib/generators/arturo/initializer_generator.rb
+- lib/generators/arturo/migration_generator.rb
+- lib/generators/arturo/routes_generator.rb
+- lib/generators/arturo/templates/arturo.css
+- lib/generators/arturo/templates/arturo.js
+- lib/generators/arturo/templates/arturo_customizations.css
+- lib/generators/arturo/templates/initializer.rb
+- lib/generators/arturo/templates/migration.rb
+- lib/generators/arturo/templates/semicolon.png
+- app/controllers/arturo/features_controller.rb
+- app/helpers/arturo/features_helper.rb
+- app/models/arturo/feature.rb
+- app/views/arturo/features/_feature.html.erb
+- app/views/arturo/features/_form.html.erb
+- app/views/arturo/features/edit.html.erb
+- app/views/arturo/features/forbidden.html.erb
+- app/views/arturo/features/index.html.erb
+- app/views/arturo/features/new.html.erb
+- app/views/arturo/features/show.html.erb
+- config/locales/en.yml
+- config/routes.rb
+- README.md
+- HISTORY.md
+homepage: http://github.com/jamesarosen/arturo
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- .
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.11
+signing_key: 
+specification_version: 2
+summary: Enphase specific fork. Feature sliders, wrapped up in an engine
+test_files: []