bigbluebutton_rails 0.0.6 → 0.1.0

data/spec/rails_app/features/config.yml.example

@@ -0,0 +1,13 @@
+# maximum wait until the bot starts (secs)
+timeout_bot_start: 60
+
+servers:
+  bbb-dev-07:
+    salt: 'your-salt'
+    url: 'http://your-server/bigbluebutton/api'
+    version: '0.7'
+  test-install-08:
+    salt: '8cd8ef52e8e101574e400365b55e11a6'
+    url: 'http://test-install.blindsidenetworks.com/bigbluebutton/api'
+    version: '0.8'
+    mobile_salt: '03b07' # needed for >= 0.8

data/spec/rails_app/features/create_rooms.feature

@@ -0,0 +1,17 @@
+Feature: Create webconference rooms
+  In order to held webconferences
+  One needs to create and configure webconference rooms
+
+  Scenario: Register a new BigBlueButton room
+    Given a real server
+    When the user goes to the new room page
+      And registers a new room
+    Then he should see the information about this room
+
+  Scenario: Try to register a new BigBlueButton room with errors
+    Given a real server
+    When the user goes to the new room page
+      And registers a new room with wrong parameters
+    Then he should be at the create room URL
+      And see the new room page
+      And see 2 errors in the field "bigbluebutton_room[name]"

data/spec/rails_app/features/create_servers.feature

@@ -0,0 +1,17 @@
+Feature: Create webconference servers
+  In order to held webconferences
+  One needs to create and configure webconference servers
+
+  Scenario: Register a new BigBlueButton server
+    Given an anonymous user
+    When he goes to the new server page
+      And registers a new server
+    Then he should see the information about this server
+
+  Scenario: Try to register a BigBlueButton server with errors
+    Given an anonymous user
+    When he goes to the new server page
+      And registers a new server with a wrong URL
+    Then he should be at the create server URL
+      And see the new server page
+      And see 1 error in the field "bigbluebutton_server[url]"

data/spec/rails_app/features/destroy_rooms.feature

@@ -0,0 +1,12 @@
+Feature: Destroy webconference rooms
+  To remove a webconference room from a server
+  One needs to destroy its record
+
+  Scenario: Destroy a stored BigBlueButton server
+    Given an anonymous user
+      And a real server
+      And a room in this server
+    When he goes to the rooms index page
+      And clicks in the link to remove the first room
+    Then he should be at the rooms index URL
+      And the removed room should not be listed

data/spec/rails_app/features/destroy_servers.feature

@@ -0,0 +1,11 @@
+Feature: Destroy webconference servers
+  To remove a webconference server from the list
+  One needs to destroy its record
+
+  Scenario: Destroy a stored BigBlueButton server
+    Given an anonymous user
+      And a real server
+    When he goes to the servers index page
+      And clicks in the link to remove the first server
+    Then he should be at the servers index URL
+      And the removed server should not be listed

data/spec/rails_app/features/edit_rooms.feature

@@ -0,0 +1,26 @@
+Feature: Edit webconference rooms
+  To change the information of a webconference rooms
+  One needs to be able to edit and update the room
+
+  Scenario: Edit data in a BigBlueButton room
+    Given an anonymous user
+      And a real server
+      And a room in this server
+    When he goes to the edit room page
+      And change the room name to "Anything different"
+      And click in the button to save the room
+    Then he should be at the show room URL
+      And the room name should be "Anything different"
+
+  Scenario: Try to edit data in a BigBlueButton room with incorrect values
+    Given an anonymous user
+      And a real server
+      And a room in this server
+    When he goes to the edit room page
+      And change the room name to ""
+      And click in the button to save the room
+    Then he should be at the update room URL
+      And see the edit room page
+      And see 2 errors in the field "bigbluebutton_room[name]"
+      And the room name should NOT be "Anything different"
+

data/spec/rails_app/features/edit_servers.feature

@@ -0,0 +1,24 @@
+Feature: Edit webconference servers
+  To change the information of a webconference server
+  One needs to be able to edit and update the server
+
+  Scenario: Edit data in a BigBlueButton server
+    Given an anonymous user
+      And a real server
+    When he goes to the edit server page
+      And change the server URL to "http://test.com/bigbluebutton/api"
+      And click in the button to save the server
+    Then he should be at the show server URL
+      And the server URL should be "http://test.com/bigbluebutton/api"
+
+  Scenario: Try to edit data in a BigBlueButton server with incorrect values
+    Given an anonymous user
+      And a real server
+    When he goes to the edit server page
+      And change the server URL to "http://test.com/"
+      And click in the button to save the server
+    Then he should be at the update server URL
+      And see the edit server page
+      And see 1 errors in the field "bigbluebutton_server[url]"
+      And the server URL should NOT be "http://test.com/"
+

data/spec/rails_app/features/join_external_rooms.feature

@@ -0,0 +1,61 @@
+Feature: Join external webconference rooms
+  In order to join webconferences that were created from another application
+  One needs to enter his name and a password, that will define his role
+
+  @mechanize
+  Scenario: Joining an external room as moderator (a room that is not in the database)
+    Given an anonymous user
+      And a real server
+      And an external room in this server
+    When the user goes to the join external room page
+      And enters his name and the moderator password
+      And clicks in the button "Submit"
+    Then he should join the conference room
+
+  Scenario: Joining an external room that is NOT running as attendee
+    Given an anonymous user
+      And a real server
+      And an external room in this server
+    When the user goes to the join external room page
+      And enters his name and the attendee password
+      And clicks in the button "Submit"
+    Then he should NOT join the conference room
+      And should see an error message with the message "The meeting is not running"
+
+  @mechanize @need-bot
+  Scenario: Joining an external room that is running as attendee
+    Given an anonymous user
+      And a real server
+      And an external room in this server
+      And a meeting is running in this room
+    When the user goes to the join external room page
+      And enters his name and the attendee password
+      And clicks in the button "Submit"
+    Then he should join the conference room
+
+  Scenario: Joining an external room without entering a user name
+    Given an anonymous user
+      And a real server
+      And an external room in this server
+    When the user goes to the join external room page
+      And enters only the moderator password
+      And clicks in the button "Submit"
+    Then he should NOT join the conference room
+      And should see an error message with the message "Authentication failure"
+
+  Scenario: Joining an external room without entering a password (wrong password)
+    Given an anonymous user
+      And a real server
+      And an external room in this server
+    When the user goes to the join external room page
+      And enters only the user name
+      And clicks in the button "Submit"
+    Then he should NOT join the conference room
+      And should see an error message with the message "Authentication failure"
+
+  Scenario: Uses the current user's name as the default name to join an external room
+    Given a user named "test user"
+      And a real server
+      And an external room in this server
+    When the user goes to the join external room page
+    Then he should see his name in the user name input

data/spec/rails_app/features/join_mobile.feature

@@ -0,0 +1,10 @@
+Feature: Join a webconference using a mobile device
+  In order to participate in webconference using a mobile device
+  One needs to access the page with the mobile link and QR code
+
+  Scenario: Accessing the mobile join page
+    Given a user named "test user"
+      And a real server
+      And a public room in this server
+    When the user goes to the mobile join page
+    Then he should see the QR code and a link to join using a mobile device

data/spec/rails_app/features/join_rooms.feature

@@ -0,0 +1,117 @@
+Feature: Join webconference rooms
+  In order to participate in webconferences
+  One needs to join webconference rooms
+
+  # These scenarios are based in the permission defined in the default
+  # bigbluebutton_role method:
+  # if room.private or bigbluebutton_user.nil?
+  #   :password # ask for a password
+  # else
+  #   :moderator
+  # end
+
+  # First we check the behaviour of BigbluebuttonRoom#join and the redirects to
+  # BigbluebuttonRoom#invite
+
+  @mechanize
+  Scenario: Joining a public room
+    Given a user named "test user"
+      And a real server
+      And a public room in this server
+    When the user goes to the join room page
+    Then he should join the conference room
+
+  Scenario: Joining a public room as an anonymous user
+    Given an anonymous user
+      And a real server
+      And a public room in this server
+    When the user goes to the join room page
+    Then he should be at the invite room URL
+      And the password field was pre-filled with the attendee password
+
+  Scenario: Joining a private room requires a password
+    Given a user named "test user"
+      And a real server
+      And a private room in this server
+    When the user goes to the join room page
+    Then he should be redirected to the invite room URL
+
+  @mechanize
+  Scenario: Joining a private room as a moderator
+    Given a user named "test user"
+      And a real server
+      And a private room in this server
+    When the user goes to the join room page
+      And enters his name and the moderator password
+      And clicks in the button "Submit"
+    Then he should join the conference room
+
+  Scenario: Joining a private room that is NOT running as attendee
+    Given a user named "test user"
+      And a real server
+      And a private room in this server
+    When the user goes to the join room page
+      And enters his name and the attendee password
+      And clicks in the button "Submit"
+    Then he should NOT join the conference room
+      And should see an error message with the message "The meeting is not running"
+
+  @mechanize @need-bot
+  Scenario: Joining a private room that is running as attendee
+    Given a user named "test user"
+      And a real server
+      And a private room in this server
+      And a meeting is running in this room
+    When the user goes to the join room page
+      And enters his name and the attendee password
+      And clicks in the button "Submit"
+    Then he should join the conference room
+
+  Scenario: Joining a private room without entering a user name
+    Given an anonymous user
+      And a real server
+      And a private room in this server
+    When the user goes to the join room page
+      And enters only the moderator password
+      And clicks in the button "Submit"
+    Then he should NOT join the conference room
+      And should see an error message with the message "Authentication failure"
+
+  Scenario: Joining a private room without entering a password (wrong password)
+    Given an anonymous user
+      And a real server
+      And a private room in this server
+    When the user goes to the join room page
+      And enters only the user name
+      And clicks in the button "Submit"
+    Then he should NOT join the conference room
+      And should see an error message with the message "Authentication failure"
+
+  Scenario: Uses the current user's name as the default name to join a room
+    Given a user named "test user"
+      And a real server
+      And a private room in this server
+    When the user goes to the join room page
+    Then he should see his name in the user name input
+
+
+  # For the BigbluebuttonRoom#invite action we only check that it can be used by logged
+  # or anonymous users. Other cases were already tested above
+
+  @mechanize
+  Scenario: A logged user may join the meeting through the invite page
+    Given a user named "test user"
+      And a real server
+      And a public room in this server
+    When the user goes to the invite room page (no view check)
+    Then he should join the conference room
+
+  @mechanize
+  Scenario: An anonymous user may join the meeting through the invite page
+    Given an anonymous user
+      And a real server
+      And a public room in this server
+    When the user goes to the invite room page
+      And enters his name and the moderator password
+      And clicks in the button "Submit"
+    Then he should join the conference room

data/spec/rails_app/features/list_and_show_rooms.feature

@@ -0,0 +1,18 @@
+Feature: List and show webconference rooms
+  To view information of a webconference room
+  One needs to see the room in a list of rooms
+    and see all the information it has stored
+
+  Scenario: View the list of BigBlueButton rooms
+    Given an anonymous user
+      And a real server
+      And 3 rooms in this server
+    When he goes to the rooms index page
+    Then he should see all available rooms in the list
+
+  Scenario: View all information of a BigBlueButton room
+    Given an anonymous user
+      And a real server
+      And a room in this server
+    When he goes to the show room page
+    Then he should see all the information available for this room

data/spec/rails_app/features/list_and_show_servers.feature

@@ -0,0 +1,16 @@
+Feature: List and show webconference servers
+  To view information of a webconference server
+  One needs to see the server in a list of servers
+    and see all the information it has stored
+
+  Scenario: View the list of BigBlueButton servers
+    Given an anonymous user
+      And 3 servers
+    When he goes to the servers index page
+    Then he should see all available servers in the list
+
+  Scenario: View all information of a BigBlueButton server
+    Given an anonymous user
+      And a real server
+    When he goes to the show server page
+    Then he should see all the information available for this server

data/spec/rails_app/features/step_definitions/activity_monitor_servers_step.rb

@@ -0,0 +1,102 @@
+When /^(\d+) meetings running in this server$/ do |count|
+  msalt = FeaturesConfig.server.has_key?('mobile_salt') ? FeaturesConfig.server['mobile_salt'] : ""
+  @rooms = []
+  count.to_i.times do |i|
+    room = Factory.create(:bigbluebutton_room, :server => @server)
+    room.send_create
+    BigBlueButtonBot.new(@server.api, room.meetingid, msalt,
+                         1, FeaturesConfig.root['timeout_bot_start'])
+    @rooms << room
+  end
+end
+
+When /^(\d+) meetings recently ended in this server$/ do |count|
+  msalt = FeaturesConfig.server.has_key?('mobile_salt') ? FeaturesConfig.server['mobile_salt'] : ""
+  @ended_rooms = []
+  count.to_i.times do |i|
+    room = Factory.create(:bigbluebutton_room, :server => @server)
+    room.send_create
+    BigBlueButtonBot.new(@server.api, room.meetingid, msalt,
+                         1, FeaturesConfig.root['timeout_bot_start'])
+    BigBlueButtonBot.finalize(room.meetingid)
+    sleep 1
+    @ended_rooms << room
+  end
+end
+
+When /^he should see the (\d+) meetings that are running$/ do |count|
+  check_server_activity_monitor_rooms(@rooms)
+end
+
+When /^he should see the external room in the list$/ do
+  check_server_activity_monitor_rooms([@room])
+end
+
+When /^he should see the (\d+) recently ended meetings$/ do |count|
+  check_server_activity_monitor_rooms(@ended_rooms)
+end
+
+When /^the first meeting is ended$/ do
+  @rooms.first.send_end
+  BigBlueButtonBot.finalize(@rooms.first.meetingid)
+  sleep 1 # give the bot some time to finish
+end
+
+When /^he clicks in the link to update the meeting list$/ do
+  find(make_selector("a.bbbrails_refresh_now")).click
+end
+
+When /^he should see one meeting running and the other meeting not running$/ do
+  # first was ended, second is running
+  @rooms.first.fetch_is_running?
+  @rooms.first.is_running?.should be_false
+  @rooms.last.fetch_is_running?
+  @rooms.last.is_running?.should be_true
+
+  check_server_activity_monitor_rooms(@rooms)
+end
+
+When /^after (\d+) seconds$/ do |count|
+  sleep count.to_i
+end
+
+# checks the rooms inside the activity monitor
+def check_server_activity_monitor_rooms(rooms)
+  within(make_selector("div#bbbrails_server_activity_meetings")) do
+    rooms.each do |room|
+
+      # restrict the search to this room's div
+      xpath = ".//div[@class=\"bbbrails_meeting_description\" and contains(., \"#{room.meetingid}\")]"
+      within(find(:xpath, xpath)) do
+
+        # FIXME in bbb 0.7 get_meeting_info didn't return the room's name, only
+        #       the meeting_id, so the name in the obj will be == meeting_id
+        #       See BigbluebuttonServer#fetch_meetings
+        has_content(room.name) unless room.new_record?
+        has_content(room.meetingid)
+
+        method = room.new_record? ? method(:doesnt_have_element) : method(:has_element)
+        method.call("a", { :href => bigbluebutton_server_room_path(@server, room) })
+        method.call("a", { :href => edit_bigbluebutton_server_room_path(@server, room) })
+        method.call("a", { :href => bigbluebutton_server_room_path(@server, room), :"data-method" => :delete })
+        method.call("a", { :href => join_bigbluebutton_server_room_path(@server, room) })
+        method.call("a", { :href => join_mobile_bigbluebutton_server_room_path(@server, room) })
+        method.call("a", { :href => end_bigbluebutton_server_room_path(@server, room) })
+
+        room.fetch_is_running?
+        if room.is_running?
+          has_content(room.start_time)
+          has_element("span.running")
+          room.participant_count.times do |i|
+            has_content("Bot #{i}") # user name
+          end
+        else
+          has_content(room.start_time)
+          has_content(room.end_time)
+          has_element("span.not_running")
+        end
+      end
+
+    end
+  end
+end