[](https://github.com/switchboardpy/switchboard/actions/workflows/main.yml)
[](https://codecov.io/gh/switchboardpy/switchboard)
Switchboard
===========
Switchboard is a Python WSGI app that makes it easy to [toggle
features](https://en.wikipedia.org/wiki/Feature_toggle) in
a variety of Python web frameworks. Created to enable
[A/B](https://www.optimizely.com/optimization-glossary/ab-testing/) and [user
testing](https://www.experienceux.co.uk/faqs/what-is-usability-testing/)
at [SourceForge](https://sourceforge.net/), 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](http://switchboard.readthedocs.io/).
## Getting Started
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](#development) section.
### Installing
Install Switchboard and its dependencies using pip:
```
pip install switchboard
```
### Setup
Next, embed Switchboard and its admin UI within the application.
Framework-specific details can be found in [Switchboard's
documentation](http://switchboard.readthedocs.io/en/stable/user-documentation.html#installation).
### Using Switches
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](http://switchboard.readthedocs.io/en/stable/user-documentation.html#using-switches).
## Development
These instructions cover setting Switchboard up locally for development and
testing purposes. See [Getting Started](#getting-started) for notes on how to
use Switchboard within a web application.
### Prerequisites
* Virtualenv: `$ sudo easy_install virtualenv`
### Bootstrapping
1. Make a virtualenv workspace: `$ virtualenv --no-site-packages .venv`
1. Activate the virtualenv: `$ source .venv/bin/activate`
1. Install all dependencies: `$ make install`
### Running the Example App
Switchboard includes an
[example](https://github.com/switchboardpy/switchboard/blob/master/example/server.py)
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](https://www.fullstackpython.com/bottle.html)-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.
### Running Tests
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](https://www.mozilla.org/en-US/firefox/new/) and
[geckodriver](https://github.com/mozilla/geckodriver):
```
$ npm install -g geckodriver
```
To run the functional tests:
```
$ make functional-test
```
### Releasing
To distribute a new release of Switchboard:
1. Update the version in `setup.py`, following [Semantic
Versioning](http://semver.org).
1. Cut the release:
```
$ make release
```
### Versioning
We use [Semantic Versioning](http://semver.org/) for versioning. For the
versions available, see the [tags on this
repository](https://github.com/switchboardpy/switchboard/tags).
## Contributing
Please read [CONTRIBUTING.md](CONTRIBUTING.md) for details on our code of
conduct, and the process for submitting pull requests to us.
## Authors
* **Kyle Adams** - *Initial work* - [kadams54](https://github.com/kadams54)
See also the list of
[contributors](https://github.com/switchboardpy/switchboard/contributors) who
participated in this project.
## License
This project is licensed under the Apache License - see the [LICENSE](LICENSE)
file for details.
## Acknowledgments
Switchboard began life as a port of [Disqus'](https://disqus.github.io/)
[Gargoyle](https://github.com/disqus/gargoyle), a feature flipper
for [Django](https://www.djangoproject.com/).
[David Cramer's](https://twitter.com/zeeg) [Pycon](https://us.pycon.org/2018/)
lightning talk on Gargoyle had me drooling for that same feature flipping fun in
non-Django apps.
Raw data
{
"_id": null,
"home_page": "https://github.com/switchboardpy/switchboard/",
"name": "switchboard",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "switches feature flipper pyramid pylons turbogears",
"author": "Kyle Adams",
"author_email": "kadams54@users.noreply.github.com",
"download_url": "https://files.pythonhosted.org/packages/07/f2/04aa4d25dd709cfb3c9d6f4abbd4211b6747a7d3c7fbb0f78542dfbba645/switchboard-1.6.8.tar.gz",
"platform": null,
"description": "[](https://github.com/switchboardpy/switchboard/actions/workflows/main.yml)\n[](https://codecov.io/gh/switchboardpy/switchboard)\n\n\nSwitchboard\n===========\n\nSwitchboard is a Python WSGI app that makes it easy to [toggle\nfeatures](https://en.wikipedia.org/wiki/Feature_toggle) in\na variety of Python web frameworks. Created to enable\n[A/B](https://www.optimizely.com/optimization-glossary/ab-testing/) and [user\ntesting](https://www.experienceux.co.uk/faqs/what-is-usability-testing/)\nat [SourceForge](https://sourceforge.net/), it features an easy-to-use admin\ndashboard with powerful conditions for activating a particular feature.\n\n\n\nWhat follows is an abbreviated version of [Switchboard's full\ndocumentation](http://switchboard.readthedocs.io/).\n\n## Getting Started\n\nWant to use Switchboard in your application? Keep reading. Interested in\ndeveloping on Switchboard or running a small example locally? Take a\nlook at the [Development](#development) section.\n\n### Installing\n\nInstall Switchboard and its dependencies using pip:\n\n```\npip install switchboard\n```\n\n### Setup\n\nNext, embed Switchboard and its admin UI within the application.\nFramework-specific details can be found in [Switchboard's\ndocumentation](http://switchboard.readthedocs.io/en/stable/user-documentation.html#installation).\n\n### Using Switches\n\nSwitchboard's basic unit is a switch. Every switch has a unique key\nassociated with it and is either active (on) or inactive (off), so using\nit in code is simple:\n\n```\n>>> from switchboard import operator\n>>> operator.is_active('foo')\nFalse\n```\n\nIn this case we checked to see if the \"foo\" switch was active. By\ndefault, Switchboard will auto-create any switches that don't already\nexist, such as \"foo\". Auto-created switches default to an inactive\nstate. This just scratches the surface; [there's so much more that a switch can\ndo](http://switchboard.readthedocs.io/en/stable/user-documentation.html#using-switches).\n\n## Development\n\nThese instructions cover setting Switchboard up locally for development and\ntesting purposes. See [Getting Started](#getting-started) for notes on how to\nuse Switchboard within a web application.\n\n### Prerequisites\n\n* Virtualenv: `$ sudo easy_install virtualenv`\n\n### Bootstrapping\n\n1. Make a virtualenv workspace: `$ virtualenv --no-site-packages .venv`\n1. Activate the virtualenv: `$ source .venv/bin/activate`\n1. Install all dependencies: `$ make install`\n\n### Running the Example App\n\nSwitchboard includes an\n[example](https://github.com/switchboardpy/switchboard/blob/master/example/server.py)\napplication, which is handy both for doing development and for taking it for a\ntest drive in a very simple environment. It also provides an example of\nsetting Switchboard up to run within a\n[Bottle](https://www.fullstackpython.com/bottle.html)-based application.\n\nTo run:\n\n```\n$ make example\n```\n\nAt this point a very simple application is now running at\n`http://localhost:8080` and the admin UI is accessible at\n`http://localhost:8080/_switchboard/`. The application has one switch\n(`example`) and outputs text that tells you whether the switch is active.\n\n### Running Tests\n\nSwitchboard includes both unit tests and functional tests of the admin\ndashboard, using the example application.\n\nTo run the unit tests:\n\n```\n$ make test\n```\n\nThe functional test requires both an updated\n[Firefox](https://www.mozilla.org/en-US/firefox/new/) and\n[geckodriver](https://github.com/mozilla/geckodriver):\n\n```\n$ npm install -g geckodriver\n```\n\nTo run the functional tests:\n\n```\n$ make functional-test\n```\n\n### Releasing\n\nTo distribute a new release of Switchboard:\n\n1. Update the version in `setup.py`, following [Semantic\n Versioning](http://semver.org).\n1. Cut the release:\n```\n$ make release\n```\n\n### Versioning\n\nWe use [Semantic Versioning](http://semver.org/) for versioning. For the\nversions available, see the [tags on this\nrepository](https://github.com/switchboardpy/switchboard/tags).\n\n\n## Contributing\n\nPlease read [CONTRIBUTING.md](CONTRIBUTING.md) for details on our code of\nconduct, and the process for submitting pull requests to us.\n\n## Authors\n\n* **Kyle Adams** - *Initial work* - [kadams54](https://github.com/kadams54)\n\nSee also the list of\n[contributors](https://github.com/switchboardpy/switchboard/contributors) who\nparticipated in this project.\n\n## License\n\nThis project is licensed under the Apache License - see the [LICENSE](LICENSE)\nfile for details.\n\n## Acknowledgments\n\nSwitchboard began life as a port of [Disqus'](https://disqus.github.io/)\n[Gargoyle](https://github.com/disqus/gargoyle), a feature flipper\nfor [Django](https://www.djangoproject.com/).\n[David Cramer's](https://twitter.com/zeeg) [Pycon](https://us.pycon.org/2018/)\nlightning talk on Gargoyle had me drooling for that same feature flipping fun in\nnon-Django apps.\n",
"bugtrack_url": null,
"license": "Apache License",
"summary": "Feature flipper for Pyramid, Pylons, or TurboGears apps.",
"version": "1.6.8",
"project_urls": {
"Download": "https://github.com/switchboardpy/switchboard/releases",
"Homepage": "https://github.com/switchboardpy/switchboard/"
},
"split_keywords": [
"switches",
"feature",
"flipper",
"pyramid",
"pylons",
"turbogears"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "3df509f7c957413369123bb0653ad3977aa3a1900112a009f38214e1f1dca46e",
"md5": "bc2391ec680c23c904238f76ebecbf53",
"sha256": "e08d55e2146b57745914c7e6495d777d4b467ca4d702d02eacb604258e50d894"
},
"downloads": -1,
"filename": "switchboard-1.6.8-py3-none-any.whl",
"has_sig": false,
"md5_digest": "bc2391ec680c23c904238f76ebecbf53",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 60377,
"upload_time": "2025-01-06T22:54:28",
"upload_time_iso_8601": "2025-01-06T22:54:28.488038Z",
"url": "https://files.pythonhosted.org/packages/3d/f5/09f7c957413369123bb0653ad3977aa3a1900112a009f38214e1f1dca46e/switchboard-1.6.8-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "07f204aa4d25dd709cfb3c9d6f4abbd4211b6747a7d3c7fbb0f78542dfbba645",
"md5": "fc5f40ea1a72ef9398d9841ab7a76de4",
"sha256": "08c3ec33454c4847fa8f65de35385c409c8f7ab28a66bff80abdff2c126ce487"
},
"downloads": -1,
"filename": "switchboard-1.6.8.tar.gz",
"has_sig": false,
"md5_digest": "fc5f40ea1a72ef9398d9841ab7a76de4",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 52925,
"upload_time": "2025-01-06T22:54:29",
"upload_time_iso_8601": "2025-01-06T22:54:29.666033Z",
"url": "https://files.pythonhosted.org/packages/07/f2/04aa4d25dd709cfb3c9d6f4abbd4211b6747a7d3c7fbb0f78542dfbba645/switchboard-1.6.8.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-06 22:54:29",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "switchboardpy",
"github_project": "switchboard",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"tox": true,
"lcname": "switchboard"
}
JSON
