Skip to content

strongqa/howitzer_example_rspec

Repository files navigation

Howitzer Example Rspec

Build Status CircleCI

Howitzer example project based on Rspec for demo web application http://demoapp.strongqa.com

Requirements

  • Ruby 3.0.2+

Getting Started

Note! This project uses Git submodules in order to reuse common code between similar projects:

howitzer_example_cucumber howitzer_example_turnip

Typically it is not required for a regular project based on Howitzer

How to try the project locally

  • Clone project
git clone --recursive git@github.com:strongqa/howitzer_example_rspec.git
  • Install dependencies
bundle install
  • Get list of available commands
rake -T

Run tests in Docker

Build image

docker build -t howitzer_example_rspec .

Driver which is used by default is headless chrome

Use docker run command to create and run container.

  • In order to run container by default:
docker run -d --name rspec_container howitzer_example_rspec
  • Connect to created container using this command:
docker exec -it rspec_container /bin/bash
docker exec -it <container ID> /bin/bash
  • Run tests with the next commands using container's terminal:
SEXY_SETTINGS="driver=headless_chrome; headless_chrome_flags=$CHROME_ARGS" bundle exec rake

NOTE! If you need to launch tests under firefox headless browser, use this command:

SEXY_SETTINGS="driver=headless_firefox" bundle exec rake

Run with docker compose

  • Initialize build, and up the container in detached mode:
docker-compose -f docker-compose.yml up -d
  • Connect to created container using this command:
docker compose exec -it howitzer_example_rspec  /bin/bash

Stop container

  • Perform the next command to stop running container using docker-compose command:
docker-compose -f docker-compose.yml down

WARNING: after this command container will be deleted and all data lost.

  • If you need to save container use the next command to stop container:
docker stop <container_name/ID>

Contributing

Code quality is controlled by Rubocop

It is useful to activate rubocop pre-commit git hook for changed files.

cp scripts/pre-commit .git/hooks/pre-commit