Purpose

This repository is for learning and practice purposes on authoring Gherkin scenarios in a BDD behave project. The sample scenarios covers functional related tests from the practice automation site Saucedemo.

For more coverage, feel free to create pull requests to add additional scenarios/scenario outlines into the repository.

Prerequisites

For both test authoring and execution:

• Python 3.7+ Ensure that you have python installed in your system preferably Python 3.7 or higher.

Only for automated test execution:

• Chrome
• Chrome web driver for Selenium, which needs to be in your PATH environment variable. Ensure that the Chrome web driver you download is compatible to the chrome browser you are using. To check the version of your chrome browser, input this url in your chrome browser chrome://settings/help. The version should be displayed on that page.

Configuration

Configuration is contained in config.yaml. Here are the available options:

• users: User information.

  • user_name: String. User name.
  • password: String. Password.

• browser: General browser settings.

  • url: String. Base URL.
  • headless: Boolean. Whether to run the browser in headless mode.
  • size: String. Window dimensions in format width,height (e.g., 1920,1080).
  • extensions: Boolean. Whether to allow the use of installed extensions.
  • gpu: Boolean. Whether to enable GPU acceleration.

You can also create a file named config.override.yaml to selectively override a subset of the defaults without directly changing config.yaml, which is useful when you want to avoid Git picking up those changes. Example override file:

browser:
  headless: true

Development

Prerequisites:

• Poetry 1.0.0+
  • Windows: pip install poetry
  • Linux/Mac: pip3 install --user poetry

poetry is a tool to handle dependency installation as well as building and packaging of Python packages. It only needs one file to do all of that: the new, standardized pyproject.toml.

In other words, poetry uses pyproject.toml to replace setup.py, requirements.txt, setup.cfg, MANIFEST.in and the newly added Pipfile.

After cloning this repository, prepare your development environment like so:

• Set the virtual environment in your project locally: poetry config virtualenvs.in-project true --local
• Set up the Python virtual environment: poetry install
• Activate the pre-commit hooks: poetry run pre-commit install

Test Execution

Test Execution commands:

• Run all scenarios: poetry run behave
• Running tag specific scenarios: poetry run behave features --tags ~wip --tags @positive
• Verify scenario syntax without actually running the tests: poetry run behave --dry-run