From a718df3793c15f6f3c510bf777a62b46ce02b195 Mon Sep 17 00:00:00 2001 From: Matthieu Aubry Date: Wed, 30 Oct 2013 11:49:22 +1300 Subject: Screenshot tests in own readme --- tests/README.md | 40 ++-------------------------------------- 1 file changed, 2 insertions(+), 38 deletions(-) (limited to 'tests/README.md') diff --git a/tests/README.md b/tests/README.md index 46ac18c5d0..9a85cdb676 100644 --- a/tests/README.md +++ b/tests/README.md @@ -143,7 +143,7 @@ piwik.js is unit tested and you can run tests via piwik/tests/javascript/ You can import test data over several days in Piwik. -See [tests/README.testing-data.md])(https://github.com/piwik/piwik/blob/master/tests/README.testing-data.md) +See [tests/README.testing-data.md](https://github.com/piwik/piwik/blob/master/tests/README.testing-data.md) ## Scheduled Reports Tests @@ -161,43 +161,7 @@ The characteristics of the integration server are described in `IntegrationTestC ## UI Screenshots Tests -Piwik contains UI tests that work by taking a screenshot of a URL and comparing it with -an expected screenshot. If the screenshots do not match, there is a bug somewhere. These -tests are in another repository but are included in Piwik as a submodule. To get the tests, -run the following commands: - - $ git submodule init - $ git submodule update - -### How to generate screenshots - -In order to run UI tests, you need to have [phantomjs](http://phantomjs.org) version 1.9.0 or greater -installed on your machine. You can download phantomjs [here](http://phantomjs.org/download.html). phantomjs is headless, so even if you're on a server without the X window system, you can still run the -UI tests. - -On Ubuntu: - - $ sudo apt-get install ttf-mscorefonts-installer imagemagick imagemagick-doc - -To generate screenshots identical to those generated by Travis, we install some extra fonts. - -Imagick is used to generate the "difference" screenshots which show which pixels have changed. - -Removing this font may be useful if your generated screenshots' fonts do not match the expected screenshots: - - $ sudo apt-get remove ttf-bitstream-vera - -**Running Tests** - -You can test the UI by running: - - $ cd PHPUnit - $ phpunit --group UI - -**Learn more** - -Check out this blog post to learn more about Screenshot Tests in Piwik: -[QA Screenshot Testing blog post](http://piwik.org/blog/2013/10/our-latest-improvement-to-qa-screenshot-testing/) +See [tests/README.screenshots.md](https://github.com/piwik/piwik/blob/master/tests/README.screenshots.md) ## VisualPHPUnit -- cgit v1.2.3