tests/browser/README.mediawiki

   1 Purpose:
   2
   3 The purpose of these tests is to validate that a newly installed (or updated, or hacked, or whatever) mediawiki instance presents to the user a set of expected features, regardless of what language the wiki is in, or where it is installed, or what extensions it might have.
   4
   5 The tests are based on the basic definition of a wiki, a website where anyone
   6
   7 * can read a page
   8 * can create a page
   9 * can edit a page
  10 * can link one page to another page
  11
  12 Install:
  13
  14 Ruby 1.9.3 or higher is required
  15 Firefox browser is required
  16 ::
  17  cd /tests/browser
  18  gem update --system
  19  gem install bundler
  20  bundle install
  21
  22 Run the tests:
  23
  24 Edit the environment_variables file with appropriate values for your wiki
  25 $source environment_variables (example shown in bash shell)
  26
  27 bundle exec cucumber features/
  28
  29 Note that the acceptance tests will create three pages in your wiki entitled "Editing Test Page", "Link Source Test Page", and "Link Target Test Page".  These pages may be deleted at any time.  If you wish to re-run the tests at any time, these test pages will be re-created or reset to their original contents at the time that the tests run.
  30
  31 For more information about running Selenium tests please see
  32 https://github.com/wikimedia/mediawiki-selenium
  33
  34 Details:
  35
  36 create_account.feature
  37 * Checks three different ways to arrive on page allowing the user to create an account
  38
  39 create_and_follow_wiki_link.feature:
  40 * uses the mediawiki API to create a link target page
  41 * uses the mediawiki API to create a link source page
  42 * navigates a browser to the link source page
  43 * clicks the link in that page to the link target page
  44 * validates that the browser has in fact followed the link to the target page correctly
  45
  46 edit_page.feature:
  47 * uses the mediawiki API to create an editable page on the wiki
  48 * navigates a browser to the page
  49 * clicks the Edit button to invoke the basic editor
  50 * edits the page with a particular string containing a static part and also a quasi-unique random part
  51 * saves the edited page
  52 * checks that the saved page contains the particular string with which the page was edited
  53
  54 main_page.feature:
  55 * navigates a browser to the default landing page of the wiki
  56 * checks for the View History link on the landing page
  57 * checks for the full set of of sidebar links that should exist on every mediawiki wiki
  58
  59 view_history.feature
  60 * similar to edit_page.feature but checks for an older version of the edited page
  61
  62 Notes:
  63
  64 Tested on beta labs hewiki, dewiki, enwiki, and on a local installation of mediawiki