/Chronometer

A module for measuring performance of Powershell scripts, one line at a time

Primary LanguagePowerShellMIT LicenseMIT

Chronometer

A module for measuring performance of Powershell scripts, one line at a time.

Project status

Preview release. The core logic is fleshed out but more testing is needed.

Getting started

Prerequirements

You need to have Powershell 5.0 or newer. This module uses classes.

Installing Chronometer

This is published in the Powershell Gallery

Install-Module Chronometer

Basic usage

Provide a script file and a command to execute.

$path = myscript.ps1
$Chronometer = Get-Chronometer -Path $path -Script {. .\myscript.ps1}
$Chronometer | Format-Chronometer

Things to know

The Path can be any ps1 and the script can run any command. Ideally, you would either execute the script or load the script and execute a command inside it.

Here is a more complex example:

$script = ls C:\workspace\PSGraph\PSGraph -Recurse -Filter *.ps1
$Chronometer = @{
    Path = $script.fullname
    Script = {Invoke-Pester C:\workspace\PSGraph}
}
$results = Get-Chronometer @Chronometer 
$results | Format-Chronometer