1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
|
.. _wiki_adding_tests:
============
Adding Tests
============
We will now add tests for the models and the views and a few functional tests
in ``tests.py``. Tests ensure that an application works, and that it
continues to work when changes are made in the future.
Test the models
===============
We write tests for the ``model`` classes and the ``appmaker``. Changing
``tests.py``, we'll write a separate test class for each ``model`` class, and
we'll write a test class for the ``appmaker``.
To do so, we'll retain the ``tutorial.tests.ViewTests`` class that was
generated as part of the ``zodb`` scaffold. We'll add three test classes: one
for the ``Page`` model named ``PageModelTests``, one for the ``Wiki`` model
named ``WikiModelTests``, and one for the appmaker named ``AppmakerTests``.
Test the views
==============
We'll modify our ``tests.py`` file, adding tests for each view function we
added previously. As a result, we'll *delete* the ``ViewTests`` class that
the ``zodb`` scaffold provided, and add four other test classes:
``ViewWikiTests``, ``ViewPageTests``, ``AddPageTests``, and ``EditPageTests``.
These test the ``view_wiki``, ``view_page``, ``add_page``, and ``edit_page``
views.
Functional tests
================
We'll test the whole application, covering security aspects that are not
tested in the unit tests, like logging in, logging out, checking that
the ``viewer`` user cannot add or edit pages, but the ``editor`` user
can, and so on.
View the results of all our edits to ``tests.py``
=================================================
Open the ``tutorial/tests.py`` module, and edit it such that it appears as
follows:
.. literalinclude:: src/tests/tutorial/tests.py
:linenos:
:language: python
Running the tests
=================
We can run these tests by using ``setup.py test`` in the same way we did in
:ref:`running_tests`. However, first we must edit our ``setup.py`` to
include a dependency on WebTest, which we've used in our ``tests.py``.
Change the ``requires`` list in ``setup.py`` to include ``WebTest``.
.. literalinclude:: src/tests/setup.py
:linenos:
:language: python
:lines: 11-22
:emphasize-lines: 11
After we've added a dependency on WebTest in ``setup.py``, we need to run
``setup.py develop`` to get WebTest installed into our virtualenv. Assuming
our shell's current working directory is the "tutorial" distribution
directory:
On UNIX:
.. code-block:: text
$ $VENV/bin/python setup.py develop
On Windows:
.. code-block:: text
c:\pyramidtut\tutorial> %VENV%\Scripts\python setup.py develop
Once that command has completed successfully, we can run the tests
themselves:
On UNIX:
.. code-block:: text
$ $VENV/bin/python setup.py test -q
On Windows:
.. code-block:: text
c:\pyramidtut\tutorial> %VENV%\Scripts\python setup.py test -q
The expected result should look like the following:
.. code-block:: text
.........
----------------------------------------------------------------------
Ran 23 tests in 1.653s
OK
|
