Zfilipin has uploaded a new change for review. https://gerrit.wikimedia.org/r/99391
Change subject: Moved information on how to run Selenium tests to a separate README file ...................................................................... Moved information on how to run Selenium tests to a separate README file The goal is to make it easy for people to start contributing to Selenium tests. While working on resolving a couple of bugs (see below) we are updating existing documentation and adding README files to tests/browser folders of all repositories that contain Selenium tests. Some people will land there and never notice the main README file. Bug: 57841 Bug: 56089 Change-Id: I814f7167ef5aafca62fc92d11ad27956cc3a4d89 --- M README.mediawiki D tests/browser/README.md A tests/browser/README.mediawiki 3 files changed, 50 insertions(+), 33 deletions(-) git pull ssh://gerrit.wikimedia.org:29418/mediawiki/extensions/MobileFrontend refs/changes/91/99391/1 diff --git a/README.mediawiki b/README.mediawiki index 08fe779..e0c9a4b 100644 --- a/README.mediawiki +++ b/README.mediawiki @@ -59,36 +59,6 @@ make qunit ==== Selenium tests ==== -To run the Selenium tests you will have to install Ruby (for the exact -version see tests/browser/Gemfile), the latest versions of -RubyGems and Firefox. -The easiest way to install Ruby on *nix is RVM (https://rvm.io/) and on -Windows RubyInstaller (http://rubyinstaller.org/). - -Open terminal in tests/browser. Update RubyGems and install required -gems with: - - gem update --system - gem install bundler - bundle install - -You will need to create a user account for selenium on your local wiki with the -username 'Selenium_user' and then store the password in /private/wmf/secret.yml -in the following format: -mediawiki_password: <local selenium account password> - -Run the tests from the MobileFrontend directory with: - - make cucumber - -If you want to run a single set of tests, go to the MobileFrontend/tests/browser/ -directory and call 'bundle exec cucumber' with the path to the test file. For example, -to run only the watchlist tests: - - bundle exec cucumber features/watchlist.feature - -XML report (for Jenkins) is created at tests/browser/reports/junit. - -Jenkins is hosted at https://wmf.ci.cloudbees.com/ and it drives -browsers at http://saucelabs.com/ +For information on how to run Selenium tests please see README file in +tests/browser directory. diff --git a/tests/browser/README.md b/tests/browser/README.md deleted file mode 100644 index 3631949..0000000 --- a/tests/browser/README.md +++ /dev/null @@ -1 +0,0 @@ -Please see https://github.com/wikimedia/mediawiki-selenium for instructions on how to run tests. diff --git a/tests/browser/README.mediawiki b/tests/browser/README.mediawiki new file mode 100644 index 0000000..f051c6f --- /dev/null +++ b/tests/browser/README.mediawiki @@ -0,0 +1,48 @@ += MobileFrontend Extension = + +For general information about MobileFrontend Extension please see +README.mediawiki file in the root of the repository. + +==== Selenium tests ==== + +To run the Selenium tests you will have to install Ruby (for the exact +version see Gemfile), the latest versions of RubyGems and Firefox. + +The easiest way to install Ruby on *nix is RVM (https://rvm.io/) and on +Windows RubyInstaller (http://rubyinstaller.org/). + +Open terminal in tests/browser. Update RubyGems and install required +gems with: + + gem update --system + gem install bundler + bundle install + +Environment variables MEDIAWIKI_USER and MEDIAWIKI_PASSWORD are required for +tests tagged `@login`. For local testing, create a test user on your local wiki +and export the user and password as the values for those variables. +For example: + + export MEDIAWIKI_USER=<username here> # Linux/Unix/Mac + set MEDIAWIKI_USER=<username here> # Windows + + export MEDIAWIKI_PASSWORD=<password here> # Linux/Unix/Mac + set MEDIAWIKI_PASSWORD=<password here> # Windows + +Run the tests from the MobileFrontend directory with: + + make cucumber + +If you want to run a single set of tests, go to the tests/browser directory and +call 'bundle exec cucumber' with the path to the test file. For example, to run +only the watchlist tests: + + bundle exec cucumber features/watchlist.feature + +XML report (for Jenkins) is created at tests/browser/reports/junit. + +Jenkins is hosted at https://wmf.ci.cloudbees.com/ and it drives +browsers at http://saucelabs.com/ + +For more information about running Selenium tests please see +https://github.com/wikimedia/mediawiki-selenium -- To view, visit https://gerrit.wikimedia.org/r/99391 To unsubscribe, visit https://gerrit.wikimedia.org/r/settings Gerrit-MessageType: newchange Gerrit-Change-Id: I814f7167ef5aafca62fc92d11ad27956cc3a4d89 Gerrit-PatchSet: 1 Gerrit-Project: mediawiki/extensions/MobileFrontend Gerrit-Branch: master Gerrit-Owner: Zfilipin <zfili...@wikimedia.org> _______________________________________________ MediaWiki-commits mailing list MediaWiki-commits@lists.wikimedia.org https://lists.wikimedia.org/mailman/listinfo/mediawiki-commits
