PSGalleryInfo.ps1
|
<#PSScriptInfo
.VERSION 1.1.0 .GUID 0fd916fe-3a0d-48c4-a196-18ea085e071f .AUTHOR Craig Dayton .COMPANYNAME Example.com .COPYRIGHT Absolute Zero .TAGS .LICENSEURI .PROJECTURI https://github.com/cadayton/PSGalleryInfo .ICONURI .EXTERNALMODULEDEPENDENCIES .REQUIREDSCRIPTS .EXTERNALSCRIPTDEPENDENCIES .RELEASENOTES #> <# .SYNOPSIS Display and search for top downloaded modules or scripts in PowerShell Gallery, PSGallery By default, MicroSoft Corporation and PowerShell DSC authors are excluded. .DESCRIPTION Display and search for top downloaded modules or scripts from the PowerShell Gallery, PSGallery By default, MicroSoft Corporation and PowerShell DSC author are excluded. Optionally, one can specific a different registered repository name. Output is displayed in a Out-GridView and selection of an entry will display the module's or script's project web page, if one exists. Module and script data is cached locally for a period of 8 hours, so repeated execution of the command is very quick. The script extends the work of Chris Hunt. https://www.automatedops.com/blog/2017/04/28/bringing-the-community-forward/ .PARAMETER scripts Specify this option to display top X downloaded scripts .PARAMETER top Default is 100. .PARAMETER all Switch to include Microsoft code. .PARAMETER matchAuthor String value to display specific modules or scripts matching the Author Name property. .PARAMETER matchDesc String value to display specific modules or scripts matching the Description property. .PARAMETER repository String value to specific a specific registered PowerShell gallery. The default PowerShell is PSGallery. .INPUTS ScriptRepo.xml or ModuleRepo.xml depending on age of the file. .OUTPUTS ScriptRepo.xml or ModuleRepo.xml depending on parameters specified. Out-Gridview .EXAMPLE PSGalleryInfo Displays the top 100 downloaded modules minus default exclusions. On the Out-GridView dialog select an entry and click on the "OK" button to display the module's project home page. Or click on the "Cancel" button to exit. .EXAMPLE PSGalleryInfo -All Displays the top 100 downloaded modules from PSGallery without any exclusions. On the Out-GridView dialog select an entry and click on the "OK" button to display the module's project home page. Or click on the "Cancel" button to exit. .EXAMPLE PSGalleryInfo -repository MyGallery Same as the prior example, but specifies a private PowerShell repository named, MyGallery. See the following URL on how to create your own internal PowerShell repository. https://kevinmarquette.github.io/2017-05-30-Powershell-your-first-PSScript-repository/?utm_source=rss&utm_medium=blog&utm_content=rss .EXAMPLE PSGalleryInfo -script -all Displays the top 100 downloaded scripts without any exclusions. .EXAMPLE PSGalleryInfo -matchAuthor "Lee" Displays the top 100 downloaded modules with an author property matching "Lee". .NOTES Author: Craig Dayton 1.0.0: 05/01/2017 - Extending the work of Chris Hunt https://www.automatedops.com/blog/2017/04/28/bringing-the-community-forward/ #> # PSGalleryInfo Params [cmdletbinding()] Param( [Parameter(Position=0, Mandatory=$false, HelpMessage = "Search for PowerShell Gallery scripts", ValueFromPipeline=$True)] [switch]$script, [Parameter(Position=1, Mandatory=$false, HelpMessage = "Display Top X modules or scripts", ValueFromPipeline=$True)] [ValidateNotNullorEmpty()] [int]$top = 100, [Parameter(Position=2, Mandatory=$false, HelpMessage = "Display Online Lottery Results & update history file", ValueFromPipeline=$True)] [ValidateNotNullorEmpty()] [switch]$all, [Parameter(Position=3, Mandatory=$false, HelpMessage = "Display all game history file records", ValueFromPipeline=$True)] [ValidateNotNullorEmpty()] [string]$matchAuthor, [Parameter(Position=4, Mandatory=$false, HelpMessage = "Display the pick history of all games", ValueFromPipeline=$True)] [ValidateNotNullorEmpty()] [string]$matchDesc, [Parameter(Position=5, Mandatory=$false, HelpMessage = "Specify a repository name", ValueFromPipeline=$True)] [ValidateNotNullorEmpty()] [string]$repository = "PSGallery" ) # # Declarations #Import-Module BurntToast; $sPath = Get-Location; $ScriptRepoFile = "$sPath\ScriptRepo-$repository.xml"; $ModuleRepoFile = "$sPath\ModuleRepo-$repository.xml"; # # functions function Get-XMLFile { param ([string]$XMLInput) [int]$mts = 0; if (Test-Path $XMLInput) { $csvFile = Get-ChildItem $XMLInput; $cts = $csvFile.LastWriteTime $nts = New-TimeSpan -Start (Get-Date) -End $cts # Number of minutes since LastWriteTime [int]$mts = (($nts.Days * 1440) + ($nts.Hours * 60) + ($nts.Minutes)) * -1; } if (($mts -gt 480) -or ($mts -eq 0)) { # older than 8 hours or file doesn't exist return $null } else { $obj = Import-CliXML -Path $XMLInput return $obj } } # # Main Routine if ($script) { $codetype = "scripts"; $modules = Get-XMLFile $ScriptRepoFile if ($modules -is [Object]) { } else { Write-Progress -Activity "Loading script data from PowerShell Gallery $repository..." -Status "Please wait" $modules = Find-Script -Repository $repository Write-Progress -Activity "Done" -Completed; $modules | Export-CliXML -Path $ScriptRepoFile } } else { $codetype = "modules" $modules = Get-XMLFile $ModuleRepoFile if ($modules -is [Object]) { } else { Write-Progress -Activity "Loading module data from PowerShell Gallery $repository..." -Status "Please wait" $modules = Find-Module -Repository $repository Write-Progress -Activity "Done" -Completed; $modules | Export-CliXML -Path $ModuleRepoFile } } if ((-not $matchAuthor) -and (-not $matchDesc)) { $normalized = $modules | Select-Object Name, @{Name = "Downloads"; Expression = {$_.AdditionalMetadata.downloadCount -as [int]}}, Author, Description, ProjectUri } if ($matchAuthor) { $normalized = $modules | Where-Object {$_.Author -match $matchAuthor} | Select-Object Name, @{Name = "Downloads"; Expression = {$_.AdditionalMetadata.downloadCount -as [int]}}, Author, Description, ProjectUri } if ($matchDesc) { $normalized = $modules | Where-Object {$_.Description -match $matchDesc} | Select-Object Name, @{Name = "Downloads"; Expression = {$_.AdditionalMetadata.downloadCount -as [int]}}, Author, Description, ProjectUri } if (-not $All) { $Selected = $normalized | Where-Object {$_.Author -ne 'Microsoft Corporation' -and $_.Author -ne 'PowerShell DSC'} | Sort-Object Downloads -Descending | Select-Object Name, Downloads, Author, Description, ProjectUri -first $top | Out-GridView -Title "Top $top Non-Microsoft $codetype" -OutputMode Single; } else { $Selected = $normalized | Sort-Object Downloads -Descending | Select-Object Name, Downloads, Author, Description, ProjectUri -first $top | Out-GridView -Title "Top 100 $codetype" -OutputMode Single; } if ($Selected -eq $null) { Write-Host " Selection Cancelled" -ForegroundColor Red Write-Host "Thanks for trying! Bye" -ForegroundColor Blue } else { [string]$URL = $Selected.ProjectUri; [string]$PRJ = $Selected.Name; if ($URL -ne $null -and $URL.Length -gt 7) { $Browser = new-object -com internetexplorer.application; $Browser.navigate2($URL); $Browser.visible = $true; } else { Write-Host "$PRJ " -NoNewLine -ForegroundColor Blue Write-Host "doesn't reference a home page" -ForegroundColor Red } } # |