source: main/waeup.cas/trunk/README.rst @ 17387

Last change on this file since 17387 was 10512, checked in by Henrik Bettermann, 11 years ago

Increase test coverage.

File size: 1.7 KB
Line 
1waeup.cas
2*********
3
4Install for Development
5-----------------------
6
7Create a virtualenv and install basic packages::
8
9  $ virtualenv py27
10  $ source py27/bin/activate
11  (py27)$ python setup.py dev
12
13Running Tests
14-------------
15
16After `Install for Development`_ run::
17
18  (py27)$ py.test
19
20We also provide support for `tox`. You can run tests in Python 2.6,
212.7, 3.2, and 3.3 environments (if you have the respective Python
22versions installed locally) simply by::
23
24  (py27)$ pip install tox   # needed only once per virtualenv
25  (py27)$ tox
26
27If you want to run tests for a specific version only, try something
28like::
29
30  (py27)$ tox -e py32
31
32to run tests for Python 3.2 only.
33
34Getting Test-Coverage Reports
35-----------------------------
36
37You can generate coverage reports by::
38
39  (py27)$ py.test --cov .
40
41This will dump reports on commandline. For HTML reports you can try::
42
43  (py27)$ py.test --cov . --cov-report=html
44
45Please make sure, that coverage stays at 100%.
46
47
48Running the CAS Server (with `paster`)
49--------------------------------------
50
51You need some WSGI-capable HTTP-server to run CAS. One approach would
52be the ``paster`` HTTP-server included in the ``PasteScript``
53package::
54
55   (py27)$ pip install PasteScript
56
57This will provide the `paster` executable in path. Now you need a
58configuration file like the ``sample.ini`` file provided in the
59package root. You can run this configuration then like this::
60
61   (py27)$ paster serve sample.ini
62
63Afterwards you should be able to login on http://localhost:8008/login
64
65The authentication module enabled by default is ``dummy`` and mainly
66for testing. It gives a successful login for the credentials ``bird``
67/ ``bebop`` (and nothing else).
Note: See TracBrowser for help on using the repository browser.