abstract_feature_branch 1.2.2 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 171dc3b05d9257bd90a08f4675cb4be9649e0c1e
-  data.tar.gz: caa97d72c5866c47023ce82bba130b747e526936
+SHA256:
+  metadata.gz: 8f0025726fa5c4de15b39b5b51ba6e180cf156ccccf86d661e3f9e4982d899a4
+  data.tar.gz: 78dae9664bcce67b70f2768ff9e866d9b47155ec1c8ef7c9d0f7d341f4866249
 SHA512:
-  metadata.gz: 92bc2cf8e35055a73a2e44a276b89cd5d3a27b2e499ed176243f836046392bb2f38109aa50b38a75b6c8ab254dc7695796ee0fb5b89d5e8ea652dc29ffc76edb
-  data.tar.gz: b63edde1fb4b6beeece611e173dc002a56ff00a577d10003d769b1f21945a9b9e924663b87dfdefe673b3093c741e4ce6becc65e9f7d5af85b6b32efee1de76f
+  metadata.gz: 96649ca6005883f9765ac18d115e08eb1ac8c9aa165cba039b07aa3d843b29bc8f70cf8ec768bdb6e491e2982eb04f9f0959210418feeccd5da242df6c57bdd9
+  data.tar.gz: 0d305129dc28c997d740e1a6f0dbe2dfefddd1a379dfc64c4fc42287c3fbaf965dde0358287a91346af7aef201a6b1480be5d02f66dcff91464d64cf7f9e850e

data/.travis.yml

@@ -1,40 +1,30 @@
 language: ruby
 services:
   - redis-server
+addons:
+  code_climate:
+    repo_token: 535ff40cf55554362b2f48b85e913a7362f0cf3e51638455dab456006258c5a0
 rvm:
+  - 2.2.1
+  - 2.1.5
   - 2.0.0
   - 1.9.3
   - 1.8.7
   - ree
-  - jruby-18mode
-  - jruby-19mode
-  - rbx-2.1.1
 gemfile:
   - Gemfile
   - ruby187.Gemfile
 matrix:
   exclude:
+    - rvm: 2.2.1
+      gemfile: ruby187.Gemfile
+    - rvm: 2.1.5
+      gemfile: ruby187.Gemfile
     - rvm: 2.0.0
       gemfile: ruby187.Gemfile
     - rvm: 1.9.3
       gemfile: ruby187.Gemfile
     - rvm: 1.8.7
       gemfile: Gemfile
-    - rvm: 1.8.7
-      gemfile: ruby187.Gemfile
-    - rvm: ree
-      gemfile: Gemfile
     - rvm: ree
-      gemfile: ruby187.Gemfile
-    - rvm: jruby-18mode
-      gemfile: Gemfile
-    - rvm: jruby-18mode
-      gemfile: ruby187.Gemfile
-    - rvm: jruby-19mode
-      gemfile: ruby187.Gemfile
-    - rvm: jruby-19mode
-      gemfile: Gemfile
-    - rvm: rbx-2.1.1
       gemfile: Gemfile
-    - rvm: rbx-2.1.1
-      gemfile: ruby187.Gemfile

data/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Change Log
+
+## 1.3.0
+
+- Officially support newer `redis` client gem version 5
+- Support (general-user) Redis Overrides (similar to Environment Variable Overrides)
+- Remove `redis` gem from required dependencies to allow using `abstract_feature_branch` without Redis
+- Make configuration of Redis optional in generated Rails initializer
+- Provide alias of `AbstractFeatureBranch::Configuration#feature_store` to `AbstractFeatureBranch::Configuration#user_features_storage` (plus corresponding aliases `feature_store=` and `initialize_feature_store`)
+- Document support for Rails 7 and Redis Server 7
+- Add gem post install instructions, including how to run the Rails generators and install/use Redis

data/LICENSE.txt

@@ -1,4 +1,4 @@
-Copyright (c) 2012 Annas "Andy" Maleh
+Copyright (c) 2012-2022 Andy Maleh
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/README.md

@@ -1,21 +1,13 @@
-Abstract Feature Branch
-=======================
+# Abstract Feature Branch 1.3.0
 [![Gem Version](https://badge.fury.io/rb/abstract_feature_branch.png)](http://badge.fury.io/rb/abstract_feature_branch)
 [![Build Status](https://api.travis-ci.org/AndyObtiva/abstract_feature_branch.png?branch=master)](https://travis-ci.org/AndyObtiva/abstract_feature_branch)
 [![Coverage Status](https://coveralls.io/repos/AndyObtiva/abstract_feature_branch/badge.png?branch=master)](https://coveralls.io/r/AndyObtiva/abstract_feature_branch?branch=master)
 [![Code Climate](https://codeclimate.com/github/AndyObtiva/abstract_feature_branch.png)](https://codeclimate.com/github/AndyObtiva/abstract_feature_branch)
 
-**As Featured In**
-
-[![Factor 75](https://dzd6ppgm28vds.cloudfront.net/assets/logo-b190de0b423855600e216d490fc160ad.png)](https://www.factor75.com)..[![Character Business Card](https://characterbusinesscard.s3.amazonaws.com/assets/Character-Business-Card-Logo-Desktop-44eb97b18b0a100488ba9c322343b91a.png)](https://www.characterbusinesscard.com)..[![Early Shares](http://early-shares-assets-production.s3.amazonaws.com/assets/logo2x-67fadfc8bb942ba92cca60c464010f1f.png)](https://www.earlyshares.com)
-
-
-
 abstract_feature_branch is a Rails gem that enables developers to easily branch by abstraction as per this pattern:
 http://paulhammant.com/blog/branch_by_abstraction.html
 
-It is a productivity and fault tolerance enhancing team practice that has been utilized by professional software development
-teams at large corporations, such as [Sears](http://www.sears.com) and [Groupon](http://www.groupon.com).
+It is a productivity and fault tolerance enhancing team practice.
 
 It provides the ability to wrap blocks of code with an abstract feature branch name, and then
 specify in a configuration file which features to be switched on or off.
@@ -34,9 +26,10 @@ context-specific feature files if needed.
 
 Requirements
 ------------
-- Ruby ~> 2.0.0, ~> 1.9 or ~> 1.8.7
-- (Optional) Rails ~> 4.0.0, ~> 3.0 or ~> 2.0
-- (Optional) Redis server
+- Ruby (between `~> 3.1.0` and `~> 1.8.7`) ([click for a list of tested Ruby versions](https://travis-ci.org/AndyObtiva/abstract_feature_branch))
+- [Optional] Rails (between `~> 7.0` and `~> 2.0`)
+- [Optional] Redis Server (between `~> 7.0` and `~> 2.0`)
+- [Optional] Redis client gem (between `~> 5.0` and `~> 3.0`)
 
 Setup
 -----
@@ -44,25 +37,27 @@ Setup
 ### Rails Application Use
 
 1. Configure Rubygem
-   - Rails (~> 4.0.0 or ~> 3.0): Add the following to Gemfile <pre>gem 'abstract_feature_branch', '1.2.2'</pre>
-   - Rails (~> 2.0): Add the following to config/environment.rb <pre>config.gem 'abstract_feature_branch', :version => '1.2.2'</pre>
+   - With `rails` between `~> 7.0` and `~> 2.0`: Add the following to Gemfile <pre>gem 'abstract_feature_branch', '~> 1.3.0'</pre>
+   - With `rails` `~> 2.0` only: Add the following to config/environment.rb <pre>config.gem 'abstract_feature_branch', :version => '1.3.0'</pre>
 2. Generate <code>config/initializers/abstract_feature_branch.rb</code>, <code>lib/tasks/abstract_feature_branch.rake</code>, <code>config/features.yml</code> and <code>config/features.local.yml</code> in your Rails app directory by running <pre>rails g abstract_feature_branch:install</pre>
-3. (Optional) Generate <code>config/features/[context_path].yml</code> in your Rails app directory by running <pre>rails g abstract_feature_branch:context context_path</pre> (more details under [**instructions**](#instructions))
-4. (Optional) Customize configuration in <code>config/initializers/abstract_feature_branch.rb</code> (can be useful for changing location of feature files in Rails application, configuring Redis for per-user feature enablement, or troubleshooting a specific Rails environment feature configuration)
+3. [Optional] Generate <code>config/features/[context_path].yml</code> in your Rails app directory by running <pre>rails g abstract_feature_branch:context context_path</pre> (more details under [**instructions**](#instructions))
+4. [Optional] Customize configuration in <code>config/initializers/abstract_feature_branch.rb</code> (can be useful for changing location of feature files in Rails application, configuring Redis for per-user feature enablement, or troubleshooting a specific Rails environment feature configuration)
+5. [Optional] Redis Server (between `~> 7.0` and `~> 3.0`): Install view [Homebrew](https://brew.sh/) with `brew install redis`
+6. [Optional] `redis` client gem (between `~> 5.0` and `~> 3.0`): Add the following to Gemfile above `abstract_feature_branch` <pre>gem 'redis', '~> 5.0.5'</pre>
 
 ### Ruby Application General Use
 
-1. <pre>gem install abstract_feature_branch -v 1.2.2</pre>
+1. <pre>gem install abstract_feature_branch -v 1.3.0</pre>
 2. Add code <code>require 'abstract_feature_branch'</code>
 3. Create <code>config/features.yml</code> under <code>AbstractFeatureBranch.application_root</code> and fill it with content similar to that of the sample <code>config/features.yml</code> mentioned under [**instructions**](#instructions).
-4. (Optional) Create <code>config/features.local.yml</code> under <code>AbstractFeatureBranch.application_root</code>  (more details under [**instructions**](#instructions))
-5. (Optional) Create <code>config/features/[context_path].yml</code> under <code>AbstractFeatureBranch.application_root</code> (more details under [**instructions**](#instructions))
-6. (Optional) Add code <code>AbstractFeatureBranch.application_root = "[your_application_path]"</code> to configure the location of feature files (it defaults to <code>'.'</code>)
-7. (Optional) Add code <code>AbstractFeatureBranch.application_environment = "[your_application_environment]"</code> (it defaults to <code>'development'</code>). Alternatively, you can set <code>ENV['APP_ENV']</code> before the <code>require</code> statement or an an external environment variable.
-8. (Optional) Add code <code>AbstractFeatureBranch.logger = "[your_application_logger]"</code> (it defaults to a new instance of Ruby <code>Logger</code>. Must use a logger with <code>info</code> and <code>warn</code> methods).
-9. (Optional) Add code <code>AbstractFeatureBranch.cacheable = {[environment] => [true/false]}</code> to indicate cacheability of loaded feature files for enhanced performance (it defaults to true for every environment other than development).
-10. (Optional) Add code <code>AbstractFeatureBranch.load_application_features</code> to pre-load application features for improved first-use performance
-11. (Optional) Add code <code>AbstractFeatureBranch.user_features_storage = Redis.new(options)</code> to configure Redis for per-user feature enablement
+4. [Optional] Create <code>config/features.local.yml</code> under <code>AbstractFeatureBranch.application_root</code>  (more details under [**instructions**](#instructions))
+5. [Optional] Create <code>config/features/[context_path].yml</code> under <code>AbstractFeatureBranch.application_root</code> (more details under [**instructions**](#instructions))
+6. [Optional] Add code <code>AbstractFeatureBranch.application_root = "[your_application_path]"</code> to configure the location of feature files (it defaults to <code>'.'</code>)
+7. [Optional] Add code <code>AbstractFeatureBranch.application_environment = "[your_application_environment]"</code> (it defaults to <code>'development'</code>). Alternatively, you can set <code>ENV['APP_ENV']</code> before the <code>require</code> statement or an an external environment variable.
+8. [Optional] Add code <code>AbstractFeatureBranch.logger = "[your_application_logger]"</code> (it defaults to a new instance of Ruby <code>Logger</code>. Must use a logger with <code>info</code> and <code>warn</code> methods).
+9. [Optional] Add code <code>AbstractFeatureBranch.cacheable = {[environment] => [true/false]}</code> to indicate cacheability of loaded feature files for enhanced performance (it defaults to true for every environment other than development).
+10. [Optional] Add code <code>AbstractFeatureBranch.load_application_features</code> to pre-load application features for improved first-use performance
+11. [Optional] Add code <code>AbstractFeatureBranch.feature_store = Redis.new(options)</code> to configure Redis for overrides or per-user feature enablement
 
 Instructions
 ------------
@@ -264,6 +259,45 @@ The benefits can be achieved more easily via <code>config/features.local.yml</co
 However, environment variable overrides are implemented to support overriding feature configuration for a Heroku deployed
 application more easily.
 
+Redis Overrides
+---------------
+
+Prerequisites: Redis server and client (`redis` gem) and optional Redis configuration of `AbstractFeatureBranch.feature_store` in `config/initializers/abstract_feature_branch.rb`
+
+To be able to override feature configuration in a production environment, you can utilize Redis Overrides.
+
+Alternatively, you may use Redis Overrides as your main source of feature configuration if you prefer that instead of relying on YAML files.
+
+You can override feature configuration with Redis hash values by calling `AbstractFeatureBranch#set_store_feature` in `rails console` (or `irb` after requiring `redis` and `abstract_feature_branch`):
+
+```ruby
+AbstractFeatureBranch.set_store_feature('feature1', true)
+```
+
+Behind the scenes, that is the equivalent of the following Redis client invocation, which stores a hash value in a `abstract_feature_branch` key:
+
+```ruby
+AbstractFeatureBranch.configuration.feature_store.hset('abstract_feature_branch', 'feature1', 'true')
+```
+
+To remove a Redis override, you can run the following in `rails console` (or `irb`):
+
+```ruby
+AbstractFeatureBranch.delete_store_feature('feature1')
+```
+
+To get a Redis override value, you can run the following in `rails console` (or `irb`):
+
+```ruby
+AbstractFeatureBranch.get_store_feature('feature1')
+```
+
+To get an array of all Redis Override features, you can run the following in `rails console` (or `irb`):
+
+```ruby
+AbstractFeatureBranch.get_store_features
+```
+
 Heroku
 ------
 
@@ -284,7 +318,7 @@ Removing an environment variable override:
 ### Recommendation
 
 It is recommended that you use environment variable overrides on Heroku only as an emergency or temporary measure.
-Afterward, make the change officially in config/features.yml, deploy, and remove the environment variable override for the long term.
+Afterward, make the change official in config/features.yml, deploy, and remove the environment variable override for the long term.
 
 ### Gotcha with abstract feature branching in CSS and JS files
 
@@ -308,18 +342,18 @@ the former if overlap in features occurs:
 3. Context-specific local feature file overrides: <code>config/features/**/*.local.yml</code>
 4. Main local feature file override: <code>config/features.local.yml</code>
 5. Environment variable overrides
+6. Redis overrides
 
 Rails Initializer
 -----------------
 
-Here is the content of the generated initializer (<code>config/initializers/abstract_feature_branch.rb</code>), which contains instructions on how to customize via [dependency injection](http://en.wikipedia.org/wiki/Dependency_injection):
+Here is the content of the generated initializer [with `redis` client gem added] (<code>config/initializers/abstract_feature_branch.rb</code>), which contains instructions on how to customize via [dependency injection](http://en.wikipedia.org/wiki/Dependency_injection):
 
->     require 'redis'
+>     # Storage system for features (other than YAML/Env-Vars). Right now, only Redis is supported.
+>     # AbstractFeatureBranch.feature_store = Redis.new
 >
->     # Storage for user features, customizable over here. Right now, only a Redis client is supported.
 >     # The following example line works with Heroku Redis To Go while still operating on local Redis for local development
->     # AbstractFeatureBranch.user_features_storage = Redis.new(:url => ENV['REDISTOGO_URL'])
->     AbstractFeatureBranch.user_features_storage = Redis.new
+>     # AbstractFeatureBranch.feature_store = Redis.new(:url => ENV['REDISTOGO_URL'])
 >
 >     # Application root where config/features.yml or config/features/ is found
 >     AbstractFeatureBranch.application_root = Rails.root
@@ -342,8 +376,6 @@ Here is the content of the generated initializer (<code>config/initializers/abst
 >     # Pre-load application features to improve performance of first web-page hit
 >     AbstractFeatureBranch.load_application_features unless Rails.env.development?
 
-TODO Document in Heroku (:url => ENV['REDISTOGO_URL'])
-
 Rake Task
 ---------
 
@@ -437,15 +469,14 @@ after invoking the rake task, **verify** that your feature file contents are to
 task changes.
 
 Feature Branches vs Branch by Abstraction
----------
+-----------------------------------------
 
-Although feature branches and branching by abstraction are similar, there are different situations that recommend each approach.  
+Although feature branches and branching by abstraction are similar, there are different situations that recommend each approach.
 
-Feature branching leverages your version control software (VCS) to create a branch that is independent of your main branch.  Once you write your feature, you integrate it with the rest of your code base. Featuring branching is ideal for developing features that can be completed within the one or two iterations.  But it can become cumbersome with larger features due to the fact your code is isolated and quickly falls out of sync with your main branch.  You will have to regularly rebase with your main branch or devote substantial time to resolving merge conflicts.   
+Feature branching leverages your version control software (VCS) to create a branch that is independent of your main branch.  Once you write your feature, you integrate it with the rest of your code base. Feature branching is ideal for developing features that can be completed within the one or two iterations.  But it can become cumbersome with larger features due to the fact your code is isolated and quickly falls out of sync with your main branch.  You will have to regularly rebase with your main branch or devote substantial time to resolving merge conflicts.
 
 Branching by abstraction, on the other hand, is ideal for substantial features, i.e. ones which take many iterations to complete.  This approach to branching takes place outside of your VCS.  Instead, you build your feature, but wrap the code inside configurable flags.  These configuration flags will allow for different behavior, depending on the runtime environment.  For example, a feature would be set to "on" when your app runs in development mode, but "off" when running in "production" mode.  This approach avoids the pain of constantly rebasing or resolving a myriad of merge conflict when you do attempt to integrate your feature into the larger app.
 
-
 Contributing to abstract_feature_branch
 ---------------------------------------
 
@@ -459,17 +490,14 @@ Contributing to abstract_feature_branch
 
 Committers
 ---------------------------------------
-* [Annas "Andy" Maleh (Author)](https://github.com/AndyObtiva)
+* [Andy Maleh (Author)](https://github.com/AndyObtiva)
 
 Contributors
 ---------------------------------------
-* [Christian Nennemann](https://github.com/XORwell)
-* [Ben Downey](https://github.com/bnd5k)
 * [Mark Moschel](https://github.com/mmosche2)
 
 Copyright
 ---------------------------------------
 
-Copyright (c) 2013 Annas "Andy" Maleh. See LICENSE.txt for
+Copyright (c) 2012-2022 Andy Maleh. See [LICENSE.txt](LICENSE.txt) for
 further details.
-

data/TODO.md

@@ -0,0 +1,3 @@
+# TODO
+
+- Support `connection_pool` gem to enable working with a Redis `ConnectionPool`

data/VERSION

@@ -1 +1 @@
-1.2.2
+1.3.0

data/abstract_feature_branch.gemspec

@@ -2,25 +2,30 @@
 # DO NOT EDIT THIS FILE DIRECTLY
 # Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
 # -*- encoding: utf-8 -*-
+# stub: abstract_feature_branch 1.3.0 ruby lib
 
 Gem::Specification.new do |s|
-  s.name = "abstract_feature_branch"
-  s.version = "1.2.2"
+  s.name = "abstract_feature_branch".freeze
+  s.version = "1.3.0"
 
-  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
-  s.authors = ["Annas \"Andy\" Maleh"]
-  s.date = "2014-02-23"
-  s.description = "abstract_feature_branch is a Rails gem that enables developers to easily branch by abstraction as per this pattern:\nhttp://paulhammant.com/blog/branch_by_abstraction.html\n\nIt is a productivity and fault tolerance enhancing team practice that has been utilized by professional software development\nteams at large corporations, such as Sears and Groupon.\n\nIt provides the ability to wrap blocks of code with an abstract feature branch name, and then\nspecify in a configuration file which features to be switched on or off.\n\nThe goal is to build out upcoming features in the same source code repository branch, regardless of whether all are\ncompleted by the next release date or not, thus increasing team productivity by preventing integration delays.\nDevelopers then disable in-progress features until they are ready to be switched on in production, yet enable them\nlocally and in staging environments for in-progress testing.\n\nThis gives developers the added benefit of being able to switch a feature off after release should big problems arise\nfor a high risk feature.\n\nabstract_feature_branch additionally supports DDD's pattern of\nBounded Contexts by allowing developers to configure\ncontext-specific feature files if needed.\n"
+  s.required_rubygems_version = Gem::Requirement.new(">= 0".freeze) if s.respond_to? :required_rubygems_version=
+  s.require_paths = ["lib".freeze]
+  s.authors = ["Annas \"Andy\" Maleh".freeze]
+  s.date = "2022-12-11"
+  s.description = "abstract_feature_branch is a Rails gem that enables developers to easily branch by abstraction as per this pattern:\nhttp://paulhammant.com/blog/branch_by_abstraction.html\n\nIt is a productivity and fault tolerance enhancing team practice.\n\nIt provides the ability to wrap blocks of code with an abstract feature branch name, and then\nspecify in a configuration file which features to be switched on or off.\n\nThe goal is to build out upcoming features in the same source code repository branch, regardless of whether all are\ncompleted by the next release date or not, thus increasing team productivity by preventing integration delays.\nDevelopers then disable in-progress features until they are ready to be switched on in production, yet enable them\nlocally and in staging environments for in-progress testing.\n\nThis gives developers the added benefit of being able to switch a feature off after release should big problems arise\nfor a high risk feature.\n\nabstract_feature_branch additionally supports DDD's pattern of\nBounded Contexts by allowing developers to configure\ncontext-specific feature files if needed.\n".freeze
   s.extra_rdoc_files = [
+    "CHANGELOG.md",
     "LICENSE.txt",
     "README.md"
   ]
   s.files = [
     ".coveralls.yml",
     ".travis.yml",
+    "CHANGELOG.md",
     "LICENSE.txt",
     "README.md",
     "RELEASE_NOTES.md",
+    "TODO.md",
     "VERSION",
     "abstract_feature_branch.gemspec",
     "config/features/admin.local.yml",
@@ -29,6 +34,9 @@ Gem::Specification.new do |s|
     "config/features/internal/wiki.yml",
     "config/features/public.local.yml",
     "config/features/public.yml",
+    "img/BigAstronaut-Logo.png",
+    "img/EarlyShares-Logo.svg",
+    "img/Factor75-Logo.svg",
     "lib/abstract_feature_branch.rb",
     "lib/abstract_feature_branch/configuration.rb",
     "lib/abstract_feature_branch/file_beautifier.rb",
@@ -41,7 +49,6 @@ Gem::Specification.new do |s|
     "lib/generators/templates/config/initializers/abstract_feature_branch.rb",
     "lib/generators/templates/lib/tasks/abstract_feature_branch.rake",
     "ruby187.Gemfile",
-    "ruby187.Gemfile.lock",
     "spec/abstract_feature_branch/file_beautifier_spec.rb",
     "spec/ext/feature_branch__feature_branch_per_user_spec.rb",
     "spec/ext/feature_branch__feature_branch_spec.rb",
@@ -64,28 +71,30 @@ Gem::Specification.new do |s|
     "spec/fixtures/application_ugly_config_reference/config/features/public.local.yml",
     "spec/fixtures/application_ugly_config_reference/config/features/public.yml"
   ]
-  s.homepage = "http://github.com/AndyObtiva/abstract_feature_branch"
-  s.licenses = ["MIT"]
-  s.require_paths = ["lib"]
-  s.rubygems_version = "2.0.6"
-  s.summary = "abstract_feature_branch is a Rails gem that enables developers to easily branch by abstraction as per this pattern: http://paulhammant.com/blog/branch_by_abstraction.html"
+  s.homepage = "http://github.com/AndyObtiva/abstract_feature_branch".freeze
+  s.licenses = ["MIT".freeze]
+  s.post_install_message = "\nRails-only post-install instructions:\n\n1) Run the following command to generate the Rails initializer and basic feature files:\n\nrails g abstract_feature_branch:install\n\n2) Optionally, you may run this command to generate feature files per context:\n\nrails g abstract_feature_branch:context context_path\n   \n3) Optionally, install Redis server with [Homebrew](https://brew.sh/) by running:\n\nbrew install redis\n\n4) Optionally, install redis client gem (required with Redis server) by adding the following line to Gemfile above abstract_feature_branch:\n\ngem 'redis', '~> 5.0.5'\n\nAfterwards, run:\n\nbundle\n\n5) Optionally, customize configuration in config/initializers/abstract_feature_branch.rb\n\n(can be useful for changing location of feature files in Rails application,\nconfiguring Redis to use for overrides and per-user feature enablement,\nand/or troubleshooting specific Rails environment feature configurations)\n\n".freeze
+  s.rubygems_version = "3.3.6".freeze
+  s.summary = "abstract_feature_branch is a Rails gem that enables developers to easily branch by abstraction as per this pattern: http://paulhammant.com/blog/branch_by_abstraction.html".freeze
 
   if s.respond_to? :specification_version then
     s.specification_version = 4
+  end
 
-    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
-      s.add_runtime_dependency(%q<deep_merge>, ["= 1.0.0"])
-      s.add_runtime_dependency(%q<redis>, ["~> 3.0.0"])
-      s.add_development_dependency(%q<jeweler>, ["= 1.8.8"])
-    else
-      s.add_dependency(%q<deep_merge>, ["= 1.0.0"])
-      s.add_dependency(%q<redis>, ["~> 3.0.0"])
-      s.add_dependency(%q<jeweler>, ["= 1.8.8"])
-    end
+  if s.respond_to? :add_runtime_dependency then
+    s.add_runtime_dependency(%q<deep_merge>.freeze, ["~> 1.0.0"])
+    s.add_development_dependency(%q<jeweler>.freeze, ["~> 2.3.9"])
+    s.add_development_dependency(%q<bundler>.freeze, [">= 2.1.4"])
+    s.add_development_dependency(%q<rspec>.freeze, ["= 2.14.1"])
+    s.add_development_dependency(%q<rdoc>.freeze, ["= 5.1.0"])
+    s.add_development_dependency(%q<psych>.freeze, ["= 3.3.4"])
   else
-    s.add_dependency(%q<deep_merge>, ["= 1.0.0"])
-    s.add_dependency(%q<redis>, ["~> 3.0.0"])
-    s.add_dependency(%q<jeweler>, ["= 1.8.8"])
+    s.add_dependency(%q<deep_merge>.freeze, ["~> 1.0.0"])
+    s.add_dependency(%q<jeweler>.freeze, ["~> 2.3.9"])
+    s.add_dependency(%q<bundler>.freeze, [">= 2.1.4"])
+    s.add_dependency(%q<rspec>.freeze, ["= 2.14.1"])
+    s.add_dependency(%q<rdoc>.freeze, ["= 5.1.0"])
+    s.add_dependency(%q<psych>.freeze, ["= 3.3.4"])
   end
 end
 

data/img/EarlyShares-Logo.svg

@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<svg width="181px" height="26px" viewBox="0 0 181 26" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:sketch="http://www.bohemiancoding.com/sketch/ns">
+    <!-- Generator: Sketch 3.1 (8751) - http://www.bohemiancoding.com/sketch -->
+    <title>es_logo</title>
+    <desc>Created with Sketch.</desc>
+    <defs></defs>
+    <g id="Page-1" stroke="none" stroke-width="1" fill="none" fill-rule="evenodd" sketch:type="MSPage">
+        <g id="es_logo" sketch:type="MSLayerGroup" transform="translate(1.000000, 0.000000)">
+            <path d="M-0.0666666667,0.342105263 L15.2666667,0.342105263 L15.2666667,2.12105263 L1.8,2.12105263 L1.8,9.1 L13.7333333,9.1 L13.7333333,10.8789474 L1.8,10.8789474 L1.8,18.6789474 L15.4,18.6789474 L15.4,20.4578947 L-0.0666666667,20.4578947" id="Shape" fill="#3c3f40" sketch:type="MSShapeGroup"></path>
+            <path d="M31.4666667,20.4578947 L31.4666667,18.3368421 C30.1333333,19.9105263 28.2,20.7315789 25.8,20.7315789 C23.5333333,20.7315789 21.6666667,19.9789474 20.3333333,18.5421053 C19.0666667,17.1736842 18.4666667,15.3947368 18.4666667,13.2052632 C18.4666667,11.0157895 19.0666667,9.16842105 20.3333333,7.8 C21.6666667,6.29473684 23.5333333,5.54210526 25.8666667,5.54210526 C28.2666667,5.54210526 30.0666667,6.29473684 31.4,7.86842105 L31.4,5.61052632 L33.3333333,5.61052632 L33.3333333,20.3894737 L31.4666667,20.3894737 L31.4666667,20.4578947 Z M30,8.96315789 C29,7.93684211 27.6,7.38947368 25.7333333,7.38947368 C24,7.38947368 22.6666667,7.93684211 21.6666667,9.1 C20.7333333,10.1947368 20.3333333,11.5631579 20.3333333,13.2052632 C20.3333333,14.9157895 20.8,16.2842105 21.6666667,17.3105263 C22.6,18.4052632 24,18.9526316 25.7333333,18.9526316 C27.4666667,18.9526316 28.8,18.4052632 29.8666667,17.3105263 C30.9333333,16.2157895 31.4,14.8473684 31.4,13.2052632 C31.4666667,11.4263158 31,9.98947368 30,8.96315789 L30,8.96315789 Z" id="Shape" fill="#3C3F40" sketch:type="MSShapeGroup"></path>
+            <path d="M42,9.64736842 C41.2,10.9473684 40.8,12.5894737 40.8,14.5736842 L40.8,20.4578947 L38.8666667,20.4578947 L38.8666667,5.95263158 L40.8,5.95263158 L40.8,7.93684211 C42.1333333,6.36315789 44.2,5.61052632 46.9333333,5.61052632 L46.9333333,7.38947368 C44.6,7.38947368 43,8.14210526 42,9.64736842" id="Shape" fill="#3C3F40" sketch:type="MSShapeGroup"></path>
+            <rect id="Rectangle-path" fill="#3C3F40" sketch:type="MSShapeGroup" x="51.3333333" y="0.684210526" width="1.93333333" height="20.1157895"></rect>
+            <path d="M64.4,25.7947368 C62.6666667,25.7947368 61.2,25.4526316 60.0666667,24.7684211 C58.6666667,23.8789474 57.9333333,22.3736842 57.8,20.2526316 L59.7333333,20.2526316 C59.8666667,21.5526316 60.2666667,22.5105263 61,23.1263158 C61.7333333,23.7421053 62.9333333,24.0157895 64.4666667,24.0157895 C67.9333333,24.0157895 69.6666667,22.5789474 69.6666667,19.7052632 L69.6666667,19.1578947 C68.4666667,20.4578947 66.8,21.0736842 64.6666667,21.0736842 C62.8,21.0736842 61.3333333,20.5947368 60.2,19.7052632 C59.0666667,18.6789474 58.4666667,17.3105263 58.4666667,15.5315789 L58.4666667,5.95263158 L60.4,5.95263158 L60.4,15.4631579 C60.4,17.9947368 61.8,19.2947368 64.6666667,19.2947368 C66.3333333,19.2947368 67.6,18.8157895 68.4,17.7894737 C69.2,16.9 69.6,15.6 69.6,13.9578947 L69.6,5.95263158 L71.5333333,5.95263158 L71.5333333,19.7052632 C71.5333333,23.7421053 69.1333333,25.7947368 64.4,25.7947368" id="Shape" fill="#3C3F40" sketch:type="MSShapeGroup"></path>
+            <path d="M85.6666667,20.6631579 C83.0666667,20.6631579 81.0666667,20.1842105 79.4666667,19.2947368 C77.4666667,18.1315789 76.5333333,16.3526316 76.5333333,13.8894737 L76.5333333,13 L78.4666667,13 L78.4666667,13.8210526 C78.4666667,17.2421053 80.8666667,18.9526316 85.7333333,18.9526316 C87.4,18.9526316 88.8,18.6789474 89.9333333,18.2 C91.3333333,17.5157895 92.0666667,16.5578947 92.0666667,15.2578947 C92.0666667,14.3684211 91.8,13.6842105 91.3333333,13.2052632 C90.9333333,12.7947368 90.2,12.4526316 89.1333333,12.1105263 C88.5333333,11.9052632 87.2,11.6315789 85,11.1526316 C82.5333333,10.6052632 80.8,10.1263158 79.9333333,9.64736842 C78.1333333,8.68947368 77.2,7.32105263 77.2,5.47368421 C77.2,1.98421053 79.8666667,0.205263158 85.1333333,0.205263158 C90.6666667,0.205263158 93.4666667,2.46315789 93.5333333,6.97894737 L91.6666667,6.97894737 C91.5333333,4.92631579 90.8666667,3.55789474 89.6666667,2.87368421 C88.6666667,2.32631579 87.1333333,2.05263158 85.1333333,2.05263158 C81.1333333,2.05263158 79.0666667,3.21578947 79.0666667,5.47368421 C79.0666667,6.56842105 79.6,7.45789474 80.6666667,8.00526316 C81.4,8.41578947 82.7333333,8.75789474 84.6,9.1 C88.1333333,9.78421053 90.5333333,10.4684211 91.7333333,11.1526316 C93.2,12.0421053 93.9333333,13.4105263 93.9333333,15.3263158 C93.9333333,17.2421053 92.9333333,18.6789474 91,19.6368421 C89.5333333,20.3210526 87.7333333,20.6631579 85.6666667,20.6631579" id="Shape" fill="#6BA651" sketch:type="MSShapeGroup"></path>
+            <path d="M110.266667,20.4578947 L110.266667,10.8105263 C110.266667,9.57894737 109.866667,8.62105263 109.133333,8.00526316 C108.4,7.38947368 107.333333,7.04736842 106,7.04736842 C104.466667,7.04736842 103.2,7.52631579 102.333333,8.41578947 C101.466667,9.37368421 101,10.6052632 101,12.1105263 L101,20.3894737 L99.0666667,20.3894737 L99.0666667,0.273684211 L101,0.273684211 L101,7.11578947 C102.2,5.88421053 103.866667,5.2 106,5.2 C107.733333,5.2 109.2,5.61052632 110.333333,6.5 C111.6,7.45789474 112.2,8.75789474 112.2,10.5368421 L112.2,20.3894737 L110.266667,20.3894737 L110.266667,20.4578947 Z" id="Shape" fill="#6BA651" sketch:type="MSShapeGroup"></path>
+            <path d="M140.333333,9.64736842 C139.533333,10.9473684 139.133333,12.5894737 139.133333,14.5736842 L139.133333,20.4578947 L137.2,20.4578947 L137.2,5.95263158 L139.133333,5.95263158 L139.133333,7.93684211 C140.466667,6.36315789 142.533333,5.61052632 145.266667,5.61052632 L145.266667,7.38947368 C142.933333,7.38947368 141.333333,8.14210526 140.333333,9.64736842" id="Shape" fill="#6BA651" sketch:type="MSShapeGroup"></path>
+            <path d="M150,13.9578947 C150.266667,17.3105263 152.133333,19.0210526 155.6,19.0210526 C158.266667,19.0210526 160.066667,17.8578947 160.933333,15.6 L162.933333,15.6 C162.266667,17.6526316 161.266667,19.0210526 159.866667,19.7736842 C158.6,20.4578947 157.2,20.8 155.533333,20.8 C153.066667,20.8 151.2,20.1157895 149.933333,18.6789474 C148.733333,17.3789474 148.133333,15.5315789 148.133333,13.2736842 C148.133333,11.0842105 148.8,9.23684211 150.133333,7.8 C151.466667,6.36315789 153.333333,5.61052632 155.666667,5.61052632 C157.933333,5.61052632 159.8,6.22631579 161.133333,7.52631579 C162.533333,8.82631579 163.2,10.5368421 163.2,12.7263158 L163.2,13.9578947 L150,13.9578947 L150,13.9578947 Z M159.733333,8.89473684 C158.733333,7.93684211 157.4,7.38947368 155.733333,7.38947368 C154.2,7.38947368 152.933333,7.8 151.933333,8.62105263 C150.933333,9.44210526 150.333333,10.6052632 150.133333,12.1789474 L161.2,12.1789474 C161,10.8105263 160.533333,9.71578947 159.733333,8.89473684 L159.733333,8.89473684 Z" id="Shape" fill="#6BA651" sketch:type="MSShapeGroup"></path>
+            <path d="M177.666667,20.0473684 C176.666667,20.5947368 175.333333,20.8684211 173.733333,20.8684211 C169.266667,20.8684211 167.066667,18.8157895 167.066667,14.6421053 L169.066667,14.6421053 C169.066667,16.2157895 169.466667,17.3105263 170.2,17.9947368 C170.933333,18.6789474 172.133333,19.0210526 173.8,19.0210526 C174.933333,19.0210526 175.866667,18.8157895 176.6,18.4736842 C177.466667,18.0631579 177.866667,17.3789474 177.866667,16.5578947 C177.866667,15.5315789 176.933333,14.7789474 175.133333,14.3684211 C175,14.3684211 174,14.2315789 172.266667,13.8894737 C169.266667,13.4105263 167.733333,12.1105263 167.733333,9.92105263 C167.733333,8.48421053 168.333333,7.38947368 169.533333,6.56842105 C170.6,5.88421053 171.8,5.54210526 173.266667,5.54210526 C177.533333,5.54210526 179.666667,7.38947368 179.733333,11.0842105 L177.733333,11.0842105 C177.733333,9.78421053 177.4,8.82631579 176.733333,8.21052632 C176.066667,7.66315789 174.933333,7.32105263 173.466667,7.32105263 C172.466667,7.32105263 171.6,7.52631579 170.866667,7.93684211 C170.066667,8.41578947 169.733333,9.03157895 169.733333,9.85263158 C169.733333,10.8789474 170.6,11.5631579 172.333333,11.8368421 C172.866667,11.9052632 173.866667,12.1105263 175.4,12.3842105 C178.333333,12.9315789 179.8,14.2315789 179.8,16.4210526 C179.733333,18.0631579 179.066667,19.2263158 177.666667,20.0473684" id="Shape" fill="#6BA651" sketch:type="MSShapeGroup"></path>
+            <path d="M128.8,20.3894737 L128.8,18.2684211 C127.466667,19.8421053 125.533333,20.6631579 123.133333,20.6631579 C120.866667,20.6631579 119,19.9105263 117.666667,18.4736842 C116.4,17.1052632 115.8,15.3263158 115.8,13.1368421 C115.8,10.9473684 116.4,9.1 117.666667,7.73157895 C119,6.22631579 120.866667,5.47368421 123.2,5.47368421 C125.6,5.47368421 127.4,6.22631579 128.733333,7.8 L128.733333,5.54210526 L130.666667,5.54210526 L130.666667,20.3210526 L128.8,20.3210526 L128.8,20.3894737 Z M127.333333,8.89473684 C126.333333,7.86842105 124.933333,7.32105263 123.066667,7.32105263 C121.333333,7.32105263 120,7.86842105 119,9.03157895 C118.066667,10.1263158 117.666667,11.4947368 117.666667,13.1368421 C117.666667,14.8473684 118.133333,16.2157895 119,17.2421053 C119.933333,18.3368421 121.333333,18.8842105 123.066667,18.8842105 C124.8,18.8842105 126.133333,18.3368421 127.2,17.2421053 C128.266667,16.1473684 128.733333,14.7789474 128.733333,13.1368421 C128.8,11.3578947 128.333333,9.92105263 127.333333,8.89473684 L127.333333,8.89473684 Z" id="Shape" fill="#6BA651" sketch:type="MSShapeGroup"></path>
+        </g>
+    </g>
+</svg>

data/img/Factor75-Logo.svg

@@ -0,0 +1,54 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Generator: Adobe Illustrator 16.0.0, SVG Export Plug-In . SVG Version: 6.00 Build 0)  -->
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" id="Layer_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+	  width="627.062px" height="612px" viewBox="0 0 627.062 612" enable-background="new 0 0 627.062 612" xml:space="preserve">
+<g>
+	<path d="M563.713,302.966c0,139.834-113.353,253.183-253.19,253.183c-139.837,0-253.19-113.349-253.19-253.183
+		c0-139.834,113.354-253.201,253.19-253.201C450.36,49.765,563.713,163.132,563.713,302.966"/>
+	<path fill="#FFFFFF" d="M310.522,69.572c-128.674,0-233.384,104.703-233.384,233.38c0,128.688,104.71,233.376,233.384,233.376
+		c128.691,0,233.376-104.688,233.376-233.376C543.898,174.275,439.214,69.572,310.522,69.572 M310.522,590.299
+		c-158.457,0-287.336-128.903-287.336-287.347c0-158.436,128.879-287.333,287.336-287.333s287.336,128.897,287.336,287.333
+		C597.858,461.396,468.979,590.299,310.522,590.299"/>
+	<path fill="#C1D82F" d="M310.522,14.185c-159.217,0-288.771,129.543-288.771,288.768c0,159.231,129.554,288.778,288.771,288.778
+		c159.228,0,288.789-129.547,288.789-288.778C599.312,143.728,469.75,14.185,310.522,14.185z M542.457,302.952
+		c0,127.893-104.042,231.944-231.935,231.944c-127.886,0-231.938-104.052-231.938-231.944
+		c0-127.889,104.052-231.934,231.938-231.934C438.415,71.018,542.457,175.063,542.457,302.952z M310.522,17.062v51.082
+		c-129.476,0-234.818,105.332-234.818,234.808H24.622C24.622,145.308,152.893,17.062,310.522,17.062z"/>
+	<path fill="#C1D82F" d="M187.809,232.519c-4.814,0-8.731,3.662-8.731,8.194l-0.06,36.076h24.112l0.039-12.285
+		c0-5.239,3.503-8.251,7.798-8.251l70.894-0.074l-92.888,181.206h28.785l93.164-185.182v-19.684H187.809z"/>
+	<path fill="#C1D82F" d="M413.941,232.625c0,0-59.977-0.042-65.402,0c-5.434,0.042-8.997-0.127-12.531,1.647
+		c-5.989,3.005-7.198,9.94-7.863,15.986c-0.809,7.332-8.392,84.803-7.738,85.118l11.857,5.903c0,0,17.644-10.237,38.31-10.237
+		c26.75,0,44.118,17.046,44.118,42.188c0,23.123-19.291,41.626-43.842,41.626c-28.126,0-42.693-22.405-42.693-22.405l-14.579,20.903
+		c0,0,19.234,27.227,58.636,27.227c40.559,0,70.621-30.055,70.621-68.503c0-36.418-27.019-64.741-67.301-64.741
+		c-18.318,0-27.578,6.37-27.578,6.37s5.112-50.206,5.112-50.237c0.368-3.761,3.515-6.685,7.184-6.685c0,0,36.563-0.007,39.618-0.007
+		c3.98,0,6.733,3.574,6.833,6.674c0.096,3.09,0,13.285,0,13.285h22.695l0.057-31.504c0-6.622-5.246-10.605-8.746-11.765
+		C418.499,232.721,416.204,232.59,413.941,232.625"/>
+	<polygon fill="#FFFFFF" points="188.699,166.494 222.912,166.494 221.039,176.371 199.5,176.371 197.382,186.146 217.659,186.146 
+		215.746,196.009 195.487,196.009 191.436,217.463 178.745,217.463 	"/>
+	<path fill="#FFFFFF" d="M232.121,198.999h12.921l-2.888-19.549L232.121,198.999z M246.644,208.212h-19.185l-4.762,9.251h-12.695
+		l27.136-51.043h14.161l8.498,51.043h-11.789L246.644,208.212z"/>
+	<polygon fill="#FFFFFF" points="302.773,166.469 343.007,166.455 340.988,176.615 326.926,176.615 320.24,217.318 308.999,217.318 
+		315.617,176.615 301.172,176.619 	"/>
+	<path fill="#FFFFFF" d="M409.081,189.772c2.867,0,5.056-0.714,6.529-2.131c1.492-1.432,2.234-3.524,2.234-6.282
+		c0-1.195-0.587-2.881-2.305-3.984c-1.599-1.021-4.179-1.015-8.159-1.015c-3.16,0-4.214,0.053-4.214,0.053l-1.901,13.359H409.081z
+		 M400.184,199.098l-2.588,18.397l-11.963-0.042l7.883-50.892h20.532c5.401,0,9.495,1.071,12.267,3.224
+		c2.811,2.156,4.214,5.324,4.214,9.509c0,4.235-1.11,7.707-3.315,10.45c-2.185,2.733-5.176,4.292-8.923,4.702
+		c1.722,0.367,3.164,1.304,4.288,2.786c1.142,1.481,2.146,3.747,2.994,6.819l3.659,13.444h-12.617l-3.153-11.588
+		c-0.771-2.587-1.658-4.383-2.722-5.352c-1.071-0.969-2.612-1.457-4.646-1.457H400.184z"/>
+	<path fill="#FFFFFF" d="M284.809,166.494c-8.947,0-17.1,3.797-18.758,13.239c-0.007,0.042-3.58,21.041-3.609,21.31
+		c-0.205,2.139-0.145,4.179,0.039,6.441c0.178,1.796,1.086,3.669,2.153,5.115c1.075,1.372,2.364,2.454,3.906,3.228
+		c3.182,1.623,7.232,1.669,11.817,1.715c0.732,0,10.994,0,10.994,0l1.057-10.206c-0.66,0-16.187,0.131-16.879-0.042
+		c-1.055-0.261-1.69-1.025-2.051-1.919c-0.389-0.873-0.1-2.287,0.061-3.245c0.018-0.032,4.195-23.342,4.195-23.342
+		c0.283-1.704,1.541-2.178,3.143-2.167c3.16,0.06,15.982,0.018,15.982,0.018l1.835-10.125
+		C298.694,166.512,287.092,166.494,284.809,166.494"/>
+	<path fill="#FFFFFF" d="M372.779,203.796c-0.438,2.17-1.63,3.581-3.609,3.574c-0.676,0-3.786,0.032-7.611,0.032
+		c-4.15,0-7.819-0.032-8.509-0.032c-1.934,0.007-2.804-1.576-2.472-3.574c0.262-1.63,1.651-10.832,2.157-14.144
+		c0.626-3.761,1.347-8.148,1.583-9.329c0.39-2.266,1.57-3.715,3.454-3.793c0.039,0,3.8-0.05,8.177-0.05
+		c4.369-0.007,8.088,0.042,8.088,0.042c1.984,0,2.801,1.379,2.489,3.535c0,0-0.891,6.498-1.796,12.896
+		C373.832,199.342,372.779,203.796,372.779,203.796 M360.018,217.644c4.879-0.05,11.613-0.474,15.992-3.153
+		c4.091-2.521,6.354-6.356,7.251-12.394l3.221-20.345c0.799-6.059-0.039-9.859-3.358-12.373c-3.766-2.885-11.064-3.167-16.004-3.167
+		l-0.01,0.018c-4.89,0.046-11.603,0.488-15.982,3.15c-4.107,2.535-6.335,6.359-7.25,12.39l-3.211,20.327
+		c-1.008,6.038,0.008,9.874,3.303,12.394c3.538,2.679,10.152,3.104,15.01,3.153"/>
+</g>
+</svg>

data/lib/abstract_feature_branch/configuration.rb

@@ -41,15 +41,24 @@ module AbstractFeatureBranch
         :production => true
       }
     end
-    def user_features_storage
-      @user_features_storage ||= initialize_user_features_storage
+    
+    def feature_store
+      @feature_store ||= initialize_feature_store
     end
-    def user_features_storage=(user_features_storage)
-      @user_features_storage = user_features_storage
+    alias user_features_storage feature_store
+    
+    def feature_store=(feature_store)
+      @feature_store = feature_store
     end
-    def initialize_user_features_storage
-      require 'redis'
-      self.user_features_storage = Redis.new
+    alias user_features_storage= feature_store=
+    
+    def initialize_feature_store
+      self.feature_store = Redis.new
+    rescue => e
+      logger.debug { "Redis is not enabled!" }
+      logger.debug { e.full_message }
+      nil
     end
+    alias initialize_user_features_storage initialize_feature_store
   end
 end

data/lib/abstract_feature_branch.rb

@@ -11,26 +11,42 @@ rescue Bundler::BundlerError => e
 end
 require 'logger' unless defined?(Rails) && Rails.logger
 require 'deep_merge' unless {}.respond_to?(:deep_merge!)
+require 'forwardable'
 
 require File.join(File.dirname(__FILE__), 'abstract_feature_branch', 'configuration')
 
 module AbstractFeatureBranch
   ENV_FEATURE_PREFIX = "abstract_feature_branch_"
+  REDIS_HKEY = "abstract_feature_branch"
 
   class << self
     extend Forwardable
-    def_delegators :configuration, :application_root, :application_root=, :initialize_application_root, :application_environment, :application_environment=, :initialize_application_environment, :logger, :logger=, :initialize_logger, :cacheable, :cacheable=, :initialize_cacheable, :user_features_storage, :user_features_storage=, :initialize_user_features_storage
+    def_delegators :configuration, :application_root, :application_root=, :initialize_application_root, :application_environment, :application_environment=, :initialize_application_environment, :logger, :logger=, :initialize_logger, :cacheable, :cacheable=, :initialize_cacheable, :feature_store, :feature_store=, :initialize_feature_store, :user_features_storage, :user_features_storage=, :initialize_user_features_storage
 
     def configuration
       @configuration ||= Configuration.new
     end
 
+    def redis_overrides
+      load_redis_overrides
+    end
+    def load_redis_overrides
+      return {} if feature_store.nil?
+      
+      redis_feature_hash = get_store_features.inject({}) do |output, feature|
+        output.merge(feature => get_store_feature(feature))
+      end
+      
+      downcase_keys(redis_feature_hash)
+    end
+
     def environment_variable_overrides
       @environment_variable_overrides ||= load_environment_variable_overrides
     end
     def load_environment_variable_overrides
-      @environment_variable_overrides = featureize_keys(select_feature_keys(booleanize_values(downcase_keys(ENV))))
+      @environment_variable_overrides = featureize_keys(downcase_keys(booleanize_values(select_feature_keys(ENV))))
     end
+    
     def local_features
       @local_features ||= load_local_features
     end
@@ -38,6 +54,7 @@ module AbstractFeatureBranch
       @local_features = {}
       load_specific_features(@local_features, '.local.yml')
     end
+    
     def features
       @features ||= load_features
     end
@@ -45,6 +62,7 @@ module AbstractFeatureBranch
       @features = {}
       load_specific_features(@features, '.yml')
     end
+    
     # performance optimization via caching of feature values resolved through environment variable overrides and local features
     def environment_features(environment)
       @environment_features ||= {}
@@ -54,7 +72,9 @@ module AbstractFeatureBranch
       @environment_features ||= {}
       features[environment] ||= {}
       local_features[environment] ||= {}
-      @environment_features[environment] = features[environment].merge(local_features[environment]).merge(environment_variable_overrides)
+      @environment_features[environment] = features[environment].
+        merge(local_features[environment]).
+        merge(environment_variable_overrides)
     end
     def application_features
       unload_application_features unless cacheable?
@@ -77,12 +97,58 @@ module AbstractFeatureBranch
       value = (application_environment != 'development') if value.nil?
       value
     end
+    
+    # Sets feature value (true or false) in storage (e.g. Redis client)
+    def set_store_feature(feature, value)
+      raise 'Feature storage (e.g. Redis) is not setup!' if feature_store.nil?
+      feature = feature.to_s
+      return delete_store_feature(feature) if value.nil?
+      value = 'true' if value == true
+      value = 'false' if value == false
+      feature_store.hset(REDIS_HKEY, feature, value)
+    end
+    
+    # Gets feature value (true or false) from storage (e.g. Redis client)
+    def get_store_feature(feature)
+      raise 'Feature storage (e.g. Redis) is not setup!' if feature_store.nil?
+      feature = feature.to_s
+      value = feature_store.hget(REDIS_HKEY, feature)
+      if value.nil?
+        matching_feature = get_store_features.find { |store_feature| store_feature.downcase == feature.downcase }
+        value = feature_store.hget(REDIS_HKEY, matching_feature) if matching_feature
+      end
+      return nil if value.nil?
+      return 'per_user' if value.to_s.downcase == 'per_user'
+      value.to_s.downcase == 'true'
+    end
+    
+    # Gets feature value (true or false) from storage (e.g. Redis client)
+    def delete_store_feature(feature)
+      raise 'Feature storage (e.g. Redis) is not setup!' if feature_store.nil?
+      feature = feature.to_s
+      feature_store.hdel(REDIS_HKEY, feature)
+    end
+    
+    # Gets features array (all features) from storage (e.g. Redis client)
+    def get_store_features
+      raise 'Feature storage (e.g. Redis) is not setup!' if feature_store.nil?
+      feature_store.hkeys(REDIS_HKEY)
+    end
+    
+    # Gets features array (all features) from storage (e.g. Redis client)
+    def clear_store_features
+      raise 'Feature storage (e.g. Redis) is not setup!' if feature_store.nil?
+      feature_store.hkeys(REDIS_HKEY).each do |feature|
+        feature_store.hdel(REDIS_HKEY, feature)
+      end
+    end
+    
     def toggle_features_for_user(user_id, features)
       features.each do |name, value|
         if value
-          user_features_storage.sadd("#{ENV_FEATURE_PREFIX}#{name.to_s.downcase}", user_id)
+          feature_store.sadd("#{ENV_FEATURE_PREFIX}#{name.to_s.downcase}", user_id)
         else
-          user_features_storage.srem("#{ENV_FEATURE_PREFIX}#{name.to_s.downcase}", user_id)
+          feature_store.srem("#{ENV_FEATURE_PREFIX}#{name.to_s.downcase}", user_id)
         end
       end
     end
@@ -103,7 +169,7 @@ module AbstractFeatureBranch
     end
 
     def select_feature_keys(hash)
-      hash.reject {|k, v| !k.start_with?(ENV_FEATURE_PREFIX)} # using reject for Ruby 1.8 compatibility as select returns an array in it
+      hash.reject {|k, v| !k.downcase.start_with?(ENV_FEATURE_PREFIX)} # using reject for Ruby 1.8 compatibility as select returns an array in it
     end
 
     def booleanize_values(hash)

data/lib/ext/feature_branch.rb

@@ -10,9 +10,10 @@ class Object
   def self.feature_enabled?(feature_name, user_id = nil)
     normalized_feature_name = feature_name.to_s.downcase
 
-    value = AbstractFeatureBranch.application_features[normalized_feature_name]
+    redis_override_value = AbstractFeatureBranch.get_store_feature(normalized_feature_name) rescue nil
+    value = !redis_override_value.nil? ? redis_override_value : AbstractFeatureBranch.application_features[normalized_feature_name]
     if value == 'per_user'
-      value = AbstractFeatureBranch.user_features_storage.sismember("#{AbstractFeatureBranch::ENV_FEATURE_PREFIX}#{normalized_feature_name}", user_id)
+      value = !user_id.nil? && AbstractFeatureBranch.user_features_storage.sismember("#{AbstractFeatureBranch::ENV_FEATURE_PREFIX}#{normalized_feature_name}", user_id)
     end
     value
   end
@@ -26,4 +27,4 @@ class Object
   def feature_enabled?(feature_name, user_id = nil)
     Object.feature_enabled?(feature_name.to_s, user_id)
   end
-end
+end

data/lib/generators/templates/config/initializers/abstract_feature_branch.rb

@@ -1,9 +1,8 @@
-require 'redis'
+# Storage system for features (other than YAML/Env-Vars). Right now, only Redis is supported.
+# AbstractFeatureBranch.feature_store = Redis.new
 
-# Storage for user features, customizable over here. Right now, only a Redis client is supported.
 # The following example line works with Heroku Redis To Go while still operating on local Redis for local development
-# AbstractFeatureBranch.user_features_storage = Redis.new(:url => ENV['REDISTOGO_URL'])
-AbstractFeatureBranch.user_features_storage = Redis.new
+# AbstractFeatureBranch.feature_store = Redis.new(:url => ENV['REDISTOGO_URL'])
 
 # Application root where config/features.yml or config/features/ is found
 AbstractFeatureBranch.application_root = Rails.root
@@ -24,4 +23,4 @@ AbstractFeatureBranch.cacheable = {
 }
 
 # Pre-load application features to improve performance of first web-page hit
-AbstractFeatureBranch.load_application_features unless Rails.env.development?
+AbstractFeatureBranch.load_application_features unless Rails.env.development?

data/ruby187.Gemfile

@@ -1,12 +1,13 @@
 source 'http://rubygems.org'
 
-gem 'deep_merge', '1.0.0', :require => false #avoid loading into memory to use deep_merge only if Rails is unavailable
+gem 'deep_merge', '1.0.0', :require => false #avoid loading to use only if Rails is unavailable
 gem 'redis', '~> 3.0.0', :require => false
 
 group :development do
   gem 'jeweler', '1.8.8'
-end
-
-group :test do
   gem 'rspec', '2.14.1'
-end
+  
+  #Ruby 1.8.7 compatible versions
+  gem "nokogiri", "~> 1.5.0"
+  gem "highline", "~> 1.6.21"
+end

data/spec/ext/feature_branch__feature_branch_per_user_spec.rb

@@ -25,16 +25,22 @@ describe 'feature_branch object extensions' do
     rescue => e
     #noop
     end
+    AbstractFeatureBranch.user_features_storage.keys.each do |key|
+      AbstractFeatureBranch.user_features_storage.del(key)
+    end
   end
   describe '#feature_branch' do
     context 'per user' do
       it 'feature branches correctly after storing feature configuration per user in a separate process (ensuring persistence)' do
         user_id = 'email1@example.com'
-        Process.fork do
+        ruby_code = <<-RUBY_CODE
+          $:.unshift('.')
+          require 'redis'
+          require 'lib/abstract_feature_branch'
           AbstractFeatureBranch.initialize_user_features_storage
-          AbstractFeatureBranch.toggle_features_for_user(user_id, :feature1 => false, :feature3 => true, :feature6 => true, :feature7 => false)
-        end
-        Process.wait
+          AbstractFeatureBranch.toggle_features_for_user('#{user_id}', :feature1 => false, :feature3 => true, :feature6 => true, :feature7 => false)
+        RUBY_CODE
+        system "ruby -e \"#{ruby_code}\""
         features_enabled = []
         feature_branch :feature1, user_id do
           features_enabled << :feature1
@@ -63,12 +69,15 @@ describe 'feature_branch object extensions' do
       end
       it 'update feature branching (disabling some features) after having stored feature configuration per user in a separate process (ensuring persistence)' do
         user_id = 'email1@example.com'
-        Process.fork do
+        ruby_code = <<-RUBY_CODE
+          $:.unshift('.')
+          require 'redis'
+          require 'lib/abstract_feature_branch'
           AbstractFeatureBranch.initialize_user_features_storage
-          AbstractFeatureBranch.toggle_features_for_user(user_id, :feature6 => true, :feature7 => false)
-          AbstractFeatureBranch.toggle_features_for_user(user_id, :feature6 => false, :feature7 => true)
-        end
-        Process.wait
+          AbstractFeatureBranch.toggle_features_for_user('#{user_id}', :feature6 => true, :feature7 => false)
+          AbstractFeatureBranch.toggle_features_for_user('#{user_id}', :feature6 => false, :feature7 => true)
+        RUBY_CODE
+        system "ruby -e \"#{ruby_code}\""
         features_enabled = []
         feature_branch :feature6, user_id do
           features_enabled << :feature6

data/spec/ext/feature_branch__feature_branch_spec.rb

@@ -15,6 +15,9 @@ describe 'feature_branch object extensions' do
     AbstractFeatureBranch.application_root = @app_root_backup
     AbstractFeatureBranch.application_environment = @app_env_backup
     AbstractFeatureBranch.unload_application_features
+    AbstractFeatureBranch.user_features_storage.keys.each do |key|
+      AbstractFeatureBranch.user_features_storage.del(key)
+    end
   end
   describe '#feature_branch' do
     context 'class level behavior (case-insensitive string or symbol feature names)' do
@@ -63,6 +66,26 @@ describe 'feature_branch object extensions' do
       features_enabled.should_not include(:feature2)
       features_enabled.should include(:feature3)
     end
+    it 'allows redis variables (case-insensitive booleans) to override configuration file' do
+      AbstractFeatureBranch.unload_application_features
+      AbstractFeatureBranch.user_features_storage.hset('abstract_feature_branch', 'FEATURE1', 'FALSE')
+      AbstractFeatureBranch.user_features_storage.hset('abstract_feature_branch', 'Feature2', 'False')
+      AbstractFeatureBranch.user_features_storage.hset('abstract_feature_branch', 'feature3', 'true')
+      AbstractFeatureBranch.load_application_features
+      features_enabled = []
+      feature_branch :feature1 do
+        features_enabled << :feature1
+      end
+      feature_branch :feature2 do
+        features_enabled << :feature2
+      end
+      feature_branch :feature3 do
+        features_enabled << :feature3
+      end
+      features_enabled.should_not include(:feature1)
+      features_enabled.should_not include(:feature2)
+      features_enabled.should include(:feature3)
+    end
     it 'allows local configuration file to override main configuration file' do
       features_enabled = []
       feature_branch :feature4 do

data/spec/ext/feature_branch__feature_enabled_spec.rb

@@ -15,6 +15,9 @@ describe 'feature_branch object extensions' do
     AbstractFeatureBranch.application_root = @app_root_backup
     AbstractFeatureBranch.application_environment = @app_env_backup
     AbstractFeatureBranch.unload_application_features
+    AbstractFeatureBranch.user_features_storage.keys.each do |key|
+      AbstractFeatureBranch.user_features_storage.del(key)
+    end
   end
   describe '#feature_enabled?' do
     it 'determines whether a feature is enabled or not in features configuration (case-insensitive string or symbol feature names)' do
@@ -35,6 +38,17 @@ describe 'feature_branch object extensions' do
       feature_enabled?(:feature3).should == true
       feature_enabled?(:feature4a).should == true #not overridden
     end
+    it 'allows redis variables (case-insensitive booleans) to override configuration file' do
+      AbstractFeatureBranch.unload_application_features
+      AbstractFeatureBranch.user_features_storage.hset('abstract_feature_branch', 'FEATURE1', 'FALSE')
+      AbstractFeatureBranch.user_features_storage.hset('abstract_feature_branch', 'Feature2', 'False')
+      AbstractFeatureBranch.user_features_storage.hset('abstract_feature_branch', 'feature3', 'true')
+      AbstractFeatureBranch.load_application_features
+      feature_enabled?(:feature1).should == false
+      feature_enabled?(:feature2).should == false
+      feature_enabled?(:feature3).should == true
+      feature_enabled?(:feature4a).should == true #not overridden
+    end
     it 'allows local configuration file to override main configuration file in test environment' do
       feature_enabled?(:feature4).should == false
       feature_enabled?(:feature5).should == true

metadata

@@ -1,63 +1,104 @@
 --- !ruby/object:Gem::Specification
 name: abstract_feature_branch
 version: !ruby/object:Gem::Version
-  version: 1.2.2
+  version: 1.3.0
 platform: ruby
 authors:
 - Annas "Andy" Maleh
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2014-02-23 00:00:00.000000000 Z
+date: 2022-12-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: deep_merge
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 1.0.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 1.0.0
 - !ruby/object:Gem::Dependency
-  name: redis
+  name: jeweler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.0.0
-  type: :runtime
+        version: 2.3.9
+  type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.0.0
+        version: 2.3.9
 - !ruby/object:Gem::Dependency
-  name: jeweler
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.1.4
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.1.4
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 2.14.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 2.14.1
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 5.1.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 5.1.0
+- !ruby/object:Gem::Dependency
+  name: psych
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.8.8
+        version: 3.3.4
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.8.8
+        version: 3.3.4
 description: |
   abstract_feature_branch is a Rails gem that enables developers to easily branch by abstraction as per this pattern:
   http://paulhammant.com/blog/branch_by_abstraction.html
 
-  It is a productivity and fault tolerance enhancing team practice that has been utilized by professional software development
-  teams at large corporations, such as Sears and Groupon.
+  It is a productivity and fault tolerance enhancing team practice.
 
   It provides the ability to wrap blocks of code with an abstract feature branch name, and then
   specify in a configuration file which features to be switched on or off.
@@ -73,18 +114,21 @@ description: |
   abstract_feature_branch additionally supports DDD's pattern of
   Bounded Contexts by allowing developers to configure
   context-specific feature files if needed.
-email: 
+email:
 executables: []
 extensions: []
 extra_rdoc_files:
+- CHANGELOG.md
 - LICENSE.txt
 - README.md
 files:
-- .coveralls.yml
-- .travis.yml
+- ".coveralls.yml"
+- ".travis.yml"
+- CHANGELOG.md
 - LICENSE.txt
 - README.md
 - RELEASE_NOTES.md
+- TODO.md
 - VERSION
 - abstract_feature_branch.gemspec
 - config/features/admin.local.yml
@@ -93,6 +137,9 @@ files:
 - config/features/internal/wiki.yml
 - config/features/public.local.yml
 - config/features/public.yml
+- img/BigAstronaut-Logo.png
+- img/EarlyShares-Logo.svg
+- img/Factor75-Logo.svg
 - lib/abstract_feature_branch.rb
 - lib/abstract_feature_branch/configuration.rb
 - lib/abstract_feature_branch/file_beautifier.rb
@@ -105,7 +152,6 @@ files:
 - lib/generators/templates/config/initializers/abstract_feature_branch.rb
 - lib/generators/templates/lib/tasks/abstract_feature_branch.rake
 - ruby187.Gemfile
-- ruby187.Gemfile.lock
 - spec/abstract_feature_branch/file_beautifier_spec.rb
 - spec/ext/feature_branch__feature_branch_per_user_spec.rb
 - spec/ext/feature_branch__feature_branch_spec.rb
@@ -131,24 +177,33 @@ homepage: http://github.com/AndyObtiva/abstract_feature_branch
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message: "\nRails-only post-install instructions:\n\n1) Run the following
+  command to generate the Rails initializer and basic feature files:\n\nrails g abstract_feature_branch:install\n\n2)
+  Optionally, you may run this command to generate feature files per context:\n\nrails
+  g abstract_feature_branch:context context_path\n   \n3) Optionally, install Redis
+  server with [Homebrew](https://brew.sh/) by running:\n\nbrew install redis\n\n4)
+  Optionally, install redis client gem (required with Redis server) by adding the
+  following line to Gemfile above abstract_feature_branch:\n\ngem 'redis', '~> 5.0.5'\n\nAfterwards,
+  run:\n\nbundle\n\n5) Optionally, customize configuration in config/initializers/abstract_feature_branch.rb\n\n(can
+  be useful for changing location of feature files in Rails application,\nconfiguring
+  Redis to use for overrides and per-user feature enablement,\nand/or troubleshooting
+  specific Rails environment feature configurations)\n\n"
 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.0.6
-signing_key: 
+rubygems_version: 3.3.6
+signing_key:
 specification_version: 4
 summary: 'abstract_feature_branch is a Rails gem that enables developers to easily
   branch by abstraction as per this pattern: http://paulhammant.com/blog/branch_by_abstraction.html'

data/ruby187.Gemfile.lock

@@ -1,63 +0,0 @@
-GEM
-  remote: http://rubygems.org/
-  specs:
-    addressable (2.3.5)
-    builder (3.2.2)
-    deep_merge (1.0.0)
-    diff-lcs (1.2.5)
-    faraday (0.8.9)
-      multipart-post (~> 1.2.0)
-    git (1.2.6)
-    github_api (0.10.1)
-      addressable
-      faraday (~> 0.8.1)
-      hashie (>= 1.2)
-      multi_json (~> 1.4)
-      nokogiri (~> 1.5.2)
-      oauth2
-    hashie (2.0.5)
-    highline (1.6.20)
-    httpauth (0.2.0)
-    jeweler (1.8.8)
-      builder
-      bundler (~> 1.0)
-      git (>= 1.2.5)
-      github_api (= 0.10.1)
-      highline (>= 1.6.15)
-      nokogiri (= 1.5.10)
-      rake
-      rdoc
-    json (1.8.1)
-    jwt (0.1.10)
-      multi_json (>= 1.5)
-    multi_json (1.8.4)
-    multi_xml (0.5.5)
-    multipart-post (1.2.0)
-    nokogiri (1.5.10)
-    oauth2 (0.9.2)
-      faraday (~> 0.8)
-      httpauth (~> 0.2)
-      jwt (~> 0.1.4)
-      multi_json (~> 1.0)
-      multi_xml (~> 0.5)
-      rack (~> 1.2)
-    rack (1.5.2)
-    rake (10.1.1)
-    rdoc (4.1.1)
-      json (~> 1.4)
-    rspec (2.14.1)
-      rspec-core (~> 2.14.0)
-      rspec-expectations (~> 2.14.0)
-      rspec-mocks (~> 2.14.0)
-    rspec-core (2.14.7)
-    rspec-expectations (2.14.4)
-      diff-lcs (>= 1.1.3, < 2.0)
-    rspec-mocks (2.14.4)
-
-PLATFORMS
-  ruby
-
-DEPENDENCIES
-  deep_merge (= 1.0.0)
-  jeweler (= 1.8.8)
-  rspec (= 2.14.1)