Introduction

Jacquard is a server for powering split tests.

Installation

Jacquard can be installed from PyPI:

pip install jacquard-split

Configuration

Example configuration:

# Jacquard configuration.

# Storage configuration. Defaults here to storing to a file.
[storage]
engine = file
url = file:jacquard.db

# If you wanted to connect to Redis, the storage section would look something
# more like this:
#
# engine = redis
# url = redis://redis.example.com:6379/

# User directory source. By default this is configured to use the dummy
# directory (effectively, not to use a directory).
[directory]
engine = dummy

# An example of using a custom directory engine MyDirectory from
# /etc/jacquard/plugins/my_directory.py:
#
# [plugins:directory_engines]
# my_directory_engine = my_directory:MyDirectory
#
# [directory]
# engine = my_directory_engine

# Any custom paths to add to the Python interpreter. By default this is the
# normal system Python path plus /etc/jacquard/plugins.
#
# Each path entry gets a descriptive key.
#
# [paths]
# my_extra_path = /usr/share/my-plugins

Running the service

The command line control tool is available using jacquard. To actually run the server, one must use a WSGI server such as waitress or gunicorn.

For waitress:

pip install waitress
waitress-serve --listen='[::1]:1212' jacquard.wsgi:app

For gunicorn:

pip install gunicorn
gunicorn -b '[::1]:1212' jacquard.wsgi:app