In addition to running the django app using
./manage.py runserver, you can run
the kumascript service to enable wiki templates processing:
...and celery to enable background task processing (such as sending
the e-mail notifications).
Note that, before running the kumascript, you need to install the node.js
npm install fibers.
You can log into the wiki using Persona or via the django admin interface.
If you use the admin interface, you can log in as the user you created during installation
or on the vagrant VM use login
admin with password
Set up permissions
Some features are only available to privileged users. To manage permissions use the Auth -> Users section of the django admin interface.
Hacking on bleeding edge features
To hack on the features not yet ready for production you have to enable them first.
Enable kumawiki in waffle
The Kuma wiki is disabled by default using django-waffle. To test out the wiki,
open the django admin interface (
http://.../admin/) and add a
in the Waffle section.
Note that features disabled by a flag will show up as a 404 error.
Kuma uses a separate nodejs-based service to process templates in wiki pages. Its
use is disabled by default, to enable: open the django admin interface and in the
Constance section change the value of
KUMASCRIPT_TIMEOUT parameter to a positive
value (such as
Running the Tests
A great way to check that everything really is working is to run the test suite.
If you're not using the vagrant VM, you'll need to add an extra grant in MySQL for your database user:
GRANT ALL ON test_NAME.* TO USER@localhost;
USER are the same as the values in your database
The test suite will create and use this database, to keep any data in your development database safe from tests.
Running the test suite is easy:
./manage.py test -s --noinput --logging-clear-handlers
Note that this will try (and fail) to run tests that depend on apps disabled
INSTALLED_APPS. You should run a subset of tests specified in
scripts/build.sh, at the bottom of the script.
When using the vagrant VM you must run the tests from the root folder, not from
(cd / && /vagrant/manage.py test ...)
For more information, see the test documentation.
If you're changing Kumascript, be sure to run its tests too. See https://github.com/mozilla/kumascript