Build/Github/Actions/PipeScriptAction.ps1
|
<# .Synopsis GitHub Action for PipeScript .Description GitHub Action for PipeScript. This will: * Import PipeScript * Run all *.PipeScript.ps1 files beneath the workflow directory * Run a .PipeScriptScript parameter Any files changed can be outputted by the script, and those changes can be checked back into the repo. Make sure to use the "persistCredentials" option with checkout. #> param( # A PowerShell Script that uses PipeScript. # Any files outputted from the script will be added to the repository. # If those files have a .Message attached to them, they will be committed with that message. [string] $Script, # If set, will not run Build-PipeScript. [switch] $SkipBuild, # If provided, will commit any remaining changes made to the workspace with this commit message. # If no commit message is provided, if a GitHub Event contains a commit message, that message will be used. # If no commit message is provided, and a commit message cannot be automatically detected, changes will not be committed. [string] $CommitMessage, # A list of modules to be installed from the PowerShell gallery before scripts run. # Note: If ugit is not installed, commit messages will not be carried properly with multiple commits. [string[]] $InstallModule = 'ugit', # If set, will build files one-by-one, instead of in parallel. This is currently the default. [switch] $Serial, # If set, will build files in parallel. [switch] $Parallel, # The number of files to build in each batch. [int] $BatchSize = 11, # The throttle limit for parallel jobs. # If too many jobs are running at once, errors may occur. [int] $ThrottleLimit = 7, # The user email associated with a git commit. [string] $UserEmail, # The user name associated with a git commit. [string] $UserName ) "::group::Parameters" | Out-Host [PSCustomObject]$PSBoundParameters | Format-List | Out-Host "::endgroup::" | Out-Host $gitHubEvent = if ($env:GITHUB_EVENT_PATH) { [IO.File]::ReadAllText($env:GITHUB_EVENT_PATH) | ConvertFrom-Json } else { $null } @" ::group::GitHubEvent $($gitHubEvent | ConvertTo-Json -Depth 100) ::endgroup:: "@ | Out-Host # Set -ErrorActionPreference to continue. $global:ErrorActionPreference = 'continue' #region -InstallModule if ($InstallModule) { "::group::Installing Modules" | Out-Host foreach ($moduleToInstall in $InstallModule) { $moduleInWorkspace = Get-ChildItem -Path $env:GITHUB_WORKSPACE -Recurse -File | Where-Object Name -eq "$($moduleToInstall).psd1" | Where-Object { $(Get-Content $_.FullName -Raw) -match 'ModuleVersion' } if (-not $moduleInWorkspace) { Install-Module $moduleToInstall -Scope CurrentUser -Force -AllowClobber Import-Module $moduleToInstall -Force -PassThru | Out-Host } } "::endgroup::" | Out-Host } #endregion -InstallModule $PSD1Found = Get-ChildItem -Recurse -Filter "*.psd1" | Where-Object Name -eq 'PipeScript.psd1' | Select-Object -First 1 if ($PSD1Found) { $PipeScriptModulePath = $PSD1Found Import-Module $PSD1Found -Force -PassThru | Out-Host } elseif ($env:GITHUB_ACTION_PATH) { $PipeScriptModulePath = Join-Path $env:GITHUB_ACTION_PATH 'PipeScript.psd1' if (Test-path $PipeScriptModulePath) { Import-Module $PipeScriptModulePath -Force -PassThru | Out-Host } else { throw "PipeScript not found" } } elseif (-not (Get-Module PipeScript)) { throw "Action Path not found" } "::notice title=ModuleLoaded::PipeScript Loaded from Path - $($PipeScriptModulePath)" | Out-Host $anyFilesChanged = $false $processScriptOutput = { process { $out = $_ $outItem = Get-Item -Path $out -ErrorAction SilentlyContinue $fullName, $shouldCommit = if ($out -is [IO.FileInfo]) { $out.FullName, (git status $out.Fullname -s) } elseif ($outItem) { $outItem.FullName, (git status $outItem.Fullname -s) } if ($shouldCommit) { git add $fullName if ($out.Message) { git commit -m "$($out.Message)" } elseif ($out.CommitMessage) { git commit -m "$($out.CommitMessage)" } elseif ($CommitMessage) { git commit -m $CommitMessage } elseif ($gitHubEvent.head_commit.message) { git commit -m "$($gitHubEvent.head_commit.message)" } $anyFilesChanged = $true } $out } } if (-not $UserName) { $UserName = $env:GITHUB_ACTOR } if (-not $UserEmail) { $UserEmail = if ($GitHubUserEmail) { $GitHubUserEmail } else { "$UserName@github.com" } } git config --global user.email $UserEmail git config --global user.name $UserName if (-not $env:GITHUB_WORKSPACE) { throw "No GitHub workspace" } $branchName = git rev-parse --abrev-ref HEAD if (-not $branchName) { return } try { $unshallowResults = git fetch --unshallow } catch { $_ | Out-Host } if (-not $Parallel) { $serial= $true} $PipeScriptStart = [DateTime]::Now if ($Script) { Invoke-PipeScript -Command $Script | . $processScriptOutput | Out-Host } $PipeScriptTook = [Datetime]::Now - $PipeScriptStart "::notice:: .PipeScript ran in $($PipeScriptTook.TotalMilliseconds) ms" | Out-Host "::notice:: Building Files in '$env:GITHUB_WORKSPACE'" | Out-Host $BuildPipeScriptStart = [DateTime]::Now $pipeScriptBuildErrors = $null if (-not $SkipBuild) { $buildOutputFiles = @(Build-Pipescript -Serial:$Serial -BatchSize:$BatchSize -ThrottleLimit:$ThrottleLimit -InputPath $env:GITHUB_WORKSPACE -ErrorVariable pipeScriptBuildErrors) if ($buildOutputFiles) { "::notice:: $($buildOutputFiles.Length) files outputted" | Out-Host "$($buildOutputFiles.FullName -join [Environment]::newLine)" | Out-Host $buildOutputFiles | . $processScriptOutput | Out-Host } } if ($pipeScriptBuildErrors) { "There were build errors" | Out-Host "::error::$($pipeScriptBuildErrors | Out-String)" | Out-Host $pipeScriptBuildErrors exit 1 } $BuildPipeScriptEnd = [DateTime]::Now $BuildPipeScriptTook = $BuildPipeScriptEnd - $BuildPipeScriptStart [long]$TotalFileLength = 0 $buildFilePaths = @( foreach ($buildOutputFile in $buildOutputFiles) { if ($buildOutputFile.FullName) { $buildOutputFile.FullName if ($buildOutputFile.Length) { $TotalFileLength+=$buildOutputFile.Length } } } ) "::notice:: $($buildOutputFiles.Length) files built ( $([Math]::Round($TotalFileLength/1kb, 2))kb ) in $($BuildPipeScriptTook.TotalSeconds) seconds" | Out-Host "::group:: Output Files" | Out-Host $buildFilePaths -join [Environment]::newLine | Out-Host "::endgroup::" | Out-Host if ($CommitMessage -or $anyFilesChanged) { if ($CommitMessage) { Get-ChildItem $env:GITHUB_WORKSPACE -Recurse | ForEach-Object { $gitStatusOutput = git status $_.Fullname -s if ($gitStatusOutput) { git add $_.Fullname } } git commit -m $ExecutionContext.SessionState.InvokeCommand.ExpandString($CommitMessage) } $checkDetached = git symbolic-ref -q HEAD if (-not $LASTEXITCODE) { "::notice::Pulling Changes" | Out-Host git pull | Out-Host "::notice::Pushing Changes" | Out-Host git push | Out-Host "Git Push Output: $($gitPushed | Out-String)" } else { "::notice::Not pushing changes (on detached head)" | Out-Host $LASTEXITCODE = 0 exit 0 } } |