Cmcmahon has submitted this change and it was merged. Change subject: Minor fixes and updates of the readme file ......................................................................
Minor fixes and updates of the readme file Change-Id: Ie3ff98f67f0fb1fa1b2a25d30d0807589b8dd2bd --- M README.md 1 file changed, 7 insertions(+), 8 deletions(-) Approvals: Cmcmahon: Looks good to me, approved jenkins-bot: Verified diff --git a/README.md b/README.md index 06103b7..b048030 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ ## Environment -To run the Selenium tests you will have to install Ruby. Look at the `.ruby-version` file for the exact required version. You also have to install the latest versions of RubyGems and Firefox (the default browser in which the tests run). The easiest way to install Ruby on Linux/Unix is [RVM](https://rvm.io/) and on Windows [RubyInstaller](http://rubyinstaller.org/). +To run the Selenium tests you will have to install Ruby. Look at the `Gemfile` file for the exact required version. You also have to install the latest versions of RubyGems and Firefox (the default browser in which the tests run). The easiest way to install Ruby on Linux/Unix/Mac is [RVM](https://rvm.io/) and on Windows [RubyInstaller](http://rubyinstaller.org/). ALERT: On Windows you must use Ruby 1.9.3 for now because cucumber/gherkin library currently doesn't work with Ruby 2.x.x. Clone the repository, `cd` into it, update RubyGems and install the required RubyGems: @@ -12,29 +12,28 @@ gem install bundler bundle install -If you're not using rvm to manage your Ruby versions, you will need to run the commands as root (using `sudo`). +If you're not using RVM to manage your Ruby versions, you will need to run the commands as root (using `sudo`). Environment variable MEDIAWIKI_PASSWORD is required for tests tagged `@login`. For local testing, create a user named `Selenium_user` on your local wiki and export the password as the value for this variable. For example: - export MEDIAWIKI_PASSWORD: password here + export MEDIAWIKI_PASSWORD=<password here> # Linux/Unix/Mac + set MEDIAWIKI_PASSWORD=<password here> # Windows Run the tests with `bundle exec cucumber`, this should start Firefox. By default the tests run at en.wikipedia.beta.wmflabs.org. If you want to run the tests elsewhere, set the `MEDIAWIKI_URL` environment variable. For example: - export MEDIAWIKI_URL=http://commons.wikimedia.beta.wmflabs.org/wiki/ # Linux/Unix + export MEDIAWIKI_URL=http://commons.wikimedia.beta.wmflabs.org/wiki/ # Linux/Unix/Mac set MEDIAWIKI_URL=http://commons.wikimedia.beta.wmflabs.org/wiki/ # Windows - -The test run creates an HTML report in `reports/` and an XML report (for Jenkins) in `reports/junit`. To run a single test file enter `bundle exec cucumber features/FEATURE_NAME.feature`. To run a single test scenario, put a colon and the line number (NN) on which the scenario begins after the file name: `bundle exec cucumber features/FEATURE_NAME.feature:NN`. -By default, the browser will close itself at the end of every scenario. If you want the browser to stay open, set the environment variable KEEP_BROWSER_OPEN to `true`: +By default, the browser will close itself at the end of every scenario. If you want the browser to stay open, set the environment variable `KEEP_BROWSER_OPEN` to `true`: - export KEEP_BROWSER_OPEN=true # Linux/Unix + export KEEP_BROWSER_OPEN=true # Linux/Unix/Mac set KEEP_BROWSER_OPEN=true # Windows ## Sites -- To view, visit https://gerrit.wikimedia.org/r/85058 To unsubscribe, visit https://gerrit.wikimedia.org/r/settings Gerrit-MessageType: merged Gerrit-Change-Id: Ie3ff98f67f0fb1fa1b2a25d30d0807589b8dd2bd Gerrit-PatchSet: 1 Gerrit-Project: qa/browsertests Gerrit-Branch: master Gerrit-Owner: Zfilipin <[email protected]> Gerrit-Reviewer: Cmcmahon <[email protected]> Gerrit-Reviewer: jenkins-bot _______________________________________________ MediaWiki-commits mailing list [email protected] https://lists.wikimedia.org/mailman/listinfo/mediawiki-commits
