mirror of
https://gerrit.wikimedia.org/r/mediawiki/extensions/RelatedArticles
synced 2024-11-30 19:14:49 +00:00
57 lines
1.9 KiB
Plaintext
57 lines
1.9 KiB
Plaintext
= Setup =
|
|
|
|
Please include the LocalSettings.php file in your MediaWiki instance.
|
|
|
|
|
|
== 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
|
|
|
|
In addition to this create another user which will be reserved for new uploads
|
|
"Selenium_newuser". The password for this user should be the same as
|
|
MEDIAWIKI_PASSWORD
|
|
|
|
Tests that use the "Given I create a random page using the API" step need to set
|
|
the MEDIAWIKI_API_URL environment variable, e.g.
|
|
export MEDIAWIKI_API_URL=http://en.wikipedia.beta.wmflabs.org/w/api.php
|
|
|
|
Run the tests from the RelatedArticles 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/read_more_desktop.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
|