Actions

Testing Area/Behat Testing/Setup: Difference between revisions

From Mahara Wiki

< Testing Area‎ | Behat Testing
No edit summary
No edit summary
 
(51 intermediate revisions by 12 users not shown)
Line 1: Line 1:
<h1>How to install Mahara and Behat</h1>
{{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|error}}
1. Set up your [[Developer_Area/Developer_Environment | developer environment]] if you haven't already done so.


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


For devs instructions to install a Mahara please use [[System_Administrator%27s_Guide/Installing_Mahara]].
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}}


For everyone else please follow the steps below:
<syntaxhighlight lang="bash">
// Behat config
$cfg->behat_test = true; // Turn this off when you are not behat testing
$cfg->behat_dbprefix = 'behat_'; // must not empty
$cfg->behat_dataroot = "/var/lib/maharadata/main_behat"; // The Behat copy of maharadata.
$cfg->behat_wwwroot = 'http://localhost:8000'; // Must be this
$cfg->behat_selenium2 = "http://127.0.0.1:4444/wd/hub"; // Must be this


// If you want failed step screenshots appear directly on screen while the step fails (only Ubuntu)
$cfg->behat_view_screenshots = true;
</syntaxhighlight>


Install Apache, PHP5, Database, Git:
{{note|There should be a behat_dataroot for each Mahara instance that you set up. Here the one for the main branch / this Mahara instance is created.}}
sudo apt-get install php5 php5-cli php5-pgsql php5-xmlrpc php5-intl php5-curl php5-gd php5-xdebug php5-dbg postgresql apache2 git curl openjdk-7-jre-headless xvfb
{{note|If the directory for $cfg->behat_dataroot does not exist then it will need to be created.}}


Restart Apache
4. Make your Behat data directory (check this matches what you set in config.php):
sudo service apache2 restart
<syntaxhighlight lang="bash">
$ sudo mkdir /var/lib/maharadata/main_behat
</syntaxhighlight>


Make a Mahara directory in the same place as Moodle
5. Make the directory and any subdirectories writeable by Mahara (check the directory is correct):
sudo mkdir /var/www/html/mahara
<syntaxhighlight lang="bash">
$ sudo chmod 777 -R /var/lib/maharadata/main_behat
</syntaxhighlight>
<span id="chown"></span>
6. Change the directory and any subdirectories permissions to be owned by apache user (check the directory is correct):
<syntaxhighlight lang="bash">
$ sudo chown -R www-data:www-data /var/lib/maharadata/main_behat
</syntaxhighlight>


Then change into the Mahara directory
*For Ubuntu, apache runs with user www-data
cd /var/www/html/mahara
*For Centos, apache runs with user apache


Then change the permission (insert the username of the machine into the username. Don't use the word username)
7. Run Behat tests (change into your Mahara code directory first) as the apache user:
sudo chown username:username /var/www/html/mahara
<syntaxhighlight lang="bash">
$ cd
$ cd code/mahara
./test/behat/mahara_behat.sh run
</syntaxhighlight>


Get Mahara clone.
Or if you have sudo access:
git clone https://github.com/MaharaProject/mahara.git .
<syntaxhighlight lang="bash">
$ cd
$ cd code/mahara
sudo -u www-data ./test/behat/mahara_behat.sh run
</syntaxhighlight>


Checkout the master(15.04) branch
git checkout master


Note: if this step doesn't work. You may have forgotten the fullstop off the end of the git clone command. It created a mahara directory inside the other mahara directory. Go in to the file explorer and delete the second instance.  
For the first time of running Behat, you need to wait for the Behat environment initialisation. This can take a while.


Become Postgres user:
To run all tests:
  sudo su postgres
  ./test/behat/mahara_behat.sh run


Open psql. After some preamble you should see the prompt postgres=#.
To run your specific tests marked with @yourtags:
psql
./test/behat/mahara_behat.sh run @yourtags


You should now see postgres=# ready and awaiting your command.
To run a particular feature file:
./test/behat/mahara_behat.sh run my_file.feature


Create a user and don't use the PW that you use for your workstation:
The run / runheadless / rundebug / rundebugheadless / runfresh are interchangable with run in above commands
CREATE USER maharauser WITH PASSWORD 'yourpassword';
 
As you previously did, you should see postgres=#
You are now going to create a database:
CREATE DATABASE mahara WITH OWNER maharauser;


Exit to leave psql by pressing Ctrl-D
[[Category:Behat]]
 
Exit back to your own user:
exit
 
Make a data directory:
sudo mkdir /var/www/maharadata


Make directory writeable by mahara:
==Running Behat tests with html report and screenshots on failed steps==
sudo chmod 777 /var/www/maharadata


To run tests with html output, add the flag 'html' to your test run command, e.g:


In the code below make sure you change <your email address> to your actual work email address, without the <> signs.
<syntaxhighlight lang="bash">./test/behat/mahara_behat.sh run create_page.feature html</syntaxhighlight>


<pre>
This will automatically open an html report of the test run in your browser. If there were failed steps, the the html report plugin takes a screenshot of the page that failed.
<?php
You can find the screenshots in your behat dataroot (usually /var/lib/maharadata/main_behat) at the following path:
$cfg = new stdClass();
behat/html_results/<feature title>/<scenario title>.png


$branch = 'master';
Ubuntu only (you need the image viewer '[https://packages.ubuntu.com/search?keywords=eog eog]'): If you set


// database connection details
$cfg->behat_view_screenshots = true;
// valid values for dbtype are 'postgres8' and 'mysql5'
$cfg->dbtype  = 'postgres';
$cfg->dbhost  = 'localhost';
$cfg->dbuser  = 'maharauser';
$cfg->dbname  = "mahara";
$cfg->dbpass  = 'password';  


$cfg->dataroot = "/var/www/maharadata";
in your config.php file then the images will be opened up in image browser.


$cfg->sendemail = true;
Hopefully we will rig up the report to link to the screenshot soon.
$cfg->sendallemailto = '<your email address>';


$cfg->productionmode = false;
==How to Run Mahara behat test on Chrome for versions older than 17.04==
$cfg->perftofoot = true;
</pre>


{{note|Mahara behat is running on chrome driver by default in 17:04+}}


An example config.php should appear:
This is steps for older versions of Mahara


* Copy all of the code above
1. Download chromedriver here http://www.seleniumhq.org/download/ ( download the latest release)
* open text editor from start menu
* paste code
* save file in the directory: /var/www/html/mahara/htdocs/ and call it config.php
* save


===Behat installation with Mahara===
2. Start selenium Server with chrome driver


Add these config settings to the bottom of your config.php file.  
$ java -jar selenium-server-standalone-2.53.1.jar -Dwebdriver.chrome.driver=path of chromedriver


<pre>
3. Change the behat.yml file as follows,
// Behat config
$cfg->dbprefix = ''; // Behat complains without this
$cfg->wwwroot = 'http://127.0.0.1/mahara/htdocs';
$cfg->behat_dbprefix = 'behat_'; // must not empty
$cfg->behat_dataroot = '/var/www/maharadata/behat';
$cfg->behat_wwwroot = 'http://localhost:8000';
</pre>


Make a data directory:
Here is the file path var/lib/maharadata/main_behat/behat.yml
sudo mkdir /var/www/maharadata/behat


Make directory writeable by mahara:
when you open the beaht.yml file replace the following code with the lines that contain sessions to go
sudo chmod 777 /var/www/maharadata/behat


Run Behat tests
javascript_session: selenium2
cd /var/www/html/mahara
        selenium2:
./test/behat/mahara_behat.sh run
          browser: chrome
            goutte: ~


For the first time of running behat, you need to wait for the Behat environment initialisation.
4. Run the behat test without rundebug


Run your specific test from now on run:
for example ./test/behat/mahara_behat.sh run example.feature
Make sure it's saved in the feature folder with the name something.feature and it has tags in it, inc @javascript and then run this line from the mahara directory:
Remember cd into Mahara directory first.
  ./test/behat/mahara_behat.sh run @yourtags


==Debugging==


[[Category:Behat]]
Go here for tips: https://wiki.mahara.org/wiki/Testing/Behat_Testing/Error_%26_Solutions

Latest revision as of 12:21, 15 Haziran 2023

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-8-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_test = true; // Turn this off when you are not behat testing
$cfg->behat_dbprefix = 'behat_'; // must not empty
$cfg->behat_dataroot = "/var/lib/maharadata/main_behat"; // The Behat copy of maharadata.
$cfg->behat_wwwroot = 'http://localhost:8000'; // Must be this
$cfg->behat_selenium2 = "http://127.0.0.1:4444/wd/hub"; // Must be this

// If you want failed step screenshots appear directly on screen while the step fails (only Ubuntu)
$cfg->behat_view_screenshots = true;
Note: There should be a behat_dataroot for each Mahara instance that you set up. Here the one for the main branch / this Mahara instance is created.
Note: If the directory for $cfg->behat_dataroot does not exist then it will need to be created.

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

$ sudo mkdir /var/lib/maharadata/main_behat

5. Make the directory and any subdirectories writeable by Mahara (check the directory is correct): 

$ sudo chmod 777 -R /var/lib/maharadata/main_behat

6. Change the directory and any subdirectories permissions to be owned by apache user (check the directory is correct): 

$ sudo chown -R www-data:www-data /var/lib/maharadata/main_behat
  • For Ubuntu, apache runs with user www-data
  • For Centos, apache runs with user apache

7. Run Behat tests (change into your Mahara code directory first) as the apache user: 

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

Or if you have sudo access: 

$ cd
$ cd code/mahara
sudo -u www-data ./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 marked with @yourtags: 

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

To run a particular feature file: 

./test/behat/mahara_behat.sh run my_file.feature

The run / runheadless / rundebug / rundebugheadless / runfresh are interchangable with run in above commands

Running Behat tests with html report and screenshots on failed steps

To run tests with html output, add the flag 'html' to your test run command, e.g: 

./test/behat/mahara_behat.sh run create_page.feature html

This will automatically open an html report of the test run in your browser. If there were failed steps, the the html report plugin takes a screenshot of the page that failed. You can find the screenshots in your behat dataroot (usually /var/lib/maharadata/main_behat) at the following path: behat/html_results/<feature title>/<scenario title>.png

Ubuntu only (you need the image viewer 'eog'): If you set 

$cfg->behat_view_screenshots = true;

in your config.php file then the images will be opened up in image browser.

Hopefully we will rig up the report to link to the screenshot soon.

How to Run Mahara behat test on Chrome for versions older than 17.04

Note: Mahara behat is running on chrome driver by default in 17:04+

This is steps for older versions of Mahara

1. Download chromedriver here http://www.seleniumhq.org/download/ ( download the latest release)

2. Start selenium Server with chrome driver

$ java -jar selenium-server-standalone-2.53.1.jar -Dwebdriver.chrome.driver=path of chromedriver

3. Change the behat.yml file as follows,

Here is the file path var/lib/maharadata/main_behat/behat.yml

when you open the beaht.yml file replace the following code with the lines that contain sessions to go

javascript_session: selenium2 

        selenium2:
          browser: chrome
           goutte: ~

4. Run the behat test without rundebug

for example ./test/behat/mahara_behat.sh run example.feature

Debugging

Go here for tips: https://wiki.mahara.org/wiki/Testing/Behat_Testing/Error_%26_Solutions

Retrieved from ‘https://wiki.mahara.org/index.php?title=Testing_Area/Behat_Testing/Setup&oldid=13718’