The End-to-End Testing (e2e) suite is written in Python and tests the pages by loading a webpage within the browser and confirming the expected HTML is displayed. This does not test the PHP (or C++) code directly, but rather focuses on user navigation through the website. It utilizes selenium and Chrome to complete these tests.
If you are using Windows here are more detailed instructions for selenium on Windows.
The python dependencies can be installed by doing:
pip3 install selenium
This test suite runs within a Chrome browser so does require an
up-to-date local installation of Chrome. (This can be modified to use
a different browser stack by modifying the
setUpClass method in
You’ll need to install the
to allow selenium access to utilize Chrome. You can either download the binary
from the above site or use your OS’ package manager. For convinence, we list
some options for installation on Mac, Linux, and Windows below. For any step
<CHROMEDRIVER_VERSION>, you will have to determine the appropriate
version using the Version Selection
page from the above link.
For Mac, using homebrew:
brew install --cask chromedriver
For Linux, use:
wget https://chromedriver.storage.googleapis.com/<CHROMEDRIVER_VERSION>/chromedriver_linux64.zip && \ unzip chromedriver_linux64.zip && \ sudo mv chromedriver /usr/local/bin/chromedriver && \ sudo chown root:root /usr/local/bin/chromedriver && \ sudo chmod +x /usr/local/bin/chromedriver
For Windows, download the appropriate version and place it on your PATH.
NOTE: You will need to make sure to keep chromedriver up-to-date as Chrome auto-updates itself.
Because some tests utilize autograding, you must ensure the autograding shippers and workers are running before testing. To start the autograding systems run:
sudo systemctl start submitty_autograding_shipper sudo systemctl start submitty_autograding_worker /usr/local/submitty/.setup/INSTALL_SUBMITTY.sh
See also: Automated Grading
To run the test suite, navigate to
../Submitty/tests and run:
python3 -m unittest
Note: If you are using a non-standard installation of Submitty, you must
tests/e2e/base_testcase.py and change the constant
to reflect your installation’s IP address.
To run an individual file or testcase, run:
python3 -m unittest e2e.<module_name>.<ClassName> python3 -m unittest e2e.<module_name>.<ClassName>.<function_name>
An example of running the login tests:
python3 -m unittest e2e.test_login.TestLogin python3 -m unittest e2e.test_login.TestLogin.test_login
To disable headless mode and view the browser while running a test,
tests/e2e/base_testcase.py and comment out the line:
To slow down the tests for debugging, you can pause execution until you press Enter in the terminal. To do this, add the following line into your test:
wait.until is another way to slow down tests.
It waits until an element loads or times out after a maximum time. This is
useful for both debugging and writing tests. For example, the following snippet
waits until an
h1 element containing “My Heading” appears and fails after
10 secs if nothing shows up.
wait = WebDriverWait(self.browser, 10) wait.until( EC.presence_of_element_located( (By.XPATH, "//h1[contains(text(),'My Heading')]") ) )
Finally, to help debug a failing test, it may be useful to print out the page source right before a failed assertion. You can do this by doing: