Switchboard is a Python WSGI app that makes it easy to toggle features in a variety of Python web frameworks. Created to enable A/B and user testing at SourceForge, it features an easy-to-use admin dashboard with powerful conditions for activating a particular feature.
What follows is an abbreviated version of Switchboard's full documentation.
Want to use Switchboard in your application? Keep reading. Interested in developing on Switchboard or running a small example locally? Take a look at the Development section.
Install Switchboard and its dependencies using pip:
pip install switchboard
Next, embed Switchboard and its admin UI within the application. Framework-specific details can be found in Switchboard's documentation.
Switchboard's basic unit is a switch. Every switch has a unique key associated with it and is either active (on) or inactive (off), so using it in code is simple:
>>> from switchboard import operator
>>> operator.is_active('foo')
False
In this case we checked to see if the "foo" switch was active. By default, Switchboard will auto-create any switches that don't already exist, such as "foo". Auto-created switches default to an inactive state. This just scratches the surface; there's so much more that a switch can do.
These instructions cover setting Switchboard up locally for development and testing purposes. See Getting Started for notes on how to use Switchboard within a web application.
- Virtualenv:
$ sudo easy_install virtualenv
- Make a virtualenv workspace:
$ virtualenv --no-site-packages .venv - Activate the virtualenv:
$ source .venv/bin/activate - Install all dependencies:
$ make install
Switchboard includes an example application, which is handy both for doing development and for taking it for a test drive in a very simple environment. It also provides an example of setting Switchboard up to run within a Bottle-based application.
To run:
$ make example
At this point a very simple application is now running at
http://localhost:8080 and the admin UI is accessible at
http://localhost:8080/_switchboard/. The application has one switch
(example) and outputs text that tells you whether the switch is active.
Switchboard includes both unit tests and functional tests of the admin dashboard, using the example application.
To run the unit tests:
$ make test
The functional test requires both an updated Firefox and geckodriver:
$ npm install -g geckodriver
To run the functional tests:
$ make functional-test
To distribute a new release of Switchboard:
- Update the version in
setup.py, following Semantic Versioning. - Cut the release:
$ make release
We use Semantic Versioning for versioning. For the versions available, see the tags on this repository.
Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.
- Kyle Adams - Initial work - kadams54
See also the list of contributors who participated in this project.
This project is licensed under the Apache License - see the LICENSE file for details.
Switchboard began life as a port of Disqus' Gargoyle, a feature flipper for Django. David Cramer's Pycon lightning talk on Gargoyle had me drooling for that same feature flipping fun in non-Django apps.