Security update for permissions_by_term
[yaffs-website] / vendor / drupal / drupal-extension / src / Drupal / DrupalExtension / Context / DrupalContext.php
diff --git a/vendor/drupal/drupal-extension/src/Drupal/DrupalExtension/Context/DrupalContext.php b/vendor/drupal/drupal-extension/src/Drupal/DrupalExtension/Context/DrupalContext.php
new file mode 100644 (file)
index 0000000..3ac77dc
--- /dev/null
@@ -0,0 +1,454 @@
+<?php
+
+namespace Drupal\DrupalExtension\Context;
+
+use Behat\Behat\Context\TranslatableContext;
+use Behat\Mink\Element\Element;
+
+use Behat\Gherkin\Node\TableNode;
+
+/**
+ * Provides pre-built step definitions for interacting with Drupal.
+ */
+class DrupalContext extends RawDrupalContext implements TranslatableContext {
+
+  /**
+   * Returns list of definition translation resources paths.
+   *
+   * @return array
+   */
+  public static function getTranslationResources() {
+    return glob(__DIR__ . '/../../../../i18n/*.xliff');
+  }
+
+  /**
+   * @Given I am an anonymous user
+   * @Given I am not logged in
+   */
+  public function assertAnonymousUser() {
+    // Verify the user is logged out.
+    if ($this->loggedIn()) {
+      $this->logout();
+    }
+  }
+
+  /**
+   * Creates and authenticates a user with the given role(s).
+   *
+   * @Given I am logged in as a user with the :role role(s)
+   * @Given I am logged in as a/an :role
+   */
+  public function assertAuthenticatedByRole($role) {
+    // Check if a user with this role is already logged in.
+    if (!$this->loggedInWithRole($role)) {
+      // Create user (and project)
+      $user = (object) array(
+        'name' => $this->getRandom()->name(8),
+        'pass' => $this->getRandom()->name(16),
+        'role' => $role,
+      );
+      $user->mail = "{$user->name}@example.com";
+
+      $this->userCreate($user);
+
+      $roles = explode(',', $role);
+      $roles = array_map('trim', $roles);
+      foreach ($roles as $role) {
+        if (!in_array(strtolower($role), array('authenticated', 'authenticated user'))) {
+          // Only add roles other than 'authenticated user'.
+          $this->getDriver()->userAddRole($user, $role);
+        }
+      }
+
+      // Login.
+      $this->login();
+    }
+  }
+
+  /**
+   * Creates and authenticates a user with the given role(s) and given fields.
+   * | field_user_name     | John  |
+   * | field_user_surname  | Smith |
+   * | ...                 | ...   |
+   *
+   * @Given I am logged in as a user with the :role role(s) and I have the following fields:
+   */
+  public function assertAuthenticatedByRoleWithGivenFields($role, TableNode $fields) {
+    // Check if a user with this role is already logged in.
+    if (!$this->loggedInWithRole($role)) {
+      // Create user (and project)
+      $user = (object) array(
+        'name' => $this->getRandom()->name(8),
+        'pass' => $this->getRandom()->name(16),
+        'role' => $role,
+      );
+      $user->mail = "{$user->name}@example.com";
+
+      // Assign fields to user before creation.
+      foreach ($fields->getRowsHash() as $field => $value) {
+        $user->{$field} = $value;
+      }
+
+      $this->userCreate($user);
+
+      $roles = explode(',', $role);
+      $roles = array_map('trim', $roles);
+      foreach ($roles as $role) {
+        if (!in_array(strtolower($role), array('authenticated', 'authenticated user'))) {
+          // Only add roles other than 'authenticated user'.
+          $this->getDriver()->userAddRole($user, $role);
+        }
+      }
+
+      // Login.
+      $this->login();
+    }
+  }
+
+
+  /**
+   * @Given I am logged in as :name
+   */
+  public function assertLoggedInByName($name) {
+    if (!isset($this->users[$name])) {
+      throw new \Exception(sprintf('No user with %s name is registered with the driver.', $name));
+    }
+
+    // Change internal current user.
+    $this->user = $this->users[$name];
+
+    // Login.
+    $this->login();
+  }
+
+  /**
+   * @Given I am logged in as a user with the :permissions permission(s)
+   */
+  public function assertLoggedInWithPermissions($permissions) {
+    // Create user.
+    $user = (object) array(
+      'name' => $this->getRandom()->name(8),
+      'pass' => $this->getRandom()->name(16),
+    );
+    $user->mail = "{$user->name}@example.com";
+    $this->userCreate($user);
+
+    // Create and assign a temporary role with given permissions.
+    $permissions = array_map('trim', explode(',', $permissions));
+    $rid = $this->getDriver()->roleCreate($permissions);
+    $this->getDriver()->userAddRole($user, $rid);
+    $this->roles[] = $rid;
+
+    // Login.
+    $this->login();
+  }
+
+  /**
+   * Retrieve a table row containing specified text from a given element.
+   *
+   * @param \Behat\Mink\Element\Element
+   * @param string
+   *   The text to search for in the table row.
+   *
+   * @return \Behat\Mink\Element\NodeElement
+   *
+   * @throws \Exception
+   */
+  public function getTableRow(Element $element, $search) {
+    $rows = $element->findAll('css', 'tr');
+    if (empty($rows)) {
+      throw new \Exception(sprintf('No rows found on the page %s', $this->getSession()->getCurrentUrl()));
+    }
+    foreach ($rows as $row) {
+      if (strpos($row->getText(), $search) !== FALSE) {
+        return $row;
+      }
+    }
+    throw new \Exception(sprintf('Failed to find a row containing "%s" on the page %s', $search, $this->getSession()->getCurrentUrl()));
+  }
+
+  /**
+   * Find text in a table row containing given text.
+   *
+   * @Then I should see (the text ):text in the :rowText row
+   */
+  public function assertTextInTableRow($text, $rowText) {
+    $row = $this->getTableRow($this->getSession()->getPage(), $rowText);
+    if (strpos($row->getText(), $text) === FALSE) {
+      throw new \Exception(sprintf('Found a row containing "%s", but it did not contain the text "%s".', $rowText, $text));
+    }
+  }
+
+  /**
+   * Asset text not in a table row containing given text.
+   *
+   * @Then I should not see (the text ):text in the :rowText row
+   */
+  public function assertTextNotInTableRow($text, $rowText) {
+    $row = $this->getTableRow($this->getSession()->getPage(), $rowText);
+    if (strpos($row->getText(), $text) !== FALSE) {
+      throw new \Exception(sprintf('Found a row containing "%s", but it contained the text "%s".', $rowText, $text));
+    }
+  }
+
+  /**
+   * Attempts to find a link in a table row containing giving text. This is for
+   * administrative pages such as the administer content types screen found at
+   * `admin/structure/types`.
+   *
+   * @Given I click :link in the :rowText row
+   * @Then I (should )see the :link in the :rowText row
+   */
+  public function assertClickInTableRow($link, $rowText) {
+    $page = $this->getSession()->getPage();
+    if ($link_element = $this->getTableRow($page, $rowText)->findLink($link)) {
+      // Click the link and return.
+      $link_element->click();
+      return;
+    }
+    throw new \Exception(sprintf('Found a row containing "%s", but no "%s" link on the page %s', $rowText, $link, $this->getSession()->getCurrentUrl()));
+  }
+
+  /**
+   * @Given the cache has been cleared
+   */
+  public function assertCacheClear() {
+    $this->getDriver()->clearCache();
+  }
+
+  /**
+   * @Given I run cron
+   */
+  public function assertCron() {
+    $this->getDriver()->runCron();
+  }
+
+  /**
+   * Creates content of the given type.
+   *
+   * @Given I am viewing a/an :type (content )with the title :title
+   * @Given a/an :type (content )with the title :title
+   */
+  public function createNode($type, $title) {
+    // @todo make this easily extensible.
+    $node = (object) array(
+      'title' => $title,
+      'type' => $type,
+    );
+    $saved = $this->nodeCreate($node);
+    // Set internal page on the new node.
+    $this->getSession()->visit($this->locatePath('/node/' . $saved->nid));
+  }
+
+  /**
+   * Creates content authored by the current user.
+   *
+   * @Given I am viewing my :type (content )with the title :title
+   */
+  public function createMyNode($type, $title) {
+    if (!isset($this->user->uid)) {
+      throw new \Exception(sprintf('There is no current logged in user to create a node for.'));
+    }
+
+    $node = (object) array(
+      'title' => $title,
+      'type' => $type,
+      'body' => $this->getRandom()->name(255),
+      'uid' => $this->user->uid,
+    );
+    $saved = $this->nodeCreate($node);
+
+    // Set internal page on the new node.
+    $this->getSession()->visit($this->locatePath('/node/' . $saved->nid));
+  }
+
+  /**
+   * Creates content of a given type provided in the form:
+   * | title    | author     | status | created           |
+   * | My title | Joe Editor | 1      | 2014-10-17 8:00am |
+   * | ...      | ...        | ...    | ...               |
+   *
+   * @Given :type content:
+   */
+  public function createNodes($type, TableNode $nodesTable) {
+    foreach ($nodesTable->getHash() as $nodeHash) {
+      $node = (object) $nodeHash;
+      $node->type = $type;
+      $this->nodeCreate($node);
+    }
+  }
+
+  /**
+   * Creates content of the given type, provided in the form:
+   * | title     | My node        |
+   * | Field One | My field value |
+   * | author    | Joe Editor     |
+   * | status    | 1              |
+   * | ...       | ...            |
+   *
+   * @Given I am viewing a/an :type( content):
+   */
+  public function assertViewingNode($type, TableNode $fields) {
+    $node = (object) array(
+      'type' => $type,
+    );
+    foreach ($fields->getRowsHash() as $field => $value) {
+      $node->{$field} = $value;
+    }
+
+    $saved = $this->nodeCreate($node);
+
+    // Set internal browser on the node.
+    $this->getSession()->visit($this->locatePath('/node/' . $saved->nid));
+  }
+
+  /**
+   * Asserts that a given content type is editable.
+   *
+   * @Then I should be able to edit a/an :type( content)
+   */
+  public function assertEditNodeOfType($type) {
+    $node = (object) array(
+      'type' => $type,
+      'title' => "Test $type",
+    );
+    $saved = $this->nodeCreate($node);
+
+    // Set internal browser on the node edit page.
+    $this->getSession()->visit($this->locatePath('/node/' . $saved->nid . '/edit'));
+
+    // Test status.
+    $this->assertSession()->statusCodeEquals('200');
+  }
+
+
+  /**
+   * Creates a term on an existing vocabulary.
+   *
+   * @Given I am viewing a/an :vocabulary term with the name :name
+   * @Given a/an :vocabulary term with the name :name
+   */
+  public function createTerm($vocabulary, $name) {
+    // @todo make this easily extensible.
+    $term = (object) array(
+      'name' => $name,
+      'vocabulary_machine_name' => $vocabulary,
+      'description' => $this->getRandom()->name(255),
+    );
+    $saved = $this->termCreate($term);
+
+    // Set internal page on the term.
+    $this->getSession()->visit($this->locatePath('/taxonomy/term/' . $saved->tid));
+  }
+
+  /**
+   * Creates multiple users.
+   *
+   * Provide user data in the following format:
+   *
+   * | name     | mail         | roles        |
+   * | user foo | foo@bar.com  | role1, role2 |
+   *
+   * @Given users:
+   */
+  public function createUsers(TableNode $usersTable) {
+    foreach ($usersTable->getHash() as $userHash) {
+
+      // Split out roles to process after user is created.
+      $roles = array();
+      if (isset($userHash['roles'])) {
+        $roles = explode(',', $userHash['roles']);
+        $roles = array_filter(array_map('trim', $roles));
+        unset($userHash['roles']);
+      }
+
+      $user = (object) $userHash;
+      // Set a password.
+      if (!isset($user->pass)) {
+        $user->pass = $this->getRandom()->name();
+      }
+      $this->userCreate($user);
+
+      // Assign roles.
+      foreach ($roles as $role) {
+        $this->getDriver()->userAddRole($user, $role);
+      }
+    }
+  }
+
+  /**
+   * Creates one or more terms on an existing vocabulary.
+   *
+   * Provide term data in the following format:
+   *
+   * | name  | parent | description | weight | taxonomy_field_image |
+   * | Snook | Fish   | Marine fish | 10     | snook-123.jpg        |
+   * | ...   | ...    | ...         | ...    | ...                  |
+   *
+   * Only the 'name' field is required.
+   *
+   * @Given :vocabulary terms:
+   */
+  public function createTerms($vocabulary, TableNode $termsTable) {
+    foreach ($termsTable->getHash() as $termsHash) {
+      $term = (object) $termsHash;
+      $term->vocabulary_machine_name = $vocabulary;
+      $this->termCreate($term);
+    }
+  }
+
+  /**
+   * Creates one or more languages.
+   *
+   * @Given the/these (following )languages are available:
+   *
+   * Provide language data in the following format:
+   *
+   * | langcode |
+   * | en       |
+   * | fr       |
+   *
+   * @param TableNode $langcodesTable
+   *   The table listing languages by their ISO code.
+   */
+  public function createLanguages(TableNode $langcodesTable) {
+    foreach ($langcodesTable->getHash() as $row) {
+      $language = (object) array(
+        'langcode' => $row['languages'],
+      );
+      $this->languageCreate($language);
+    }
+  }
+
+  /**
+   * Pauses the scenario until the user presses a key. Useful when debugging a scenario.
+   *
+   * @Then (I )break
+   */
+    public function iPutABreakpoint()
+    {
+      fwrite(STDOUT, "\033[s \033[93m[Breakpoint] Press \033[1;93m[RETURN]\033[0;93m to continue, or 'q' to quit...\033[0m");
+      do {
+        $line = trim(fgets(STDIN, 1024));
+        //Note: this assumes ASCII encoding.  Should probably be revamped to
+        //handle other character sets.
+        $charCode = ord($line);
+        switch($charCode){
+          case 0: //CR
+          case 121: //y
+          case 89: //Y
+            break 2;
+          // case 78: //N
+          // case 110: //n
+          case 113: //q
+          case 81: //Q
+            throw new \Exception("Exiting test intentionally.");
+          default:
+            fwrite(STDOUT, sprintf("\nInvalid entry '%s'.  Please enter 'y', 'q', or the enter key.\n", $line));
+          break;
+        }
+      } while (true);
+      fwrite(STDOUT, "\033[u");
+    }
+
+}