build.ps1

# **************************************************************************
#  Copyright (c) Cloud Native Foundation.
#  SPDX-License-Identifier: Apache-2.0
# **************************************************************************

<#
   .SYNOPSIS
   Builds and tests the CloudEvents.Sdk module


   .DESCRIPTION
   The script is the entry point to build and test the CloudEvents.Sdk module.

   .PARAMETER OutputDir
   Target directory where the CloudEvents.Sdk will be created by the script. The default is the PS Script Root

   .PARAMETER TestsType
   Specifies the type of the test to be run post build. Possible values are 'none','unit', 'integration', 'all'.
   The default is 'all'

   .PARAMETER ExitProcess
   Specifies whther to exit the running process. Exits with exit code equal to the number of failing tests.

#>

param(
   [Parameter()]
   [string]
   $OutputDir,

   [Parameter()]
   [ValidateSet('none','unit', 'integration', 'all')]
   [string]
   $TestsType = 'all',

   [Parameter()]
   [switch]
   $ExitProcess
)

$moduleName = 'CloudEvents.Sdk'

#region Input
if (-not $OutputDir) {
    $OutputDir = $PSScriptRoot
}

# Create Output Dir if it doesn't exist
if (-not (Test-Path $OutputDir)) {
    New-Item -ItemType Directory -Path $OutputDir -Force -Confirm:$false | Out-Null
    # Get the full path
    $OutputDir = (Resolve-Path $OutputDir).Path
}

$OutputDir = Join-Path $OutputDir $moduleName

if (-not (Test-Path $OutputDir)) {
   New-Item -ItemType Directory -Path $OutputDir | Out-Null
}
#endregion

#region Helper Funcitons
function Write-InfoLog($message) {
   $dt = (Get-Date).ToLongTimeString()
   Write-Host "[$dt] INFO: $message" -ForegroundColor Green
}

function Write-ErrorLog($message) {
   $dt = (Get-Date).ToLongTimeString()
   Write-Host "[$dt] ERROR: $message" -ForegroundColor Red
}

function Test-BuildToolsAreAvailable {
   $dotnetSdk = Get-Command 'dotnet'
   if (-not $dotnetSdk) {
     throw "'dotnet' sdk is not available"
   }
}

function Start-Tests {
param(
   [Parameter()]
   [ValidateSet('unit', 'integration')]
   [string]
   $TestsType
)
   $pesterModule = Get-Module Pester -List
   if ($pesterModule -eq $null) {
      Write-ErrorLog "Pester Module is not available"
   } else {
      # Run Tests in external process because it will load build output binaries
      Write-InfoLog "Run $TestsType tests"
      $usePowerShell = (Get-Process -Id $pid).ProcessName

      $testLauncherScript = Join-Path (Join-Path $PSScriptRoot 'test') 'RunTests.ps1'
      $CloudEventsModulePath = Join-Path $OutputDir "$moduleName.psd1"
      $testProcessArguments = "-Command $testLauncherScript -CloudEventsModulePath '$CloudEventsModulePath' -TestsType '$TestsType' -EnableProcessExit"

      # Process Exit Code is 0 if all tests pass, otherwise it equals the number of failed tests
      $testProcess = Start-Process `
         -FilePath $usePowerShell `
         -ArgumentList $testProcessArguments `
         -PassThru `
         -NoNewWindow

      $testProcess | Wait-Process | Out-Null

      # Return the number of failed tests
      $testProcess.ExitCode
   }
}
#endregion

$dotnetProjectName = 'CloudEventsPowerShell'
$dotnetProjectPath = Join-Path (Join-Path (Join-Path $PSScriptRoot 'src') $dotnetProjectName) "$dotnetProjectName.csproj"

# 1. Test dotnet command is available
Test-BuildToolsAreAvailable

# 2. Publish CloudEvents Module
Write-InfoLog "Publish CloudEvents.Sdk Module to '$OutputDir'"
dotnet publish -c Release -o $OutputDir $dotnetProjectPath | Out-Null

# 3. Cleanup Unnecessary Outputs
Get-ChildItem "$dotnetProjectName*" -Path $OutputDir  | Remove-Item -Confirm:$false

$failedTests = 0
# 4. Run Unit Tests
if ($TestsType -eq 'unit' -or $TestsType -eq 'all') {
   $failedTests += (Start-Tests -TestsType 'unit')
}

# 5. Run Integration Tests
if ($TestsType -eq 'integration' -or $TestsType -eq 'all') {
   $failedTests += (Start-Tests -TestsType 'integration')
}

# 6. Set exit code
if ($ExitProcess.IsPresent) {
    exit $failedTests
} else {
    $failedTests
}