Add hooks for experiment deletion and resetting.

README.mdown

@@ -247,6 +247,19 @@ def log_trial_complete(trial)
 end
 ```
 
+### Experiment Hooks
+
+You can assign a proc that will be called when an experiment is reset or deleted. You can use these hooks to call methods within your application to keep data related to experiments in sync with Split.
+
+For example:
+
+``` ruby
+Split.configure do |config|
+  config.on_experiment_reset  = proc{ |experiment| # Do something on reset }
+  config.on_experiment_delete = proc{ |experiment| # Do something else on delete }
+end
+```
+
 ## Web Interface
 
 Split comes with a Sinatra-based front end to get an overview of how your experiments are doing.

lib/split/configuration.rb

@@ -14,6 +14,8 @@ class Configuration
     attr_accessor :store_override
     attr_accessor :on_trial_choose
     attr_accessor :on_trial_complete
+    attr_accessor :on_experiment_reset
+    attr_accessor :on_experiment_delete
 
     attr_reader :experiments
 
@@ -161,6 +163,8 @@ def initialize
       @ignore_filter = proc{ |request| is_robot? || is_ignored_ip_address? }
       @db_failover = false
       @db_failover_on_db_error = proc{|error|} # e.g. use Rails logger here
+      @on_experiment_reset = proc{|experiment|}
+      @on_experiment_delete = proc{|experiment|}
       @db_failover_allow_parameter_override = false
       @allow_multiple_experiments = false
       @enabled = true

lib/split/experiment.rb

@@ -210,6 +210,7 @@ def resettable?
     def reset
       alternatives.each(&:reset)
       reset_winner
+      Split.configuration.on_experiment_reset.call(self)
       increment_version
     end
 
@@ -219,6 +220,7 @@ def delete
       Split.redis.srem(:experiments, name)
       Split.redis.del(name)
       delete_goals
+      Split.configuration.on_experiment_delete.call(self)
       increment_version
     end
 

spec/experiment_spec.rb

@@ -174,6 +174,11 @@ def alternative(color)
       experiment.delete
       experiment.version.should eql(1)
     end
+
+    it "should call the on_experiment_delete hook" do
+      expect(Split.configuration.on_experiment_delete).to receive(:call)
+      experiment.delete
+    end
   end
 
 
@@ -219,6 +224,11 @@ def alternative(color)
       experiment.reset
       experiment.version.should eql(1)
     end
+
+    it "should call the on_experiment_reset hook" do
+      expect(Split.configuration.on_experiment_reset).to receive(:call)
+      experiment.reset
+    end
   end
 
   describe 'algorithm' do