[Koha-bugs] [Bug 19243] Selenium test for testing the administration module functionality

[bugzilla-daemon at bugs.koha-community.org]

https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=19243

--- Comment #8 from Alex Buckley <alexbuckley at catalyst.net.nz> ---
Created attachment 67495
  -->
https://bugs.koha-community.org/bugzilla3/attachment.cgi?id=67495&action=edit
Bug 19243 - Followup moving common Selenium functions into a seperate module

In this patch a module t/lib/Selenium.pm has been created and it
contains the auth, patron_auth, patron_opac_auth, cleaup, time_difffunctions
which are common to other Selenium text scripts.

Also a function to wait for an element to be found before it is
interacted with was created and it is called pause_driver

At present this pause_driver function throws an error in the test output
saying that it cannot find an element and then it fails.

Test plan (this test plan includes how to install Selenium as well as how to
run this test, for the benefit of people who have not got
Selenium installed on their machines):

1. wget
https://selenium-release.storage.googleapis.com/2.53/selenium-server-standalone-2.53.0.jar

2. vim /etc/apt/sources.list.d/firefox.list

3. Paste into the file:
deb http://packages.linuxmint.com debian import

4. sudo apt-get update

5. sudo apt-get install firefox

6. sudo apt-get install xvfb

7. Set the SELENIUM_PATH vartiable:
SELENIUM_PATH=/home/vagrant/kohaclone/selenium-server-standalone-2.53.0.jar

8. Xvfb :1 -screen 0 1024x768x24 2>&1 >/dev/null &

9. DISPLAY=:1 java -jar $SELENIUM_PATH

Note: This will start up the selenium server. Everytime you want to
shutdown this terminal window and want to restart Selenium just run
the step 9 command to restart the Selenium server

10. Open a new terminal window and write in:
git clone https://github.com/gempesaw/Selenium-Remote-Driver
--branch build/master --single-branch --depth 1

11. cd Selenium-Remote-Driver

12. perl Makefile.PL

13. make

14. make test

15. sudo make install

16. Now everything is installed and you can set up for running the
selenium tests

17. Drop and recreate the Koha database and restart memcached

18. Go through the web installer installing all sample data and
onboarding tool

19. Create a superlibrarian user with the username koha and password
koha

20. If your usual port configuration for the intranet and OPAC is
8081 and 8080 respectively then set the staffClientBaseURL and
OPACBaseURL system preferences to localhost:8080 and localhost:80
respectively

21. sudo koha-shell <instancename>

22. perl t/db_dependent/selenium/administration_tasks.t

23. The test should pass.
Note: The time_diff comments in the test output showing what the
test is doing

Note: If you have issues with installing Selenium and
Selenium::Remote::Driver please write a comment on the bug report
and I will be more than happy to create a screencapture video
showing all the steps

Note: Warns in front of the $driver->get_title() function have been
implemented because during troubleshooting they were found to be an
effective solution for stopping the test from failing due to not
being able to find an element on the page. If anyone can suggest an
alternative to using these warns please do

Sponsored-By: Catalyst IT

-- 
You are receiving this mail because:
You are watching all bug changes.