[Summary view] [Print] [Text view]

   1  <?php
   2  // This file is part of Moodle - http://moodle.org/
   3  //
   4  // Moodle is free software: you can redistribute it and/or modify
   5  // it under the terms of the GNU General Public License as published by
   6  // the Free Software Foundation, either version 3 of the License, or
   7  // (at your option) any later version.
   8  //
   9  // Moodle is distributed in the hope that it will be useful,
  10  // but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12  // GNU General Public License for more details.
  13  //
  14  // You should have received a copy of the GNU General Public License
  15  // along with Moodle.  If not, see <http://www.gnu.org/licenses/>.
  16  
  17  /**
  18   * Behat question-related steps definitions.
  19   *
  20   * @package    core_question
  21   * @category   test
  22   * @copyright  2013 David Monllaó
  23   * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
  24   */
  25  
  26  // NOTE: no MOODLE_INTERNAL test here, this file may be required by behat before including /config.php.
  27  
  28  require_once (__DIR__ . '/behat_question_base.php');
  29  
  30  use Behat\Behat\Context\Step\Given as Given,
  31      Behat\Gherkin\Node\TableNode as TableNode,
  32      Behat\Mink\Exception\ExpectationException as ExpectationException,
  33      Behat\Mink\Exception\ElementNotFoundException as ElementNotFoundException;
  34  
  35  /**
  36   * Steps definitions related with the question bank management.
  37   *
  38   * @package    core_question
  39   * @category   test
  40   * @copyright  2013 David Monllaó
  41   * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
  42   */
  43  class behat_question extends behat_question_base {
  44  
  45      /**
  46       * Creates a question in the current course questions bank with the provided data. This step can only be used when creating question types composed by a single form.
  47       *
  48       * @Given /^I add a "(?P<question_type_name_string>(?:[^"]|\\")*)" question filling the form with:$/
  49       * @param string $questiontypename The question type name
  50       * @param TableNode $questiondata The data to fill the question type form.
  51       * @return Given[] the steps.
  52       */
  53      public function i_add_a_question_filling_the_form_with($questiontypename, TableNode $questiondata) {
  54  
  55          return array_merge(array(
  56              new Given('I follow "' . get_string('questionbank', 'question') . '"'),
  57              new Given('I press "' . get_string('createnewquestion', 'question') . '"'),
  58                  ), $this->finish_adding_question($questiontypename, $questiondata));
  59      }
  60  
  61      /**
  62       * Checks the state of the specified question.
  63       *
  64       * @Then /^the state of "(?P<question_description_string>(?:[^"]|\\")*)" question is shown as "(?P<state_string>(?:[^"]|\\")*)"$/
  65       * @throws ExpectationException
  66       * @throws ElementNotFoundException
  67       * @param string $questiondescription
  68       * @param string $state
  69       */
  70      public function the_state_of_question_is_shown_as($questiondescription, $state) {
  71  
  72          // Using xpath literal to avoid quotes problems.
  73          $questiondescriptionliteral = $this->getSession()->getSelectorsHandler()->xpathLiteral($questiondescription);
  74          $stateliteral = $this->getSession()->getSelectorsHandler()->xpathLiteral($state);
  75  
  76          // Split in two checkings to give more feedback in case of exception.
  77          $exception = new ElementNotFoundException($this->getSession(), 'Question "' . $questiondescription . '" ');
  78          $questionxpath = "//div[contains(concat(' ', normalize-space(@class), ' '), ' que ')]" .
  79                  "[contains(div[@class='content']/div[@class='formulation'], {$questiondescriptionliteral})]";
  80          $this->find('xpath', $questionxpath, $exception);
  81  
  82          $exception = new ExpectationException('Question "' . $questiondescription . '" state is not "' . $state . '"', $this->getSession());
  83          $xpath = $questionxpath . "/div[@class='info']/div[@class='state' and contains(., {$stateliteral})]";
  84          $this->find('xpath', $xpath, $exception);
  85      }
  86  }