View source for Testing Area/Behat Testing/Setup

{{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_Area/Developer_Environment | developer environment]] if you haven't already done so.

2. Install Behat's dependencies:
<source lang="bash" enclose="div">
$ sudo apt-get install curl openjdk-7-jre-headless
</source>

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}}

<source lang="bash" enclose="div">
// 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
</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.}}

4. Make your Behat data directory (check this matches what you set in config.php):
<source lang="bash" enclose="div">
$ sudo mkdir /var/lib/maharadata/master_behat
</source>

5. Make the directory writeable by Mahara (check this is correct): 
<source lang="bash" enclose="div">
$ sudo chmod 777 /var/lib/maharadata/behat
</source>

6. Run Behat tests (change into your Mahara code directory first):
<source lang="bash" enclose="div">
$ cd
$ cd code/mahara
./test/behat/mahara_behat.sh run
</source>

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


[[Category:Behat]]