this_feature 0.4.1 → 0.5.0

data/docs/flipper.md

@@ -0,0 +1,41 @@
+# ThisFeature - Flipper Adapter
+
+## Installation
+
+```ruby
+gem 'this_feature-adapters-flipper
+```
+
+## Configuration
+
+```ruby
+# config/initializers/this_feature.rb
+require 'this_feature'
+require 'this_feature/adapters/flipper'
+
+ThisFeature.configure do |config|
+  adapter = ThisFeature::Adapters::Flipper.new
+  config.adapters = [adapter]
+  config.default_adapter = adapter
+end
+```
+
+An existing Flipper client can be optionally passed to the initializer:
+
+```
+ThisFeature::Adapters::Flipper.new(client: my_existing_client)
+```
+
+
+## API
+
+The Flipper adapter supports the public API of `ThisFeature`.
+
+The `context` argument is supported, but not `data`.
+
+Read the following notes as well:
+
+- **on?** / **off?**: Under the hood, calls `flipper_id` method on the `context`, if one was given.
+- **control?** / **present?**: Flipper doesn't have a concept of "control", so we just implement it as `!present?`
+
+It is possible to support `on!` and `off!` from Flipper but that's not implemented yet.

data/docs/memory.md

@@ -0,0 +1,65 @@
+# ThisFeature - Memory Adapter
+
+## Installation
+
+This adapter is included with the core gem:
+
+```ruby
+gem 'this_feature
+```
+
+## Configuration
+
+```ruby
+# config/initializers/this_feature.rb
+require 'this_feature'
+require 'this_feature/adapters/memory'
+
+ThisFeature.configure do |config|
+  adapter = ThisFeature::Adapters::Memory.new
+  config.adapters = [adapter]
+  config.default_adapter = adapter
+end
+```
+
+The initializer takes an optional `context_key_method` argument. This is only relevant when using `context` - 
+it specifies a method name which should be called on the context object to determine its identity.
+For example:
+
+```
+# Say you have this method which you want to use as the "identity" of a context object:
+module FeatureFlaggable
+  def this_feature_id
+    "#{self.class}-#{self.id}"
+  end
+end
+
+# Then you would refer to it like so in the initializer:
+ThisFeature::Adapters::Memory.new(context_key_method: :this_feature_id)
+```
+
+If this option is ommitted, then the context object uses its `self` as its "identity".
+
+## API
+
+The Memory adapter supports the public API of `ThisFeature`.
+
+The `context` argument is supported, but not `data`.
+
+Read the following notes as well:
+
+- **on?** / **off?**: Under the hood, calls `flipper_id` method on the `context`, if one was given.
+
+- **control?** is not yet implemented
+
+We also support two additional methods here that aren't present on the main adapter yet:
+
+- **on!** / **off!**
+
+Usage example of these:
+
+```
+# If you have configured the in-memory adapter as the default
+ThisFeature.default_adapter.on!(:flag_name, context: user) # with context
+ThisFeature.default_adapter.off!(:flag_name)               # without context
+```

data/docs/writing_an_adapter.md

@@ -0,0 +1 @@
+todo

data/lib/this_feature.rb

@@ -34,4 +34,8 @@ class ThisFeature
   def self.adapters
     configuration.adapters
   end
+
+  def self.test_adapter
+    configuration.test_adapter
+  end
 end

data/lib/this_feature/adapters/base.rb

@@ -1,11 +1,6 @@
 class ThisFeature
   module Adapters
     class Base
-
-      def setup
-        raise UnimplementedError.new(self, __method__)
-      end
-
       def present?(flag_name)
         raise UnimplementedError.new(self, __method__)
       end

data/lib/this_feature/configuration.rb

@@ -1,7 +1,6 @@
-
 class ThisFeature
   class Configuration
-    attr_writer :adapters, :default_adapter
+    attr_writer :adapters, :default_adapter, :test_adapter
 
     def init
       validate_adapters!
@@ -20,5 +19,9 @@ class ThisFeature
     def default_adapter
       @default_adapter ||= adapters.first
     end
+
+    def test_adapter
+      @test_adapter ||= Adapters::Memory.new
+    end
   end
 end

data/lib/this_feature/version.rb

@@ -1,3 +1,3 @@
 class ThisFeature
-  VERSION = "0.4.1"
+  VERSION = "0.5.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: this_feature
 version: !ruby/object:Gem::Version
-  version: 0.4.1
+  version: 0.5.0
 platform: ruby
 authors:
 - Max Pleaner
-autorequire:
+autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-09-11 00:00:00.000000000 Z
+date: 2020-09-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -127,6 +127,11 @@ files:
 - Rakefile
 - bin/console
 - bin/setup
+- docs/flipper.html
+- docs/flipper.md
+- docs/memory.md
+- docs/splitio.md
+- docs/writing_an_adapter.md
 - lib/this_feature.rb
 - lib/this_feature/adapters.rb
 - lib/this_feature/adapters/base.rb
@@ -145,7 +150,7 @@ licenses: []
 metadata:
   homepage_uri: https://github.com/hoverinc/this_feature
   source_code_uri: https://github.com/hoverinc/this_feature
-post_install_message:
+post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -160,8 +165,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.2
-signing_key:
+rubygems_version: 3.0.3
+signing_key: 
 specification_version: 4
 summary: Feature flag control
 test_files: []