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

Modifications is testing docs

Browse Source
This commit is contained in:
Shloka
2022-10-09 19:07:20 +05:30
parent c126cc3f9b
commit 395b1a5681
1 changed files with 10 additions and 14 deletions
Download Patch File Download Diff File Expand all files Collapse all files

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

@@ -4,19 +4,16 @@
Testing JupyterHub and linting code Testing JupyterHub and linting code
=================================== ===================================
Unit test help validate that JupyterHub works the way we think it does, Unit tests help confirming that JupyterHub works as intended and does so even when modifications are made. Additionally, they help in clarifying our expectations for our code.
and continues to do so when changes occur. They also help communicate
precisely what we expect our code to do.
JupyterHub uses `pytest <https://pytest.org>`_ for all our tests. You JupyterHub uses `pytest <https://pytest.org>`_ for all the tests. You
can find them under ``jupyterhub/tests`` directory in the git repository. can find them under the `jupyterhub/tests <https://github.com/jupyterhub/jupyterhub/tree/main/jupyterhub/tests>`_ directory in the git repository.
Running the tests Running the tests
================== ==================
#. Make sure you have completed :ref:`contributing/setup`. You should be able #. Make sure you have completed :ref:`contributing/setup`. Once completed, you should be able
to start ``jupyterhub`` from the commandline & access it from your to start ``jupyterhub`` through a web browser as well as the command line. By doing this, it is ensured that the dev environment is properly set
web browser. This ensures that the dev environment is properly set
up for tests to run. up for tests to run.
#. You can run all tests in JupyterHub #. You can run all tests in JupyterHub
@@ -57,7 +54,7 @@ Running the tests
pytest -v jupyterhub/tests/test_api.py::test_shutdown pytest -v jupyterhub/tests/test_api.py::test_shutdown
See the `pytest usage documentation <https://pytest.readthedocs.io/en/latest/usage.html>`_ for more details. For more information, refer to `pytest usage documentation <https://pytest.readthedocs.io/en/latest/usage.html>`_.
Test organisation Test organisation
================= =================
@@ -98,8 +95,7 @@ And fixtures to add functionality or spawning behavior:
- ``bad_spawn``: enables the BadSpawner (a spawner that fails immediately) - ``bad_spawn``: enables the BadSpawner (a spawner that fails immediately)
- ``slow_bad_spawn``: enables the SlowBadSpawner (a spawner that fails after a short delay) - ``slow_bad_spawn``: enables the SlowBadSpawner (a spawner that fails after a short delay)
See the `pytest fixtures documentation <https://pytest.readthedocs.io/en/latest/fixture.html>`_ For information on using the existing fixtures and creating new ones, refer to `pytest fixtures documentation <https://pytest.readthedocs.io/en/latest/fixture.html>`_
for how to use the existing fixtures, and how to create new ones.
Troubleshooting Test Failures Troubleshooting Test Failures
@@ -109,7 +105,7 @@ All the tests are failing
------------------------- -------------------------
Make sure you have completed all the steps in :ref:`contributing/setup` successfully, and Make sure you have completed all the steps in :ref:`contributing/setup` successfully, and
can launch ``jupyterhub`` from the terminal. can launch ``jupyterhub`` from the terminal as well as the web browser.
Code formatting and linting Code formatting and linting
@@ -117,13 +113,13 @@ Code formatting and linting
JupyterHub has adopted automatic code formatting and linting. JupyterHub has adopted automatic code formatting and linting.
As long as your code is valid, the pre-commit hook should take care of how it should look. As long as your code is valid, the pre-commit hook should take care of how it should look.
You can invoke the pre-commit hook by hand at any time with: You can invoke the pre-commit hook manually at any time with:
.. code:: bash .. code:: bash
pre-commit run pre-commit run
which should run any autoformatting on your code and tell you about any errors it couldn't fix automatically. This should run any auto formatting on your code and tell you about any errors it couldn't fix automatically.
You may also install `black integration <https://github.com/psf/black#editor-integration>`_ You may also install `black integration <https://github.com/psf/black#editor-integration>`_
into your text editor to format code automatically. into your text editor to format code automatically.