How to install and run

Installation

Do a normal install on the machine you wish to test on (this is so a valid configuration file is present)

Create a behat.xml file in your config directory. It should contain the following settings:

behat.xml

<?xml version="1.0" encoding="UTF-8"?>
<rogo>
  <website>http://localhost:8000/</website>
  <db_database>behat_database_schema_name</db_database>
  <db_user>username</db_user>
  <db_password>password</db_password>
  <data>path_to_behat_user_data</data>
  <faildump>path_for_screenshots_of_failures</faildump>
</rogo>

Run the following script: testing/behat/cli/init.php
Download selenium (V3.x is supported) from http://www.seleniumhq.org/download/
Download ChromeDriver from https://sites.google.com/a/chromium.org/chromedriver/

Note for Windows users

You will need to install composer.phar into the root rogo directory manually from https://getcomposer.org/download/

Running

Start the webserver referenced in behat's website setting. You can use the builtin php web server with the following command: php -S localhost:8000
Start Selenium with a command similar to: java -Dwebdriver.chrome.driver=<path_to_chromedriver> -jar selenium-server-standalone-<version_number>.jar
Run the following command to run the test suite: vendor/bin/behat --config <rogo_root_directory>/testing/behat/config/behat.yml

Additional information

Alternative configuration

It is also possible to configure behat using the main Rogo config using the following settings:

$cfg_behat_website - Should be a url and specific port, for example http://localhost:8000/
$cfg_behat_db_database - Should be the name of a database schema that is different to the live schema, but on the same server
$cfg_behat_data - The location that you wish behat to store user data files, must be different to the value of $cfg_rogo_data
$cfg_behat_db_user - Username that can be used to fully control your database
$cfg_behat_db_password - The password for the database user

Settings in the behat.xml file will override any behat settings in the main config.inc.php file.

Useful information

How to install and run on Docker

Start up rogo docker

docker-compose

docker-compose -f docker-compose.yml -f db.yml -f expose.yml -f selenium.yml up -d

Install rogo

Create a behat.xml file in your config directory. It should contain the following settings:

behat.xml

<?xml version="1.0" encoding="UTF-8"?>
<rogo>
  <website>http://web:8003</website>
  <db_database>behat_database_schema_name</db_database>
  <db_user>username</db_user>
  <db_password>password</db_password>
  <data>path_to_behat_user_data</data>
</rogo>

Run the following script: testing/behat/cli/init.php on the web service.
Start the webserver referenced in behat's website setting. You can use the builtin php web server with the following command: php -S localhost:8003
Overwrite the generated /testing/behat/config/behat.yml file with the location of the selenium service:

behat.yml

...
...
extensions:
    Behat\MinkExtension:
      base_url: 'http://web:8003'
      goutte: null
      selenium2:
        browser: chrome
        wd_host: 'selenium:4444/wd/hub'

5. Run the following command to run the test suite: vendor/bin/behat --config <rogo_root_directory>/testing/behat/config/behat.yml

Ideas for the future

We can probably set things up so that our tests will run automatically in the cloud on something like: https://travis-ci.com/

ExamSys

Automatic functional testing