togls 2.1.1 → 2.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 1e26c25d5e392fcf0784759ef62cafe4716cdc85
-  data.tar.gz: 057ac20f307b93518808f3ecef8426fb33bbd428
+  metadata.gz: 9abbf07a34b200f7000e94608724c8499cd0277a
+  data.tar.gz: 5724c3c1c652bf825a1de22b539b1f848f1d1a11
 SHA512:
-  metadata.gz: f9a733735c31d42f0dfd3e5c2f14fea0832b814111ba3d020678d6a6eace4c82128e720601dfc9da897ed9265ad7a22ee3817252154e1a6090db30522590b506
-  data.tar.gz: 554a8fc657ef91253afedec1793725c0c6a2b9f64388ae8686d8a54750d63f4987fa7f4448cf1b81f76dfb4ab1000feef0ae94f428a08c56841da092e13bbf4d
+  metadata.gz: a74f6677b8c623e757a32c3bddcc026571485263bbf75ad6ac4c5ab53c22856e26299835d1bf83e7ac6b62bfddea4698754a04ab2738249e477ab7719b16aeab
+  data.tar.gz: c3cd113e76fc0035bd3994684cc84208a69fb9e496a4402dfa23c9c0dc47e510277fa8cb73344c541fd8465c75ac3db03b844ecece48d1f23e40a83d88c72691

data/.codeclimate.yml

@@ -1,2 +1,18 @@
-languages:
-  Ruby: true
+---
+engines:
+  duplication:
+    enabled: true
+    config:
+      languages:
+      - ruby
+  rubocop:
+    enabled: true
+  fixme:
+    enabled: true
+ratings:
+  paths:
+    - lib/**
+    - exe/**
+exclude_paths:
+  - spec/**/*
+  - docs/**/*

data/.ruby-version

@@ -1 +1 @@
-2.2.3
+2.3.0

data/.travis.yml

@@ -1,4 +1,5 @@
 language: ruby
 rvm:
+  - 2.3.0
   - 2.2.3
   - 2.2.2

data/{ChangeLog.md → CHANGELOG.md}

@@ -6,6 +6,12 @@ versions, as well as provide a rough history.
 
 #### Next Release
 
+### v2.2.0
+
+* Changed Togls to be thread-safe
+* Added Togls::TestToggleRegistry class for initializing test state
+* Added ability to create additional toggle registries
+
 ### v2.1.1
 
 * Fixed issue #21, env variable override wasn't falling through to in

data/DEVELOPMENT.md

@@ -0,0 +1,53 @@
+Welcome to the development guide for
+[Togls](https://github.com/codebreakdown/togls). The hope is that the
+following will aid in your development contributions to
+[Togls](https://github.com/codebreakdown/togls).
+
+# Where should I start?
+
+We recommend generally that you start with first understanding the
+existing features and documentation. These can be obtained by
+referencing the [README](https://github.com/codebreakdown/togls) and the
+[Wiki](https://github.com/codebreakdown/togls/wiki).
+
+Once you are well versed in concepts, features, and documentation from
+an end user standpoint. The next thing we feel is worth exploring is the
+architecture. We recommend doing this after understanding it from the
+end user standpoint as it should give you context when learning about
+the internal concepts.
+
+## The Architecture
+
+### Models
+
+At the core exists three main concepts, the Feature, the Rule, and the
+Toggle.
+
+#### Feature
+
+A Feature is the code that provides some functionality coupled with a
+unique identifier.
+
+#### Rule
+
+A Rule is conceptually the logic used to determine whether or not to
+toggle a feature on or off. This is generally a Rule class provided by
+[Togls](https://github.com/codebreakdown/togls/wiki) or a custom Rule
+class provided by the end user conforming to the Rule interface.
+
+#### Toggle
+
+Conceptually, a Toggle is a switch that is used to turn something on or
+off. In our case it is used to turn a Feature on or off. It does so by
+consulting an associated Rule to determine if the Toggle should be on or
+off.
+
+The Toggle is really the linch pin of these three concepts as it ties
+all three of them together. Forming, a functional feature toggle.
+
+### Repositories
+
+In addition to the three model concepts from above. We also have
+Repositories for each of the concepts respectively. They are responsible
+for managing and separating the business representations from the
+persistance layers.

data/Gemfile

@@ -3,4 +3,4 @@ source 'https://rubygems.org'
 # Specify your gem's dependencies in togl.gemspec
 gemspec
 
-gem "codeclimate-test-reporter", "~> 0.4.8", group: :test, require: nil
+gem 'codeclimate-test-reporter', '~> 0.4.8', group: :test, require: nil

data/LICENSE.txt

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2015 Brian Miller, Andrew De Ponte, Ryan Hedges
+Copyright (c) 2015-2016 Brian Miller, Andrew De Ponte, Ryan Hedges
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/Rakefile

@@ -1,6 +1,6 @@
-require "bundler/gem_tasks"
+require 'bundler/gem_tasks'
 require 'rspec/core/rake_task'
 
 RSpec::Core::RakeTask.new(:spec)
 
-task :default => :spec
+task default: :spec

data/bin/console

@@ -1,7 +1,7 @@
 #!/usr/bin/env ruby
 
-require "bundler/setup"
-require "togls"
+require 'bundler/setup'
+require 'togls'
 
 # You can add fixtures and/or initialization code here to make experimenting
 # with your gem easier. You can also use a different console, if you like.
@@ -10,5 +10,5 @@ require "togls"
 # require "pry"
 # Pry.start
 
-require "irb"
+require 'irb'
 IRB.start

data/lib/tasks/togls.rake

@@ -1,5 +1,6 @@
 namespace :togls do
-  desc "Output all features including status (on, off, ? - unknown due to complex rule), key, description"
+  desc 'Output all features including status (on, off, ? - unknown due to' \
+   ' complex rule), key, description'
   task :features do
     Togls.features.all.each do |toggle|
       puts toggle.to_s

data/lib/togls/feature.rb

@@ -1,4 +1,8 @@
 module Togls
+  # Feature
+  #
+  # The Feature model is the business representation of a feature. It is how
+  # Togls primarily interfaces with the concept of a feature.
   class Feature
     attr_reader :key, :description
 

data/lib/togls/feature_repository.rb

@@ -1,11 +1,15 @@
 module Togls
+  # Feature Repository
+  #
+  # The Feature Repository is the primary interface for storing and retrieving
+  # feature entities using the initialized prioritized drivers Array.
   class FeatureRepository
     def initialize(drivers)
-      if !drivers.is_a?(Array)
-        raise Togls::InvalidDriver.new("FeatureRepository requires a valid driver")
+      unless drivers.is_a?(Array)
+        raise Togls::InvalidDriver, 'FeatureRepository requires a valid driver'
       end
       if drivers.empty?
-        raise Togls::MissingDriver.new("FeatureRepository requires a driver")
+        raise Togls::MissingDriver, 'FeatureRepository requires a driver'
       end
       @drivers = drivers
     end
@@ -18,7 +22,7 @@ module Togls
     end
 
     def extract_feature_data(feature)
-      { "key" => feature.key, "description" => feature.description }
+      { 'key' => feature.key, 'description' => feature.description }
     end
 
     def fetch_feature_data(id)
@@ -36,8 +40,8 @@ module Togls
     end
 
     def reconstitute_feature(feature_data)
-      Togls::Feature.new(feature_data["key"],
-                         feature_data["description"])
+      Togls::Feature.new(feature_data['key'],
+                         feature_data['description'])
     end
   end
 end

data/lib/togls/feature_repository_drivers/in_memory_driver.rb

@@ -1,16 +1,27 @@
+require 'thread'
+
 module Togls
   module FeatureRepositoryDrivers
+    # Feature Repository In-Memory Driver
+    #
+    # The Feature Repository In-Memory Driver provides the facility to store and
+    # retrieve features to and from the in-memory store.
     class InMemoryDriver
       def initialize
         @features = {}
+        @features_lock = Mutex.new
       end
 
       def store(feature_id, feature_data)
-        @features[feature_id] = feature_data
+        @features_lock.synchronize do
+          @features[feature_id] = feature_data
+        end
       end
 
       def get(feature_id)
-        @features[feature_id]
+        @features_lock.synchronize do
+          @features[feature_id]
+        end
       end
     end
   end

data/lib/togls/feature_repository_drivers.rb

@@ -1,4 +1,8 @@
 module Togls
+  # Feature Repository Drivers
+  #
+  # The Feature Repository Drivers module is simply an organization bucket used
+  # to house the Feature Repository drivers provided by Togls.
   module FeatureRepositoryDrivers
   end
 end

data/lib/togls/feature_toggle_registry.rb

@@ -1,4 +1,11 @@
 module Togls
+  # Feature Toggle Registry
+  #
+  # The Feature Toggle Registry conceptually houses a registry of toggles. It
+  # accomplishes this by technically housing a toggle repository, rule
+  # repository, and feature repository which is uses to store and retrieve the
+  # respective entities. This plays a significant portion in the primary DSL as
+  # well.
   class FeatureToggleRegistry
     def initialize
       @toggle_repository_drivers = [
@@ -8,25 +15,24 @@ module Togls
         [Togls::FeatureRepositoryDrivers::InMemoryDriver.new]
       @rule_repository_drivers =
         [Togls::RuleRepositoryDrivers::InMemoryDriver.new]
-      @feature_repository = Togls::FeatureRepository.new(@feature_repository_drivers)
+      @feature_repository = Togls::FeatureRepository.new(
+        @feature_repository_drivers)
       @rule_repository = Togls::RuleRepository.new(@rule_repository_drivers)
-      @toggle_repository = Togls::ToggleRepository.new(@toggle_repository_drivers,
-                                    @feature_repository, @rule_repository)
-      @boolean_true_rule = Togls::Rules::Boolean.new(true)
-      @boolean_false_rule = Togls::Rules::Boolean.new(false)
-      @rule_repository.store(@boolean_false_rule)
-      @rule_repository.store(@boolean_true_rule)
+      @toggle_repository = Togls::ToggleRepository.new(
+        @toggle_repository_drivers, @feature_repository, @rule_repository)
+      @rule_repository.store(Togls::Rules::Boolean.new(true))
+      @rule_repository.store(Togls::Rules::Boolean.new(false))
     end
 
     def self.create(&block)
-      feature_toggle_registry = self.new
+      feature_toggle_registry = new
       feature_toggle_registry.instance_eval(&block)
-      return feature_toggle_registry
+      feature_toggle_registry
     end
 
     def expand(&block)
-      self.instance_eval(&block)
-      return self
+      instance_eval(&block)
+      self
     end
 
     def feature(key, desc)
@@ -41,7 +47,7 @@ module Togls
       if toggle.is_a?(Togls::NullToggle)
         Togls.logger.warn("Feature identified by '#{key}' has not been defined")
       end
-      return toggle
+      toggle
     end
 
     def all

data/lib/togls/helpers.rb

@@ -1,7 +1,10 @@
 module Togls
+  # Helpers
+  #
+  # Collection of helper methods used through the Togls library.
   module Helpers
     def self.sha1(klass, data)
-      Digest::SHA1.hexdigest("#{klass}:#{data.to_s}")
+      Digest::SHA1.hexdigest("#{klass}:#{data}")
     end
   end
 end

data/lib/togls/null_toggle.rb

@@ -1,7 +1,11 @@
 module Togls
+  # Null Toggle
+  #
+  # The Null Toggle model is designed to be used as a response when there is no
+  # toggle found when requested to be retreived through a Toggle Repository.
   class NullToggle < Togls::Toggle
     def initialize
-      feature = Togls::Feature.new("null", "the official null feature")
+      feature = Togls::Feature.new('null', 'the official null feature')
       super(feature)
     end
 

data/lib/togls/release_toggle_registry_manager.rb

@@ -0,0 +1,43 @@
+module Togls
+  # Release Toggle Registry Manager
+  #
+  # This is the primary DSL interface. It provides a DSL to facilitate housing
+  # and managing a toggle registry.
+  module ReleaseToggleRegistryManager
+    def self.included(mod)
+      mod.extend(ClassMethods)
+    end
+
+    # Release Toggle Registry Manager Class Methods
+    #
+    # The class methods that should be extended onto the module/class when
+    # ReleaseToggleRegistryManager is included.
+    module ClassMethods
+      def features(&block)
+        if @feature_toggle_registry.nil?
+          @feature_toggle_registry = FeatureToggleRegistry.new
+        end
+
+        @feature_toggle_registry.expand(&block) if block
+
+        @feature_toggle_registry
+      end
+
+      def features=(feature_toggle_registry)
+        @feature_toggle_registry = feature_toggle_registry
+      end
+
+      def feature(key)
+        if @feature_toggle_registry.nil?
+          @feature_toggle_registry = FeatureToggleRegistry.new
+        end
+
+        @feature_toggle_registry.get(key)
+      end
+
+      def logger
+        @logger ||= Logger.new(STDOUT)
+      end
+    end
+  end
+end

data/lib/togls/rule.rb

@@ -1,15 +1,17 @@
 module Togls
+  # Rule
+  #
+  # The Rule is an abstract base class that is intended to act as an interface
+  # for other rules to be implemented against.
   class Rule
     attr_reader :data
 
-    def initialize(data=nil)
-      @data = data  
+    def initialize(data = nil)
+      @data = data
     end
 
     def run(key, target = nil)
-      raise Togls::NotImplemented.new(
-        "Rule's #run method must be implemented"
-      )
+      raise Togls::NotImplemented, "Rule's #run method must be implemented"
     end
 
     def id

data/lib/togls/rule_repository.rb

@@ -1,11 +1,16 @@
 module Togls
+  # Rule Repository
+  #
+  # The Rule Repository is the intended interface to store and retrieve rules.
+  # It does these by interfacing with Rule Repository Drivers which are passed
+  # in during construction as an Array.
   class RuleRepository
     def initialize(drivers)
-      if !drivers.is_a?(Array)
-        raise Togls::InvalidDriver.new("RuleRepository requires a valid driver")
+      unless drivers.is_a?(Array)
+        raise Togls::InvalidDriver, 'RuleRepository requires a valid driver'
       end
       if drivers.empty?
-        raise Togls::MissingDriver.new("RuleRepository requires a driver")
+        raise Togls::MissingDriver, 'RuleRepository requires a driver'
       end
       @drivers = drivers
     end
@@ -16,9 +21,9 @@ module Togls
         driver.store(rule.id, rule_data)
       end
     end
- 
+
     def extract_storage_payload(rule)
-      return { "klass" => rule.class, "data" => rule.data }
+      { 'klass' => rule.class, 'data' => rule.data }
     end
 
     def fetch_rule_data(id)
@@ -36,7 +41,7 @@ module Togls
     end
 
     def reconstitute_rule(rule_data)
-      rule_data["klass"].new(rule_data["data"])
+      rule_data['klass'].new(rule_data['data'])
     end
   end
 end

data/lib/togls/rule_repository_drivers/in_memory_driver.rb

@@ -1,16 +1,27 @@
+require 'thread'
+
 module Togls
   module RuleRepositoryDrivers
+    # Rule Repository In-Memory Driver
+    #
+    # The Rule Repository In-Memory Driver provides the interface to store and
+    # retrieve rules. This is intended to be used by a Rule Repository instance.
     class InMemoryDriver
       def initialize
         @rules = {}
+        @rules_lock = Mutex.new
       end
 
       def store(rule_id, rule_data)
-        @rules[rule_id] = rule_data
+        @rules_lock.synchronize do
+          @rules[rule_id] = rule_data
+        end
       end
-      
+
       def get(rule_id)
-        @rules[rule_id]
+        @rules_lock.synchronize do
+          @rules[rule_id]
+        end
       end
     end
   end

data/lib/togls/rule_repository_drivers.rb

@@ -1,5 +1,8 @@
 module Togls
+  # Rule Repository Drivers
+  #
+  # The Rule Repository Drivers module is simply an organizational bucket to
+  # house the rule repository drivers provided by Togls.
   module RuleRepositoryDrivers
-
   end
 end

data/lib/togls/rules/boolean.rb

@@ -1,8 +1,22 @@
 module Togls
   module Rules
+    # Boolean Rule
+    #
+    # The Boolean Rule is a provided Rule that expects to be given a boolean as
+    # it's initialization data and when evaluated determines the toggle state
+    # based on the initialization value. Example:
+    #
+    # always_on = Togls::Rules::Boolean.new(true)
+    # Togls.features do
+    #   feature(:foo).on(always_on)
+    # end
+    #
+    # if Togls.feature(:foo).on?
+    #   ...
+    # end
     class Boolean < Rule
-      def run(key, target = nil)
-        return @data
+      def run(_key, _target = nil)
+        @data
       end
     end
   end

data/lib/togls/rules/group.rb

@@ -1,7 +1,23 @@
 module Togls
   module Rules
+    # Group Rule
+    #
+    # The Group Rule is a provided Rule that expects to be given an Array as
+    # it's initialization data and when evaluated determines the toggle state
+    # based on the given target being included in the Array that was passed in
+    # during initialization. This allows you to define various groups. For
+    # example:
+    #
+    # alpha_testers = Togls::Rules::Group.new(['bob@ex.com', 'cindy@ex.com'])
+    # Togls.features do
+    #   feature(:foo).on(alpha_testers)
+    # end
+    #
+    # if Togls.feature(:foo).on?(current_user.email)
+    #   ...
+    # end
     class Group < Rule
-      def run(key, target)
+      def run(_key, target)
         @data.include?(target)
       end
     end

data/lib/togls/rules.rb

@@ -2,6 +2,10 @@ require 'togls/rules/boolean'
 require 'togls/rules/group'
 
 module Togls
+  # Rules
+  #
+  # The Rules module is simply an organizational bucket to house all the rules
+  # that Togls provides.
   module Rules
   end
 end

data/lib/togls/test_toggle_registry.rb

@@ -0,0 +1,26 @@
+module Togls
+  # Test Toggle Registry
+  #
+  # The Test Toggle Registry is a toggle feature toggle registry specifically
+  # intended to be used in the use case of automated test suites. The difference
+  # between this toggle registry and the normal FeatureToggleRegistry is that
+  # this registry only uses in-memory drivers and the FeatureToggleRegistry uses
+  # in-memory drivers as well as the environment override drivers.
+  class TestToggleRegistry < FeatureToggleRegistry
+    def initialize
+      @toggle_repository_drivers = [
+        Togls::ToggleRepositoryDrivers::InMemoryDriver.new]
+      @feature_repository_drivers =
+        [Togls::FeatureRepositoryDrivers::InMemoryDriver.new]
+      @rule_repository_drivers =
+        [Togls::RuleRepositoryDrivers::InMemoryDriver.new]
+      @feature_repository = Togls::FeatureRepository.new(
+        @feature_repository_drivers)
+      @rule_repository = Togls::RuleRepository.new(@rule_repository_drivers)
+      @toggle_repository = Togls::ToggleRepository.new(
+        @toggle_repository_drivers, @feature_repository, @rule_repository)
+      @rule_repository.store(Togls::Rules::Boolean.new(true))
+      @rule_repository.store(Togls::Rules::Boolean.new(false))
+    end
+  end
+end

data/lib/togls/toggle.rb

@@ -1,4 +1,9 @@
 module Togls
+  # Toggle
+  #
+  # The model representing a Toggle within the world of Togls. A Toggle's
+  # responsibility is binding a specific rule to a specific feature. Toggle's by
+  # default are associated with a boolean rule initialized to false.
   class Toggle
     attr_reader :feature
     attr_accessor :rule
@@ -17,15 +22,15 @@ module Togls
     end
 
     def off?(target = nil)
-      return !@rule.run(@feature.key, target)
+      !@rule.run(@feature.key, target)
     end
 
     def to_s
-      if @rule.is_a?(Togls::Rules::Boolean)
-        display_value = @rule.run(@feature.key) ? ' on' : 'off'
-      else
-        display_value = '  ?'
-      end
+      display_value = if @rule.is_a?(Togls::Rules::Boolean)
+                        @rule.run(@feature.key) ? ' on' : 'off'
+                      else
+                        '  ?'
+                      end
 
       "#{display_value} - #{@feature.key} - #{@feature.description}"
     end

data/lib/togls/toggle_repository.rb

@@ -1,11 +1,14 @@
 module Togls
+  # Toggle Repository
+  #
+  # Repository interface for storing and retrieving toggles.
   class ToggleRepository
     def initialize(drivers, feature_repository, rule_repository)
-      if !drivers.is_a?(Array)
-        raise Togls::InvalidDriver.new("ToggleRepository requires a valid driver")
+      unless drivers.is_a?(Array)
+        raise Togls::InvalidDriver, 'ToggleRepository requires a valid driver'
       end
       if drivers.empty?
-        raise Togls::MissingDriver.new("ToggleRepository requires a driver")
+        raise Togls::MissingDriver, 'ToggleRepository requires a driver'
       end
       @drivers = drivers
       @feature_repository = feature_repository
@@ -23,24 +26,21 @@ module Togls
     end
 
     def extract_storage_payload(toggle)
-      { "feature_id" => toggle.feature.id, "rule_id" => toggle.rule.id }
+      { 'feature_id' => toggle.feature.id, 'rule_id' => toggle.rule.id }
     end
 
     def get(id)
       toggle_data = fetch_toggle_data(id)
-      if toggle_data
-        return reconstitute_toggle(toggle_data)
-      else
-        return Togls::NullToggle.new
-      end
+      return reconstitute_toggle(toggle_data) if toggle_data
+      Togls::NullToggle.new
     end
 
     def reconstitute_toggle(toggle_data)
-      feature = @feature_repository.get(toggle_data["feature_id"])
-      rule = @rule_repository.get(toggle_data["rule_id"])
+      feature = @feature_repository.get(toggle_data['feature_id'])
+      rule = @rule_repository.get(toggle_data['rule_id'])
       toggle = Togls::Toggle.new(feature)
       toggle.rule = rule
-      return toggle
+      toggle
     end
 
     def fetch_toggle_data(id)

data/lib/togls/toggle_repository_drivers/env_override_driver.rb

@@ -1,33 +1,45 @@
 module Togls
   module ToggleRepositoryDrivers
+    # Toggle Repository Environment Override Driver
+    #
+    # The Toggle Repository Environment Override Driver provides a Toggle
+    # Repository driver that passively ignores requests to store toggles but
+    # still responds to retrieval requests. This conceptually makes it what I am
+    # referring to as an "Override Driver" because it only allows retrieving
+    # overrides from the store.
+    #
+    # In this particular case it is an Environment Override Driver. Therefore,
+    # the store that backs this driver is environment variables. Specifically,
+    # this driver would retrieve a boolean rule initialized true if the
+    # associated environment variable was equal to the string, 'true'. If the
+    # associated environment variable was equal to the string, 'false', it would
+    # return a boolean rule initialized to false. Any other value and the driver
+    # returns nil indicating that it couldn't find the toggle in the store.
     class EnvOverrideDriver
       def store(toggle_id, toggle_data)
       end
 
       def get(toggle_id)
-        if ENV[toggle_env_key(toggle_id)]
-          if ENV[toggle_env_key(toggle_id)] == "true"
-            return { "feature_id" => toggle_id,
-                     "rule_id" => Togls::Helpers.sha1(Togls::Rules::Boolean, true) }
-          elsif ENV[toggle_env_key(toggle_id)] == "false"
-            return { "feature_id" => toggle_id,
-                     "rule_id" => Togls::Helpers.sha1(Togls::Rules::Boolean, false) }
-          else
-            return nil
-          end
+        return nil if ENV[toggle_env_key(toggle_id)].nil?
+        if ENV[toggle_env_key(toggle_id)] == 'true'
+          return { 'feature_id' => toggle_id, 'rule_id' => Togls::Helpers.sha1(
+            Togls::Rules::Boolean, true) }
+        elsif ENV[toggle_env_key(toggle_id)] == 'false'
+          return { 'feature_id' => toggle_id, 'rule_id' => Togls::Helpers.sha1(
+            Togls::Rules::Boolean, false) }
         else
           return nil
         end
       end
 
       def all
-        return {}
+        {}
       end
 
       private
 
       def toggle_env_key(toggle_id)
-        return "TOGLS_#{toggle_id.to_s.upcase}"
+        "TOGLS_#{toggle_id.to_s.upcase}"
       end
     end
   end

data/lib/togls/toggle_repository_drivers/in_memory_driver.rb

@@ -1,20 +1,33 @@
+require 'thread'
+
 module Togls
   module ToggleRepositoryDrivers
+    # Toggle Repositoy In-Memory Driver
+    #
+    # The Toggle Repository In-Memory Driver provides the interface to store and
+    # retrieve toggles from the in-memory store.
     class InMemoryDriver
       def initialize
         @toggles = {}
+        @toggles_lock = Mutex.new
       end
 
       def store(toggle_id, toggle_data)
-        @toggles[toggle_id] = toggle_data
+        @toggles_lock.synchronize do
+          @toggles[toggle_id] = toggle_data
+        end
       end
 
       def get(toggle_id)
-        @toggles[toggle_id]
+        @toggles_lock.synchronize do
+          @toggles[toggle_id]
+        end
       end
 
       def all
-        @toggles
+        @toggles_lock.synchronize do
+          @toggles
+        end
       end
     end
   end

data/lib/togls/toggle_repository_drivers.rb

@@ -1,5 +1,8 @@
 module Togls
+  # Toggle Repository Drivers
+  #
+  # Simply an organizational container for the Toggle Repository drivers
+  # provided by Togls.
   module ToggleRepositoryDrivers
-
   end
 end

data/lib/togls/toggler.rb

@@ -1,4 +1,8 @@
 module Togls
+  # Toggle Toggler
+  #
+  # The Toggle Toggler provides the convenience interface of being able to
+  # toggle a feature on/off via the `on` or `off` methods respectively.
   class Toggler
     def initialize(toggle_repository, toggle)
       @toggle_repository = toggle_repository
@@ -6,9 +10,7 @@ module Togls
     end
 
     def on(rule = nil)
-      if rule.nil?
-        rule = Togls::Rules::Boolean.new(true)
-      end
+      rule = Togls::Rules::Boolean.new(true) if rule.nil?
       @toggle.rule = rule
       @toggle_repository.store(@toggle)
       @toggle

data/lib/togls/version.rb

@@ -1,3 +1,3 @@
 module Togls
-  VERSION = "2.1.1"
+  VERSION = '2.2.0'.freeze
 end

data/lib/togls.rb

@@ -1,51 +1,31 @@
-require "togls/version"
-require "togls/errors"
-require "togls/helpers"
-require "togls/toggle_repository_drivers"
-require "togls/toggle_repository_drivers/in_memory_driver"
-require "togls/toggle_repository_drivers/env_override_driver"
-require "togls/feature_repository_drivers"
-require "togls/feature_repository_drivers/in_memory_driver"
-require "togls/rule_repository_drivers"
-require "togls/rule_repository_drivers/in_memory_driver"
-require "togls/toggler"
-require "togls/feature_toggle_registry"
-require "togls/feature_repository"
-require "togls/rule_repository"
-require "togls/toggle_repository"
-require "togls/feature"
-require "togls/toggle"
-require "togls/null_toggle"
-require "togls/rule"
-require "togls/rules"
-require "logger"
+require 'togls/version'
+require 'togls/errors'
+require 'togls/helpers'
+require 'togls/toggle_repository_drivers'
+require 'togls/toggle_repository_drivers/in_memory_driver'
+require 'togls/toggle_repository_drivers/env_override_driver'
+require 'togls/feature_repository_drivers'
+require 'togls/feature_repository_drivers/in_memory_driver'
+require 'togls/rule_repository_drivers'
+require 'togls/rule_repository_drivers/in_memory_driver'
+require 'togls/toggler'
+require 'togls/feature_toggle_registry'
+require 'togls/test_toggle_registry'
+require 'togls/feature_repository'
+require 'togls/rule_repository'
+require 'togls/toggle_repository'
+require 'togls/feature'
+require 'togls/toggle'
+require 'togls/null_toggle'
+require 'togls/rule'
+require 'togls/rules'
+require 'logger'
+require 'togls/release_toggle_registry_manager'
 
+# Togls
+#
+# Togls is the primary interface to the out of the box toggle registry. It is
+# the namespace the DSL is exposed under.
 module Togls
-  def self.features(&block)
-    if @feature_toggle_registry.nil?
-      @feature_toggle_registry = FeatureToggleRegistry.new
-    end
-
-    if block
-      @feature_toggle_registry.expand(&block)
-    end
-
-    return @feature_toggle_registry
-  end
-
-  def self.features=(feature_toggle_registry)
-    @feature_toggle_registry = feature_toggle_registry
-  end
-  
-  def self.feature(key)
-    if @feature_toggle_registry.nil?
-      @feature_toggle_registry = FeatureToggleRegistry.new
-    end
-
-    return @feature_toggle_registry.get(key)
-  end
-
-  def self.logger
-    @logger ||= Logger.new(STDOUT)
-  end
+  include ReleaseToggleRegistryManager
 end

data/togls.gemspec

@@ -4,23 +4,29 @@ $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 require 'togls/version'
 
 Gem::Specification.new do |spec|
-  spec.name          = "togls"
+  spec.name          = 'togls'
   spec.version       = Togls::VERSION
-  spec.authors       = ["Brian Miller", "Andrew DePonte", "Ryan Hedges"]
-  spec.email         = ["brimil01@gmail.com", "cyphactor@gmail.com", "ryanhedges@gmail.com"]
+  spec.authors       = ['Brian Miller', 'Andrew DePonte', 'Ryan Hedges']
+  spec.email         = ['brimil01@gmail.com', 'cyphactor@gmail.com',
+                        'ryanhedges@gmail.com']
 
-  spec.summary       = %q{An ultra light weight yet ridiculously powerful ruby feature toggle gem.}
-  spec.description   = %q{An ultra light weight yet ridiculously powerful ruby feature toggle gem that supports the concept of release toggles and business toggles.}
-  spec.homepage      = "http://github.com/codebreakdown/togls"
-  spec.license       = "MIT"
+  spec.summary       = 'An ultra light weight yet ridiculously powerful' \
+                       'ruby feature toggle gem.'
+  spec.description   = 'An ultra light weight yet ridiculously powerful' \
+                       ' ruby feature toggle gem that supports the concept' \
+                       ' of release toggles and business toggles.'
+  spec.homepage      = 'http://github.com/codebreakdown/togls'
+  spec.license       = 'MIT'
 
-  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
-  spec.bindir        = "exe"
+  spec.files = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  spec.bindir        = 'exe'
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
-  spec.require_paths = ["lib"]
+  spec.require_paths = ['lib']
 
-  spec.add_development_dependency "bundler", "~> 1.9"
-  spec.add_development_dependency "rake", "~> 10.0"
-  spec.add_development_dependency "rspec", "~> 3.2"
-  spec.add_development_dependency "pry", "~> 0.10"
+  spec.add_development_dependency 'bundler', '~> 1.9'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'rspec', '~> 3.2'
+  spec.add_development_dependency 'pry', '~> 0.10'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: togls
 version: !ruby/object:Gem::Version
-  version: 2.1.1
+  version: 2.2.0
 platform: ruby
 authors:
 - Brian Miller
@@ -10,7 +10,7 @@ authors:
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2015-12-14 00:00:00.000000000 Z
+date: 2016-03-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -83,8 +83,9 @@ files:
 - ".rspec"
 - ".ruby-version"
 - ".travis.yml"
+- CHANGELOG.md
 - CODE_OF_CONDUCT.md
-- ChangeLog.md
+- DEVELOPMENT.md
 - Gemfile
 - LICENSE.txt
 - README.md
@@ -102,6 +103,7 @@ files:
 - lib/togls/feature_toggle_registry.rb
 - lib/togls/helpers.rb
 - lib/togls/null_toggle.rb
+- lib/togls/release_toggle_registry_manager.rb
 - lib/togls/rule.rb
 - lib/togls/rule_repository.rb
 - lib/togls/rule_repository_drivers.rb
@@ -109,6 +111,7 @@ files:
 - lib/togls/rules.rb
 - lib/togls/rules/boolean.rb
 - lib/togls/rules/group.rb
+- lib/togls/test_toggle_registry.rb
 - lib/togls/toggle.rb
 - lib/togls/toggle_repository.rb
 - lib/togls/toggle_repository_drivers.rb
@@ -137,8 +140,9 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.4.5.1
+rubygems_version: 2.5.1
 signing_key: 
 specification_version: 4
-summary: An ultra light weight yet ridiculously powerful ruby feature toggle gem.
+summary: An ultra light weight yet ridiculously powerfulruby feature toggle gem.
 test_files: []
+has_rdoc: