https://github.com/rdmueller/grails-filmstrip

a grails plugin for better geb/spock reports
https://github.com/rdmueller/grails-filmstrip

Last synced: 29 days ago
JSON representation

a grails plugin for better geb/spock reports

• Host: GitHub
• URL: https://github.com/rdmueller/grails-filmstrip
• Owner: rdmueller
• Created: 2014-11-05T07:10:21.000Z (about 10 years ago)
• Default Branch: Grails-2.x
• Last Pushed: 2018-11-26T20:57:10.000Z (almost 6 years ago)
• Last Synced: 2024-05-02T05:22:04.294Z (7 months ago)
• Language: Groovy
• Size: 649 KB
• Stars: 7
• Watchers: 4
• Forks: 2
• Open Issues: 8
• Metadata Files:
  • Readme: README.adoc

Awesome Lists containing this project

README

        
grails-filmStrip-plugin for Grails 2.x

======================================

Geb and Spock is a great combination if you need to create functional tests for your Grails application.

A not so well known feature is the http://www.gebish.org/manual/current/testing.html#reporting[++report++] feature: +

whenever you use the command ++report "some text"++, geb tries to create a screenshot and save the current DOM as HTML.

This plugin crawls through the generated screenshots and creates an HTML report which displays preview images as film strip

on the bottom of the page and the test result on the main part of the window. When you click on an image, it will be displayed

full size, if you click on the name of a report image, the corresponding HTML file will be displayed. Without the proper path

to referenced files, this view will look broken, but it is very usefull for debugging.

The aim of this plugin is not only to help a tester in developing Geb/Spock tests and see what went wrong, but also to create

a report for your customer. With all those screenshot you can easily get an graphical overview of the application and

see if all pages display correctly.

image::./src/doc/images/Screenshot.png["Screenshot", align="center"]

=== Setup / Usage

There is not much to do in order to use the plugin. Just configure it in your +BuildConfig.groovy+ as

    test ":film-strip:0.1.7"

and add the following line to your gebConfig.groovy:

    reportingListener = new grails.plugin.filmstrip.FilmStripReportingListener()

If your geb ++reportDir++ is the standard one, the report will be generated after running ++grails test-app++.

=== Documentation

The documentation is currently located at http://rdmueller.github.io/grails-filmStrip/ .

The source for the documentation can be found at https://github.com/rdmueller/grails-filmStrip/blob/master/src/doc/arc42-template.adoc .

=== Notes to my future self or another future maintainer :-)

To build the plugin, just do

    ./grailsw package-plugin

    

and to publish it, do

    ./grailsw publish-plugin

    

To be able to publish, you need to have an account on https://grails.org/plugin/film-strip