generate-info.ps1

#requires -PSEdition Core
param (
    [string] $class
)

$destinationPath = ".\docs\_data"
$destinationFile = "$($class.ToLower()).json"


########### Check if it's useful to make changes to doc or readme #############
Set-Location ./

$hash = 0
If(Test-Path -LiteralPath $destinationPath\$destinationFile -PathType leaf) {
    $hash = Get-FileHash $destinationPath\$destinationFile
    Write-Debug "Previous hash for $destinationPath\$destinationFile is $($hash.Hash)"
}

########### Generate JSON file #############

$assemblyPath = "Expressif\bin"
Set-Location $assemblyPath
$dllfile = "net8.0\Expressif.dll"
If ((-not (Test-Path -Path "Release\$dllfile")) -or ("Release\$dllfile".CreationTime -lt "Debug\$dllfile".CreationTime)) {
    $directory = "Debug"    
} else {
    $directory = "Release"   
}
Set-Location "..\..\"
Write-Host "Generating JSON for $($class.ToLower())s based on $assemblyPath\$directory\$dllfile"

$job = Start-Job -ScriptBlock { param($fullDllPath, $class, $destination)
    Add-Type -Path "$fullDllPath"
    $elapsed = Measure-Command -Expression {
        $TextInfo = (Get-Culture).TextInfo
        $locator = New-Object -TypeName "Expressif.$($TextInfo.ToTitleCase($class))s.Introspection.$($TextInfo.ToTitleCase($class))Introspector"
        $functions = $locator.Describe() | Sort-Object ListingPriority | Select-Object -Property Name, IsPublic, Aliases, Scope, Summary, Parameters
        Write-Host  "`t$($functions.Count) $($class.ToLower()) identified"
        $functions | ForEach-Object {
            if ($_.IsPublic) {
                Write-Host "`t`t$($_.Name)"
            } else {
                Write-Warning "`t$($_.Name)"
            }
        }
        $functions | ConvertTo-Json -depth 4 | Out-File "$destination"
    }
    Write-Host  "File created at $destination in $($elapsed.TotalSeconds) seconds"
} -Args "$assemblyPath\$directory\$dllfile", $class, "$destinationPath\$destinationFile"
Wait-Job $job
Receive-Job $job

########### Check if it's useful to report a change #############

If ($hash.Hash -eq (Get-FileHash $destinationPath\$destinationFile).Hash) {
    Write-Host "No change detected in the list of predicates."
    Exit 0
} else {
    Write-Host "Changes detected in the list of predicates."
    Exit 1
}