americanexpress/xcode-result-bundle-processor

xcode-result-bundle-processor converts Xcode test result bundles into friendly HTML reports

What is XcodeResultBundleProcessor?

This tool converts into Xcode 7's machine-readable results bundle into a human-readable HTML report including detailed activity logs and screenshots for UI tests.

Installation

Add this line to your application's Gemfile:

gem 'xcode-result-bundle-processor'

And then execute:

$ bundle

Or install it yourself as:

$ gem install xcode-result-bundle-processor

Usage

First, run your UI tests using an invocation like this:

xcodebuild -workspace MyWorkspace.xcworkspace \
    -scheme 'My UI Tests' \
    -sdk iphonesimulator \
    -resultBundlePath "my_results_bundle" \

This will put a bunch of mystery files into my_results_bundle, which you can transform into un-mystery files via

bundle exec xcode-result-bundle-processor --save-html-report report my_results_bundle

The report will appear in report/index.html

Development

If you have RVM and change to the working directory, you'll be prompted to install the needed Ruby version if you don't already have it. RVM will also handle creating a gemset.

To update the dependencies, run

bundle

To run tests, run

bundle exec rake

To build the gem, run

bundle exec rake build

To execute the tool, run

bundle exec xcode-result-bundle-processor

Contributing

We welcome Your interest in the American Express Open Source Community on Github. Any Contributor to any Open Source Project managed by the American Express Open Source Community must accept and sign an Agreement indicating agreement to the terms below. Except for the rights granted in this Agreement to American Express and to recipients of software distributed by American Express, You reserve all right, title, and interest, if any, in and to Your Contributions. Please fill out the Agreement.

License

Any contributions made under this project will be governed by the Apache License 2.0.

Code of Conduct

This project adheres to the American Express Community Guidelines. By participating, you are expected to honor these guidelines.

xcode-result-bundle-processor's Issues

Help on generate html report

Hi ,

I installed this tool by below command:

$ gem install xcode-result-bundle-processor

Generate html via below command:

xcode-result-bundle-processor --save-html-report report my_results_bundle

But I got error "uninitialized constant XcodeResultBundleProcessor::DirectoryResultsBundle::Pathname
" when generating html, please help on this.

Thanks
Luis

Test ticket from Code Climate