Actions

Difference between revisions of "Testing/Behat Testing/Setup"

From Mahara Wiki

< Testing/Behat Testing
(How to install Mahara and Behat)
Line 1: Line 1:
=How to install Mahara and Behat=
+
{{note|These instructions for the Behat setup are only for machines running Linux. They will not work for Windows machines.}}
 
 
'''Note''': These instructions for Mahara and Behat setup are only for machines running Linux. They will not work for Windows machines.
 
  
 
1. Set up your [[Developer_Area/Developer_Environment | developer environment]] if you haven't already done so.
 
1. Set up your [[Developer_Area/Developer_Environment | developer environment]] if you haven't already done so.
Line 21: Line 19:
 
</source>
 
</source>
  
{{note|There should be a behat_dataroot for each Mahara instance that you set up. Here the one for the master branch / this Mahara instance is created.
+
{{note|There should be a behat_dataroot for each Mahara instance that you set up. Here the one for the master branch / this Mahara instance is created.}}
  
 
4. Make your Behat data directory (check this matches what you set in config.php):
 
4. Make your Behat data directory (check this matches what you set in config.php):

Revision as of 08:05, 12 July 2015

Note: These instructions for the Behat setup are only for machines running Linux. They will not work for Windows machines.

1. Set up your developer environment if you haven't already done so.

2. Install Behat's dependencies:

$ sudo apt-get install curl openjdk-7-jre-headless

3. Add the following config settings to the bottom of your Mahara config.php file inside the htdocs/ subdirectory of the Mahara codebase.

Note: If /var/www/maharadata is not where you created your dataroot, you'll need to replace that with the correct path in the following commands
// Behat config
$cfg->behat_dbprefix = 'behat_'; // must not empty
$cfg->behat_dataroot = "/var/lib/maharadata/master_behat"; // Behat's copy of maharadata
$cfg->behat_wwwroot = 'http://localhost:8000'; // Must be this
Note: There should be a behat_dataroot for each Mahara instance that you set up. Here the one for the master branch / this Mahara instance is created.

4. Make your Behat data directory (check this matches what you set in config.php):

$ sudo mkdir /var/lib/maharadata/master_behat

5. Make the directory writeable by Mahara (check this is correct):

$ sudo chmod 777 /var/lib/maharadata/behat

6. Run Behat tests (change into your Mahara code directory first):

$ cd
$ cd code/mahara
./test/behat/mahara_behat.sh run

For the first time of running Behat, you need to wait for the Behat environment initialisation. This can take a while.

To run all tests:

./test/behat/mahara_behat.sh run

To run your specific tests:

./test/behat/mahara_behat.sh run @yourtags