growthbook 1.1.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f5919b4bd1e6564233d0fb61f00f2fcc5fee175f3122a35e9815df47ebdaeb6f
-  data.tar.gz: 88bf0372e161e261a536fd8953f858e9f4ad60592a96cbfb8e3baa523414cbca
+  metadata.gz: 2d8ce0f8ecb79cd594b5b6e820410acb3abc3773c8a3012f8cf39df388d94acb
+  data.tar.gz: 0f9030d6c3db6fdcc7821e28fe18379967ed20aa88661d946ec67c56af3c6ef1
 SHA512:
-  metadata.gz: 771a1f4fd4eeb6acb92606e67677d65717e3b3a98de80528d2adef3cce17f183a6524af1da74cb09ff18d195a062dd1c882c208cb8dfeaf631603c54b7d128e9
-  data.tar.gz: 3b2386b97c64ea3609ad907005d90baec0a25e7b51d45bbd973490d66a204255d5a31d1d435da406cfcd8f3443a28bb8163e6f649af114999b847cbe822f2593
+  metadata.gz: 963c831c370739516b95dcecfb1ba321202a53ab053316f1e715df452b599fb0213b04355b5bd31d3f5c6c5b54100307f5ca2231321e4f04375a68774e8752c2
+  data.tar.gz: 4858df411e5cf01bf35d08e1ea77bf588f04e7d6b49d99d750f0280c0bc0513486604e574bf580b005c2d0eb703ce52ffe507221b8aa83e184d29123cacac7ed

data/lib/growthbook/context.rb

@@ -15,6 +15,9 @@ module Growthbook
     # @return [Growthbook::TrackingCallback] An object that responds to `on_experiment_viewed(GrowthBook::InlineExperiment, GrowthBook::InlineExperimentResult)`
     attr_accessor :listener
 
+    # @return [Growthbook::FeatureUsageCallback] An object that responds to `on_feature_usage(String, Growthbook::FeatureResult)`
+    attr_accessor :on_feature_usage
+
     # @return [Hash] Map of user attributes that are used to assign variations
     attr_reader :attributes
 
@@ -61,6 +64,8 @@ module Growthbook
           @qa_mode = value
         when :listener
           @listener = value
+        when :on_feature_usage
+          @on_feature_usage = value
         else
           warn("Unknown context option: #{key}")
         end
@@ -94,11 +99,11 @@ module Growthbook
 
     def eval_feature(key)
       # Forced in the context
-      return get_feature_result(@forced_features[key.to_s], 'override', nil, nil) if @forced_features.key?(key.to_s)
+      return get_feature_result(key.to_s, @forced_features[key.to_s], 'override', nil, nil) if @forced_features.key?(key.to_s)
 
       # Return if we can't find the feature definition
       feature = get_feature(key)
-      return get_feature_result(nil, 'unknownFeature', nil, nil) unless feature
+      return get_feature_result(key.to_s, nil, 'unknownFeature', nil, nil) unless feature
 
       feature.rules.each do |rule|
         # Targeting condition
@@ -120,7 +125,7 @@ module Growthbook
           )
           next unless included_in_rollout
 
-          return get_feature_result(rule.force, 'force', nil, nil)
+          return get_feature_result(key.to_s, rule.force, 'force', nil, nil)
         end
         # Experiment rule
         next unless rule.experiment?
@@ -132,11 +137,11 @@ module Growthbook
 
         next unless result.in_experiment && !result.passthrough
 
-        return get_feature_result(result.value, 'experiment', exp, result)
+        return get_feature_result(key.to_s, result.value, 'experiment', exp, result)
       end
 
       # Fallback
-      get_feature_result(feature.default_value.nil? ? nil : feature.default_value, 'defaultValue', nil, nil)
+      get_feature_result(key.to_s, feature.default_value.nil? ? nil : feature.default_value, 'defaultValue', nil, nil)
     end
 
     def run(exp)
@@ -285,8 +290,19 @@ module Growthbook
       result
     end
 
-    def get_feature_result(value, source, experiment, experiment_result)
-      Growthbook::FeatureResult.new(value, source, experiment, experiment_result)
+    def get_feature_result(key, value, source, experiment, experiment_result)
+      res = Growthbook::FeatureResult.new(value, source, experiment, experiment_result)
+
+      track_feature_usage(key, res)
+
+      res
+    end
+
+    def track_feature_usage(key, feature_result)
+      return unless on_feature_usage.respond_to?(:on_feature_usage)
+      return if feature_result.source == 'override'
+
+      on_feature_usage.on_feature_usage(key, feature_result)
     end
 
     def get_feature(key)

data/lib/growthbook/feature_usage_callback.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Growthbook
+  # Extendable class that can be used as the feature usage callback
+  class FeatureUsageCallback
+    def on_feature_usage(_feature_key, _result); end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: growthbook
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.2.0
 platform: ruby
 authors:
 - GrowthBook
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-06-16 00:00:00.000000000 Z
+date: 2023-07-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
@@ -94,6 +94,7 @@ files:
 - lib/growthbook/feature_repository.rb
 - lib/growthbook/feature_result.rb
 - lib/growthbook/feature_rule.rb
+- lib/growthbook/feature_usage_callback.rb
 - lib/growthbook/fnv.rb
 - lib/growthbook/inline_experiment.rb
 - lib/growthbook/inline_experiment_result.rb
@@ -119,7 +120,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.2
+rubygems_version: 3.4.10
 signing_key: 
 specification_version: 4
 summary: GrowthBook SDK for Ruby