Venice - Multivariate Test Bed

A simple test bed for running multivariate tests. It only provides a way to query experiments and assigning users to a particular variant. You will need to use the manager throughout your code and manually provide the code for each of the variants.

Installation

npm install venice

Config

{
    "experiment-1": {
        "type": "variant",
        "variants": [
            "control",
            "variant-1"
        ]
    }
}

Usage

    var venice = require('venice');

    var definition = {
        "experiment-1": {
            "type": "variant",
            "variants": [
                "control",
                "variant-1"
            ]
        }
    };

    var manager = venice.init(definition);

    ...

    /** Alter the functionality for an experiment **/

    var experiment = manager.get('experiment-1');
    if (experiment && experiment.active()) {

        switch (experiment.variant()) {

            case 'control':
                console.log('control');
                break;

            case 'variant-1':
                console.log('variant-1');
                break;

        }

    }

The default init method will use cookies to persist the user's session. This makes it unsuitable for use in a CLI app. You can create your own session storage (e.g. in a database) and create an instance of the manager:

    /** Create an instance of the manager **/

    var session = {
        variant: function() {
            // query the database
        },
        setVariant: function() {
            // write to database
        }
    };

    var factory = new venice.Factory(session);

    var config = new venice.Config(factory);
    config.setDefintion(definition);

    var manager = new venice.Manager();
    manager.addConfig(config);