summaryrefslogtreecommitdiff
path: root/docs/development/installation.rst
diff options
context:
space:
mode:
authorStephen Finucane <stephen@that.guru>2018-04-17 09:50:44 +0100
committerStephen Finucane <stephen@that.guru>2018-04-26 10:47:02 +0100
commitbab2895fcfbbe32f7d18b6a680111e675ddd73dd (patch)
treebe367ea1c0cfd19c1899b9e2c264680dd7ea9b21 /docs/development/installation.rst
parentda3ff5426c44e1a976783430ce12b081ef51b736 (diff)
downloadpatchwork-bab2895fcfbbe32f7d18b6a680111e675ddd73dd.tar
patchwork-bab2895fcfbbe32f7d18b6a680111e675ddd73dd.tar.gz
tests: Remove Selenium tests
These were added quite some time ago in order to allow some level of UI testing. However, I've personally never used them, they're not used by the CI, and no one has shown any desire in extending them in their time here. It is time to bid these tests adieu. Removing these allows us to remove a whole load of wiring that existed just to enable these. Some of this, like the '--quick-tox' option for the Dockerfile, is retained so we don't need to use different commands for various versions of Patchwork, but the majority is just stripped out. Signed-off-by: Stephen Finucane <stephen@that.guru> Cc: Daniel Axtens <dja@axtens.net>
Diffstat (limited to 'docs/development/installation.rst')
-rw-r--r--docs/development/installation.rst46
1 files changed, 8 insertions, 38 deletions
diff --git a/docs/development/installation.rst b/docs/development/installation.rst
index a1bee1d..f2ed0f2 100644
--- a/docs/development/installation.rst
+++ b/docs/development/installation.rst
@@ -41,7 +41,8 @@ To run a shell within this environment, run:
$ docker-compose run --rm web --shell
-To run `django-manage` commands, such as `createsuperuser` or `migrate`, run:
+To run ``django-manage`` commands, such as ``createsuperuser`` or ``migrate``,
+run:
.. code-block:: shell
@@ -53,48 +54,17 @@ To access the SQL command-line client, run:
$ docker-compose run --rm web python manage.py dbshell
-To run unit tests, excluding Selenium UI interaction tests, using only the
-package versions installed during container initialization, run:
-
-.. code-block:: shell
-
- $ docker-compose run --rm web --quick-test
-
-To run the same against all supported versions of Django (via tox), run:
-
-.. code-block:: shell
-
- $ docker-compose run --rm web --quick-tox
-
-To run specific tox targets or tests, pass arguments to the above:
+To run unit tests against the system Python packages, run:
.. code-block:: shell
- $ docker-compose run --rm web --quick-tox -e py27-django18 \
- patchwork.tests.test_bundles
+ $ docker-compose run --rm web python manage.py test
-To run all tests, including Selenium UI interaction tests, using only the
-package versions installed container initialization, run:
-
-.. code-block:: shell
-
- $ docker-compose run --rm web --test
-
-To run the same against all supported versions of Django (via tox), run:
-
-.. code-block:: shell
-
- $ docker-compose run --rm web --tox
-
-To run all tests, including Selenium UI interaction tests in non-headless mode,
-run:
+To run unit tests for multiple versions using ``tox``, run:
.. code-block:: shell
- $ docker run -it --rm -v (pwd):/home/patchwork/patchwork/ \
- --link patchwork_db_1:db -p 8000:8000 \
- -v /tmp/.X11-unix:/tmp/.X11-unix \
- -e PW_TEST_DB_HOST=db -e DISPLAY patchwork_web bash
+ $ docker-compose run --rm web tox
To reset the database before any of these commands, add ``--reset`` to the
command line after ``web`` and before any other arguments. Conversely, to
@@ -102,8 +72,8 @@ backup the database at any stage, run:
.. code-block:: shell
- $ docker exec DATABASECONTAINER /usr/bin/mysqldump -u DATABASEUSER \
- --password=DATABASEPASSWORD DATABASE > backup.sql
+ $ docker exec DATABASECONTAINER /usr/bin/mysqldump -u DATABASEUSER \
+ --password=DATABASEPASSWORD DATABASE > backup.sql
where ``DATABASECONTAINER`` is found by ``docker ps -a`` and the other settings
are the same as those defined in ``patchwork/settings/dev.py``. To restore this