CSC/ECE 517 Fall 2017/E1766 Test team functionality: Difference between revisions
(Created page with "== Background == Expertiza is an open source web based peer review system developed and maintained by students and faculty at North Carolina State University. It enables students...") |
|||
(14 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
== Background == | == Background == | ||
Expertiza is | Expertiza is a peer review based system which provides incremental learning from the class. This project has been developed together by faculty and students using Ruby on Rails framework. Expertiza allows the instructor to create, edit and delete assignments, create new assignment topics, assign them to a particular class or selected students, have students work on teams and then review each other's assignments at the end. For the students, they can signup for topics, form teams, and submit their projects and assignments. Students then review the work done by other students and give suggestions to improve. Teams after reviews are allotted scores and they can refer to the peer comments to further improve their work. It also supports submission of different file types for assignments, including the URLs and wiki pages. | ||
== Purpose == | == Purpose == | ||
Line 20: | Line 14: | ||
Capybara gem allows a user to test their web application through simulations. | Capybara gem allows a user to test their web application through simulations. | ||
== | == Test Plan (Implementation of functional tests) == | ||
=== Functional Tests for Create group assignment === | |||
In Expertiza instructor can create public assignment for particular course, define the required rubrics and add students to that assignment. | |||
The following test spec has been written to create public group assignment | |||
<pre> | <pre> | ||
def create_new_assignment | |||
login_as("instructor6") | |||
visit "/assignments/new?private=0" | |||
fill_in 'assignment_form_assignment_name', with: 'public assignment for test' | |||
select('Course 2', from: 'assignment_form_assignment_course_id') | |||
fill_in 'assignment_form_assignment_directory_path', with: 'testDirectory' | |||
fill_in 'assignment_form_assignment_spec_location', with: 'testLocation' | |||
check("assignment_form_assignment_microtask") | |||
check("team_assignment") | |||
fill_in 'assignment_form_assignment_max_team_size', with: '3', visible: false | |||
check("assignment_form_assignment_reviews_visible_to_all") | |||
check("assignment_form_assignment_is_calibrated") | |||
check("assignment_form_assignment_availability_flag") | |||
expect(page).to have_select("assignment_form[assignment][reputation_algorithm]", options: ['--', 'Hamer', 'Lauw']) | |||
click_button 'Create' | |||
end | |||
</pre> | </pre> | ||
Add topics to the assignment | |||
<pre> | <pre> | ||
def add_topic_to_assignment assignment | |||
visit "/assignments/#{assignment.id}/edit" | |||
click_link 'Topics' | |||
click_link 'New topic' | |||
fill_in 'topic_topic_identifier', with: '112' | |||
fill_in 'topic_topic_name', with: 'test_topic_1' | |||
fill_in 'topic_category', with: 'test_topic_1' | |||
fill_in 'topic_max_choosers', with: 3 | |||
click_button 'Create' | |||
create(:assignment_due_date) | |||
create_list(:participant, 3) | |||
end | end | ||
</pre> | </pre> | ||
=== Functional Tests for Log in as student and selecting a topic of assignment === | |||
When student login into his Expertiza account, he can check for new assignment under "Assignments" tab and choose the topic of his interest. Student then can send invitation to other students who are also enrolled in same course. | |||
We have written following test spec to impersonate as a student and select a topic | |||
<pre> | <pre> | ||
it "should impersonate as student" do | |||
user = User.find_by(name: "student2064") | |||
stub_current_user(user, user.role.name, user.role) | |||
visit '/student_task/list' | |||
# Assignment name | |||
expect(page).to have_content('public assignment for test') | |||
click_link 'public assignment for test' | |||
expect(page).to have_content('Submit or Review work for public assignment for test') | |||
click_link 'Signup sheet' | |||
expect(page).to have_content('Signup sheet for public assignment for test assignment') | |||
assignment_id = Assignment.first.id | |||
visit "/sign_up_sheet/sign_up?id=#{assignment_id}&topic_id=1" | |||
expect(page).to have_content('Your topic(s): test_topic_1') | |||
end | |||
</pre> | </pre> | ||
Sending invitations to other students | |||
<pre> | <pre> | ||
visit '/student_task/list' | |||
click_link 'public assignment for test' | |||
click_link 'Your team' | |||
expect(page).to have_content('public assignment for test_Team1') | |||
fill_in 'user_name', with: 'student2065' | |||
click_button 'Invite' | |||
fill_in 'user_name', with: 'student2066' | |||
click_button 'Invite' | |||
expect(page).to have_content('student2065') | |||
</pre> | </pre> | ||
=== Functional Tests for accepting an invitation === | |||
In Expertiza assignments, the only way for a student to join an existing team is to be invited by the leader. | |||
Following test spec has been written to accept the invitation to join the team and verify that the assignment topic is assigned to all users | |||
<pre> | <pre> | ||
it "joins the team" do | |||
expect(page).to have_content | user = User.find_by(name: "student2065") | ||
stub_current_user(user, user.role.name, user.role) | |||
visit '/student_task/list' | |||
expect(page).to have_content('public assignment for test') | |||
visit '/invitation/accept?inv_id=1&student_id=1&team_id=1' | |||
visit '/student_teams/view?student_id=1' | |||
expect(page).to have_content('Team Information for public assignment for test') | |||
# to test invalid case - student who is not part of the team does not have created assignment | |||
user = User.find_by(name: "student2066") | |||
stub_current_user(user, user.role.name, user.role) | |||
visit '/student_task/list' | |||
page.should has_no_content?('public assignment for test') | |||
end | |||
</pre> | </pre> | ||
===Functional Tests for whether students choosing the same topic are in the same team=== | ===Functional Tests for whether students choosing the same topic are in the same team=== | ||
Line 225: | Line 132: | ||
== Running the tests == | == Running the tests == | ||
The tests can be run on the terminal using the command: | The tests can be run on the terminal by navigating to the /spec/features directory using the command: | ||
<pre> | <pre> | ||
rspec | rspec team_functionalities_spec.rb | ||
</pre> | </pre> | ||
Line 233: | Line 140: | ||
== Result == | == Result == | ||
Coverage increased (+0.3%) to 51.108% when pulling 4915488 on ankit13jain:master into 781e456 on expertiza:master. | |||
== External Links == | == External Links == | ||
# link for forked repository [[https://github.com/ | # link for forked repository [[https://github.com/ankit13jain/expertiza]] | ||
# Github link for original repository [[https://github.com/expertiza/expertiza.git]] | # Github link for original repository [[https://github.com/expertiza/expertiza.git]] | ||
# Github link for Capybara [[https://github.com/jnicklas/capybara.git]] | # Github link for Capybara [[https://github.com/jnicklas/capybara.git]] |
Latest revision as of 21:35, 28 October 2017
Background
Expertiza is a peer review based system which provides incremental learning from the class. This project has been developed together by faculty and students using Ruby on Rails framework. Expertiza allows the instructor to create, edit and delete assignments, create new assignment topics, assign them to a particular class or selected students, have students work on teams and then review each other's assignments at the end. For the students, they can signup for topics, form teams, and submit their projects and assignments. Students then review the work done by other students and give suggestions to improve. Teams after reviews are allotted scores and they can refer to the peer comments to further improve their work. It also supports submission of different file types for assignments, including the URLs and wiki pages.
Purpose
The purpose of this task is to write functional tests for team functionality. Once an assignment is out, a student can select this assignment and others can join in the team. To test this functionality we wrote functional tests for the various scenarios. One such scenario is :
- Once the assignment is out and a student selects it, he/she can send out invites to other students to join the team.
- Invited students can accept the invitation and join the team.
Functional Tests
Functional tests ensure that the functionalities of a software system are working as expected. To write our functional tests, we used the Capybara gem available for Ruby. Capybara gem allows a user to test their web application through simulations.
Test Plan (Implementation of functional tests)
Functional Tests for Create group assignment
In Expertiza instructor can create public assignment for particular course, define the required rubrics and add students to that assignment.
The following test spec has been written to create public group assignment
def create_new_assignment login_as("instructor6") visit "/assignments/new?private=0" fill_in 'assignment_form_assignment_name', with: 'public assignment for test' select('Course 2', from: 'assignment_form_assignment_course_id') fill_in 'assignment_form_assignment_directory_path', with: 'testDirectory' fill_in 'assignment_form_assignment_spec_location', with: 'testLocation' check("assignment_form_assignment_microtask") check("team_assignment") fill_in 'assignment_form_assignment_max_team_size', with: '3', visible: false check("assignment_form_assignment_reviews_visible_to_all") check("assignment_form_assignment_is_calibrated") check("assignment_form_assignment_availability_flag") expect(page).to have_select("assignment_form[assignment][reputation_algorithm]", options: ['--', 'Hamer', 'Lauw']) click_button 'Create' end
Add topics to the assignment
def add_topic_to_assignment assignment visit "/assignments/#{assignment.id}/edit" click_link 'Topics' click_link 'New topic' fill_in 'topic_topic_identifier', with: '112' fill_in 'topic_topic_name', with: 'test_topic_1' fill_in 'topic_category', with: 'test_topic_1' fill_in 'topic_max_choosers', with: 3 click_button 'Create' create(:assignment_due_date) create_list(:participant, 3) end
Functional Tests for Log in as student and selecting a topic of assignment
When student login into his Expertiza account, he can check for new assignment under "Assignments" tab and choose the topic of his interest. Student then can send invitation to other students who are also enrolled in same course. We have written following test spec to impersonate as a student and select a topic
it "should impersonate as student" do user = User.find_by(name: "student2064") stub_current_user(user, user.role.name, user.role) visit '/student_task/list' # Assignment name expect(page).to have_content('public assignment for test') click_link 'public assignment for test' expect(page).to have_content('Submit or Review work for public assignment for test') click_link 'Signup sheet' expect(page).to have_content('Signup sheet for public assignment for test assignment') assignment_id = Assignment.first.id visit "/sign_up_sheet/sign_up?id=#{assignment_id}&topic_id=1" expect(page).to have_content('Your topic(s): test_topic_1') end
Sending invitations to other students
visit '/student_task/list' click_link 'public assignment for test' click_link 'Your team' expect(page).to have_content('public assignment for test_Team1') fill_in 'user_name', with: 'student2065' click_button 'Invite' fill_in 'user_name', with: 'student2066' click_button 'Invite' expect(page).to have_content('student2065')
Functional Tests for accepting an invitation
In Expertiza assignments, the only way for a student to join an existing team is to be invited by the leader.
Following test spec has been written to accept the invitation to join the team and verify that the assignment topic is assigned to all users
it "joins the team" do user = User.find_by(name: "student2065") stub_current_user(user, user.role.name, user.role) visit '/student_task/list' expect(page).to have_content('public assignment for test') visit '/invitation/accept?inv_id=1&student_id=1&team_id=1' visit '/student_teams/view?student_id=1' expect(page).to have_content('Team Information for public assignment for test') # to test invalid case - student who is not part of the team does not have created assignment user = User.find_by(name: "student2066") stub_current_user(user, user.role.name, user.role) visit '/student_task/list' page.should has_no_content?('public assignment for test') end
Functional Tests for whether students choosing the same topic are in the same team
Since the only way for students to be in a team is by invitation, students who choose the same topic will be in different team. Our test is to let two different students select the same topic and see if their teammates contains each other. Therefore, first we let ‘student2064’ and 'student2065' sign for the same topic, and in their pages, to see if there is 'student2065' or 'student2064'.
expect(page).to have_content "Team Name" expect(page).to have_content "student2065" expect(page).to have_content "student2064"
Running the tests
The tests can be run on the terminal by navigating to the /spec/features directory using the command:
rspec team_functionalities_spec.rb
Whether the test fails or succeeds, allows us to determine which parts of the system are functioning properly.
Result
Coverage increased (+0.3%) to 51.108% when pulling 4915488 on ankit13jain:master into 781e456 on expertiza:master.