#Requires -Modules GitHub

[Diagnostics.CodeAnalysis.SuppressMessageAttribute(

'PSAvoidLongLines', '',

Justification = 'Markdown templates'

)]

[CmdletBinding()]

param()

function Show-RepoList {

<#

[CmdletBinding()]

param(

# Name of the organization to connect to. Defaults to the owner of the current repository.

[Parameter()]

[string] $Owner = $env:GITHUB_REPOSITORY_OWNER

)

LogGroup "Connect to organization [$Owner]" {

Connect-GitHubApp -Organization $Owner -Default

Get-GitHubContext | Select-Object * | Format-List | Out-String

}

LogGroup "Get repositories for organization [$Owner]" {

$rawRepos = Get-GitHubRepository -Organization $Owner -AdditionalProperty 'description'

Write-Output "Found $($rawRepos.Count) repositories"

$repos = $rawRepos | ForEach-Object {

$rawRepo = $_

$rawRepo.CustomProperties | Where-Object { $_.Name -eq 'Type' } | ForEach-Object {

$type = $_.Value

[pscustomobject]@{

Name = $rawRepo.Name

Owner = $Owner

Type = $type

Description = $rawRepo.Description

}

}

} | Sort-Object Type, Name

$repos | Format-Table -AutoSize

}

$repos | Group-Object -Property Type

}

function Update-MDSection {

<#

[outputType([void])]

[CmdletBinding(SupportsShouldProcess)]

param(

# Path to the markdown file where the section should be updated.

[Parameter()]

[string] $Path = 'src\docs\index.md',

# Name of the section to be updated, used in comment markers.

[Parameter()]

[string] $Name = 'MODULE_LIST',

# The new content to insert between the section markers.

[Parameter()]

[string] $Content

)

$startSegment = "<!-- $Name`_START -->"

$endSegment = "<!-- $Name`_END -->"

$currentContent = Get-Content -Path $Path

$startIndex = $currentContent.IndexOf($startSegment)

$endIndex = $currentContent.IndexOf($endSegment)

if ($startIndex -lt 0) {

throw "[$Name] The start comment segment was not found in the file."

}

if ($endIndex -lt 0) {

throw "[$Name] The end comment segment was not found in the file."

}

if ($endIndex -lt $startIndex) {

throw "[$Name] The end comment segment was found before the start comment segment."

}

$updatedContent = $currentContent[0..$startIndex] + $Content + $currentContent[($endIndex)..($currentContent.Length - 1)]

if ($PSCmdlet.ShouldProcess('Readme section', 'Update')) {

Set-Content -Path $Path -Value $updatedContent

}

}

function Update-ActionList {

<#

[CmdletBinding(SupportsShouldProcess)]

param()

$actionTableRowTemplate = @'

$actionTableRows = ''

$repos | Where-Object { $_.Type -eq 'Action' } | ForEach-Object {

$name_hyphened = ($_.Name).Replace('-', '&#8209;')

$actionTableRow = $actionTableRowTemplate.replace('{{ OWNER }}', $_.Owner)

$actionTableRow = $actionTableRow.replace('{{ NAME }}', $_.Name)

$actionTableRow = $actionTableRow.replace('{{ NAME_HYPHENED }}', $name_hyphened)

$actionTableRow = $actionTableRow.replace('{{ DESCRIPTION }}', $_.Description)

$actionTableRow = $actionTableRow.TrimEnd()

$actionTableRow += [Environment]::NewLine

$actionTableRows += $actionTableRow

}

$actionTable = @"

Update-MDSection -Path '.\src\docs\GitHub-Actions\index.md' -Name 'ACTION_LIST' -Content $actionTable

}

function Update-ModuleList {

<#

[CmdletBinding(SupportsShouldProcess)]

param()

$moduleTableRowTemplate = @'

$moduleTableRows = ''

$repos | Where-Object { $_.Type -eq 'Module' } | ForEach-Object {

$moduleTableRows += $moduleTableRowTemplate.replace('{{ OWNER }}', $_.Owner).replace('{{ NAME }}', $_.Name).replace('{{ DESCRIPTION }}', $_.Description).TrimEnd()

$moduleTableRows += [Environment]::NewLine

}

$moduleTable = @"

Update-MDSection -Path '.\src\docs\PowerShell\Modules\index.md' -Name 'MODULE_LIST' -Content $moduleTable

}

function Update-FunctionAppList {

<#

[CmdletBinding(SupportsShouldProcess)]

param()

$functionAppTableRowTemplate = @'

$functionAppTableRows = ''

$repos | Where-Object { $_.Type -eq 'FunctionApp' } | ForEach-Object {

$name_hyphened = ($_.Name).Replace('-', '&#8209;')

$functionAppTableRow = $functionAppTableRowTemplate.replace('{{ OWNER }}', $_.Owner)

$functionAppTableRow = $functionAppTableRow.replace('{{ NAME }}', $_.Name)

$functionAppTableRow = $functionAppTableRow.replace('{{ NAME_HYPHENED }}', $name_hyphened)

$functionAppTableRow = $functionAppTableRow.replace('{{ DESCRIPTION }}', $_.Description)

$functionAppTableRow = $functionAppTableRow.TrimEnd()

$functionAppTableRow += [Environment]::NewLine

$functionAppTableRows += $functionAppTableRow

}

$functionAppTable = @"

Update-MDSection -Path '.\src\docs\PowerShell\FunctionApps\index.md' -Name 'FUNCTIONAPP_LIST' -Content $functionAppTable

}