Tests

These instructions explain how you can run tests.

Behat

Requirements

Ansible 1.9.4+ http://docs.ansible.com/ansible/intro_installation.html
Docker https://docs.docker.com/engine/installation/

Run Full Test Suite

Execute the following commands:

cd profiles/contrib/openy
sh runtests.sh

Open http://site.com/profiles/contrib/openy/build/reports/behat in your browser to view the test results.

Run Selenium Container + Behat Tests

To run only the Selenium container and Behat tests:

cd profiles/contrib/openy
sh runtests.sh --tags run_selenium
bin/behat

Stop Selenium Container

To stop the Selenium container:

cd profiles/contrib/openy
sh runtests.sh --tags stop_selenium

If necessary, edit behat.local.yml to match your environment.

Visual Debugging - Video

When developing JS tests, it’s important to see what’s happening on the Selenium screen. You can easily do this during development.

Install the RealVNC Viewer.

Run Selenium using the following command:

cd profiles/contrib/openy
sh runtests.sh --tags run_selenium

Open the installed VNC Viewer and connect to the server with IP 192.168.56.132:5901.
- Password: secret
Run the tests. You should see everything performed by the Behat tests in the VNC client.
```
bin/behat
```

Custom Behat Functionality

Create entities in table forms, with a key to use for reference and reference entities by key.

KEY is optional and must be all CAPS.

Taxonomy

Given I create "taxonomy_term" of type "color" with key for reference:
  | KEY  | name  | field_color |
  | Blue | Blue  | 0000FF      |
  | Red  | Red   | FF0000      |

Paragraphs

Given I create "paragraph" of type "small_banner" with key for reference:
  | KEY     | field_prgf_headline | field_prgf_color |
  | banner1 | Headline 1          | Blue             |
  | banner2 | Headline 2          | Red              |

Media entities

Given I create "media" of type "image" with key for reference:
  | KEY       | name            | file         |
  | gallery_1 | Gallery image 1 | gallery.png  |
  | gallery_2 | Gallery image 2 | gallery2.png |
  | gallery_3 | Gallery image 3 | gallery3.png |

Create nodes in table forms, with a key to use for reference and reference entities by key.

KEY is optional and must be all CAPS.

Basic create

Given I create "landing_page" content:
  | KEY       | title           | field_lp_layout | field_content |
  | landing_1 | Test Landing 01 | one_column      | banner1       |
  | landing_2 | Test Landing 02 | one_column      | banner2       |

Vertical field table

Given I create large "landing_page" content:
  | KEY             | landing_3       | landing_4       |
  | title           | Test Landing 03 | Test Landing 04 |
  | field_lp_layout | one_column      | one_column      |
  | field_content   | banner1         | banner2         |

Create & view immediately

Given I view a "landing_page" content:
  | KEY             | landing_5       |
  | title           | Test Landing 05 |
  | field_lp_layout | one_column      |
  | field_content   | banner1         |

Multiple referenced entities by key on a field.

Given I create "landing_page" content:
  | KEY       | title           | field_lp_layout | field_content    |
  | landing_6 | Test Landing 06 | one_column      | banner1, banner2 |

Example Address and Latitude + Longitude

Fields with subfields/columns: The machine name and columns can be found in the form markup in the field name property.

Inspect form field name depicted

The first portion, field_location_address, represents the Drupal field machine name, while the second array key, address_line1, represents the column.

Add Address

Given I view a "branch" content:
    | title                                | Branch Example  |
    | field_location_address:country_code  | US             |
    | :address_line1                       | Main road 10   |
    | :locality                            | Seattle        |
    | :administrative_area                 | WA             |
    | :postal_code                         | 98101          |

Add Latitude and Longitude

Given I view a "branch" content:
  | title                          | Branch Example 2 |
  | field_location_coordinates:lat | 47.293433        |
  | :lng                           | -122.238717      |
  | field_location_phone           | +1234567890      |