Home

Awesome

Build status

Format-Pester

Powershell module for documenting Pester's results.

All the formatting work is done by the module PScribo.

Reports are generated based on a custom PowerShell object returned by Invoke-Pester. You have to provide the parameter PassThru to Pester. Currently, NUnit style files generated by Pester are not supported.

If you can't generate report on a computer where tests are executed please save tests results piping them to Export-Clixml.

You can be interested also in the

Report example

Partial screenshot for a HTML report generated by Format-Pester v. 1.6.0, PScribo v. 0.7.19, the full screenshot.

You can find more examples here.

Supported languages

Since version 1.3.0 internationalization of generated reports is supported. It means that reports parts e.g. section names, columns headers, etc. can be wrote in a different language than English.

Currently available languages are:

If you would like to add support for your language please read the section Information for translators in the project's wiki.

Requirements

Usage

Format-Pester is a PowerShell module so it has to be imported before using it - you can find more instructions in the wiki.

Example 1

  Invoke-Pester -PassThru | Format-Pester -Path . -Format HTML,Word,Text

This command will document the results of the Pester's tests. Documents will be stored in the current path and they will be available in 3 formats (.html,.docx and .txt).

Example 2

    Invoke-Pester -PassThru | Export-Clixml -Path .\Test-Result.xml

    Import-Clixml -Path .\Test-Result.xml | Format-Pester -Format .\ -BaseFileName Test-Result -Format HTML -FailedOnly

You can run the first command on a server where PScribo and Format-Pester are not installed. The tests results object will be stored in a xmf file.

After copying the file to the computer where PScribo and Format-Pester are available you can generate a report. In this example, the HTML file will be generated with results of failed tests only.

Online help

You can read online version of help - online help generated by platyPS module.

Initial author

Contributors

Version history

TODO and development plans

License

Copyright 2016-17 Erwan Quelin and the community.
Licensed under the MIT License