update wiki1 with py.test and coverage defaults

Steve Piercy

2016-05-07 779b316ec36ad4920bbe2fd6c6e0aaa5c021e029

update wiki1 with py.test and coverage defaults

 docs/tutorials/wiki/installation.rst

@@ -262,14 +262,14 @@

.. code-block:: bash

   $ $VENV/bin/py.test tutorial/tests.py -q
   $ $VENV/bin/py.test -q

On Windows
^^^^^^^^^^

.. code-block:: doscon

   c:\pyramidtut\tutorial> %VENV%\Scripts\py.test tutorial\tests.py -q
   c:\pyramidtut\tutorial> %VENV%\Scripts\py.test -q

For a successful test run, you should see output that ends like this:

@@ -277,16 +277,6 @@

   .
   1 passed in 0.24 seconds

.. note::
   py.test follows :ref:`conventions for Python test discovery
   <pytest:test discovery>`. This explains why we cannot run just ``py.test``
   without specifying the module to test after generating a project from a
   scaffold.

   py.test is a :ref:`mature full-featured Python testing tool
   <pytest:features>`. See py.test's documentation for :ref:`pytest:usage` or
   invoke ``py.test -h`` to see its full set of options.


Expose test coverage information
@@ -305,15 +295,15 @@

.. code-block:: bash

   $ $VENV/bin/py.test --cov=tutorial --cov-report=term-missing tutorial/tests.py
   $ $VENV/bin/py.test --cov --cov-report=term-missing

On Windows
^^^^^^^^^^

.. code-block:: doscon

   c:\pyramidtut\tutorial> %VENV%\Scripts\py.test --cov=tutorial \
       --cov-report=term-missing tutorial\tests.py
   c:\pyramidtut\tutorial> %VENV%\Scripts\py.test --cov \
       --cov-report=term-missing

If successful, you will see output something like this:

@@ -341,6 +331,40 @@
Our package doesn't quite have 100% test coverage.


.. _test_and_coverage_scaffold_defaults_zodb:

Test and coverage scaffold defaults
-----------------------------------

Scaffolds include configuration defaults for ``py.test`` and test coverage.
These configuration files are ``pytest.ini`` and ``.coveragerc``, located at
the root of your package. Without these defaults, we would need to specify the
path to the module on which we want to run tests and coverage.

On UNIX
^^^^^^^

.. code-block:: bash

   $ $VENV/bin/py.test --cov=tutorial tutorial/tests.py -q

On Windows
^^^^^^^^^^

.. code-block:: doscon

   c:\pyramidtut\tutorial> %VENV%\Scripts\py.test --cov=tutorial \
       --cov-report=term-missing tutorial\tests.py -q

py.test follows :ref:`conventions for Python test discovery
<pytest:test discovery>`, and the configuration defaults from the scaffold
tell ``py.test`` where to find the module on which we want to run tests and
coverage.

.. seealso:: See py.test's documentation for :ref:`pytest:usage` or invoke
   ``py.test -h`` to see its full set of options.


.. _wiki-start-the-application:

Start the application

 docs/tutorials/wiki2/installation.rst

@@ -355,7 +355,7 @@
Our package doesn't quite have 100% test coverage.


.. _test_and_coverage_scaffold_defaults:
.. _test_and_coverage_scaffold_defaults_sql:

Test and coverage scaffold defaults
-----------------------------------