Functions/GenXdev.AI/EnsurePaintNet.ps1
|
<##############################################################################
Part of PowerShell module : GenXdev.AI Original cmdlet filename : EnsurePaintNet.ps1 Original author : René Vaessen / GenXdev Version : 1.300.2025 ################################################################################ Copyright (c) René Vaessen / GenXdev Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. ################################################################################> ############################################################################### <# .SYNOPSIS Ensures Paint.NET is properly installed and accessible on the system. .DESCRIPTION Performs comprehensive checks and setup for Paint.NET: - Verifies if Paint.NET is installed and accessible in PATH - Installs Paint.NET via WinGet if not present - Configures system PATH environment variable - Ensures paintdotnet.exe is available for command-line usage The function handles all prerequisites and ensures a working Paint.NET installation. .EXAMPLE EnsurePaintNet This will verify and setup Paint.NET if needed. #> function EnsurePaintNet { [CmdletBinding()] [System.Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSAvoidGlobalVars', '')] [System.Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSUseDeclaredVarsMoreThanAssignments', '')] param() begin { # ensure graphics assembly is loaded for image processing if (-not [System.Drawing.Rectangle]) { Microsoft.PowerShell.Utility\Add-Type -AssemblyName System.Drawing } ######################################################################## <# .SYNOPSIS Verifies if WinGet PowerShell module is installed. .DESCRIPTION Attempts to import WinGet module and checks if it's available. .OUTPUTS System.Boolean. Returns true if WinGet is installed, false otherwise. #> function IsWinGetInstalled { try { Microsoft.PowerShell.Core\Import-Module 'Microsoft.WinGet.Client' -ErrorAction Stop $ModuleObj = Microsoft.PowerShell.Core\Get-Module 'Microsoft.WinGet.Client' -ErrorAction Stop return $null -ne $ModuleObj } catch [System.IO.FileNotFoundException] { Microsoft.PowerShell.Utility\Write-Verbose 'WinGet module not found' return $false } catch { Microsoft.PowerShell.Utility\Write-Verbose "Error checking WinGet installation: $_" return $false } } ######################################################################## <# .SYNOPSIS Installs the WinGet PowerShell module. .DESCRIPTION Forces installation of the Microsoft.WinGet.Client module and imports it. #> function InstallWinGet { try { # Request consent before installing WinGet PowerShell module $wingetConsent = GenXdev.FileSystem\Confirm-InstallationConsent ` -ApplicationName 'Microsoft.WinGet.Client PowerShell Module' ` -Source 'PowerShell Gallery' ` -Description 'Required for automated software package management via WinGet' ` -Publisher 'Microsoft' if (-not $wingetConsent) { throw 'User declined installation of Microsoft.WinGet.Client PowerShell module' } Microsoft.PowerShell.Utility\Write-Verbose 'Installing WinGet PowerShell client...' PowerShellGet\Install-Module 'Microsoft.WinGet.Client' -Force -AllowClobber -ErrorAction Stop Microsoft.PowerShell.Core\Import-Module 'Microsoft.WinGet.Client' -ErrorAction Stop } catch [System.UnauthorizedAccessException] { throw "Insufficient permissions to install WinGet module. Run as administrator: $_" } catch { throw "Failed to install WinGet module: $_" } } } process { try { # First, ensure current session PATH is up to date with both Machine and User PATH $paintNetPath = 'C:\Program Files\paint.net' # Only add Paint.NET path to user PATH if it's not already present $userPath = [Environment]::GetEnvironmentVariable('PATH', 'User') if ($userPath -notlike "*$paintNetPath*") { $userPath = "$userPath;$paintNetPath" [System.Environment]::SetEnvironmentVariable('PATH', $userPath, 'User') } # Only update session PATH if Paint.NET path is not already in current session if ($env:PATH -notlike "*$paintNetPath*") { $env:PATH = "$env:PATH;$paintNetPath" } # Check if Paint.NET is already accessible Microsoft.PowerShell.Utility\Write-Verbose 'Paint.NET not found in PATH, checking installation...' # Check again after updating PATH if (@(Microsoft.PowerShell.Core\Get-Command 'paintdotnet.exe' -ErrorAction SilentlyContinue).Length -eq 0) { # Request consent before installing Paint.NET $paintNetConsent = GenXdev.FileSystem\Confirm-InstallationConsent ` -ApplicationName 'Paint.NET' ` -Source 'WinGet' ` -Description 'Image editing software required for graphics processing operations' ` -Publisher 'dotPDN LLC' if (-not $paintNetConsent) { throw 'User declined installation of Paint.NET. Cannot proceed without image editing capabilities.' } Microsoft.PowerShell.Utility\Write-Verbose 'Installing Paint.NET...' if (-not (IsWinGetInstalled)) { InstallWinGet } try { $null = Microsoft.WinGet.Client\Install-WinGetPackage -Id 'dotPDN.PaintDotNet' -Force } catch { throw "Failed to install Paint.NET via WinGet: $_" } # Update PATH after installation $userPath = [Environment]::GetEnvironmentVariable('PATH', 'User') if ($userPath -notlike "*$paintNetPath*") { try { Microsoft.PowerShell.Utility\Write-Verbose 'Adding Paint.NET to User PATH after installation...' [Environment]::SetEnvironmentVariable( 'PATH', "$userPath;$paintNetPath", 'User') # Update current session PATH only if not already present if ($env:PATH -notlike "*$paintNetPath*") { $env:PATH = "$env:PATH;$paintNetPath" } } catch [System.Security.SecurityException] { throw "Access denied while updating PATH environment variable: $_" } } if (-not (Microsoft.PowerShell.Core\Get-Command 'paintdotnet.exe' -ErrorAction SilentlyContinue)) { throw 'Paint.NET installation failed: paintdotnet.exe not found after installation' } } Microsoft.PowerShell.Utility\Write-Verbose "Paint.NET is now available at: $(Microsoft.PowerShell.Core\Get-Command 'paintdotnet.exe' -ErrorAction SilentlyContinue | Microsoft.PowerShell.Utility\Select-Object -ExpandProperty Source)" } catch { $errorMessage = "Failed to setup Paint.NET: $($_.Exception.Message)" Microsoft.PowerShell.Utility\Write-Error -Exception $_.Exception -Message $errorMessage -Category OperationStopped throw } } end {} } |