Cucumber automation example project for the Weather Checker site.

The project can be executed in 2 different ways depending on your local dev environment set up. It has been assumed to be run in a Mac OS or Linux environment.

git clone [email protected]:itsDanOades/WeatherChecker.git

Spawn a browser instance on your local dev machine and execute Cucumber tests using Selenium Webdriver

• Install Google Chrome (https://www.google.com/chrome/) or Firefox (https://www.mozilla.org/en-GB/firefox/new/)

• Install Ruby 2.6.0 or later using RVM (https://rvm.io/rvm/install):

# Download and install latest stable version
curl -sSL https://get.rvm.io | bash -s stable --ruby

# Confirm your Ruby install
rvm list
ruby -v

• Install Ruby project dependencies

gem install bundler
bundle install

Note: The bundle install step will download and install the correct Chromedriver or Geckodriver version for your local browser. If this fails then you will need to ensure your chosen driver is available on your system path or follow the Docker solution below.

# Launch Chrome
bundle exec cucumber -p default -p chrome

# Launch Firefox
bundle exec cucumber -p default -p firefox

Start a Docker container running an instance of Selenium Grid and a Google Chrome node, execute Cucumber tests inside Docker, use this approach if you do not want to set up Ruby on your local machine.

• Install Docker, https://docs.docker.com/docker-for-mac/install

• Install docker-compose (non Mac platforms only) https://docs.docker.com/docker-for-mac/install/

• Build the test runner Docker container using Dockerfile and public Ruby docker image from https://hub.docker.com/

sh ./build_docker.sh

• Confirm docker cucumber:0.0.1 image was built and tagged successfully in your local docker repo

docker images

Start automation framework and execute tests headlessly inside docker node

sh ./run_cucumber_docker.sh