Feature Toggle¶
Feature Toggle is a simple Django app based on the behavioural pattern Feature Toggle proposed by Martin Fowler.
Quick links¶
Quick start¶
Install the package
pip install django-feature-toggleAdd “feature_toggle” to your INSTALLED_APPS setting like this:
INSTALLED_APPS = [ ... 'feature_toggle', ]
Run
python manage.py migrateto create the models required feature_toggle.Start your app to use the feature_toggle.
Quick Setup¶
For people intrested in contributing:
- Make a virtual environment
- run
python setup.py installorpython3 setup.py install - run
pip install -r requirements.txtorpip3 install -r requirements.txt - Make your changes and run tests by doing steps
5and6 git checkout py2_django_appand runpython manage.py testmake sure you have python 2 in your environmentgit checkout py3_django_appand runpython3 manage.py testmake sure you have python 3 in your environment5and6will be mitigated in the near future by tox or by using travis.
Generating Docs¶
Handled by: https://readthedocs.org/projects/django-feature-toggle
Legacy
1. cd to docs\
2. run make custom-gh-pages
3. The current state of docs is a mix of gh-pages and wiki
4. Docs are generated using sphinx. Generates files read from index.rst to _build directory.
5. make custom-gh-pages custom command copies _build to gh-pages directory and commits it which is used by github docs.