Actions

Difference between revisions of "Testing Area/Behat Testing/Basics"

From Mahara Wiki

< Testing Area‎ | Behat Testing
m (Anitsirk moved page Testing/Behat Testing/Basics to Testing Area/Behat Testing/Basics: Consolidating where testing pages sit)
(42 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
[[Category:Behat]]
 
[[Category:Behat]]
<h1>How to write a Behat test</h1>
+
<h1>How to write a Behat test - Overview/Summary</h1>
  
 +
Behat tests are written in Gerkin language, which is English readable. You write the test in a text editor like Vim, Gedit or Eclipse. For beginners, Gedit is recommended.
 +
To write the test start with the feature. The purpose of the Feature is to say what you are testing and what you gain from testing that feature.
  
Behat tests are written in Gerkin language, which is English readable. You write the test in a text editor like Vim, Gedit or Eclipse. For beginners, Gedit is reccomended.  
+
  ''<@javascript @core @core_portfolio_page>''        # Tag the tests appropriately to allow them to be run selectively.
To write the test start with the feature, you are about to click around Mahara and test an area so say:
+
  '''Feature:''' ''<Portfolio page creation>''              # Identify the area under test.
 +
  '''As a''' ''<logged in account type>''                    # Identify who 'you' are
 +
                                                          (e.g. site admin, institution admin, tutor, student).
 +
  '''I want to''' ''<save a portfolio page in Mahara>''      # Identify what 'you' want to do.                                
 +
  '''So that''' ''<there is a record of my work>''  # Identify why 'you' want to do it (i.e. benefit from it).
  
  Feature: Creating a Portfolio page <- (the point of the test)
 
  In order to have a portfolio page in Mahara <- (What you are wanting to do)
 
  As a student <- (Who you are logging in as eg student, admin, institution admin)
 
  So I can save my work on my Portfolio page <- (How you benefit from it)
 
  
 +
Then follows the scenario/s, there can be many of these, each addressing different preconditions.  Their names should identify what aspect of the feature is being tested. If you are testing a specific bug add the bug number here from Launchpad.
  
 +
  '''Scenario:''' ''<Create basic page (Bug 761234)>''      # Identify what aspect/s of the feature that is being testing.
 +
  ''#'' ''<Comment/s>''                                        # Comments may be used to clarify terminology e.g. what is 'basic'.
 +
  '''Given''' ''<Set the scene with a condition...>''        # Identify the preconditions that need to be met.
 +
  ''And''  ''<Add further condition/s>''                        # Use as many 'And's as you need to set the required preconditions.
 +
  ''#''    ''<Comment/s>''                                      # Comments may be milestone markers to improve human readability.
 +
  '''When'''  ''<Provable action occurs...>''                # Identify something that happens like clicking or pressing a button.
 +
  ''And''  ''<Add further action/s to occur>''                  # Use as many 'And's as you need to describe the action/s
 +
                                                                  (eg like pushing 10 buttons to get to the place you want).
 +
  ''#''    ''<Comment/s>''                                      # Comments may be used to describing why something has to happen. 
 +
  '''Then'''  ''<Add the desired outcome...>''              # Identify the achievable outcome e.g. what you see when you click.
 +
  ''And''  ''<Add further desire outcome/s<''                  # Use as many 'And's as you need to definite success.
 +
  ''#''    ''<Comment/s>''                                      # Comments may be used to further explain outcome/s & implications.
 +
 
 +
Write down every link you click and every button you pushed to create the page using the specific Behat syntax from this page [https://wiki.mahara.org/index.php/Testing/Behat_Testing/Steps].  These are your Given, And, When and Then steps.
  
   Scenario: Creating a Portfolio page <- (Describe what you are about to do to test it works)
+
Behat test example:
   Given (Setting the scene, these are you pre conditions)
+
<pre>
   And  (Use as many And's as you need to set the pre conditions)
+
   Feature: Portfolio page creation
   When (This is an action you do like clicking or pressing a button)
+
   As a student
  And  (Use as many And's as you need to describe the action you are doing like pushing 10 buttons to get to the place you want)
+
   I want to save a portfolio page in Mahara
  Then (This is the achieveable outcome. Often it's what you see when the link you clicked worked.)
+
   So that there is a record of my work to share.
  And  (Use as many And's as you need)
 
  
 +
Scenario: Create basic page (Bug 761234)
 +
  Given I am logged in as the user "Student1" with password "Password-123"
 +
  And I follow "Portfolio"
 +
  # Create a page
 +
  And I follow "Pages"
 +
  When I press "Create page"
 +
  # Filling in the information on the page
 +
  And I fill in the following:
 +
  | Page title | This is where you put the page title |
 +
  | Page description | This is where you type the description of the page |
 +
  # Saving the page
 +
  And I press "Save"
 +
  And I press "Done"
 +
  # Verifying that the page saved 
 +
  Then I should see "This is where you put the page title"
 +
</pre>
 +
'''Save the test as a .feature file in the appropriate directory. For example, portfolio_page_creation.feature'''
  
 +
The fastest way to write a test is using parts from previous tests. In the terminal use this command to search for the specific steps that you need:
 +
  grep --color=auto -RniP -C 3 --include *.feature '(given|when|then|and).*delete.*activity' *
 +
Replace delete and activity with the specific things that you need to search for
  
 
+
For further information on Behat, Gherkin etc. please see [http://docs.behat.org/en/v2.5/guides/1.gherkin.html here] (the base web site for Behat testing).  Also, see [https://cucumber.io/docs/guides/ here] for more information on Gherkin and Cucumber.
You can follow the Behat documentation below on how to write a test:
 
[http://docs.behat.org/en/v2.5/guides/1.gherkin.html]
 

Revision as of 14:05, 8 June 2020

How to write a Behat test - Overview/Summary

Behat tests are written in Gerkin language, which is English readable. You write the test in a text editor like Vim, Gedit or Eclipse. For beginners, Gedit is recommended. To write the test start with the feature. The purpose of the Feature is to say what you are testing and what you gain from testing that feature.

 <@javascript @core @core_portfolio_page>         # Tag the tests appropriately to allow them to be run selectively.
 Feature: <Portfolio page creation>               # Identify the area under test.
 As a <logged in account type>                    # Identify who 'you' are 
                                                         (e.g. site admin, institution admin, tutor, student).
 I want to <save a portfolio page in Mahara>      # Identify what 'you' want to do.                                  
 So that <there is a record of my work>  # Identify why 'you' want to do it (i.e. benefit from it).


Then follows the scenario/s, there can be many of these, each addressing different preconditions. Their names should identify what aspect of the feature is being tested. If you are testing a specific bug add the bug number here from Launchpad.

 Scenario: <Create basic page (Bug 761234)>       # Identify what aspect/s of the feature that is being testing.
 # <Comment/s>                                         # Comments may be used to clarify terminology e.g. what is 'basic'.
 Given <Set the scene with a condition...>        # Identify the preconditions that need to be met.
 And  <Add further condition/s>                        # Use as many 'And's as you need to set the required preconditions.
 #    <Comment/s>                                      # Comments may be milestone markers to improve human readability.
 When  <Provable action occurs...>                # Identify something that happens like clicking or pressing a button.
 And  <Add further action/s to occur>                  # Use as many 'And's as you need to describe the action/s
                                                                 (eg like pushing 10 buttons to get to the place you want).
 #    <Comment/s>                                      # Comments may be used to describing why something has to happen.  
 Then  <Add the desired outcome...>               # Identify the achievable outcome e.g. what you see when you click.
 And  <Add further desire outcome/s<                   # Use as many 'And's as you need to definite success. 
 #    <Comment/s>                                      # Comments may be used to further explain outcome/s & implications.
 

Write down every link you click and every button you pushed to create the page using the specific Behat syntax from this page [1]. These are your Given, And, When and Then steps.

Behat test example:

  Feature: Portfolio page creation
  As a student
  I want to save a portfolio page in Mahara
  So that there is a record of my work to share.

 Scenario: Create basic page (Bug 761234)
  Given I am logged in as the user "Student1" with password "Password-123"
  And I follow "Portfolio"
  # Create a page 
  And I follow "Pages"
  When I press "Create page"
  # Filling in the information on the page
  And I fill in the following:
  | Page title | This is where you put the page title |
  | Page description | This is where you type the description of the page |
  # Saving the page
  And I press "Save"
  And I press "Done"
  # Verifying that the page saved  
  Then I should see "This is where you put the page title"

Save the test as a .feature file in the appropriate directory. For example, portfolio_page_creation.feature

The fastest way to write a test is using parts from previous tests. In the terminal use this command to search for the specific steps that you need:

 grep --color=auto -RniP -C 3 --include *.feature '(given|when|then|and).*delete.*activity' *

Replace delete and activity with the specific things that you need to search for

For further information on Behat, Gherkin etc. please see here (the base web site for Behat testing). Also, see here for more information on Gherkin and Cucumber.