diff options
author | Aurélien Bompard <aurelien@bompard.org> | 2012-11-21 17:32:37 +0100 |
---|---|---|
committer | Aurélien Bompard <aurelien@bompard.org> | 2012-11-21 17:32:37 +0100 |
commit | 527086586d7752243f7574a1e2f395e996d4ecf9 (patch) | |
tree | ec4cc226ba79a1aa99b683939208c02f32537750 /doc/development.rst | |
parent | 179dd8ac917b04e9dcc6d978fe0464f66adafb72 (diff) | |
download | hyperkitty-527086586d7752243f7574a1e2f395e996d4ecf9.tar.gz hyperkitty-527086586d7752243f7574a1e2f395e996d4ecf9.tar.xz hyperkitty-527086586d7752243f7574a1e2f395e996d4ecf9.zip |
Prepare for release
Diffstat (limited to 'doc/development.rst')
-rw-r--r-- | doc/development.rst | 67 |
1 files changed, 67 insertions, 0 deletions
diff --git a/doc/development.rst b/doc/development.rst new file mode 100644 index 0000000..da8ddcd --- /dev/null +++ b/doc/development.rst @@ -0,0 +1,67 @@ +=========== +Development +=========== + + +Communication channels +====================== + +Hang out on IRC and ask questions on ``#mailman`` or join the mailing list +``hyperkitty-devel@lists.fedorahosted.org``. + + +Setting up Hyperkitty for development +===================================== + +The recommanded way to develop on HyperKitty is to use VirtualEnv. It will +create an isolated Python environment where you can add HyperKitty and its +dependencies without messing up your system Python install. + +First, create the virtualenv and activate it:: + + virtualenv venv_hk + source venv_hk/bin/activate + +Then download the components of HyperKitty:: + + git clone git://github.com/pypingou/kittystore.git + cd kittystore + python setup.py develop + cd .. + bzr branch bzr://bzr.fedorahosted.org/bzr/hyperkitty/hyperkitty + cd hyperkitty + python setup.py develop + cd .. + bzr branch bzr://bzr.fedorahosted.org/bzr/hyperkitty/hyperkitty_standalone + + +.. Setting up the databases + +.. include:: database.rst + + +Running HyperKitty +================== + +If you're coding on HyperKitty, you can use Django's integrated web server. +It can be run with the following command:: + + cd hyperkitty_standalone + python manage.py runserver + +.. warning:: + You should use the development server only locally. While it's possible to + make your site publicly available using the dev server, you should never + do that in a production environment. + + +Testing +======= + +Use the following command:: + + python manage.py test hyperkitty + +All test modules reside in the ``hyperkitty/tests`` directory +and this is where you should put your own tests, too. To make the django test +runner find your tests, make sure to add them to the folder's ``__init__.py``: |