README

A collection of Behat steps for Drupal

Important

Behat Steps version 3.0 is on the way, featuring additional steps and refined, consistent language! Follow the progress in this issue.

Installation

composer require --dev drevops/behat-steps:^2

Usage

Add required traits to your FeatureContext.php (example):

<?php

use Drupal\DrupalExtension\Context\DrupalContext;
use DrevOps\BehatSteps\ContentTrait;

/**
 * Defines application features from the specific context.
 */
class FeatureContext extends DrupalContext {

  use ContentTrait;

}

Modification of behat.yml configuration is not required.

Exceptions

• \Exception is thrown for all assertions.
• \RuntimeException is thrown for any unfulfilled requirements within a step.

Available steps

Skipping before scenario hooks

Some traits provide beforeScenario hook implementations. These can be disabled by adding behat-steps-skip:METHOD_NAME tag to your test.

For example, to skip beforeScenario hook from JsTrait, add @behat-steps-skip:jsBeforeScenarioInit tag to the feature.

Development

Local environment setup

• Install Docker, Pygmy, Ahoy and shut down local web services (Apache/Nginx, MAMP etc)
• Checkout project repository in one of the supported Docker directories.
• pygmy up
• ahoy build
• Access built site at http://behat-steps.docker.amazee.io/

Use ahoy --help to see the list of available commands.

Running tests

The source code of traits is tested by running Behat tests in the same way they would be run in your project: traits are included into FeatureContext.php and then ran on the pre-configured fixture Drupal site using test features.

Run ahoy build to setup a fixture Drupal site in the build directory.

ahoy test-bdd                # Run all tests

ahoy test-bdd path/to/file   # Run all scenarios in specific feature file

ahoy test-bdd -- --tags=wip  # Run all scenarios tagged with `@wip` tag

Debugging tests

• ahoy debug
• Set breakpoint
• Run tests with ahoy test-bdd - your IDE will pickup an incoming debug connection

Updating fixture site

• Build the fixture site and make the required changes
• ahoy drush cex -y
• ahoy update-fixtures to copy configuration changes from build directory to the fixtures directory

Repository created using https://getscaffold.dev/ project scaffold template