libretro/install.ps1

# One-line bootstrap and local wrapper. The downloaded installer is accepted
# only when it matches the SHA-256 embedded in this wrapper.
# Everything runs in a script block of its own: piped into iex, the script
# would otherwise leave its variables and $ErrorActionPreference = "Stop"
# in the user's session, where every later error would stop their commands.
# Neither the script nor the block declares a parameter: one [Parameter()]
# attribute makes it an advanced one, whose common parameters took -v
# (-Verbose), -vb, -d (-Debug) and -ea before install.py could see them.
& {
    $InstallerArguments = @($args)

    $ErrorActionPreference = "Stop"
    $defaultInstallUrl = "https://raw.githubusercontent.com/Abdess/retrobios/main/install.py"
    $defaultInstallSha256 = "3f6f906ede89a0a6c350a1f85f668a213031ec8e84215595cdbd160c22ed3352"
    $maximumInstallerBytes = 2MB
    $installerExit = 0
    $installer = if ($PSScriptRoot) { Join-Path $PSScriptRoot "install.py" } else { $null }
    $temporary = $null

    try {
        if (-not $installer -or -not (Test-Path -LiteralPath $installer -PathType Leaf)) {
            $url = if ($env:RETROBIOS_INSTALL_URL) { $env:RETROBIOS_INSTALL_URL } else { $defaultInstallUrl }
            $expected = if ($env:RETROBIOS_INSTALL_SHA256) { $env:RETROBIOS_INSTALL_SHA256 } else { $defaultInstallSha256 }
            $uri = [Uri]$url
            if ($uri.Scheme -ne "https") {
                throw "RETROBIOS_INSTALL_URL must use HTTPS."
            }
            if ($expected -notmatch '^[0-9a-fA-F]{64}$') {
                throw "Installer SHA-256 must contain exactly 64 hexadecimal characters."
            }
            # Windows PowerShell 5.1 still negotiates SSL 3.0 / TLS 1.0 by default
            # and GitHub refuses both, so the download fails before any hash is
            # checked. install.sh pins the same floor with curl --tlsv1.2.
            if ($PSVersionTable.PSEdition -ne "Core") {
                [Net.ServicePointManager]::SecurityProtocol = `
                    [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12
            }
            $temporary = Join-Path ([IO.Path]::GetTempPath()) ("retrobios-install-{0}.py" -f [Guid]::NewGuid())
            try {
                Invoke-WebRequest -Uri $uri -OutFile $temporary -UseBasicParsing
            } catch {
                # The raw WebException read as a crash and named no next step.
                throw ("The installer could not be downloaded from {0}: {1} " +
                    "Check the network connection and any proxy, then run the same command again. " +
                    "Nothing was run and nothing was written.") -f $url, $_.Exception.Message
            }
            if ((Get-Item -LiteralPath $temporary).Length -gt $maximumInstallerBytes) {
                throw "Downloaded installer exceeds the size limit."
            }
            $actual = (Get-FileHash -LiteralPath $temporary -Algorithm SHA256).Hash.ToLowerInvariant()
            if ($actual -ne $expected.ToLowerInvariant()) {
                $mismatch = "The downloaded installer does not match its expected fingerprint. Nothing was run and nothing was written. "
                $overrides = @("RETROBIOS_INSTALL_URL", "RETROBIOS_INSTALL_SHA256") |
                    Where-Object { [Environment]::GetEnvironmentVariable($_) }
                if ($overrides) {
                    # A pin or a URL of the user's own refuses the installer:
                    # retrying, as the advice below says, would never help.
                    throw ($mismatch + "{0} is set in this session and decides which installer is accepted: " +
                        "remove it to use the installer this script names, or set it to match.") -f ($overrides -join " and ")
                }
                throw ($mismatch + "The download was most likely cut short: try again. Within minutes of an update " +
                    "of this project the two files can come from caches of different ages. Waiting five minutes settles that.")
            }
            $installer = $temporary
        }

        $launcher = @()
        $python = Get-Command py -ErrorAction SilentlyContinue
        if ($python) {
            $launcher = @("-3")
        } else {
            $python = Get-Command python3 -ErrorAction SilentlyContinue
            if (-not $python) {
                $python = Get-Command python -ErrorAction SilentlyContinue
            }
        }
        $needPython = "Python 3.8 or newer is required. Install it with " +
            "'winget install Python.Python.3.12' or from https://www.python.org/downloads/ " +
            "(tick 'Add python.exe to PATH'), then open a new PowerShell window and run this command again."
        if (-not $python) {
            throw $needPython
        }
        & $python.Source @launcher -c "import sys; raise SystemExit(sys.version_info < (3, 8))"
        if ($LASTEXITCODE -ne 0) { throw $needPython }
        # The installer rebuilds this command in its hints, and the user has
        # no install.py of their own to run.
        $previousBootstrap = $env:RETROBIOS_BOOTSTRAP
        $env:RETROBIOS_BOOTSTRAP = if ($temporary) { "ps1" } else { $null }
        try {
            & $python.Source @launcher $installer @InstallerArguments
        } finally {
            $env:RETROBIOS_BOOTSTRAP = $previousBootstrap
        }
        # The installer has already said what happened: its status is passed on
        # as it is (1 for files left to fetch under --check, 2 when nothing was
        # installed, 130 on Ctrl+C), not turned into a red exception that reads
        # as a crash and flattens every code to one.
        $installerExit = $LASTEXITCODE
    }
    catch {
        # One line saying what failed and what to do, rather than the red
        # exception block PowerShell prints for an uncaught throw.
        [Console]::Error.WriteLine("Error: " + $_.Exception.Message)
        $installerExit = 1
    }
    finally {
        if ($temporary -and (Test-Path -LiteralPath $temporary)) {
            Remove-Item -LiteralPath $temporary -Force
        }
    }

    if ($installerExit) {
        # Run from a file, the script ends with that status. Piped into iex it
        # runs in the user's own session, which exit would close.
        if ($PSScriptRoot) { exit $installerExit }
        $global:LASTEXITCODE = $installerExit
    }
} @args