DscResource.Tests/Tests/Unit/DscResource.DocumentationHelper.Tests.ps1
|
$projectRootPath = Split-Path -Path (Split-Path -Path $PSScriptRoot -Parent) -Parent $moduleRootPath = Join-Path -Path $projectRootPath -ChildPath 'DscResource.DocumentationHelper' $modulePath = Join-Path -Path $moduleRootPath -ChildPath 'WikiPages.psm1' Import-Module -Name $modulePath -Force Import-Module -Name (Join-Path -Path (Join-Path -Path (Split-Path $PSScriptRoot -Parent) -ChildPath 'TestHelpers') -ChildPath 'CommonTestHelper.psm1') -Global InModuleScope -ModuleName 'WikiPages' { $script:mockOutputPath = Join-Path -Path $ENV:Temp -ChildPath 'docs' $script:mockModulePath = Join-Path -Path $ENV:Temp -ChildPath 'module' # Schema file info $script:expectedSchemaPath = Join-Path -Path $script:mockModulePath -ChildPath '\**\*.schema.mof' $script:mockSchemaFileName = 'MSFT_MyResource.schema.mof' $script:mockSchemaFolder = Join-Path -Path $script:mockModulePath -ChildPath 'DSCResources\MSFT_MyResource' $script:mockSchemaFilePath = Join-Path -Path $script:mockSchemaFolder -ChildPath $script:mockSchemaFileName $script:mockSchemaFiles = @( @{ FullName = $script:mockSchemaFilePath Name = $script:mockSchemaFileName DirectoryName = $script:mockSchemaFolder } ) $script:mockGetMofSchemaObject = @{ ClassName = 'MSFT_MyResource' Attributes = @( @{ State = 'Key' DataType = 'String' ValueMap = @() IsArray = $false Name = 'Id' Description = 'Id Description' EmbeddedInstance = '' }, @{ State = 'Write' DataType = 'String' ValueMap = @( 'Value1', 'Value2', 'Value3' ) IsArray = $false Name = 'Enum' Description = 'Enum Description.' EmbeddedInstance = '' }, @{ State = 'Required' DataType = 'Uint32' ValueMap = @() IsArray = $false Name = 'Int' Description = 'Int Description.' EmbeddedInstance = '' }, @{ State = 'Read' DataType = 'String' ValueMap = @() IsArray = $false Name = 'Read' Description = 'Read Description.' EmbeddedInstance = '' } ) ClassVersion = '1.0.0' FriendlyName = 'MyResource' } # Example file info $script:mockExampleFilePath = Join-Path -Path $script:mockModulePath -ChildPath '\Examples\Resources\MyResource\MyResource_Example1_Config.ps1' $script:expectedExamplePath = Join-Path -Path $script:mockModulePath -ChildPath '\Examples\Resources\MyResource\*.ps1' $script:mockExampleFiles = @( @{ Name = 'MyResource_Example1_Config.ps1' FullName = $script:mockExampleFilePath } ) $script:mockExampleContent = '### Example 1 Example description. ```powershell Configuration Example { Import-DSCResource -ModuleName MyModule Node localhost { MyResource Something { Id = ''MyId'' Enum = ''Value1'' Int = 1 } } } ```' # General mock values $script:mockReadmePath = Join-Path -Path $script:mockSchemaFolder -ChildPath 'readme.md' $script:mockOutputFile = Join-Path -Path $script:mockOutputPath -ChildPath 'MyResource.md' $script:mockGetContentReadme = ' # Description The description of the resource. ' $script:mockWikiPageOutput = '# MyResource ## Parameters | Parameter | Attribute | DataType | Description | Allowed Values | | --- | --- | --- | --- | --- | | **Id** | Key | String | Id Description || | **Enum** | Write | String | Enum Description. |Value1, Value2, Value3| | **Int** | Required | Uint32 | Int Description. || | **Read** | Read | String | Read Description. || ## Description The description of the resource. ## Examples ### Example 1 Example description. ```powershell Configuration Example { Import-DSCResource -ModuleName MyModule Node localhost { MyResource Something { Id = ''MyId'' Enum = ''Value1'' Int = 1 } } } ``` ' Describe 'DscResource.DocumentationHelper\WikiPages.psm1\New-DscResourceWikiSite' { # Parameter filters $script:getChildItemSchema_parameterFilter = { $Path -eq $script:expectedSchemaPath } $script:getChildItemExample_parameterFilter = { $Path -eq $script:expectedExamplePath } $script:getMofSchemaObjectSchema_parameterfilter = { $Filename -eq $script:mockSchemaFilePath } $script:getTestPathReadme_parameterFilter = { $Path -eq $script:mockReadmePath } $script:getContentReadme_parameterFilter = { $Path -eq $script:mockReadmePath } $script:getDscResourceWikiExampleContent_parameterFilter = { $ExamplePath -eq $script:mockExampleFilePath -and $ExampleNumber -eq 1 } $script:outFile_parameterFilter = { $FilePath -eq $script:mockOutputFile ` -and $InputObject -eq $script:mockWikiPageOutput } # Function call parameters $script:newDscResourceWikiSite_parameters = @{ OutputPath = $script:mockOutputPath ModulePath = $script:mockModulePath Verbose = $true } Context 'When there is no schemas found in the module folder' { BeforeAll { Mock ` -CommandName Get-ChildItem ` -ParameterFilter $script:getChildItemSchema_parameterFilter } It 'Should not throw an exception' { { New-DscResourceWikiSite @script:newDscResourceWikiSite_parameters } | Should -Not -Throw } It 'Should call the expected mocks ' { Assert-MockCalled ` -CommandName Get-ChildItem ` -ParameterFilter $script:getChildItemSchema_parameterFilter ` -Exactly -Times 1 } } Context 'When there is one schema found in the module folder and one example using .EXAMPLE' { BeforeAll { Mock ` -CommandName Get-ChildItem ` -ParameterFilter $script:getChildItemSchema_parameterFilter ` -MockWith { $script:mockSchemaFiles } Mock ` -CommandName Get-MofSchemaObject ` -ParameterFilter $script:getMofSchemaObjectSchema_parameterfilter ` -MockWith { $script:mockGetMofSchemaObject } Mock ` -CommandName Test-Path ` -ParameterFilter $script:getTestPathReadme_parameterFilter ` -MockWith { $true } Mock ` -CommandName Get-Content ` -ParameterFilter $script:getContentReadme_parameterFilter ` -MockWith { $script:mockGetContentReadme } Mock ` -CommandName Get-ChildItem ` -ParameterFilter $script:getChildItemExample_parameterFilter ` -MockWith { $script:mockExampleFiles } Mock ` -CommandName Get-DscResourceWikiExampleContent ` -ParameterFilter $script:getDscResourceWikiExampleContent_parameterFilter ` -MockWith { $script:mockExampleContent } Mock ` -CommandName Out-File ` -ParameterFilter $script:outFile_parameterFilter } It 'Should not throw an exception' { { New-DscResourceWikiSite @script:newDscResourceWikiSite_parameters } | Should -Not -Throw } It 'Should call the expected mocks ' { Assert-MockCalled ` -CommandName Get-ChildItem ` -ParameterFilter $script:getChildItemSchema_parameterFilter ` -Exactly -Times 1 Assert-MockCalled ` -CommandName Get-MofSchemaObject ` -ParameterFilter $script:getMofSchemaObjectSchema_parameterfilter ` -Exactly -Times 1 Assert-MockCalled ` -CommandName Test-Path ` -ParameterFilter $script:getTestPathReadme_parameterFilter ` -Exactly -Times 1 Assert-MockCalled ` -CommandName Get-Content ` -ParameterFilter $script:getContentReadme_parameterFilter ` -Exactly -Times 1 Assert-MockCalled ` -CommandName Get-ChildItem ` -ParameterFilter $script:getChildItemExample_parameterFilter ` -Exactly -Times 1 Assert-MockCalled ` -CommandName Get-DscResourceWikiExampleContent ` -ParameterFilter $script:getDscResourceWikiExampleContent_parameterFilter ` -Exactly -Times 1 Assert-MockCalled ` -CommandName Out-File ` -ParameterFilter $script:outFile_parameterFilter ` -Exactly -Times 1 } } } Describe 'DscResource.DocumentationHelper\WikiPages.psm1\Get-DscResourceWikiExampleContent' { # Parameter filters $script:getContentExample_parameterFilter = { $Path -eq $script:mockExampleFilePath } Context 'When a path to an example file with .EXAMPLE is passed and example number 1' { $script:getDscResourceWikiExampleContent_parameters = @{ ExamplePath = $script:mockExampleFilePath ExampleNumber = 1 Verbose = $true } $script:mockExampleContent = '### Example 1 Example Description. ```powershell Configuration Example { Import-DSCResource -ModuleName MyModule Node localhost { MyResource Something { Id = ''MyId'' Enum = ''Value1'' Int = 1 } } } ```' $script:mockGetContentExample = '<# .EXAMPLE Example Description. #> Configuration Example { Import-DSCResource -ModuleName MyModule Node localhost { MyResource Something { Id = ''MyId'' Enum = ''Value1'' Int = 1 } } }' -split "`r`n" BeforeAll { Mock ` -CommandName Get-Content ` -ParameterFilter $script:getContentExample_parameterFilter ` -MockWith { $script:mockGetContentExample } } It 'Should not throw an exception' { { $script:result = Get-DscResourceWikiExampleContent @script:getDscResourceWikiExampleContent_parameters } | Should -Not -Throw } It 'Should return the expected string' { $script:result | Should -Be $script:mockExampleContent } It 'Should call the expected mocks ' { Assert-MockCalled ` -CommandName Get-Content ` -ParameterFilter $script:getContentExample_parameterFilter ` -Exactly -Times 1 } } Context 'When a path to an example file with .DESCRIPTION is passed and example number 2' { $script:getDscResourceWikiExampleContent_parameters = @{ ExamplePath = $script:mockExampleFilePath ExampleNumber = 2 Verbose = $true } $script:mockExampleContent = '### Example 2 Example Description. ```powershell Configuration Example { Import-DSCResource -ModuleName MyModule Node localhost { MyResource Something { Id = ''MyId'' Enum = ''Value1'' Int = 1 } } } ```' $script:mockGetContentExample = '<# .DESCRIPTION Example Description. #> Configuration Example { Import-DSCResource -ModuleName MyModule Node localhost { MyResource Something { Id = ''MyId'' Enum = ''Value1'' Int = 1 } } }' -split "`r`n" BeforeAll { Mock ` -CommandName Get-Content ` -ParameterFilter $script:getContentExample_parameterFilter ` -MockWith { $script:mockGetContentExample } } It 'Should not throw an exception' { { $script:result = Get-DscResourceWikiExampleContent @script:getDscResourceWikiExampleContent_parameters } | Should -Not -Throw } It 'Should return the expected string' { $script:result | Should -Be $script:mockExampleContent } It 'Should call the expected mocks ' { Assert-MockCalled ` -CommandName Get-Content ` -ParameterFilter $script:getContentExample_parameterFilter ` -Exactly -Times 1 } } Context 'When a path to an example file with .SYNOPSIS is passed and example number 3' { $script:getDscResourceWikiExampleContent_parameters = @{ ExamplePath = $script:mockExampleFilePath ExampleNumber = 3 Verbose = $true } $script:mockExampleContent = '### Example 3 Example Description. ```powershell Configuration Example { Import-DSCResource -ModuleName MyModule Node localhost { MyResource Something { Id = ''MyId'' Enum = ''Value1'' Int = 1 } } } ```' $script:mockGetContentExample = '<# .SYNOPSIS Example Description. #> Configuration Example { Import-DSCResource -ModuleName MyModule Node localhost { MyResource Something { Id = ''MyId'' Enum = ''Value1'' Int = 1 } } }' -split "`r`n" BeforeAll { Mock ` -CommandName Get-Content ` -ParameterFilter $script:getContentExample_parameterFilter ` -MockWith { $script:mockGetContentExample } } It 'Should not throw an exception' { { $script:result = Get-DscResourceWikiExampleContent @script:getDscResourceWikiExampleContent_parameters } | Should -Not -Throw } It 'Should return the expected string' { $script:result | Should -Be $script:mockExampleContent } It 'Should call the expected mocks ' { Assert-MockCalled ` -CommandName Get-Content ` -ParameterFilter $script:getContentExample_parameterFilter ` -Exactly -Times 1 } } Context 'When a path to an example file with .SYNOPSIS and #Requires is passed and example number 4' { $script:getDscResourceWikiExampleContent_parameters = @{ ExamplePath = $script:mockExampleFilePath ExampleNumber = 4 Verbose = $true } $script:mockExampleContent = '### Example 4 Example Description. ```powershell Configuration Example { Import-DSCResource -ModuleName MyModule Node localhost { MyResource Something { Id = ''MyId'' Enum = ''Value1'' Int = 1 } } } ```' $script:mockGetContentExample = '#Requires -module MyModule #Requires -module OtherModule <# .SYNOPSIS Example Description. #> Configuration Example { Import-DSCResource -ModuleName MyModule Node localhost { MyResource Something { Id = ''MyId'' Enum = ''Value1'' Int = 1 } } }' -split "`r`n" BeforeAll { Mock ` -CommandName Get-Content ` -ParameterFilter $script:getContentExample_parameterFilter ` -MockWith { $script:mockGetContentExample } } It 'Should not throw an exception' { { $script:result = Get-DscResourceWikiExampleContent @script:getDscResourceWikiExampleContent_parameters } | Should -Not -Throw } It 'Should return the expected string' { $script:result | Should -Be $script:mockExampleContent } It 'Should call the expected mocks ' { Assert-MockCalled ` -CommandName Get-Content ` -ParameterFilter $script:getContentExample_parameterFilter ` -Exactly -Times 1 } } Context 'When a path to an example file with .DESCRIPTION, #Requires and PSScriptInfo is passed and example number 5' { $script:getDscResourceWikiExampleContent_parameters = @{ ExamplePath = $script:mockExampleFilePath ExampleNumber = 5 Verbose = $true } $script:mockExampleContent = '### Example 5 Example Description. ```powershell Configuration Example { Import-DSCResource -ModuleName MyModule Node localhost { MyResource Something { Id = ''MyId'' Enum = ''Value1'' Int = 1 } } } ```' $script:mockGetContentExample = '<#PSScriptInfo .VERSION 1.0.0 .GUID 14b1346a-436a-4f64-af5c-b85119b819b3 .AUTHOR Microsoft Corporation .COMPANYNAME Microsoft Corporation .COPYRIGHT .TAGS DSCConfiguration .LICENSEURI https://github.com/PowerShell/CertificateDsc/blob/master/LICENSE .PROJECTURI https://github.com/PowerShell/CertificateDsc .ICONURI .EXTERNALMODULEDEPENDENCIES .REQUIREDSCRIPTS .EXTERNALSCRIPTDEPENDENCIES .RELEASENOTES First version. .PRIVATEDATA 2016-Datacenter,2016-Datacenter-Server-Core #> #Requires -module MyModule #Requires -module OtherModule <# .DESCRIPTION Example Description. #> Configuration Example { Import-DSCResource -ModuleName MyModule Node localhost { MyResource Something { Id = ''MyId'' Enum = ''Value1'' Int = 1 } } }' -split "`r`n" BeforeAll { Mock ` -CommandName Get-Content ` -ParameterFilter $script:getContentExample_parameterFilter ` -MockWith { $script:mockGetContentExample } } It 'Should not throw an exception' { { $script:result = Get-DscResourceWikiExampleContent @script:getDscResourceWikiExampleContent_parameters } | Should -Not -Throw } It 'Should return the expected string' { $script:result | Should -Be $script:mockExampleContent } It 'Should call the expected mocks ' { Assert-MockCalled ` -CommandName Get-Content ` -ParameterFilter $script:getContentExample_parameterFilter ` -Exactly -Times 1 } } Context 'When a path to an example file with .SYNOPSIS, .DESCRIPTION and PSScriptInfo is passed and example number 6' { $script:getDscResourceWikiExampleContent_parameters = @{ ExamplePath = $script:mockExampleFilePath ExampleNumber = 6 Verbose = $true } $script:mockExampleContent = '### Example 6 Example Synopsis. Example Description. ```powershell Configuration Example { Import-DSCResource -ModuleName MyModule Node localhost { MyResource Something { Id = ''MyId'' Enum = ''Value1'' Int = 1 } } } ```' $script:mockGetContentExample = '<#PSScriptInfo .VERSION 1.0.0 .GUID 14b1346a-436a-4f64-af5c-b85119b819b3 .AUTHOR Microsoft Corporation .COMPANYNAME Microsoft Corporation .COPYRIGHT .TAGS DSCConfiguration .LICENSEURI https://github.com/PowerShell/CertificateDsc/blob/master/LICENSE .PROJECTURI https://github.com/PowerShell/CertificateDsc .ICONURI .EXTERNALMODULEDEPENDENCIES .REQUIREDSCRIPTS .EXTERNALSCRIPTDEPENDENCIES .RELEASENOTES First version. .PRIVATEDATA 2016-Datacenter,2016-Datacenter-Server-Core #> <# .SYNOPSIS Example Synopsis. .DESCRIPTION Example Description. #> Configuration Example { Import-DSCResource -ModuleName MyModule Node localhost { MyResource Something { Id = ''MyId'' Enum = ''Value1'' Int = 1 } } }' -split "`r`n" BeforeAll { Mock ` -CommandName Get-Content ` -ParameterFilter $script:getContentExample_parameterFilter ` -MockWith { $script:mockGetContentExample } } It 'Should not throw an exception' { { $script:result = Get-DscResourceWikiExampleContent @script:getDscResourceWikiExampleContent_parameters } | Should -Not -Throw } It 'Should return the expected string' { $script:result | Should -Be $script:mockExampleContent } It 'Should call the expected mocks ' { Assert-MockCalled ` -CommandName Get-Content ` -ParameterFilter $script:getContentExample_parameterFilter ` -Exactly -Times 1 } } Context 'When a path to an example file from SharePointDsc resource module and example number 7' { $script:getDscResourceWikiExampleContent_parameters = @{ ExamplePath = $script:mockExampleFilePath ExampleNumber = 7 Verbose = $true } $script:mockExampleContent = '### Example 7 This example shows how to deploy Access Services 2013 to the local SharePoint farm. ```powershell Configuration Example { param( [Parameter(Mandatory = $true)] [PSCredential] $SetupAccount ) Import-DscResource -ModuleName SharePointDsc node localhost { SPAccessServiceApp AccessServices { Name = "Access Services Service Application" ApplicationPool = "SharePoint Service Applications" DatabaseServer = "SQL.contoso.local\SQLINSTANCE" PsDscRunAsCredential = $SetupAccount } } } ```' $script:mockGetContentExample = '<# .EXAMPLE This example shows how to deploy Access Services 2013 to the local SharePoint farm. #> Configuration Example { param( [Parameter(Mandatory = $true)] [PSCredential] $SetupAccount ) Import-DscResource -ModuleName SharePointDsc node localhost { SPAccessServiceApp AccessServices { Name = "Access Services Service Application" ApplicationPool = "SharePoint Service Applications" DatabaseServer = "SQL.contoso.local\SQLINSTANCE" PsDscRunAsCredential = $SetupAccount } } }' -split "`r`n" BeforeAll { Mock ` -CommandName Get-Content ` -ParameterFilter $script:getContentExample_parameterFilter ` -MockWith { $script:mockGetContentExample } } It 'Should not throw an exception' { { $script:result = Get-DscResourceWikiExampleContent @script:getDscResourceWikiExampleContent_parameters } | Should -Not -Throw } It 'Should return the expected string' { $script:result | Should -Be $script:mockExampleContent } It 'Should call the expected mocks ' { Assert-MockCalled ` -CommandName Get-Content ` -ParameterFilter $script:getContentExample_parameterFilter ` -Exactly -Times 1 } } } Context 'When a path to an example file from CertificateDsc resource module and example number 8' { $script:getDscResourceWikiExampleContent_parameters = @{ ExamplePath = $script:mockExampleFilePath ExampleNumber = 8 Verbose = $true } $script:mockExampleContent = '### Example 8 Exports a certificate as a CERT using the friendly name to identify it. ```powershell Configuration CertificateExport_CertByFriendlyName_Config { Import-DscResource -ModuleName CertificateDsc Node localhost { CertificateExport SSLCert { Type = ''CERT'' FriendlyName = ''Web Site SSL Certificate for www.contoso.com'' Path = ''c:\sslcert.cer'' } } } ```' $script:mockGetContentExample = '<#PSScriptInfo .VERSION 1.0.0 .GUID 14b1346a-436a-4f64-af5c-b85119b819b3 .AUTHOR Microsoft Corporation .COMPANYNAME Microsoft Corporation .COPYRIGHT .TAGS DSCConfiguration .LICENSEURI https://github.com/PowerShell/CertificateDsc/blob/master/LICENSE .PROJECTURI https://github.com/PowerShell/CertificateDsc .ICONURI .EXTERNALMODULEDEPENDENCIES .REQUIREDSCRIPTS .EXTERNALSCRIPTDEPENDENCIES .RELEASENOTES First version. .PRIVATEDATA 2016-Datacenter,2016-Datacenter-Server-Core #> #Requires -module CertificateDsc <# .DESCRIPTION Exports a certificate as a CERT using the friendly name to identify it. #> Configuration CertificateExport_CertByFriendlyName_Config { Import-DscResource -ModuleName CertificateDsc Node localhost { CertificateExport SSLCert { Type = ''CERT'' FriendlyName = ''Web Site SSL Certificate for www.contoso.com'' Path = ''c:\sslcert.cer'' } } }' -split "`r`n" BeforeAll { Mock ` -CommandName Get-Content ` -ParameterFilter $script:getContentExample_parameterFilter ` -MockWith { $script:mockGetContentExample } } It 'Should not throw an exception' { { $script:result = Get-DscResourceWikiExampleContent @script:getDscResourceWikiExampleContent_parameters } | Should -Not -Throw } It 'Should return the expected string' { $script:result | Should -Be $script:mockExampleContent } It 'Should call the expected mocks ' { Assert-MockCalled ` -CommandName Get-Content ` -ParameterFilter $script:getContentExample_parameterFilter ` -Exactly -Times 1 } } Describe 'DscResource.DocumentationHelper\WikiPages.psm1\Publish-WikiContent' { $mockRepoName = 'PowerShell/DummyServiceDsc' $mockResourceModuleName = ($mockRepoName -split '/')[1] $mockGitUserEmail = 'mock@contoso.com' $mockGitUserName = 'mock' $mockGithubAccessToken = '1234567890' $mockPath = $env:temp $mockJobId = 'imy2wgh1ylo9qcpb' $mockBuildVersion = '2.1.456.0' $mockapiUrl = 'https://ci.appveyor.com/api' $mockJobArtifactsUrl = "$mockapiUrl/buildjobs/$mockJobId/artifacts" $mockGitRepoNotFoundMessage = 'git.exe : fatal: remote error' $mockInvokeRestMethodJobIdNotFoundMessage = '{"Message":"Job not found."}' $mockInvokeRestMethodUnexpectedErrorMessage = '{"Message":"Unexpected Error."}' $mockInvokeRestMethodJobArtifactsObject = @( @{ created = '2019-06-04T15:23:53.8064505+00:00' filename = "TestsResults.xml" size = 1049288 type = 'File' } @{ created = '2019-06-04T15:24:28.0273896+00:00' filename = "$($mockResourceModuleName)_$($mockBuildVersion)_wikicontent.zip" size = 20692 type = 'Zip' } ) $mockInvokeRestMethodJobArtifactsObjectNoWikiContent = $mockInvokeRestMethodJobArtifactsObject[0] $mockWikiContentArtifactUrl = "$mockapiUrl/buildjobs/$mockJobId/artifacts/$($mockInvokeRestMethodJobArtifactsObject[1].fileName)" # Parameter filters $script:invokeGitClone_parameterFilter = { $arguments -eq 'clone' } $script:invokeGitConfigUserEmail_parameterFilter = { $Arguments[0] -eq 'config' -and $Arguments[1] -eq '--local' -and $Arguments[2] -eq 'user.email' -and $Arguments[3] -eq $mockGitUserEmail } $script:invokeGitConfigUserName_parameterFilter = { $Arguments[0] -eq 'config' -and $Arguments[1] -eq '--local' -and $Arguments[2] -eq 'user.name' -and $Arguments[3] -eq $mockGitUserName } $script:invokeGitRemoteSetUrl_parameterFilter = { $Arguments[0] -eq 'remote' -and $Arguments[1] -eq 'set-url' -and $Arguments[2] -eq 'origin' -and $Arguments[3] -eq "https://$($mockGitUserName):$($mockGithubAccessToken)@github.com/$mockRepoName.wiki.git" } $script:invokeGitAdd_parameterFilter = { $Arguments[0] -eq 'add' -and $Arguments[1] -eq '*' } $script:invokeGitCommit_parameterFilter = { $Arguments[0] -eq 'commit' -and $Arguments[1] -eq '--message' -and $Arguments[2] -eq ($localizedData.UpdateWikiCommitMessage -f $mockJobId) -and $Arguments[3] -eq '--quiet' } $script:invokeGitTag_parameterFilter = { $Arguments[0] -eq 'tag' -and $Arguments[1] -eq '--annotate' -and $Arguments[2] -eq $mockBuildVersion -and $Arguments[3] -eq '--message' -and $Arguments[4] -eq $mockBuildVersion } $script:invokeGitPush_parameterFilter = { $Arguments[0] -eq 'push' -and $Arguments[1] -eq 'origin' -and $Arguments[2] -eq '--quiet' } $script:invokeGitPushBuildVersion_parameterFilter = { $Arguments[0] -eq 'push' -and $Arguments[1] -eq 'origin' -and $Arguments[2] -eq $mockBuildVersion -and $Arguments[3] -eq '--quiet' } $script:invokeRestMethodJobArtifacts_parameterFilter = { $uri -eq $mockJobArtifactsUrl } $script:invokeRestMethodWikiContentArtifact_parameterFilter = { $uri -eq $mockWikiContentArtifactUrl } # Function call parameters $script:publishWikiContent_parameters = @{ RepoName = $mockRepoName JobId = $mockJobId MainModulePath = $mockPath ResourceModuleName = $mockResourceModuleName BuildVersion = $mockbuildVersion GitUserEmail = $mockGitUserEmail GitUserName = $mockGitUserName GithubAccessToken = $mockGithubAccessToken } $script:mockNewItemObject = @{ FullName = $mockPath } BeforeAll { Mock -CommandName New-Item -MockWith { $script:mockNewItemObject } Mock -CommandName Invoke-Git Mock -CommandName Invoke-RestMethod Mock -CommandName Expand-Archive Mock -CommandName Remove-Item Mock -CommandName Set-Location Mock -CommandName Set-WikiSidebar Mock -CommandName Set-WikiFooter Mock -CommandName Copy-WikiFile } Context 'When the Wiki Git repo is not found' { BeforeAll { Mock -CommandName Invoke-Git -MockWith { Throw $mockGitRepoNotFoundMessage } } It 'Should throw the correct exception' { { Publish-WikiContent @script:publishWikiContent_parameters } | Should -Throw $mockGitRepoNotFoundMessage } } Context 'When the Wiki Git repo is found' { BeforeAll { Mock -CommandName Invoke-RestMethod ` -ParameterFilter $script:invokeRestMethodJobArtifacts_parameterFilter ` -MockWith { $mockInvokeRestMethodJobArtifactsObject } } It 'Should not throw an exception' { { Publish-WikiContent @script:publishWikiContent_parameters } | Should -Not -Throw } It 'Should call the expected mocks' { Assert-MockCalled ` -CommandName Invoke-Git ` -ParameterFilter $script:invokeGitClone_parameterFilter ` -Exactly -Times 1 } Context 'When the AppVeyor job ID is not found' { BeforeAll { Mock -CommandName Invoke-RestMethod ` -ParameterFilter $script:invokeRestMethodJobArtifacts_parameterFilter ` -MockWith { Throw $mockInvokeRestMethodJobIdNotFoundMessage } } It 'Should throw the correct exception' { { Publish-WikiContent @script:publishWikiContent_parameters } | Should -Throw ($script:LocalizedData.NoAppVeyorJobFoundError -f $mockJobId) } } Context 'When the AppVeyor artifact details download Invoke-RestMethod produces an unexpected error' { BeforeAll { Mock -CommandName Invoke-RestMethod ` -ParameterFilter $script:invokeRestMethodJobArtifacts_parameterFilter ` -MockWith { Throw $mockInvokeRestMethodUnexpectedErrorMessage } } It 'Should throw the correct exception' { { Publish-WikiContent @script:publishWikiContent_parameters } | Should -Throw (($mockInvokeRestMethodUnexpectedErrorMessage | ConvertTo-Json).Message) } } Context 'When the AppVeyor job ID is found' { BeforeAll { Mock -CommandName Invoke-RestMethod ` -ParameterFilter $script:invokeRestMethodJobArtifacts_parameterFilter ` -MockWith { $mockInvokeRestMethodJobArtifactsObject } } It 'Should not throw an exception' { { Publish-WikiContent @script:publishWikiContent_parameters } | Should -Not -Throw } It 'Should call the expected mocks' { Assert-MockCalled ` -CommandName Invoke-RestMethod ` -ParameterFilter $script:invokeRestMethodJobArtifacts_parameterFilter ` -Exactly -Times 1 } Context 'When the AppVeyor job has no artifacts' { BeforeAll { Mock -CommandName Invoke-RestMethod ` -ParameterFilter $script:invokeRestMethodJobArtifacts_parameterFilter ` -MockWith { @() } } It 'Should throw the correct exception' { { Publish-WikiContent @script:publishWikiContent_parameters } | Should -Throw ($LocalizedData.NoWikiContentArtifactError -f $mockJobId) } } Context 'When the AppVeyor job does not have a WikiContent artifact' { BeforeAll { Mock -CommandName Invoke-RestMethod ` -ParameterFilter $script:invokeRestMethodJobArtifacts_parameterFilter ` -MockWith { $mockInvokeRestMethodJobArtifactsObjectNoWikiContent } } It 'Should throw the correct exception' { { Publish-WikiContent @script:publishWikiContent_parameters } | Should -Throw ($LocalizedData.NoWikiContentArtifactError -f $mockJobId) } } Context 'When the AppVeyor job does have a WikiContent artifact' { BeforeAll { Mock -CommandName Invoke-RestMethod ` -ParameterFilter $script:invokeRestMethodJobArtifacts_parameterFilter ` -MockWith { $mockInvokeRestMethodJobArtifactsObject } } It 'Should not throw' { { Publish-WikiContent @script:publishWikiContent_parameters } | Should -Not -Throw } It 'Should call the expected mocks' { Assert-MockCalled ` -CommandName Invoke-RestMethod ` -ParameterFilter $script:invokeRestMethodJobArtifacts_parameterFilter ` -Exactly -Times 1 } Context 'When the AppVeyor WikiContent artifact cannot be downloaded' { BeforeAll { Mock -CommandName Invoke-RestMethod ` -ParameterFilter $script:invokeRestMethodWikiContentArtifact_parameterFilter ` -MockWith { Throw ($LocalizedData.NoWikiContentArtifactError -f $mockJobId) } } It 'Should throw the correct exception' { { Publish-WikiContent @script:publishWikiContent_parameters } | Should -Throw ($LocalizedData.NoWikiContentArtifactError -f $mockJobId) } } Context 'When the AppVeyor WikiContent artifact can be downloaded' { BeforeAll { Mock -CommandName Invoke-RestMethod ` -ParameterFilter $script:invokeRestMethodWikiContentArtifact_parameterFilter ` } It 'Should not throw' { { Publish-WikiContent @script:publishWikiContent_parameters } | Should -Not -Throw } It 'Should call the expected mocks' { Assert-MockCalled ` -CommandName Invoke-RestMethod ` -ParameterFilter $script:invokeRestMethodWikiContentArtifact_parameterFilter ` -Exactly -Times 1 Assert-MockCalled ` -CommandName Invoke-Git ` -ParameterFilter $script:invokeGitConfigUserEmail_parameterFilter ` -Exactly -Times 1 Assert-MockCalled ` -CommandName Invoke-Git ` -ParameterFilter $script:invokeGitConfigUserName_parameterFilter ` -Exactly -Times 1 Assert-MockCalled ` -CommandName Invoke-Git ` -ParameterFilter $script:invokeGitRemoteSetUrl_parameterFilter ` -Exactly -Times 1 Assert-MockCalled ` -CommandName Invoke-Git ` -ParameterFilter $script:invokeGitAdd_parameterFilter ` -Exactly -Times 1 Assert-MockCalled ` -CommandName Invoke-Git ` -ParameterFilter $script:invokeGitCommit_parameterFilter ` -Exactly -Times 1 Assert-MockCalled ` -CommandName Invoke-Git ` -ParameterFilter $script:invokeGitTag_parameterFilter ` -Exactly -Times 1 Assert-MockCalled ` -CommandName Invoke-Git ` -ParameterFilter $script:invokeGitPush_parameterFilter ` -Exactly -Times 1 Assert-MockCalled ` -CommandName Invoke-Git ` -ParameterFilter $script:invokeGitPushBuildVersion_parameterFilter ` -Exactly -Times 1 } } } } } } Describe 'DscResource.DocumentationHelper\WikiPages.psm1\New-TempFile' { $mockPath = @{ Name = 'l55xoanl.ojy' } Context 'When a new temp folder is created' { BeforeAll { Mock -CommandName New-Item ` -ParameterFilter { $ItemType -eq 'Directory' } ` -MockWith { $mockPath } } It 'Should not throw' { { New-TempFolder } | Should -Not -Throw } It 'Should call the expected mocks' { Assert-MockCalled ` -CommandName New-Item ` -ParameterFilter { $ItemType -eq 'Directory' } ` -Exactly -Times 1 } } Context 'When a new temp folder cannot be created' { BeforeAll { Mock -CommandName New-Item ` -ParameterFilter { $ItemType -eq 'Directory' } ` -MockWith { $false } } It 'Should throw the correct error' { $tempPath = [System.IO.Path]::GetTempPath() { New-TempFolder } | Should -Throw ($localizedData.NewTempFolderCreationError -f $tempPath) } It 'Should call the expected mocks' { Assert-MockCalled ` -CommandName New-Item ` -ParameterFilter { $ItemType -eq 'Directory' } ` -Exactly -Times 10 } } } Describe 'DscResource.DocumentationHelper\WikiPages.psm1\Set-WikiSideBar' { BeforeAll { $mockSetWikiSideBarParms = @{ ResourceModuleName = 'TestResource' Path = $env:temp } $mockFileInfo = @( @{ Name = 'resource1.md' BaseName = 'resource1' FullName = "$($env:temp)\resource1.md" } ) $wikiSideBarFileBaseName = '_Sidebar.md' $wikiSideBarFileFullName = Join-Path -Path $mockSetWikiSideBarParms.Path -ChildPath $wikiSideBarFileBaseName Mock -CommandName Out-File } Context 'When there are markdown files to add to the side bar' { BeforeAll { Mock -CommandName Get-ChildItem -MockWith { $mockFileInfo } } It 'Should not throw an exception' { { Set-WikiSideBar @mockSetWikiSideBarParms -Verbose } | Should -Not -Throw } It 'Should call the expected mocks ' { Assert-MockCalled ` -CommandName Get-ChildItem ` -ParameterFilter { $Path -eq $mockSetWikiSideBarParms.Path } ` -Exactly -Times 1 Assert-MockCalled ` -CommandName Out-File ` -ParameterFilter { $FilePath -eq $wikiSideBarFileFullName } ` -Exactly -Times 1 } } } Describe 'DscResource.DocumentationHelper\WikiPages.psm1\Set-WikiFooter' { BeforeAll { $mockSetWikiFooterParms = @{ ResourceModuleName = 'TestResource' Path = $env:temp } $mockWikiFooterPath = Join-Path -Path $mockSetWikiFooterParms.Path -ChildPath '_Footer.md' Mock -CommandName Out-File } Context 'When there is no pre-existing Wiki footer file' { BeforeAll { Mock -CommandName Test-Path ` -ParameterFilter { $Path -eq $mockWikiFooterPath } ` -MockWith { $false } } It 'Should not throw an exception' { { Set-WikiFooter @mockSetWikiFooterParms } | Should -Not -Throw } It 'Should create the footer file' { Assert-MockCalled ` -CommandName Out-File ` -ParameterFilter { $FilePath -eq $mockWikiFooterPath } ` -Exactly -Times 1 } } Context 'When there is a pre-existing Wiki footer file' { BeforeAll { Mock -CommandName Test-Path ` -ParameterFilter { $Path -eq $mockWikiFooterPath } ` -MockWith { $true } } It 'Should not throw an exception' { { Set-WikiFooter @mockSetWikiFooterParms } | Should -Not -Throw } It 'Should not create the footer file' { Assert-MockCalled ` -CommandName Out-File ` -ParameterFilter { $FilePath -eq $mockWikiFooterPath } ` -Exactly -Times 0 } } } Describe 'DscResource.DocumentationHelper\WikiPages.psm1\Copy-WikiFile' { BeforeAll { $mockCopyWikiFileParms = @{ MainModulePath = "$env:temp\TestModule" Path = $env:temp WikiSourceFolder = 'WikiSource' } $mockFileInfo = @( @{ Name = 'Home.md' FullName = "$($mockCopyWikiFilParms.MainModulePath)\WikiSource\Home.md" } @{ Name = 'image.png' FullName = "$($mockCopyWikiFilParms.MainModulePath)\WikiSource\image.png" } ) Mock -CommandName Copy-Item } Context 'When there are no files to copy' { BeforeAll { Mock -CommandName Get-ChildItem } It 'Should not throw an exception' { { Copy-WikiFile @mockCopyWikiFileParms } | Should -Not -Throw } It 'Should not copy any files' { Assert-MockCalled ` -CommandName Copy-Item ` -Exactly -Times 0 } } Context 'When there are files to copy' { BeforeAll { Mock -CommandName Get-ChildItem ` -MockWith { $mockfileInfo } } It 'Should not throw an exception' { { Copy-WikiFile @mockCopyWikiFileParms } | Should -Not -Throw } It 'Should copy the correct number of files' { Assert-MockCalled ` -CommandName Copy-Item ` -ParameterFilter { $Destination -eq $env:temp } ` -Exactly -Times 2 } } } } $modulePath = Join-Path -Path $moduleRootPath -ChildPath 'PowerShellHelp.psm1' Import-Module -Name $modulePath -Force InModuleScope -ModuleName 'PowerShellHelp' { $script:mockOutputPath = Join-Path -Path $ENV:Temp -ChildPath 'docs' $script:mockModulePath = Join-Path -Path $ENV:Temp -ChildPath 'module' # Schema file info $script:mockResourceName = 'MyResource' $script:expectedSchemaPath = Join-Path -Path $script:mockModulePath -ChildPath '\**\*.schema.mof' $script:mockSchemaBaseName = "MSFT_$($script:mockResourceName).schema" $script:mockSchemaFileName = "$($script:mockSchemaBaseName).mof" $script:mockSchemaFolder = Join-Path -Path $script:mockModulePath -ChildPath "DSCResources\$($script:mockResourceName)" $script:mockSchemaFilePath = Join-Path -Path $script:mockSchemaFolder -ChildPath $script:mockSchemaFileName $script:mockSchemaFiles = @( @{ FullName = $script:mockSchemaFilePath Name = $script:mockSchemaFileName DirectoryName = $script:mockSchemaFolder BaseName = $script:mockSchemaBaseName } ) $script:mockGetMofSchemaObject = @{ ClassName = 'MSFT_MyResource' Attributes = @( @{ State = 'Key' DataType = 'String' ValueMap = @() IsArray = $false Name = 'Id' Description = 'Id Description' EmbeddedInstance = '' }, @{ State = 'Write' DataType = 'String' ValueMap = @( 'Value1', 'Value2', 'Value3' ) IsArray = $false Name = 'Enum' Description = 'Enum Description.' EmbeddedInstance = '' }, @{ State = 'Required' DataType = 'Uint32' ValueMap = @() IsArray = $false Name = 'Int' Description = 'Int Description.' EmbeddedInstance = '' }, @{ State = 'Read' DataType = 'String' ValueMap = @() IsArray = $false Name = 'Read' Description = 'Read Description.' EmbeddedInstance = '' } ) ClassVersion = '1.0.0' FriendlyName = 'MyResource' } # Example file info $script:mockExampleFilePath = Join-Path -Path $script:mockModulePath -ChildPath "\Examples\Resources\$($script:mockResourceName)\$($script:mockResourceName)_Example1_Config.ps1" $script:expectedExamplePath = Join-Path -Path $script:mockModulePath -ChildPath "\Examples\Resources\$($script:mockResourceName)\*.ps1" $script:mockExampleFiles = @( @{ Name = "$($script:mockResourceName)_Example1_Config.ps1" FullName = $script:mockExampleFilePath } ) $script:mockExampleContent = '.EXAMPLE 1 Example description. Configuration Example { Import-DSCResource -ModuleName MyModule Node localhost { MyResource Something { Id = ''MyId'' Enum = ''Value1'' Int = 1 } } }' # General mock values $script:mockReadmePath = Join-Path -Path $script:mockSchemaFolder -ChildPath 'readme.md' $script:mockOutputFile = Join-Path -Path $script:mockOutputPath -ChildPath "$($script:mockResourceName).md" $script:mockSavePath = Join-Path -Path $script:mockModulePath -ChildPath "DscResources\$($script:mockResourceName)\en-US\about_$($script:mockResourceName).help.txt" $script:mockOutputSavePath = Join-Path -Path $script:mockOutputPath -ChildPath "about_$($script:mockResourceName).help.txt" $script:mockGetContentReadme = '# Description The description of the resource.' $script:mockPowerShellHelpOutput = '.NAME MyResource .DESCRIPTION The description of the resource. .PARAMETER Id Key - String Id Description .PARAMETER Enum Write - String Allowed values: Value1, Value2, Value3 Enum Description. .PARAMETER Int Required - Uint32 Int Description. .PARAMETER Read Read - String Read Description. .EXAMPLE 1 Example description. Configuration Example { Import-DSCResource -ModuleName MyModule Node localhost { MyResource Something { Id = ''MyId'' Enum = ''Value1'' Int = 1 } } } ' Describe 'DscResource.DocumentationHelper\PowerShellHelp.psm1\New-DscResourcePowerShellHelp' { # Parameter filters $script:getChildItemSchema_parameterFilter = { $Path -eq $script:expectedSchemaPath } $script:getChildItemExample_parameterFilter = { $Path -eq $script:expectedExamplePath } $script:getMofSchemaObjectSchema_parameterfilter = { $Filename -eq $script:mockSchemaFilePath } $script:getTestPathReadme_parameterFilter = { $Path -eq $script:mockReadmePath } $script:getContentReadme_parameterFilter = { $Path -eq $script:mockReadmePath } $script:getDscResourceHelpExampleContent_parameterFilter = { $ExamplePath -eq $script:mockExampleFilePath -and $ExampleNumber -eq 1 } $script:outFile_parameterFilter = { $FilePath -eq $script:mockSavePath } $script:outFileInputObject_parameterFilter = { $InputObject -eq $script:mockPowerShellHelpOutput -and $FilePath -eq $script:mockSavePath } $script:outFileOutputInputObject_parameterFilter = { $InputObject -eq $script:mockPowerShellHelpOutput -and $FilePath -eq $script:mockOutputSavePath } $script:writeWarningDescription_parameterFilter = { $Message -eq ($script:localizedData.NoDescriptionFileFoundWarning -f $mockResourceName) } $script:writeWarningExample_parameterFilter = { $Message -eq ($script:localizedData.NoExampleFileFoundWarning -f $mockResourceName) } # Function call parameters $script:newDscResourcePowerShellHelp_parameters = @{ ModulePath = $script:mockModulePath } $script:newDscResourcePowerShellHelpOutput_parameters = @{ ModulePath = $script:mockModulePath OutputPath = $script:mockOutputPath } Context 'When there is no schemas found in the module folder' { BeforeAll { Mock ` -CommandName Get-ChildItem ` -ParameterFilter $script:getChildItemSchema_parameterFilter Mock ` -CommandName Out-File ` -ParameterFilter $script:outFile_parameterFilter } It 'Should not throw an exception' { { New-DscResourcePowerShellHelp @script:newDscResourcePowerShellHelp_parameters } | Should -Not -Throw } It 'Should call the expected mocks ' { Assert-MockCalled ` -CommandName Get-ChildItem ` -ParameterFilter $script:getChildItemSchema_parameterFilter ` -Exactly -Times 1 Assert-MockCalled ` -CommandName Out-File ` -Exactly -Times 0 } } Context 'When there is no resource description found' { BeforeAll { Mock ` -CommandName Get-ChildItem ` -ParameterFilter $script:getChildItemSchema_parameterFilter ` -MockWith { $script:mockSchemaFiles } Mock ` -CommandName Get-MofSchemaObject ` -ParameterFilter $script:getMofSchemaObjectSchema_parameterfilter ` -MockWith { $script:mockGetMofSchemaObject } Mock ` -CommandName Test-Path ` -ParameterFilter $script:getTestPathReadme_parameterFilter ` -MockWith { $false } Mock ` -CommandName Out-File ` -ParameterFilter $script:outFile_parameterFilter Mock ` -CommandName Write-Warning ` -ParameterFilter $script:writeWarningDescription_parameterFilter } It 'Should not throw an exception' { { New-DscResourcePowerShellHelp @script:newDscResourcePowerShellHelp_parameters } | Should -Not -Throw } It 'Should call the expected mocks ' { Assert-MockCalled ` -CommandName Get-ChildItem ` -ParameterFilter $script:getChildItemSchema_parameterFilter ` -Exactly -Times 1 Assert-MockCalled ` -CommandName Write-Warning ` -ParameterFilter $script:writeWarningDescription_parameterFilter ` -Exactly -Times 1 Assert-MockCalled ` -CommandName Out-File ` -ParameterFilter $script:outFile_parameterFilter ` -Exactly -Times 0 } } Context 'When there is no resource example file found' { BeforeAll { Mock ` -CommandName Get-ChildItem ` -ParameterFilter $script:getChildItemSchema_parameterFilter ` -MockWith { $script:mockSchemaFiles } Mock ` -CommandName Get-MofSchemaObject ` -ParameterFilter $script:getMofSchemaObjectSchema_parameterfilter ` -MockWith { $script:mockGetMofSchemaObject } Mock ` -CommandName Test-Path ` -ParameterFilter $script:getTestPathReadme_parameterFilter ` -MockWith { $true } Mock ` -CommandName Get-Content ` -ParameterFilter $script:getContentReadme_parameterFilter ` -MockWith { $script:mockGetContentReadme } Mock ` -CommandName Get-ChildItem ` -ParameterFilter $script:getChildItemExample_parameterFilter ` Mock ` -CommandName Get-DscResourceHelpExampleContent Mock ` -CommandName Out-File ` -ParameterFilter $script:outFile_parameterFilter Mock ` -CommandName Write-Warning ` -ParameterFilter $script:writeWarningExample_parameterFilter } It 'Should not throw an exception' { { New-DscResourcePowerShellHelp @script:newDscResourcePowerShellHelp_parameters } | Should -Not -Throw } It 'Should call the expected mocks ' { Assert-MockCalled ` -CommandName Get-ChildItem ` -ParameterFilter $script:getChildItemSchema_parameterFilter ` -Exactly -Times 1 Assert-MockCalled ` -CommandName Get-Content ` -ParameterFilter $script:getContentReadme_parameterFilter ` -Exactly -Times 1 Assert-MockCalled ` -CommandName Get-ChildItem ` -ParameterFilter $script:getChildItemExample_parameterFilter ` -Exactly -Times 1 Assert-MockCalled ` -CommandName Get-DscResourceHelpExampleContent ` -ParameterFilter $script:getDscResourceHelpExampleContent_parameterFilter ` -Exactly -Times 0 Assert-MockCalled ` -CommandName Out-File ` -ParameterFilter $script:outFile_parameterFilter ` -Exactly -Times 1 Assert-MockCalled ` -CommandName Write-Warning ` -ParameterFilter $script:writeWarningExample_parameterFilter ` -Exactly -Times 1 Assert-MockCalled ` -CommandName Write-Warning ` -ParameterFilter $script:writeWarningDescription_parameterFilter ` -Exactly -Times 0 } } Context 'When there is one schema found in the module folder and one example using .EXAMPLE and the OutputPath is specified' { BeforeAll { Mock ` -CommandName Get-ChildItem ` -ParameterFilter $script:getChildItemSchema_parameterFilter ` -MockWith { $script:mockSchemaFiles } Mock ` -CommandName Get-MofSchemaObject ` -ParameterFilter $script:getMofSchemaObjectSchema_parameterfilter ` -MockWith { $script:mockGetMofSchemaObject } Mock ` -CommandName Test-Path ` -ParameterFilter $script:getTestPathReadme_parameterFilter ` -MockWith { $true } Mock ` -CommandName Get-Content ` -ParameterFilter $script:getContentReadme_parameterFilter ` -MockWith { $script:mockGetContentReadme } Mock ` -CommandName Get-ChildItem ` -ParameterFilter $script:getChildItemExample_parameterFilter ` -MockWith { $script:mockExampleFiles } Mock ` -CommandName Get-DscResourceHelpExampleContent ` -ParameterFilter $script:getDscResourceHelpExampleContent_parameterFilter ` -MockWith { $script:mockExampleContent } Mock ` -CommandName Out-File Mock ` -CommandName Write-Warning ` -ParameterFilter $script:writeWarningExample_parameterFilter Mock ` -CommandName Write-Warning ` -ParameterFilter $script:writeWarningDescription_parameterFilter } It 'Should not throw an exception' { { New-DscResourcePowerShellHelp @script:newDscResourcePowerShellHelpOutput_parameters } | Should -Not -Throw } It 'Should produce the correct output' { Assert-MockCalled ` -CommandName Out-File ` -ParameterFilter $script:outFileOutputInputObject_parameterFilter ` -Exactly -Times 1 } It 'Should call the expected mocks ' { Assert-MockCalled ` -CommandName Get-ChildItem ` -ParameterFilter $script:getChildItemSchema_parameterFilter ` -Exactly -Times 1 Assert-MockCalled ` -CommandName Get-MofSchemaObject ` -ParameterFilter $script:getMofSchemaObjectSchema_parameterfilter ` -Exactly -Times 1 Assert-MockCalled ` -CommandName Test-Path ` -ParameterFilter $script:getTestPathReadme_parameterFilter ` -Exactly -Times 1 Assert-MockCalled ` -CommandName Get-Content ` -ParameterFilter $script:getContentReadme_parameterFilter ` -Exactly -Times 1 Assert-MockCalled ` -CommandName Get-ChildItem ` -ParameterFilter $script:getChildItemExample_parameterFilter ` -Exactly -Times 1 Assert-MockCalled ` -CommandName Get-DscResourceHelpExampleContent ` -ParameterFilter $script:getDscResourceHelpExampleContent_parameterFilter ` -Exactly -Times 1 Assert-MockCalled ` -CommandName Write-Warning ` -ParameterFilter $script:writeWarningExample_parameterFilter ` -Exactly -Times 0 Assert-MockCalled ` -CommandName Write-Warning ` -ParameterFilter $script:writeWarningDescription_parameterFilter ` -Exactly -Times 0 } } Context 'When there is one schema found in the module folder and one example using .EXAMPLE and the OutputPath is not specified' { BeforeAll { Mock ` -CommandName Get-ChildItem ` -ParameterFilter $script:getChildItemSchema_parameterFilter ` -MockWith { $script:mockSchemaFiles } Mock ` -CommandName Get-MofSchemaObject ` -ParameterFilter $script:getMofSchemaObjectSchema_parameterfilter ` -MockWith { $script:mockGetMofSchemaObject } Mock ` -CommandName Test-Path ` -ParameterFilter $script:getTestPathReadme_parameterFilter ` -MockWith { $true } Mock ` -CommandName Get-Content ` -ParameterFilter $script:getContentReadme_parameterFilter ` -MockWith { $script:mockGetContentReadme } Mock ` -CommandName Get-ChildItem ` -ParameterFilter $script:getChildItemExample_parameterFilter ` -MockWith { $script:mockExampleFiles } Mock ` -CommandName Get-DscResourceHelpExampleContent ` -ParameterFilter $script:getDscResourceHelpExampleContent_parameterFilter ` -MockWith { $script:mockExampleContent } Mock ` -CommandName Out-File Mock ` -CommandName Write-Warning ` -ParameterFilter $script:writeWarningExample_parameterFilter Mock ` -CommandName Write-Warning ` -ParameterFilter $script:writeWarningDescription_parameterFilter } It 'Should not throw an exception' { { New-DscResourcePowerShellHelp @script:newDscResourcePowerShellHelp_parameters } | Should -Not -Throw } It 'Should produce the correct output' { Assert-MockCalled ` -CommandName Out-File ` -ParameterFilter $script:outFileInputObject_parameterFilter ` -Exactly -Times 1 } It 'Should call the expected mocks ' { Assert-MockCalled ` -CommandName Get-ChildItem ` -ParameterFilter $script:getChildItemSchema_parameterFilter ` -Exactly -Times 1 Assert-MockCalled ` -CommandName Get-MofSchemaObject ` -ParameterFilter $script:getMofSchemaObjectSchema_parameterfilter ` -Exactly -Times 1 Assert-MockCalled ` -CommandName Test-Path ` -ParameterFilter $script:getTestPathReadme_parameterFilter ` -Exactly -Times 1 Assert-MockCalled ` -CommandName Get-Content ` -ParameterFilter $script:getContentReadme_parameterFilter ` -Exactly -Times 1 Assert-MockCalled ` -CommandName Get-ChildItem ` -ParameterFilter $script:getChildItemExample_parameterFilter ` -Exactly -Times 1 Assert-MockCalled ` -CommandName Get-DscResourceHelpExampleContent ` -ParameterFilter $script:getDscResourceHelpExampleContent_parameterFilter ` -Exactly -Times 1 Assert-MockCalled ` -CommandName Write-Warning ` -ParameterFilter $script:writeWarningExample_parameterFilter ` -Exactly -Times 0 Assert-MockCalled ` -CommandName Write-Warning ` -ParameterFilter $script:writeWarningDescription_parameterFilter ` -Exactly -Times 0 } } } Describe 'DscResource.DocumentationHelper\PowerShellHelp.psm1\Get-DscResourceHelpExampleContent' { # Parameter filters $script:getContentExample_parameterFilter = { $Path -eq $script:mockExampleFilePath } Context 'When a path to an example file with .EXAMPLE is passed and example number 1' { $script:getDscResourceHelpExampleContent_parameters = @{ ExamplePath = $script:mockExampleFilePath ExampleNumber = 1 Verbose = $true } $script:mockExampleContent = '.EXAMPLE 1 Example Description. Configuration Example { Import-DSCResource -ModuleName MyModule Node localhost { MyResource Something { Id = ''MyId'' Enum = ''Value1'' Int = 1 } } } ' $script:mockGetContentExample = '<# .EXAMPLE Example Description. #> Configuration Example { Import-DSCResource -ModuleName MyModule Node localhost { MyResource Something { Id = ''MyId'' Enum = ''Value1'' Int = 1 } } }' -split "`r`n" BeforeAll { Mock ` -CommandName Get-Content ` -ParameterFilter $script:getContentExample_parameterFilter ` -MockWith { $script:mockGetContentExample } } It 'Should not throw an exception' { { $script:result = Get-DscResourceHelpExampleContent @script:getDscResourceHelpExampleContent_parameters } | Should -Not -Throw } It 'Should return the expected string' { $script:result | Should -BeExactly $script:mockExampleContent } It 'Should call the expected mocks ' { Assert-MockCalled ` -CommandName Get-Content ` -ParameterFilter $script:getContentExample_parameterFilter ` -Exactly -Times 1 } } Context 'When a path to an example file with .DESCRIPTION is passed and example number 2' { $script:getDscResourceHelpExampleContent_parameters = @{ ExamplePath = $script:mockExampleFilePath ExampleNumber = 2 Verbose = $true } $script:mockExampleContent = '.EXAMPLE 2 Example Description. Configuration Example { Import-DSCResource -ModuleName MyModule Node localhost { MyResource Something { Id = ''MyId'' Enum = ''Value1'' Int = 1 } } } ' $script:mockGetContentExample = '<# .DESCRIPTION Example Description. #> Configuration Example { Import-DSCResource -ModuleName MyModule Node localhost { MyResource Something { Id = ''MyId'' Enum = ''Value1'' Int = 1 } } }' -split "`r`n" BeforeAll { Mock ` -CommandName Get-Content ` -ParameterFilter $script:getContentExample_parameterFilter ` -MockWith { $script:mockGetContentExample } } It 'Should not throw an exception' { { $script:result = Get-DscResourceHelpExampleContent @script:getDscResourceHelpExampleContent_parameters } | Should -Not -Throw } It 'Should return the expected string' { $script:result | Should -BeExactly $script:mockExampleContent } It 'Should call the expected mocks ' { Assert-MockCalled ` -CommandName Get-Content ` -ParameterFilter $script:getContentExample_parameterFilter ` -Exactly -Times 1 } } Context 'When a path to an example file with .SYNOPSIS is passed and example number 3' { $script:getDscResourceHelpExampleContent_parameters = @{ ExamplePath = $script:mockExampleFilePath ExampleNumber = 3 Verbose = $true } $script:mockExampleContent = '.EXAMPLE 3 Example Description. Configuration Example { Import-DSCResource -ModuleName MyModule Node localhost { MyResource Something { Id = ''MyId'' Enum = ''Value1'' Int = 1 } } } ' $script:mockGetContentExample = '<# .SYNOPSIS Example Description. #> Configuration Example { Import-DSCResource -ModuleName MyModule Node localhost { MyResource Something { Id = ''MyId'' Enum = ''Value1'' Int = 1 } } }' -split "`r`n" BeforeAll { Mock ` -CommandName Get-Content ` -ParameterFilter $script:getContentExample_parameterFilter ` -MockWith { $script:mockGetContentExample } } It 'Should not throw an exception' { { $script:result = Get-DscResourceHelpExampleContent @script:getDscResourceHelpExampleContent_parameters } | Should -Not -Throw } It 'Should return the expected string' { $script:result | Should -BeExactly $script:mockExampleContent } It 'Should call the expected mocks ' { Assert-MockCalled ` -CommandName Get-Content ` -ParameterFilter $script:getContentExample_parameterFilter ` -Exactly -Times 1 } } Context 'When a path to an example file with .SYNOPSIS and #Requires is passed and example number 4' { $script:getDscResourceHelpExampleContent_parameters = @{ ExamplePath = $script:mockExampleFilePath ExampleNumber = 4 Verbose = $true } $script:mockExampleContent = '.EXAMPLE 4 Example Description. Configuration Example { Import-DSCResource -ModuleName MyModule Node localhost { MyResource Something { Id = ''MyId'' Enum = ''Value1'' Int = 1 } } } ' $script:mockGetContentExample = '#Requires -module MyModule #Requires -module OtherModule <# .SYNOPSIS Example Description. #> Configuration Example { Import-DSCResource -ModuleName MyModule Node localhost { MyResource Something { Id = ''MyId'' Enum = ''Value1'' Int = 1 } } }' -split "`r`n" BeforeAll { Mock ` -CommandName Get-Content ` -ParameterFilter $script:getContentExample_parameterFilter ` -MockWith { $script:mockGetContentExample } } It 'Should not throw an exception' { { $script:result = Get-DscResourceHelpExampleContent @script:getDscResourceHelpExampleContent_parameters } | Should -Not -Throw } It 'Should return the expected string' { $script:result | Should -BeExactly $script:mockExampleContent } It 'Should call the expected mocks ' { Assert-MockCalled ` -CommandName Get-Content ` -ParameterFilter $script:getContentExample_parameterFilter ` -Exactly -Times 1 } } Context 'When a path to an example file with .DESCRIPTION, #Requires and PSScriptInfo is passed and example number 5' { $script:getDscResourceHelpExampleContent_parameters = @{ ExamplePath = $script:mockExampleFilePath ExampleNumber = 5 Verbose = $true } $script:mockExampleContent = '.EXAMPLE 5 Example Description. Configuration Example { Import-DSCResource -ModuleName MyModule Node localhost { MyResource Something { Id = ''MyId'' Enum = ''Value1'' Int = 1 } } } ' $script:mockGetContentExample = '<#PSScriptInfo .VERSION 1.0.0 .GUID 14b1346a-436a-4f64-af5c-b85119b819b3 .AUTHOR Microsoft Corporation .COMPANYNAME Microsoft Corporation .COPYRIGHT .TAGS DSCConfiguration .LICENSEURI https://github.com/PowerShell/CertificateDsc/blob/master/LICENSE .PROJECTURI https://github.com/PowerShell/CertificateDsc .ICONURI .EXTERNALMODULEDEPENDENCIES .REQUIREDSCRIPTS .EXTERNALSCRIPTDEPENDENCIES .RELEASENOTES First version. .PRIVATEDATA 2016-Datacenter,2016-Datacenter-Server-Core #> #Requires -module MyModule #Requires -module OtherModule <# .DESCRIPTION Example Description. #> Configuration Example { Import-DSCResource -ModuleName MyModule Node localhost { MyResource Something { Id = ''MyId'' Enum = ''Value1'' Int = 1 } } }' -split "`r`n" BeforeAll { Mock ` -CommandName Get-Content ` -ParameterFilter $script:getContentExample_parameterFilter ` -MockWith { $script:mockGetContentExample } } It 'Should not throw an exception' { { $script:result = Get-DscResourceHelpExampleContent @script:getDscResourceHelpExampleContent_parameters } | Should -Not -Throw } It 'Should return the expected string' { $script:result | Should -BeExactly $script:mockExampleContent } It 'Should call the expected mocks ' { Assert-MockCalled ` -CommandName Get-Content ` -ParameterFilter $script:getContentExample_parameterFilter ` -Exactly -Times 1 } } Context 'When a path to an example file with .SYNOPSIS, .DESCRIPTION and PSScriptInfo is passed and example number 6' { $script:getDscResourceHelpExampleContent_parameters = @{ ExamplePath = $script:mockExampleFilePath ExampleNumber = 6 Verbose = $true } $script:mockExampleContent = '.EXAMPLE 6 Example Synopsis. Example Description. Configuration Example { Import-DSCResource -ModuleName MyModule Node localhost { MyResource Something { Id = ''MyId'' Enum = ''Value1'' Int = 1 } } } ' $script:mockGetContentExample = '<#PSScriptInfo .VERSION 1.0.0 .GUID 14b1346a-436a-4f64-af5c-b85119b819b3 .AUTHOR Microsoft Corporation .COMPANYNAME Microsoft Corporation .COPYRIGHT .TAGS DSCConfiguration .LICENSEURI https://github.com/PowerShell/CertificateDsc/blob/master/LICENSE .PROJECTURI https://github.com/PowerShell/CertificateDsc .ICONURI .EXTERNALMODULEDEPENDENCIES .REQUIREDSCRIPTS .EXTERNALSCRIPTDEPENDENCIES .RELEASENOTES First version. .PRIVATEDATA 2016-Datacenter,2016-Datacenter-Server-Core #> <# .SYNOPSIS Example Synopsis. .DESCRIPTION Example Description. #> Configuration Example { Import-DSCResource -ModuleName MyModule Node localhost { MyResource Something { Id = ''MyId'' Enum = ''Value1'' Int = 1 } } }' -split "`r`n" BeforeAll { Mock ` -CommandName Get-Content ` -ParameterFilter $script:getContentExample_parameterFilter ` -MockWith { $script:mockGetContentExample } } It 'Should not throw an exception' { { $script:result = Get-DscResourceHelpExampleContent @script:getDscResourceHelpExampleContent_parameters } | Should -Not -Throw } It 'Should return the expected string' { $script:result | Should -BeExactly $script:mockExampleContent } It 'Should call the expected mocks ' { Assert-MockCalled ` -CommandName Get-Content ` -ParameterFilter $script:getContentExample_parameterFilter ` -Exactly -Times 1 } } Context 'When a path to an example file from SharePointDsc resource module and example number 7' { $script:getDscResourceHelpExampleContent_parameters = @{ ExamplePath = $script:mockExampleFilePath ExampleNumber = 7 Verbose = $true } $script:mockExampleContent = '.EXAMPLE 7 This example shows how to deploy Access Services 2013 to the local SharePoint farm. Configuration Example { param( [Parameter(Mandatory = $true)] [PSCredential] $SetupAccount ) Import-DscResource -ModuleName SharePointDsc node localhost { SPAccessServiceApp AccessServices { Name = "Access Services Service Application" ApplicationPool = "SharePoint Service Applications" DatabaseServer = "SQL.contoso.local\SQLINSTANCE" PsDscRunAsCredential = $SetupAccount } } } ' $script:mockGetContentExample = '<# .EXAMPLE This example shows how to deploy Access Services 2013 to the local SharePoint farm. #> Configuration Example { param( [Parameter(Mandatory = $true)] [PSCredential] $SetupAccount ) Import-DscResource -ModuleName SharePointDsc node localhost { SPAccessServiceApp AccessServices { Name = "Access Services Service Application" ApplicationPool = "SharePoint Service Applications" DatabaseServer = "SQL.contoso.local\SQLINSTANCE" PsDscRunAsCredential = $SetupAccount } } }' -split "`r`n" BeforeAll { Mock ` -CommandName Get-Content ` -ParameterFilter $script:getContentExample_parameterFilter ` -MockWith { $script:mockGetContentExample } } It 'Should not throw an exception' { { $script:result = Get-DscResourceHelpExampleContent @script:getDscResourceHelpExampleContent_parameters } | Should -Not -Throw } It 'Should return the expected string' { $script:result | Should -BeExactly $script:mockExampleContent } It 'Should call the expected mocks ' { Assert-MockCalled ` -CommandName Get-Content ` -ParameterFilter $script:getContentExample_parameterFilter ` -Exactly -Times 1 } } } Context 'When a path to an example file from CertificateDsc resource module and example number 8' { $script:getDscResourceHelpExampleContent_parameters = @{ ExamplePath = $script:mockExampleFilePath ExampleNumber = 8 Verbose = $true } $script:mockExampleContent = '.EXAMPLE 8 Exports a certificate as a CERT using the friendly name to identify it. Configuration CertificateExport_CertByFriendlyName_Config { Import-DscResource -ModuleName CertificateDsc Node localhost { CertificateExport SSLCert { Type = ''CERT'' FriendlyName = ''Web Site SSL Certificate for www.contoso.com'' Path = ''c:\sslcert.cer'' } } } ' $script:mockGetContentExample = '<#PSScriptInfo .VERSION 1.0.0 .GUID 14b1346a-436a-4f64-af5c-b85119b819b3 .AUTHOR Microsoft Corporation .COMPANYNAME Microsoft Corporation .COPYRIGHT .TAGS DSCConfiguration .LICENSEURI https://github.com/PowerShell/CertificateDsc/blob/master/LICENSE .PROJECTURI https://github.com/PowerShell/CertificateDsc .ICONURI .EXTERNALMODULEDEPENDENCIES .REQUIREDSCRIPTS .EXTERNALSCRIPTDEPENDENCIES .RELEASENOTES First version. .PRIVATEDATA 2016-Datacenter,2016-Datacenter-Server-Core #> #Requires -module CertificateDsc <# .DESCRIPTION Exports a certificate as a CERT using the friendly name to identify it. #> Configuration CertificateExport_CertByFriendlyName_Config { Import-DscResource -ModuleName CertificateDsc Node localhost { CertificateExport SSLCert { Type = ''CERT'' FriendlyName = ''Web Site SSL Certificate for www.contoso.com'' Path = ''c:\sslcert.cer'' } } }' -split "`r`n" BeforeAll { Mock ` -CommandName Get-Content ` -ParameterFilter $script:getContentExample_parameterFilter ` -MockWith { $script:mockGetContentExample } } It 'Should not throw an exception' { { $script:result = Get-DscResourceHelpExampleContent @script:getDscResourceHelpExampleContent_parameters } | Should -Not -Throw } It 'Should return the expected string' { $script:result | Should -BeExactly $script:mockExampleContent } It 'Should call the expected mocks ' { Assert-MockCalled ` -CommandName Get-Content ` -ParameterFilter $script:getContentExample_parameterFilter ` -Exactly -Times 1 } } } |