https://github.com/navaz-alani/selenium-testing-module
A set of functions which automate browser initiation (download & install webdriver) and prettify logging for Selenium.
https://github.com/navaz-alani/selenium-testing-module
chromium selenium-testing webdriver
Last synced: 8 months ago
JSON representation
A set of functions which automate browser initiation (download & install webdriver) and prettify logging for Selenium.
- Host: GitHub
- URL: https://github.com/navaz-alani/selenium-testing-module
- Owner: navaz-alani
- License: mit
- Created: 2019-08-01T20:35:32.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2020-03-05T19:11:20.000Z (almost 6 years ago)
- Last Synced: 2024-11-15T03:53:55.468Z (over 1 year ago)
- Topics: chromium, selenium-testing, webdriver
- Language: Python
- Homepage:
- Size: 14.6 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Selenium Testing Module
This module contains a set of functions which automate browser initiation and prettify logging for Selenium.
## Motivation
When using Selenium WebDriver to automate E2E testing, one needs a driver which Selenium can use to control the browser. In the case of Google Chrome, its the `chromedriver`.
Getting the driver and setting it up is usually manual and is somewhat error prone.
## What this module offers
This module offers the `browser_init` function which can be used as follows:
`browser_init : browser_name: str, ops=[], exp_ops=[], headless_download=False) -> WebDriver`
Arguments:
`browser_init` takes the following arguments:
- REQUIRED: `browser_name: str` - one of `"firefox", "chrome", "edge","gecko", "opera_chromium", "opera"`
- `ops: list = []` - options such as `"headless", "verbose"`
- `exp_ops: list = []` - experimental options
- `headless_download: bool = False` - This is a feature which is aimed at working around the chromium sercurity feature prohibiting downloads in headless mode. Set `True` to download in `headless` mode.
and returns a `WebDriver` object.
Also offered is the `p_print` function which can be used to prettify command line output so that tests can be understood by the greater team.
`p_print` takes in the following arguments:
- REQUIRED: `s: any` - object to print
- `n: int = 0` - This is the parameter specifying the indent level of the output
- `toc: str = None` - Token which can be used to color the output. Use token `'info'` for yellow, `'s'` for green (success) and `'f'` for red (failure).
returns `None` and outputs to `stdout`.
Finally, `user_exit` is a debug function that can be used to prevent the driver from closing when the test script execution complete. It prompts the user to close the session. It should be executed as the last command in the script.
`user_exit` takes in 1 argument:
REQUIRED: `driver: WebDriver` - a WebDriver object
returns `None` and prompts the user to exit test manually.