easy_ab 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: be25942ed3b823b7bf8b4445eee642f884d6cff2
-  data.tar.gz: dc77331ec7b69a4a4c0f3cca37e3d7cd46b922bc
+  metadata.gz: a1eeea1cbf4338159b42eb100e86cf1bae045b7a
+  data.tar.gz: dbdb41940f2da5113a705c30bc290934219666b7
 SHA512:
-  metadata.gz: 780ccb7138c2e6d0671fe6d2b1eda79cd04b68e517c941e22ce4fab91a89b31a937297a0e5f103e947db5c6d3e23fcdd3f33b0262f890039a6d90118d2674920
-  data.tar.gz: 11c2df2ef9ab91699e7c52b05894aff91fcaeb273d82a4adccee60849a943824f8b6cd2e42323501d8ef6f33ff059b61b604da29563b0cfeb0c93b2420403822
+  metadata.gz: 4b2465ffa608c615f52c9f2a3c153323848d2a5d5c8871a906e33492ba927da27a6890b6c1baf524f72e02045907d67906f2619d36e78559e3720af7900f939d
+  data.tar.gz: 00525589553175a0feac4fc7cf4f2b1c7936885792009f08e82393f988638723c9d593b31db63f9ef1ed27bdaecd3ed72266928beddd51ecc7275f280bd74c6a

data/CHANGELOG.md

@@ -1,5 +1,11 @@
+# 0.2.0 (2017-08-15)
+* **API change**: If all rules failed, `ab_test` returns nil, instead of the first variant.
+
 # 0.1.0
 * Support winner
 
 # 0.0.3
-* Add new API `all_participated_experiments` to list current user's all participated experiments
+* Add new API `all_participated_experiments` to list current user's all participated experiments
+
+# 0.0.1
+* The first version :)

data/README.md

@@ -114,21 +114,39 @@ EasyAb.experiments do |experiment|
 end
 ```
 
-NOTICE: rules are executed in the order you defined in `config/initializers/easy_ab.rb`. If there are intersections among your rules, the former rule will be applied. For example:
+NOTICE: rules are executed in the order you defined in `config/initializers/easy_ab.rb`. If there exists logic overlap among your rules, the former rule will be applied. For example:
 
 ```ruby
+# config/initializers/easy_ab.rb
 EasyAb.experiments do |experiment|
   experiment.define :extra_vip_duration,
     variants: ['90', '30']
     rules: [
-      -> { current_user.id <= 20 },
-      -> { current_user.id > 10 }
+      -> { true },
+      -> { true }
     ]
 
-# Users with id between 11 to 20 matches both lambdas, will get variant '90'
+# view
+easy_ab(:extra_vip_duration) # => '90'
 ```
 
-Keep in mind that `ab_test()` helper always returns String. You have to handle the type conversion by yourself.
+If all rules are not passed, returns nil:
+
+```ruby
+# config/initializers/easy_ab.rb
+EasyAb.experiments do |experiment|
+  experiment.define :extra_vip_duration,
+    variants: ['90', '30']
+    rules: [
+      -> { false },
+      -> { false }
+    ]
+
+# view
+ab_test(:extra_vip_duration) # => nil
+```
+
+Keep in mind that `ab_test()` helper always returns String (or nil). You have to handle the type conversion by yourself.
 
 ```ruby
 # In controller

data/lib/easy_ab/experiment.rb

@@ -32,6 +32,7 @@ module EasyAb
         grouping.variant = options[:variant].to_s
       else
         grouping.variant ||= flexible_variant(options[:contexted_rules])
+        return nil if grouping.variant.nil?
       end
 
       if grouping.changed? && !options[:skip_save]
@@ -94,8 +95,9 @@ module EasyAb
       contexted_rules.each_with_index do |rule, i|
         return variants[i] if rule.call
       end
-      # If all rules not matched, apply the first variatn
-      variants.first
+
+      # If all rules not matched, return nil
+      nil
     end
 
     def weighted_variant

data/lib/easy_ab/version.rb

@@ -1,3 +1,3 @@
 module EasyAb
-  VERSION = '0.1.0'
+  VERSION = '0.2.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: easy_ab
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Gary Chu
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-08-09 00:00:00.000000000 Z
+date: 2017-08-15 00:00:00.000000000 Z
 dependencies: []
 description: 
 email: icarus4.chu@gmail.com