action.yml

name: UseIrregular
description: Regular Expressions Made Strangle Simple
inputs: 
  IrregularScript: 
    required: false
    description: |
      A PowerShell Script that uses Irregular.  
      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.
  SkipIrregularPS1: 
    required: false
    description: 'If set, will not process any files named *.irregular.ps1'
  SkipRegexSource: 
    required: false
    description: 'If set, will not process any files named *.regex.source.ps1'
  CommitMessage: 
    required: false
    description: If provided, will commit any remaining changes made to the workspace with this commit message.
  UserEmail: 
    required: false
    description: The user email associated with a git commit.
  UserName: 
    required: false
    description: The user name associated with a git commit.
branding: 
  icon: cpu
  color: blue
runs: 
  using: composite
  steps: 
    - name: Irregular
      id: Irregular
      shell: pwsh
      env: 
        IrregularScript: ${{inputs.IrregularScript}}
        CommitMessage: ${{inputs.CommitMessage}}
        SkipIrregularPS1: ${{inputs.SkipIrregularPS1}}
        UserEmail: ${{inputs.UserEmail}}
        UserName: ${{inputs.UserName}}
        SkipRegexSource: ${{inputs.SkipRegexSource}}
      run: |
        $Parameters = @{}
        $Parameters.IrregularScript = ${env:IrregularScript}
        $Parameters.SkipIrregularPS1 = ${env:SkipIrregularPS1}
        $Parameters.SkipIrregularPS1 = $parameters.SkipIrregularPS1 -match 'true';
        $Parameters.SkipRegexSource = ${env:SkipRegexSource}
        $Parameters.SkipRegexSource = $parameters.SkipRegexSource -match 'true';
        $Parameters.CommitMessage = ${env:CommitMessage}
        $Parameters.UserEmail = ${env:UserEmail}
        $Parameters.UserName = ${env:UserName}
        foreach ($k in @($parameters.Keys)) {
            if ([String]::IsNullOrEmpty($parameters[$k])) {
                $parameters.Remove($k)
            }
        }
        Write-Host "::debug:: Irregular $(@(foreach ($p in $Parameters.GetEnumerator()) {'-' + $p.Key + ' ' + $p.Value}) -join ' ')"
        & {<#
        .Synopsis
            GitHub Action for Irregular
        .Description
            GitHub Action for Irregular.  This will:
        
            * Run all *.Irregular.ps1 files beneath the workflow directory
            * Run all *.Regex.source.ps1 files beneath the workflow directory
            * Run an .IrregularScript 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 Irregular.  
        # 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]
        $IrregularScript,
        
        # If set, will not process any files named *.irregular.ps1
        [switch]
        $SkipIrregularPS1,
        
        # If set, will not process any files named *.regex.source.ps1
        [switch]
        $SkipRegexSource,
        
        # 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.
        [string]
        $UserEmail,
        
        # The user name associated with a git commit.
        [string]
        $UserName
        )
        
        $ErrorActionPreference = 'continue'
        "::group::Parameters" | Out-Host
        [PSCustomObject]$PSBoundParameters | Format-List | Out-Host
        "::endgroup::" | Out-Host
        
        
        $PSD1Found = Get-ChildItem -Recurse -Filter "*.psd1" | Where-Object Name -eq 'Irregular.psd1' | Select-Object -First 1
        
        if ($PSD1Found) {
            $irregularModulePath = $PSD1Found
            Import-Module $PSD1Found -Force -PassThru | Out-Host
        } if ($env:GITHUB_ACTION_PATH) {
            $irregularModulePath = Join-Path $env:GITHUB_ACTION_PATH 'Irregular.psd1'
            if (Test-path $irregularModulePath) {
                Import-Module $irregularModulePath -Force -PassThru | Out-String
            } else {
                throw "Irregular not found"
            }
        } elseif (-not (Get-Module Irregular)) {    
            throw "Action Path not found"
        }
        
        "::notice title=ModuleLoaded::Irregular Loaded from Path - $($irregularModulePath)" | 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)"
                }
                $anyFilesChanged = $true
            }
            $out
        } }
        
        "::notice title=ModuleLoaded,file=$irregularModulePath::Irregular Loaded from Path" | Out-Host
        
        if (-not $UserName) { $UserName = $env:GITHUB_ACTOR }
        if (-not $UserEmail) { $UserEmail = "$UserName@github.com" }
        git config --global user.email $UserEmail
        git config --global user.name  $UserName
        
        
        if (-not $env:GITHUB_WORKSPACE) { throw "No GitHub workspace" }
        
        if ($IrregularScript) {
            "::notice::Running Irregular Script" | Out-Host
            Invoke-Expression -Command $IrregularScript |
                . $processScriptOutput |
                Out-Host
        }
        
        if (-not $SkipIrregularPS1) {
            "::notice::Running Irregular .ps1" | Out-Host
            Get-ChildItem -Recurse -Path $env:GITHUB_WORKSPACE |
                Where-Object Name -Match '\.Irregular\.ps1$' |
                ForEach-Object {
                    Write-Information "::notice file=$($_.FullName)::Running $($_.Name)"
                    $irregularPs1File = $_
                    try {
                        . $irregularPs1File.FullName |
                            . $processScriptOutput  |
                            Out-Host
                    } catch {
                        "::error::$($_ | Out-String)" | Out-Host
                    }
                }
        }
        
        if (-not $SkipRegexSource) {
            Get-ChildItem -Recurse -Path $env:GITHUB_WORKSPACE |
                Where-Object Name -Match '\.regex\.source\.ps1$' |
                ForEach-Object {
                    Write-Information "::notice file=$($_.FullName)::Running $($_.Name)"
                    . $_.FullName |            
                        . $processScriptOutput  | 
                        Out-Host
                }
        }
        
        if ($CommitMessage -or $anyFilesChanged) {
            if ($CommitMessage) {
                dir $env:GITHUB_WORKSPACE -Recurse |
                    ForEach-Object {
                        $gitStatusOutput = git status $_.Fullname -s
                        if ($gitStatusOutput) {
                            git add $_.Fullname
                        }
                    }
        
                git commit -m $ExecutionContext.SessionState.InvokeCommand.ExpandString($CommitMessage)
            }
            
            "::notice::Pushing" | Out-Host
            $gitPushed =  git push 2>&1
                
            "Git Push Output: $($gitPushed  | Out-String)"
        }} @Parameters