@@ -4,86 +4,59 @@ Testing
44Testing is done using `Selenium WebDriver `_ for automating browser tests.
55`Tox `_ is used to execute testing procedures.
66
7- Before running all tests locally, `ChromeDriver `_ (for testing on Chrome browser )
8- and `GeckoDriver `_ (for testing on Firefox browser ) are required.
7+ Before running all tests locally, `ChromeDriver `_ (for testing on Chrome)
8+ and `GeckoDriver `_ (for testing on Firefox) are required.
99
1010Install Tox via pip:
1111
1212.. prompt :: bash
1313
14- pip install tox
14+ pip install tox
1515
1616Download and setup the ChromeDriver:
1717
1818.. literalinclude :: ../scripts/setup_chromedriver.sh
19- :language: bash
19+ :language: bash
2020
2121Download and setup the GeckoDriver:
2222
2323.. literalinclude :: ../scripts/setup_geckodriver.sh
24- :language: bash
24+ :language: bash
2525
2626To run the full test suite against your changes, simply run Tox.
2727Tox should return without any errors.
2828You can run Tox against all of our environments and both browsers by running:
2929
3030.. prompt :: bash
3131
32- tox
32+ tox
3333
3434To run tests with a specific environment and for both browsers:
3535
3636.. prompt :: bash
3737
38- tox -e py36-sphinx20
38+ tox -e py36-sphinx20
3939
4040To run tests with a specific environment and for a specified browser:
4141
4242.. prompt :: bash
4343
44- tox -e py36-sphinx20 -- --driver Chrome # run tests with Python 3.6 and Sphinx < 2.1 with Chrome browser
45- tox -e py36-sphinx20 -- --driver Firefox # run tests with Python 3.6 and Sphinx < 2.1 with Firefox browser
44+ tox -e py36-sphinx20 -- --driver Chrome # run tests with Python 3.6 and Sphinx < 2.1 with Chrome browser
45+ tox -e py36-sphinx20 -- --driver Firefox # run tests with Python 3.6 and Sphinx < 2.1 with Firefox browser
4646
4747To run tests against all environments but with a specified browser:
4848
4949.. prompt :: bash
5050
51- tox -- --driver Chrome # run tests with all environments with Chrome browser
52- tox -- --driver Firefox # run tests with all environments with Firefox browser
51+ tox -- --driver Chrome # run tests with all environments with Chrome browser
52+ tox -- --driver Firefox # run tests with all environments with Firefox browser
5353
54- The `` tox `` configuration has the following environments configured.
55- You can target a single environment to limit the test suite:
54+ Internet Explorer and Edge
55+ --------------------------
5656
57- .. code-block :: text
58-
59- py36-sphinx18
60- Run test suite with Python 3.6 and Sphinx<1.9
61-
62- py36-sphinx20
63- Run test suite with Python 3.6 and Sphinx<2.1
64-
65- py36-sphinx21
66- Run test suite with Python 3.6 and Sphinx<2.2
67-
68- py37-sphinx18
69- Run test suite with Python 3.7 and Sphinx <1.9
70-
71- py37-sphinx20
72- Run test suite with Python 3.7 and Sphinx<2.1
73-
74- py37-sphinx21
75- Run test suite with Python 3.7 and Sphinx<2.2
76-
77- docs
78- Test documentation compilation with Sphinx
79-
80-
81- Continuous Integration
82- ----------------------
83-
84- For every push to GitHub, Travis CI runs all the tests.
85- You can check the current build status:
86- https://travis-ci.org/readthedocs/readthedocs-sphinx-search
57+ Internet Explorer and Edge don't support headless mode,
58+ but we can check that everything works with
59+ https://saucelabs.com/.
8760
8861
8962.. _Selenium WebDriver : https://seleniumhq.github.io/selenium/docs/api/py/index.html
0 commit comments