python-cucumber

Setup:

Clone the repo

$ git clone git@github.com:tbeede/python-cucumber.git

$ cd python-cucumber

Configure the project

Navigate to

$ cd features/environment.py

Add your Gmail username and password credentials.

Edit $ features/browser.py

to point to

$ home/full/path/to/python-cucumber/drivers/chromedriver

Some packages such as selenium will likely need to be installed locally as part of the project.

To run all tests

Run

$ behave

from project root.

To run an individual test by feature tag

$ behave --tags=tag_name

For example,

$ behave --tags=login

Features and Test Steps in This Repo

before_each is configured on all tests to log in by default, therefore the login feature tests will have to be run separately for now or they will interfere with the other tests.

Also, a LOT of custom xpath had to be written to handle the dynamic elements, and for this reason some tests are stronger and more reliable than others. The final test in the list below is very finicky when handling the "move to" dropdown to move a message into a folder.

Login to gmail
Cannot login with invalid password
Compose and send an email*
Filter/search the email list*
Delete an email
Add a folder
Move a message into the folder*

*Requires message parameters to be set in feature file

Other improvements

Configure logging
Configure multiple browser drivers such as geckodriver
Configure screen capture and reports
API tests to get around brittle xpath / custom xpath

About the Behave Framework

Behave is a Gherkin-based Behavior-Driven Development (BDD) tool developed especially for Python. Read more about it here.

alibugra / python-cucumber