A starter project for creating automated tests for websites and web applications.

• Tech Stack
• Setup
• Executing Tests
• Test Command Options
  • Usage
  • Options
• Example Commands
• FAQ

• Python 3.11+
• Selenium
• Pytest

1. Install Python 3.11+ from python.org

2. Download and unzip the project from https://github.com/letam/web-test-template/archive/master.zip

3. Open up a terminal and change your present directory to be the project directory

4. Create and activate python virtual environment for the project

   python3 -m venv .venv
   source .venv/bin/activate
   

5. Install project requirements

   pip install -U pip
   pip install -r requirements.txt
   

6. Install web drivers (Optional)

   You can place binary web driver files either in /usr/local/bin or ./webdriver_bin.

   Note: To enable opening Chrome webdriver on macOS, refer to the FAQ.

7. Create env file

   Copy .env.sample to .env and modify paths to drivers as needed:

   cp .env.sample .env
   

To run tests using firefox webdriver, exiting upon first failed test:

pytest -x -k 'firefox'

To run all tests located in the the ./tests directory located in the root:

pytest tests

Remember to activate project's virtual environment in the project directory first:

source .venv/bin/activate

To list all test command options, execute:

pytest -h

pytest [options] [file_or_dir] [file_or_dir] [...]

Exit instantly on first error or failed test.

Only run tests which match the given substring expression. An expression is a python evaluatable expression where all names are substring-matched against test names and their parent classes. Example: -k 'test_method or test_other' matches all test functions and classes whose name contains 'test_method' or 'test_other', while -k 'not test_method' matches those that don't contain 'test_method' in their names. -k 'not test_method and not test_other' will eliminate the matches. Additionally keywords are matched to classes and functions containing extra names in their 'extra_keyword_matches' set, as well as functions which have names assigned directly to them.

Run tests located in utils directory and exit instantly on first error or failed test:

pytest -x utils

Run all tests which include firefox in file name or test name:

pytest -k 'firefox'

Run all tests which include firefox in file name or test name and contained in the tests directory:

pytest -k 'firefox' tests

Run all tests which do not include safari in file name nor test name:

pytest -k 'not safari'

Run all tests which do not include safari in file name nor test name and only include tests that have the fill word in the test name:

pytest -k 'not safari and fill'

Run tests located in tests/example directory:

pytest tests/example

Run tests located in tests/example/test_chrome.py file:

pytest tests/example/test_chrome.py

Run tests located in tests/example/test_chrome.py file and include fill word in the test name:

pytest tests/example/test_chrome.py -k 'fill'

You can remove the file from quarantine via terminal:

xattr -d com.apple.quarantine <path-of-executable>

e.g.

xattr -d com.apple.quarantine ./webdriver_bin/chromedriver-114.0.5735.90_mac_arm64

Ensure that your version of Chrome webdriver matches the version of the Chrome browser that you have installed on your machine.