summaryrefslogtreecommitdiff
path: root/docs/tutorials/wiki/tests.rst
blob: 9dacc5f962be46d20d969ba922710e68bab32a35 (plain)
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
.. _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 will write a separate test class for each ``model`` class
We will also write a test class for the ``appmaker``.

To do so, we will retain the ``tutorial.tests.ViewTests`` class that was generated from choosing the ``zodb`` backend option.
We will add three test classes, one for each of the following:

-   the ``Page`` model named ``PageModelTests``
-   the ``Wiki`` model named ``WikiModelTests``
-   the appmaker named ``AppmakerTests``


Test the views
==============

We will modify our ``tests.py`` file, adding tests for each view function that we added previously.
As a result, we will delete the ``ViewTests`` class that the ``zodb`` backend option 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 will test the whole application, covering security aspects that are not tested in the unit tests, such as 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 ``pytest`` similarly to how we did in :ref:`running_tests`.
Courtesy of the cookiecutter, our testing dependencies have already been satisfied.
``pytest`` and coverage have already been configured.
We can jump right to running tests.

On Unix:

.. code-block:: bash

    $VENV/bin/pytest -q

On Windows:

.. code-block:: doscon

    %VENV%\Scripts\pytest -q

The expected result should look like the following:

.. code-block:: text

    .........................
    25 passed in 6.87 seconds