Samples

Samples are on a given percentage of the time. They do not require a request object and can be used in other contexts, such as management commands and tasks.

Warning

Sample values are random: if you check a Sample twice, there is no guarantee you will get the same value both times. If you need to rely on the value more than once, you should store it in a variable.

# YES
foo_on = sample_is_active('foo')
if foo_on:
    pass

# ...later...
if foo_on:
    pass

# NO!
if sample_is_active('foo'):
    pass

# ...later...
if sample_is_active('foo'):  # INDEPENDENT of the previous check
    pass

Sample Attributes

Samples can be administered through the Django admin site or the command line. They have the following attributes:

Name:The name of the Sample. Percent:A number from 0.0 to 100.0 that determines how often the Sample will be active. Note:Describe where the Sample is used.