molasses 0.3.1

Initialization

Start by initializing the client with an APIKey. This begins the polling for any feature updates. The updates happen every 15 seconds.

from molasses import MolassesClient

client = MolassesClient("test_key")

If you decide not to track analytics events (experiment started, experiment success) you can turn them off by setting the send_events field to False

client = MolassesClient("test_key",  send_events=False)

Check if feature is active

You can call is_active with the key name and optionally a user’s information. The id field is used to determine whether a user is part of a percentage of users. If you have other constraints based on user params you can pass those in the params field.

client.is_active("FOO_TEST", {
  "id":"foo",
  "params":{
    "isBetaUser":"false",
    "isScaredUser":"false"
   }
})

You can check if a feature is active for a user who is anonymous by just calling is_active with the key. You won’t be able to do percentage roll outs or track that user’s behavior.

client.is_active("TEST_FEATURE_FOR_USER")

Experiments

To track an analytics events called the track method.

client.track("Button Clicked",{
   "id":"foo",
   "params":{
     "isBetaUser":"false",
     "isScaredUser":"false"
    }
 },
 {
   "version": "v2.3.0"
})

To track whether an experiment was successful you can call experiment_started. experiment_started takes the feature’s name, any additional parameters for the event and the user.

client.experiment_started("GOOGLE_SSO",{
   "id":"foo",
   "params":{
     "isBetaUser":"false",
     "isScaredUser":"false"
    }
 },
 {
   "version": "v2.3.0"
})

To track whether an experiment was successful you can call experiment_success. experiment_success takes the feature’s name, any additional parameters for the event and the user.

client.experiment_success("GOOGLE_SSO",{
   "id":"foo",
   "params":{
     "isBetaUser":"false",
     "isScaredUser":"false"
    }
 },
 {
   "version": "v2.3.0"
})