determinator 0.11.0 → 0.11.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: e34898ef5ebd55998c28389b7644266fff00ca90
-  data.tar.gz: 01497458ea7daf49b59fb70c9214e7a2ae4c14cf
+  metadata.gz: d743c707c8d4b9e9e28c122aee5bd965ab3e097d
+  data.tar.gz: 540858ec639b34a39ceeef760ee51831f4c5a4a3
 SHA512:
-  metadata.gz: 8ec544cbdd744dc830e2432ee98af864361427ea543883b4db6227d72fcdf61ab2345bba6abd36df5abccacd67f99f2f4524a85338e5eea8fac5dbca32f2afe5
-  data.tar.gz: c68d088da9eba87eba25e3ecc89ae20122801a9be93c183c18c96c2e4b71b0081fc2d2e1b4c450400dd8945d4f1f54c47b3c00a32f60ad31af04a8d7da6b5b22
+  metadata.gz: 14391fb80975ee14cea5982fb345507794c5c07824f750bbc972b21dd847df5872ecbb054842fe8ceea42944c2aa7f2e696cb8d176dc904a03ff77ff150f2b45
+  data.tar.gz: 6819a9318fbce45ff3b096299d104872ad16b3cfb267277050ea3480423ba180f3881484b6b1fd5a2c7ab78d424e43fd8b3690057d7962405283dcde85f31027

data/CHANGELOG.md

@@ -1,3 +1,8 @@
+# v0.11.1 (2017-10-27)
+
+Feature:
+- Allows the use of example-scoped variables for outcomes and constraints in `RSpec::Determinator`'s mocks. (#36)
+
 # v0.11.0 (2017-10-13)
 
 Bug fix:

data/README.md

@@ -43,6 +43,8 @@ variant = determinator.which_variant(
 )
 ```
 
+Writing tests? Check out the [Local development](docs/local_development.md) docs to see examples of `RSpec::Determinator` to help you mock your Feature Flags and Experiments.
+
 ## Installation
 
 Determinator requires your application to be subscribed to the a `features` topic via Routemaster.

data/docs/local_development.md

@@ -15,14 +15,18 @@ RSpec.describe YourClass, :determinator_support do
     # This allows testing of the experiment being in a specific variant
     forced_determination(:experiment_name, 'variant_a')
 
-    it "should respond in a way that is defined by variant_a"
+    it "should respond in a way that is defined by variant_a" do
+      # … etc
+    end
   end
 
   context "when the actor is not in the experiment" do
     # This allows testing of the experiment being off
     forced_determination(:experiment_name, false)
 
-    it "should respond in a way that is defined by being out of the experiment"
+    it "should respond in a way that is defined by being out of the experiment" do
+      # … etc
+    end
   end
 
   context "when the actor is not from France" do
@@ -30,7 +34,18 @@ RSpec.describe YourClass, :determinator_support do
     # This allows testing of target group constraint functionality
     forced_determination(:experiment_name, 'variant_b', only_for: { country: 'fr' })
 
-    it "should respond in a way that is defined by being out of the experiment"
+    it "should respond in a way that is defined by being out of the experiment" do
+      # … etc
+    end
+  end
+
+  context "when the constraints are defined dynamically" do
+    forced_determination(:experiment_name, 'variant_b', only_for: constraints)
+    let(:constraints) { { employee: true } }
+
+    it "should respond in a way that shows employees the experiment" do
+      # … etc
+    end
   end
 
   context "when the actor has a specified id" do
@@ -38,11 +53,14 @@ RSpec.describe YourClass, :determinator_support do
     # This allows testing of override functionality
     forced_determination(:experiment_name, 'variant_b', only_for: { id: '123' })
 
-    it "should respond in a way that is defined by variant_b"
-  end
+    it "should respond in a way that is defined by variant_b" do
+      # … etc
+    end
 end
 ```
 
+Note that you can use Symbols for either the constraint declaration (`only_for`) or the outcome declaration and that variable or method will be called and the result used for that value. This is particularly helpful for examples which use the `let` scope declarations for cleaner tests.
+
 ## Fake Florence for local execution
 
 [Fake Florence](https://github.com/deliveroo/fake_florence) is a command line utility which operates a determinator compatible server and provides tooling for easy editing of feature flags and experiments.

data/lib/determinator/version.rb

@@ -1,3 +1,3 @@
 module Determinator
-  VERSION = '0.11.0'
+  VERSION = '0.11.1'
 end

data/lib/rspec/determinator.rb

@@ -12,11 +12,23 @@ module RSpec
     end
 
     module DSL
-      def forced_determination(name, result, only_for: {})
+      # Ensure that for the duration of the example all determinations made for the given experiment or feature flag
+      # will have the given outcome (but only if the constraints specified are met exactly).
+      #
+      # If `outcome` or `only_for` are Symbols then the example-scoped variable of that name will be referenced (ie. those
+      # variables created by `let` declarations)
+      #
+      # @params name [#to_s] The name of the Feature Flag or Experiment to mock
+      # @params outcome [Boolean,String,Symbol] The outcome which should be supplied. Will look up an example variable if a Symbol is given.
+      # @params :only_for [Hash,Symbol] The constraints that must be matched exactly in order for the determination to be applied.
+      def forced_determination(name, outcome, only_for: {})
         before do
+          outcome = send(outcome) if outcome.is_a?(Symbol)
+          only_for = send(only_for) if only_for.is_a?(Symbol)
+
           fake_determinator.mock_result(
             name,
-            result,
+            outcome,
             only_for: only_for
           )
         end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: determinator
 version: !ruby/object:Gem::Version
-  version: 0.11.0
+  version: 0.11.1
 platform: ruby
 authors:
 - JP Hastings-Spital
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2017-10-13 00:00:00.000000000 Z
+date: 2017-10-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: routemaster-drain