♻️ Cleanup boot process

Author: JustinGrote

ModuleFast.ps1

@@ -62,30 +62,35 @@ function Import-NuGetVersioningAssembly {
 Import-NuGetVersioningAssembly
 if ($ImportNugetVersioning) { return }
 
-if (Get-Module $ModuleName) {
+if (-not (Get-Module $ModuleName)) {
+  #Dont use a release, use the latest commit on main
+  if ($UseMain) {
+    $Uri = "https://raw.githubusercontent.com/$User/$Repo/main/$ModuleName.psm1"
+  }
+
+  Write-Debug "Fetching $ModuleName from $Uri"
+  $ProgressPreference = 'SilentlyContinue'
+  try {
+    $response = [HttpClient]::new().GetStringAsync($Uri).GetAwaiter().GetResult()
+  } catch {
+    $PSItem.ErrorDetails = "Failed to fetch $ModuleName from $Uri`: $PSItem"
+    $PSCmdlet.ThrowTerminatingError($PSItem)
+  }
+  Write-Debug 'Fetched response'
+  $scriptBlock = [ScriptBlock]::Create($response)
+  $ProgressPreference = 'Continue'
+
+  $bootstrapModule = New-Module -Name $ModuleName -ScriptBlock $scriptblock | Import-Module -PassThru
+  Write-Debug "Loaded Module $ModuleName"
+} else {
   Write-Warning "Module $ModuleName already loaded, skipping bootstrap."
-  return
 }
 
-#Dont use a release, use the latest commit on main
+#This is ModuleFast specific
 if ($UseMain) {
-  $Uri = "https://raw.githubusercontent.com/$User/$Repo/main/$ModuleName.psm1"
-}
-
-Write-Debug "Fetching $ModuleName from $Uri"
-$ProgressPreference = 'SilentlyContinue'
-try {
-  $response = [HttpClient]::new().GetStringAsync($Uri).GetAwaiter().GetResult()
-} catch {
-  $PSItem.ErrorDetails = "Failed to fetch $ModuleName from $Uri`: $PSItem"
-  $PSCmdlet.ThrowTerminatingError($PSItem)
+  Write-Debug 'UseMain Specified, ModuleFast will use preview.pwsh.gallery'
+  & (Get-Module $ModuleName) { $SCRIPT:DefaultSource = 'https://preview.pwsh.gallery/index.json' }
 }
-Write-Debug 'Fetched response'
-$scriptBlock = [ScriptBlock]::Create($response)
-$ProgressPreference = 'Continue'
-
-$bootstrapModule = New-Module -Name $ModuleName -ScriptBlock $scriptblock | Import-Module -PassThru
-Write-Debug "Loaded Module $ModuleName"
 
 if ($installArgs) {
   Write-Debug "Detected we were started with args, running $Entrypoint $($installArgs -join ' ')"
@@ -95,8 +100,4 @@ if ($installArgs) {
   Remove-Module $bootstrapModule
 }
 
-#This is ModuleFast specific
-if ($UseMain) {
-  Write-Debug 'UseMain Specified, ModuleFast will use preview.pwsh.gallery'
-  & (Get-Module $ModuleName) { $SCRIPT:DefaultSource = 'https://preview.pwsh.gallery/index.json' }
-}
+

ModuleFast.psm1

@@ -26,26 +26,28 @@ $ErrorActionPreference = 'Stop'
 $SCRIPT:DefaultSource = 'https://pwsh.gallery/index.json'
 
 #region Public
-<#
-.SYNOPSIS
-High performance, declarative Powershell Module Installer
-.DESCRIPTION
-ModuleFast is a high performance, declarative PowerShell module installer. It is designed with no external dependencies and can be bootstrapped in a single line of code. It is ideal for Continuous Integration/Deployment and serverless scenarios where you want to install modules quickly and without any user interaction. It is inspired by pnpm and other high performance declarative package managers.
-
-ModuleFast accepts a variety of familiar PowerShell syntaxes and objects for module specification as well as a custom shorthand syntax allowing complex version requirements to be defined in a single string.
-
-ModuleFast can also install the required modules specified in the #Requires line of a script, or in the RequiredModules section of a module manifest, by simplying providing the path to that file in the -Path parameter (which also accepts remote UNC, http, and https URLs).
-
-.EXAMPLE
-Install-ModuleFast 'Az'
-.EXAMPLE
-$plan = Get-ModuleFastPlan 'Az','VMWare.PowerCLI'
-$plan | Install-ModuleFast
-.EXAMPLE
-$plan = Install-ModuleFast 'Az','VMWare.PowerCLI' -WhatIf
-$plan | Install-ModuleFast
-#>
+
 function Install-ModuleFast {
+  <#
+  .SYNOPSIS
+  High performance, declarative Powershell Module Installer
+  .DESCRIPTION
+  ModuleFast is a high performance, declarative PowerShell module installer. It is designed with no external dependencies and can be bootstrapped in a single line of code. It is ideal for Continuous Integration/Deployment and serverless scenarios where you want to install modules quickly and without any user interaction. It is inspired by pnpm and other high performance declarative package managers.
+
+  ModuleFast accepts a variety of familiar PowerShell syntaxes and objects for module specification as well as a custom shorthand syntax allowing complex version requirements to be defined in a single string.
+
+  ModuleFast can also install the required modules specified in the #Requires line of a script, or in the RequiredModules section of a module manifest, by simplying providing the path to that file in the -Path parameter (which also accepts remote UNC, http, and https URLs).
+
+  .EXAMPLE
+  Install-ModuleFast 'Az'
+  .EXAMPLE
+  $plan = Get-ModuleFastPlan 'Az','VMWare.PowerCLI'
+  $plan | Install-ModuleFast
+  .EXAMPLE
+  $plan = Install-ModuleFast 'Az','VMWare.PowerCLI' -WhatIf
+  $plan | Install-ModuleFast
+  #>
+
   [CmdletBinding(SupportsShouldProcess, DefaultParameterSetName = 'Specification')]
   param(
     #The module(s) to install. This can be a string, a ModuleSpecification, a hashtable with nuget version style (e.g. @{Name='test';Version='1.0'}), a hashtable with ModuleSpecification style (e.g. @{Name='test';RequiredVersion='1.0'}),

README.MD

@@ -4,7 +4,7 @@
 This is a PowerShell module installer that is optimized for high performance and no external dependencies so it can be
 used as a bootstrap to quickly install and update modules in a declarative fashion.
 
-## Quick Start Bootstrap
+## Bootstrap Quick Start
 
 ### Load ModuleFast as a module for the session
 
@@ -17,6 +17,12 @@ Install-ModuleFast ImportExcel
 
 The bit.ly link will always point to the latest release of ModuleFast by default. In order to avoid breaking changes, you can pin to a specific release. This is recommended when using CI systems such as GitHub Actions to install dependencies but is generally not needed on an interactive basis.
 
+### View the Detailed Help for ModuleFast
+```powershell
+iwr bit.ly/modulefast | iex
+Get-Help Install-ModuleFast -Full
+```
+
 ### Single Line Installation (good for CI/CD)
 
 This syntax allows you to both load and invoke Install-Modulefast. Any additional arguments you pass to the command are the same as if you provided them as arguments to Install-ModuleFast