hazza/jupyterhub
1
0
Fork 0
mirror of https://github.com/jupyterhub/jupyterhub.git synced 2025-10-18 07:23:00 +00:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #2812 from jgwerner/update-tests-docs

Browse Source 
docs: Update docs to run tests
This commit is contained in:
Min RK
2019-12-03 13:19:26 +01:00
committed by GitHub
parent e407808f47 948f4c44fd
commit 33e1a090d8
2 changed files with 8 additions and 19 deletions
Download Patch File Download Diff File Expand all files Collapse all files

1
.travis.yml
View File

@@ -8,7 +8,6 @@ python:
- nightly - nightly
env: env:
global: global:
- ASYNC_TEST_TIMEOUT=15
- MYSQL_HOST=127.0.0.1 - MYSQL_HOST=127.0.0.1
- MYSQL_TCP_PORT=13306 - MYSQL_TCP_PORT=13306
services: services:

26
docs/source/contributing/tests.rst
View File

@@ -23,27 +23,28 @@ Running the tests
.. code-block:: bash .. code-block:: bash
pytest --async-test-timeout 15 -v jupyterhub/tests pytest -v jupyterhub/tests
This should display progress as it runs all the tests, printing This should display progress as it runs all the tests, printing
information about any test failures as they occur. information about any test failures as they occur.
If you wish to confirm test coverage the run tests with the `--cov` flag:
The ``--async-test-timeout`` parameter is used by `pytest-tornado .. code-block:: bash
<https://github.com/eugeniy/pytest-tornado#markers>`_ to set the
asynchronous test timeout to 15 seconds rather than the default 5, pytest -v --cov=jupyterhub jupyterhub/tests
since some of our tests take longer than 5s to execute.
#. You can also run tests in just a specific file: #. You can also run tests in just a specific file:
.. code-block:: bash .. code-block:: bash
pytest --async-test-timeout 15 -v jupyterhub/tests/<test-file-name> pytest -v jupyterhub/tests/<test-file-name>
#. To run a specific test only, you can do: #. To run a specific test only, you can do:
.. code-block:: bash .. code-block:: bash
pytest --async-test-timeout 15 -v jupyterhub/tests/<test-file-name>::<test-name> pytest -v jupyterhub/tests/<test-file-name>::<test-name>
This runs the test with function name ``<test-name>`` defined in This runs the test with function name ``<test-name>`` defined in
``<test-file-name>``. This is very useful when you are iteratively ``<test-file-name>``. This is very useful when you are iteratively
@@ -65,14 +66,3 @@ All the tests are failing
Make sure you have completed all the steps in :ref:`contributing/setup` sucessfully, and Make sure you have completed all the steps in :ref:`contributing/setup` sucessfully, and
can launch ``jupyterhub`` from the terminal. can launch ``jupyterhub`` from the terminal.
Tests are timing out
--------------------
The ``--async-test-timeout`` parameter to ``pytest`` is used by
`pytest-tornado <https://github.com/eugeniy/pytest-tornado#markers>`_ to set
the asynchronous test timeout to a higher value than the default of 5s,
since some of our tests take longer than 5s to execute. If the tests
are still timing out, try increasing that value even more. You can
also set an environment variable ``ASYNC_TEST_TIMEOUT`` instead of
passing ``--async-test-timeout`` to each invocation of pytest.