Frankenstein

A port of Ruby's scientist to help you refactor with confidence.

Usage

experiment = %Frankenstein.Experiment{
  name: :my_experiment,
  control: &original/0,
  candidate: &new/0
  # compare -> defaults to &Kernel.==/2
  # enabled? -> boolean for you to control if candidate should run
  # timeout -> timeout for the candidate function, raises Frankenstein.TimeoutError
}

Frankenstein.run(experiment)

Frankenstein always returns the control result, if enabled? is evaluated to true, Frankenstein runs the candidate in a separate process concurrently and results are reported with telemetry.

Frankenstein exposes :telemetry instrumentation for you to hook into:

• [:frankenstein, :experiment, :start] // %{experiment_name, match}
• [:frankenstein, :experiment, :stop] // %{experiment_name, match}
• [:frankenstein, :variant, :start] // %{experiment_name, variant_name}
• [:frankenstein, :variant, :stop] // %{experiment_name, variant_name}

Installation

If available in Hex, the package can be installed by adding frankenstein to your list of dependencies in mix.exs:

def deps do
  [
    {:frankenstein, "~> 0.1.0"}
  ]
end