Skip to content

craigatk/projektor

Repository files navigation

Projektor

Project Tests Coverage
Server & Gradle plugin Test results Code coverage percentage
UI Test results Code coverage percentage
Node publisher Test results Code coverage percentage

For detailed instructions to get started with Projektor, please see the full project documentation at https://projektor.dev

Test reports

Tests failing on your machine and need help debugging them? Or tests are passing local but failing in CI and CI doesn't record the test report? Debugging tests in these scenarios can be time consuming and painful, especially if you don't have the full context of the test failure.

Access and share your full test reports quickly and easily with Projektor.

Projektor test report

Projektor shows a summary of all the tests executed as part of your test run:

https://projektorlive.herokuapp.com/tests/RQ99P3LRZJSX

The summary includes things like number of tests executed, how many passed or failed, etc. And if there are any failures, those failure details are shown first on the dashboard:

Projektor dashboard failed test

To help debug failures in any environment (especially CI), Projektor gives you access to the system out and system err from each test:

Projektor system out

https://projektorlive.herokuapp.com/tests/V1BMYK93MTNR/suite/65/systemOut

Code coverage stats

Projektor can capture and visualize code coverage stats from any project that can output code coverage data in Jacoco (Gradle, sbt, etc.), Kover, Clover (Jest, Cypress, etc.), and Cobertura formats.

Projektor calculates overall code coverage stats for the project as well as per-module coverage breakdowns for Gradle multi-project builds:

Projektor overall code coverage

Drilling down further, Projektor can show file-level coverage stats, including which lines are covered, partially covered, or fully missed.

Projektor code coverage files

For example https://projektorlive.herokuapp.com/tests/RQ99P3LRZJSX/coverage/server-app/files

Projektor can also graph your project's code coverage over time, giving you the opportunity to see how the code coverage is trending:

Projektor code coverage graph

More details about using code coverage with Projektor are at https://projektor.dev/docs/code-coverage/

Performance test results

Projektor can record and graph your

Projektor performance test results graph

More details on performance test results with Projektor are at https://projektor.dev/docs/performance-test/

GitHub pull request comments

Projektor can comment directly on your pull request with direct links to the test report, code coverage data - including the change in coverage percentage in the PR.

Projektor pull request comment

Details on how to set this up are at https://projektor.dev/docs/github-pull-request/

Changelog

Projektor server

Projektor server changelog

Projektor Gradle plugin

Projektor Gradle plugin changelog

Projektor Node script

Projektor Node script changelog

Development

For information on how Projektor is developed, how to build it from source and deploy it yourself, and other development information, please see the development guide

Contributors

A big thank you to the contributors to this project!