Using Cucumber with Expertiza
Cucumber Stack
Features
Features provide a brief description about the functionality being tested.
In Expertiza, features are stored in /features. Within this folder you can find several sub-folders such as /admin, /instructor, and /student. This structure is to organize tests that apply to specific roles.
Each .feature file tests a specific aspect of the system, such as an Administrator's ability to Impersonate a User. (/features/admin/impersonate_user.feature) A feature is written in an explanatory syntax called Gherkin. For the Impersonate User feature, a feature would be described as.
Feature: Impersonate User As an Administrator I should be able to impersonate users
Scenarios
Each feature file can contain multiple scenarios. This is to test the same feature in different ways. For example. An administrator should be able to impersonate an existing student, but he should not be able to impersonate a student that doesn't exist. In the case of an instructor, he should only be able to impersonate students that are in his class.
Scenario: Impersonate a student as an Administrator
Given an Administrator named "cucumber" exists
And a Student named "impersonated_account" created by "cucumber" exists
When I log in as "cucumber"
And I click the menu link "Impersonate User"
And I fill in "user_name" with "impersonated_account"
When I press "Impersonate"
Then I should be logged in as "impersonated_account"
Scenario: Impersonate a student that does not exist
Given an Administrator named "cucumber" exists
When I log in as "cucumber"
And I click the menu link "Impersonate User"
And I fill in "user_name" with "impersonated_account"
When I press "Impersonate"
Then I should see "No user exists with the name 'impersonated_account'"
Gherkin provides multiple keywords to describe steps in a scenario such as:
- Feature
- Background
- Scenario
- Given
- When
- Then
- And
- But
- Scenario Outline
- Examples