用佩斯特5.3.3进行测试

Question

我已经写了一个函数来编写在CSV文件中函数中发生的错误，此功能在我的函数的捕获块中调用。我想在佩斯特（Pester）写一项测试，以检查我的功能是否正常工作，但是老实说我不知道​​从哪里开始，我尝试了一些事情，但它们对我不起作用，我也一直在阅读文档但我仍然不清楚，我将感谢任何帮助/评论。

这是我想在佩斯特（Pester）写测试的功能：

function Write-Logs {
    param (
        [ValidateSet("Error")]$MessageType,
        [string][Parameter(Mandatory=$true)]$Message,
        $LogFilePath,
        $Source
    )
    $CSVLogPath = Join-Path -Path $PSScriptRoot -ChildPath ".\errorslog.csv"
    $CSVLogObject = [PSCustomObject] @{
        Date = Get-Date
        Message = $Message
        MessageType = $MessageType
        Source = $Source
    }
    $CSVLogObject | Export-Csv -Path $CSVLogPath -NoTypeInformation -Encoding UTF8 -Append
}

，所以我在捕获块中调用该功能：

    catch {
        Write-Logs -LogFilePath:$CSVLogPath -Message:$Error[0].Exception.Message `
        -Source:"FunctionName()" -MessageType:"Error"
        return
    }

Answer 1

继续我的评论，这是一些代码。

首先通过实际使用-logFilePath参数来测试功能。这样，您可以在测试过程中将日志写入临时文件。由于默认值，您仍然可以在不-logfilepath中使用它时使用它。

function Write-Logs {
    param (
        [ValidateSet("Error")]$MessageType,
        [string][Parameter(Mandatory=$true)]$Message,
        $LogFilePath = (Join-Path -Path $PSScriptRoot -ChildPath ".\errorslog.csv"),
        $Source
    )
    $CSVLogObject = [PSCustomObject] @{
        Date = Get-Date
        Message = $Message
        MessageType = $MessageType
        Source = $Source
    }
    $CSVLogObject | Export-Csv -Path $LogFilePath -NoTypeInformation -Encoding UTF8 -Append
}

测试代码：

BeforeAll {
    . $PSCommandPath.Replace('.Tests.ps1','.ps1')
}

Describe "Write-Logs" {
    BeforeEach{
        # Mock Get-Date so it returns a constant value suitable for testing
        $expectedDate = [DateTime]::new( 2022, 06, 28, 12, 36, 21 )
        Mock Get-Date { return $expectedDate }
    }   

    It "writes the expected CSV" {
    
        # You might read this from a file using Import-Csv
        $expectedCsv = [PSCustomObject]@{
            Date = $expectedDate
            Message = 'test message'
            MessageType = 'Error'
            Source = 'test source'
        }

        # Write log to temp file (Pester cleans it automatically, when It block ends)
        $testLogPath = "TestDrive:\test.log"
        Write-Logs -LogFilePath $testLogPath -MessageType $expectedCsv.MessageType -Message $expectedCsv.Message -Source $expectedCsv.Source

        $actualCsv = Import-Csv $testLogPath

        # Test if $expectedCsv equals $actualCsv
        Compare-Object $expectedCsv $actualCsv -Property Date, Message, MessageType, Source | Should -BeNullOrEmpty
    }
}

• testDrive：是佩斯特为每个脚本块创建的临时驱动器。编写临时文件非常方便，因为佩斯特在脚本块结束时会自动清洁它。参见 pester docs 。
• 一旦获得了一些基本测试，您可能需要通过使用数据驱动的测试来改进测试代码。这样可以避免重复，因为您只需要单个测试，该测试可以从不同的数据集中馈送。参见 pester docs ，尤其是“为测试提供外部数据的部分）。