Merge pull request #89 from PowerShellWeb/PSJekyll-Init

PSJekyll 0.1

Author: StartAutomating

.github/FUNDING.yml

@@ -0,0 +1 @@
+github: [StartAutomating]

.github/workflows/BuildPSJekyll.yml

@@ -0,0 +1,291 @@
+<#
+.Synopsis
+    GitHub Action for PSJekyll
+.Description
+    GitHub Action for PSJekyll.  This will:
+
+    * Import PSJekyll
+    * Run all *.PSJekyll.ps1 files beneath the workflow directory
+    * Run a .PSJekyllScript parameter.
+
+    If you will be making changes using the GitHubAPI, you should provide a -GitHubToken
+    If none is provided, and ENV:GITHUB_TOKEN is set, this will be used instead.
+    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 PSJekyll.  
+# 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]
+$PSJekyllScript,
+
+# If set, will not process any files named *.PSJekyll.ps1
+[switch]
+$SkipPSJekyllPS1,
+
+# A list of modules to be installed from the PowerShell gallery before scripts run.
+[string[]]
+$InstallModule,
+
+# If provided, will checkout a new branch before making the changes.
+[string]
+$TargetBranch,
+
+# If provided, will commit any remaining changes made to the workspace with this commit message.
+[string]
+$CommitMessage,
+
+# The user email associated with a git commit.  If this is not provided, it will be set to the username@noreply.github.com.
+[string]
+$UserEmail,
+
+# The user name associated with a git commit.
+[string]
+$UserName
+)
+
+$ErrorActionPreference = 'continue'
+$error.Clear()
+"::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 }
+
+$anyFilesChanged = $false
+$moduleName = 'PSJekyll'
+$actorInfo = $null
+
+"::group::Parameters" | Out-Host
+[PSCustomObject]$PSBoundParameters | Format-List | Out-Host
+"::endgroup::" | Out-Host
+
+function InstallActionModule {
+    param([string]$ModuleToInstall)
+    $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
+        Import-Module $moduleToInstall -Force -PassThru | Out-Host
+    }
+}
+function ImportActionModule {
+    #region -InstallModule
+    if ($InstallModule) {
+        "::group::Installing Modules" | Out-Host
+        foreach ($moduleToInstall in $InstallModule) {
+            InstallActionModule -ModuleToInstall $moduleToInstall
+        }
+        "::endgroup::" | Out-Host
+    }
+    #endregion -InstallModule
+
+    if ($env:GITHUB_ACTION_PATH) {
+        $LocalModulePath = Join-Path $env:GITHUB_ACTION_PATH "$moduleName.psd1"        
+        if (Test-path $LocalModulePath) {
+            Import-Module $LocalModulePath -Force -PassThru | Out-String
+        } else {
+            throw "Module '$moduleName' not found"
+        }
+    } elseif (-not (Get-Module $moduleName)) {    
+        throw "Module '$ModuleName' not found"
+    }
+
+    "::notice title=ModuleLoaded::$ModuleName Loaded from Path - $($LocalModulePath)" | Out-Host
+    if ($env:GITHUB_STEP_SUMMARY) {
+        "# $($moduleName)" |
+            Out-File -Append -FilePath $env:GITHUB_STEP_SUMMARY
+    }
+}
+function InitializeAction {
+    #region Custom 
+    #endregion Custom
+
+    # Configure git based on the $env:GITHUB_ACTOR
+    if (-not $UserName) { $UserName = $env:GITHUB_ACTOR }
+    if (-not $actorID)  { $actorID = $env:GITHUB_ACTOR_ID }    
+    if (-not $UserEmail) { $UserEmail = "$UserName@noreply.github.com" }
+    git config --global user.email $UserEmail
+    git config --global user.name  $env:GITHUB_ACTOR
+
+    # Pull down any changes
+    git pull | Out-Host
+
+    if ($TargetBranch) {
+        "::notice title=Expanding target branch string $targetBranch" | Out-Host
+        $TargetBranch = $ExecutionContext.SessionState.InvokeCommand.ExpandString($TargetBranch)
+        "::notice title=Checking out target branch::$targetBranch" | Out-Host
+        git checkout -b $TargetBranch | Out-Host    
+        git pull | Out-Host
+    }
+}
+
+function InvokeActionModule {
+    $myScriptStart = [DateTime]::Now
+    $myScript = $ExecutionContext.SessionState.PSVariable.Get("${ModuleName}Script").Value
+    if ($myScript) {
+        Invoke-Expression -Command $myScript |
+            . ProcessOutput |
+            Out-Host
+    }
+    $myScriptTook = [Datetime]::Now - $myScriptStart
+    $MyScriptFilesStart = [DateTime]::Now
+
+    $myScriptList  = @()
+    $shouldSkip = $ExecutionContext.SessionState.PSVariable.Get("Skip${ModuleName}PS1").Value
+    if (-not $shouldSkip) {
+        Get-ChildItem -Recurse -Path $env:GITHUB_WORKSPACE |
+            Where-Object Name -Match "\.$($moduleName)\.ps1$" |            
+            ForEach-Object -Begin {
+                if ($env:GITHUB_STEP_SUMMARY) {
+                    "## $ModuleName Scripts" |
+                        Out-File -Append -FilePath $env:GITHUB_STEP_SUMMARY
+                } 
+            } -Process {
+                $myScriptList += $_.FullName.Replace($env:GITHUB_WORKSPACE, '').TrimStart('/')
+                $myScriptCount++
+                $scriptFile = $_
+                if ($env:GITHUB_STEP_SUMMARY) {
+                    "### $($scriptFile.Fullname -replace [Regex]::Escape($env:GITHUB_WORKSPACE))" |
+                        Out-File -Append -FilePath $env:GITHUB_STEP_SUMMARY
+                }
+                $scriptCmd = $ExecutionContext.SessionState.InvokeCommand.GetCommand($scriptFile.FullName, 'ExternalScript')                
+                foreach ($requiredModule in $CommandInfo.ScriptBlock.Ast.ScriptRequirements.RequiredModules) {
+                    if ($requiredModule.Name -and 
+                        (-not $requiredModule.MaximumVersion) -and
+                        (-not $requiredModule.RequiredVersion)
+                    ) {
+                        InstallActionModule $requiredModule.Name
+                    }
+                }
+                $scriptFileOutputs = . $scriptCmd                
+                $scriptFileOutputs |
+                    . ProcessOutput  | 
+                    Out-Host
+            }
+    }
+    
+    $MyScriptFilesTook = [Datetime]::Now - $MyScriptFilesStart
+    $SummaryOfMyScripts = "$myScriptCount $moduleName scripts took $($MyScriptFilesTook.TotalSeconds) seconds" 
+    $SummaryOfMyScripts | 
+        Out-Host
+    if ($env:GITHUB_STEP_SUMMARY) {
+        $SummaryOfMyScripts | 
+            Out-File -Append -FilePath $env:GITHUB_STEP_SUMMARY
+    }
+    #region Custom
+    #endregion Custom
+}
+
+function OutError {
+    $anyRuntimeExceptions = $false
+    foreach ($err in $error) {        
+        $errParts = @(
+            "::error "
+            @(
+                if ($err.InvocationInfo.ScriptName) {
+                "file=$($err.InvocationInfo.ScriptName)"
+            }
+            if ($err.InvocationInfo.ScriptLineNumber -ge 1) {
+                "line=$($err.InvocationInfo.ScriptLineNumber)"
+                if ($err.InvocationInfo.OffsetInLine -ge 1) {
+                    "col=$($err.InvocationInfo.OffsetInLine)"
+                }
+            }
+            if ($err.CategoryInfo.Activity) {
+                "title=$($err.CategoryInfo.Activity)"
+            }
+            ) -join ','
+            "::"
+            $err.Exception.Message
+            if ($err.CategoryInfo.Category -eq 'OperationStopped' -and 
+                $err.CategoryInfo.Reason -eq 'RuntimeException') {
+                $anyRuntimeExceptions = $true
+            }
+        ) -join ''
+        $errParts | Out-Host
+        if ($anyRuntimeExceptions) {
+            exit 1
+        }
+    }
+}
+
+function PushActionOutput {
+    if ($anyFilesChanged) {
+        "::notice::$($anyFilesChanged) Files Changed" | 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::Pushing Changes" | Out-Host
+            if ($TargetBranch -and $anyFilesChanged) {
+                git push --set-upstream origin $TargetBranch
+            } elseif ($anyFilesChanged) {
+                git push
+            }
+            "Git Push Output: $($gitPushed  | Out-String)"
+        } else {
+            "::notice::Not pushing changes (on detached head)" | Out-Host
+            $LASTEXITCODE = 0
+            exit 0
+        }
+    }
+}
+
+filter ProcessOutput {
+    $out = $_
+    $outItem = Get-Item -Path $out -ErrorAction Ignore
+    if (-not $outItem -and $out -is [string]) {
+        $out | Out-Host
+        if ($env:GITHUB_STEP_SUMMARY) {
+            "> $out" | Out-File -Append -FilePath $env:GITHUB_STEP_SUMMARY
+        }
+        return
+    }
+    $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) {
+        "$fullName has changed, and should be committed" | Out-Host
+        git add $fullName
+        if ($out.Message) {
+            git commit -m "$($out.Message)" | Out-Host
+        } elseif ($out.CommitMessage) {
+            git commit -m "$($out.CommitMessage)" | Out-Host
+        }  elseif ($gitHubEvent.head_commit.message) {
+            git commit -m "$($gitHubEvent.head_commit.message)" | Out-Host
+        }
+        $anyFilesChanged = $true
+    }    
+    $out
+}
+
+. ImportActionModule
+. InitializeAction
+. InvokeActionModule
+. PushActionOutput
+. OutError

Assets/PSJekyll-Animated.svg

@@ -0,0 +1,34 @@
+@{
+    "runs-on" = "ubuntu-latest"    
+    if = '${{ success() }}'
+    steps = @(
+        @{
+            name = 'Check out repository'
+            uses = 'actions/checkout@v2'
+        },
+        @{
+            name = 'GitLogger'
+            uses = 'GitLogging/GitLoggerAction@main'
+            id = 'GitLogger'
+        },
+        @{
+            name = 'Use PSSVG Action'
+            uses = 'StartAutomating/PSSVG@main'
+            id = 'PSSVG'
+        },
+        @{
+            name = 'Use PipeScript Action'
+            uses = 'StartAutomating/PipeScript@main'
+            id = 'PipeScript'
+        },        
+        'RunEZOut',
+        'RunHelpOut',
+        @{
+            name = 'Run PSJekyll (on branch)'
+            if   = '${{github.ref_name != ''main''}}'
+            uses = './'
+            id = 'PSJekyllBranch'
+        },
+        'BuildAndPublishContainer'
+    )
+}