pretty_face

HTML report for cucumber. You can customize the report by editing an erb file.

The current release is very basic but you can expect a lot more over the next month or so.

Getting Started

Download gem

Add the gem to your Gemfile

gem 'pretty_face'

Then do a bundle update to get the latest version

Add Formatter

Update your profile in cucumber.yml file with the following arguments

--format PrettyFace::Formatter::Html --out index.html

You can also run cucumber from the command line with the same arguments.

Customizing the report

Starting with version 0.3 of the gem you can customize some elements on the report. You will do this by first creating a directory named pretty_face in the features/support directory. Customization files should be placed in this directory.

Changing the image on all pages

To replace the image that appears at the top of all pages you simply need to place a file in the customization directory named logo.png. The extention can be png, gif, jpg, or jpeg but the filename must be logo in all lower case. The image will look best if it is around 220 X 220 pixels.

Replacing the header on the main landing page

To replace the header that appears at the top of the main landing page you simply need to create a file in the customization directory that contains the html you wish to display. The file must be named _suite_header.erb.

Replacing the header on the feature pages

To replace the header that appears on all of the pages with details about features you simply need to create a file in the customization directory that contains the html you wish to display. The file must be named _feature_header.erb.

Known Issues

Using this gem's formatter from within RubyMine causes the result tree not to expand Scenario Outlines when running in RubyMine.

For additional issues see: http://github.com/cheezy/pretty_face/issues

Contribute

  • Fork the project.
  • Test drive your feature addition or bug fix. Adding specs is important and I will not accept a pull request that does not have tests.
  • Make sure you describe your new feature with a cucumber scenario.
  • Make sure you provide RDoc comments for any new public method you add. Remember, others will be using this gem.
  • Commit, do not mess with Rakefile, version, or ChangeLog. (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
  • Send me a pull request. Bonus points for topic branches.

Copyright (c) 2012-2013 Jeffrey S. Morgan. See LICENSE for details.