Security update for permissions_by_term

[yaffs-website] / vendor / drupal / drupal-extension / doc / blackbox.rst

diff --git a/vendor/drupal/drupal-extension/doc/blackbox.rst b/vendor/drupal/drupal-extension/doc/blackbox.rst
new file mode 100644 (file)
index 0000000..f6a3477
--- /dev/null
+++ b/vendor/drupal/drupal-extension/doc/blackbox.rst
@@ -0,0 +1,95 @@
+Blackbox Driver
+===============
+
+The blackbox driver assumes no privileged access to the site. You can run the
+tests on a local or remote server, and all the actions will take place through
+the site's user interface. This driver was enabled as part of the installation
+instructions by lines 13 and 14, highlighted below.
+
+.. literalinclude:: _static/snippets/behat-bb.yml
+   :language: yaml
+   :linenos:
+   :lines: 1-14
+   :emphasize-lines: 13-14
+
+Region steps
+------------
+
+It may be really important that a block is in the correct region, or you may
+have a link or button that doesn't have a unique label. The blackbox driver
+allows you to create a map between a CSS selector and a user-readable region
+name so you can use steps like the following without having to write any custom
+PHP::
+
+
+  I press "Search" in the "header" region
+  I fill in "a value" for "a field" in the "content" region
+  I fill in "a field" with "Stuff" in the "header" region
+  I click "About us" in the "footer" region
+
+Example:
+++++++++
+
+A stock Drupal 7 installation has a footer area identified by the CSS Id
+"footer". By editing the behat.yml file and adding lines 15 and 16 below:
+
+.. literalinclude:: _static/snippets/behat-bb.yml
+   :language: yaml
+   :linenos:
+   :emphasize-lines: 15-16
+
+You can use a step like the following without writing any custom PHP::
+
+  When I click "About us" in the "footer" region.
+
+
+Using the blackbox driver configured with the regions of your site, you can
+access the following region-related steps:
+
+.. Note::
+    These examples won't work unless you define the appropriate regions in
+     your behat.yml file.
+
+.. literalinclude:: _static/snippets/blackbox.feature
+   :language: gherkin
+   :linenos:
+   :lines: 1-61
+
+Message selectors
+-----------------
+
+The Drupal Extension makes use of three selectors for message. If your CSS
+values are different than the defaults (shown below), you'll need to update
+your behat.yml file:
+
+.. code-block:: yaml
+   :linenos:
+   :emphasize-lines: 2-5
+
+    Drupal\DrupalExtension:
+      selectors:
+        message_selector: '.messages'
+        error_message_selector: '.messages.messages-error'
+        success_message_selector: '.messages.messages-status'
+
+Message-related steps include:
+
+.. literalinclude::  _static/snippets/blackbox.feature
+   :language: gherkin
+   :linenos:
+   :lines: 63-81
+
+Override text strings
+---------------------
+
+The Drupal Extension relies on default text for certain steps. If you have
+customized the label visible to users, you can change that text as follows:
+
+.. code-block:: yaml
+
+     Drupal\DrupalExtension:
+       text:
+         log_out: "Sign out"
+         log_in: "Sign in"
+         password_field: "Enter your password"
+         username_field: "Nickname"