sailfork / t3code-github / scripts/ install.ps1

# Installs the T3 Code CLI from a GitHub Release archive on Windows. Needs
# only PowerShell 5.1+; no Node, npm, or compiler.
#
#   irm https://t3.codes/install.ps1 | iex
#
# Environment:
#   T3CODE_CHANNEL           release train to follow: stable, nightly, or preview
#                            (default: stable; preview is a maintainers' test train)
#   T3CODE_VERSION           exact version to install (overrides T3CODE_CHANNEL)
#   T3CODE_HOME              T3 home directory (default: ~\.t3)
#   T3CODE_INSTALL_BIN_DIR   where t3.exe is linked (default: ~\.local\bin)
#   T3CODE_RELEASE_BASE_URL  mirror for releases/download (default: GitHub)
#
# The archive is unpacked into $T3CODE_HOME\runtime\versions\<version>, the
# same layout `t3 service install` uses, so the service reuses this download.
$ErrorActionPreference = "Stop"
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

$repo = "pingdotgg/t3code"
$baseUrl = if ($env:T3CODE_RELEASE_BASE_URL) { $env:T3CODE_RELEASE_BASE_URL.TrimEnd("/") } else { "https://github.com/$repo/releases/download" }
$t3Home = if ($env:T3CODE_HOME) { $env:T3CODE_HOME } else { Join-Path $HOME ".t3" }
$binDir = if ($env:T3CODE_INSTALL_BIN_DIR) { $env:T3CODE_INSTALL_BIN_DIR } else { Join-Path $HOME ".local\bin" }

function Fail([string] $message) {
  Write-Error "t3 install: $message"
  exit 1
}

$terminal = -not [Console]::IsErrorRedirected -and $env:TERM -ne "dumb"
$interactive = $terminal -and $Host.UI.SupportsVirtualTerminal
if ($interactive) {
  # Legacy code pages may support ANSI escapes but not the logo or bar glyphs.
  $glyphs = -join [char[]](0x2588, 0x2580, 0x2584, 0x25A0, 0x00B7)
  $encoding = [Console]::Error.Encoding
  $interactive = $encoding.GetString($encoding.GetBytes($glyphs)) -eq $glyphs
}
$esc = [char]27
$reset = $bold = $muted = $accent = $green = ""
if ($interactive -and -not $env:NO_COLOR) {
  $reset = "$esc[0m"; $bold = "$esc[1m"; $muted = "$esc[2m"
  $accent = "$esc[94m"; $green = "$esc[32m"
}
function Step([string] $message) {
  if ($interactive) { [Console]::Error.Write("`r$esc[2K  $muted$message$reset") }
  else { [Console]::Error.WriteLine("  $message") }
}
function Draw-Download([long] $bytes, [long] $total) {
  if (-not $interactive) { return }
  $columns = [Console]::WindowWidth
  if ($columns -le 0) { $columns = 80 }
  if ($total -gt 0 -and $columns -ge 9) {
    $percent = [Math]::Min(100, [Math]::Floor($bytes * 100.0 / $total))
    $width = [Math]::Min(32, $columns - 8)
    $filled = [int][Math]::Floor($percent * $width / 100)
    $bar = ([string][char]0x25A0) * $filled
    $rest = ([string][char]0x00B7) * ($width - $filled)
    $sizes = ("  {0:F1} / {1:F1} MB" -f ($bytes / 1MB), ($total / 1MB))
    if ($width + 7 + $sizes.Length -ge $columns) { $sizes = "" }
    [Console]::Error.Write(("`r$esc[2K  $accent$bar$reset$muted$rest$reset {0,3}%" -f $percent) + "$muted$sizes$reset")
  } else {
    $line = if ($columns -ge 32) { "  Downloading  {0:F1} MB" -f ($bytes / 1MB) } else { "  {0:F1} MB" -f ($bytes / 1MB) }
    [Console]::Error.Write("`r$esc[2K" + $line.Substring(0, [Math]::Min($line.Length, $columns - 1)))
  }
}
function Fetch([string] $uri, [string] $destination, [switch] $progress) {
  if (-not $progress -or -not $interactive) {
    $ProgressPreference = if ($progress -and $terminal) { "Continue" } else { "SilentlyContinue" }
    Invoke-WebRequest -Uri $uri -OutFile $destination -UseBasicParsing
    return
  }
  Add-Type -AssemblyName System.Net.Http
  $client = New-Object System.Net.Http.HttpClient
  $response = $source = $file = $null
  try {
    $response = $client.GetAsync($uri, [System.Net.Http.HttpCompletionOption]::ResponseHeadersRead).GetAwaiter().GetResult()
    $response.EnsureSuccessStatusCode() | Out-Null
    $source = $response.Content.ReadAsStreamAsync().GetAwaiter().GetResult()
    $file = [IO.File]::Create($destination)
    $buffer = New-Object byte[] 65536
    $bytes = 0L
    $clock = [Diagnostics.Stopwatch]::StartNew()
    Draw-Download 0 $response.Content.Headers.ContentLength
    while (($count = $source.Read($buffer, 0, $buffer.Length)) -gt 0) {
      $file.Write($buffer, 0, $count)
      $bytes += $count
      if ($clock.ElapsedMilliseconds -ge 100) {
        Draw-Download $bytes $response.Content.Headers.ContentLength
        $clock.Restart()
      }
    }
    Draw-Download $bytes $bytes
    [Console]::Error.WriteLine()
  } finally {
    if ($file) { $file.Dispose() }
    if ($source) { $source.Dispose() }
    if ($response) { $response.Dispose() }
    $client.Dispose()
  }
}
if ($interactive) {
  # Block characters are constructed so this file also loads correctly in PowerShell 5.1.
  $mark = @(
    "########## ######## ",
    "    ###       _##^  ",
    "    ###       ####_ ",
    "    ###    _     ###",
    "    ###    #######^ "
  )
  [Console]::Error.WriteLine()
  for ($i = 0; $i -lt $mark.Length; $i++) {
    $row = $mark[$i].Replace('#', [char]0x2588).Replace('^', [char]0x2580).Replace('_', [char]0x2584)
    $label = if ($i -eq 1) { "     ${bold}T3 Code$reset" } elseif ($i -eq 2) { "     ${muted}CLI installer$reset" } else { "" }
    [Console]::Error.WriteLine("  $bold$row$reset$label")
  }
  [Console]::Error.WriteLine()
}
Step "Finding your release..."

# PROCESSOR_ARCHITEW6432 bypasses WOW64 emulation; 5.1 hosts can lack RuntimeInformation's required .NET version.
$rawArch = if ($env:PROCESSOR_ARCHITEW6432) { $env:PROCESSOR_ARCHITEW6432 } else { $env:PROCESSOR_ARCHITECTURE }
$arch = switch ($rawArch) {
  "AMD64" { "x64" }
  "ARM64" { "arm64" }
  default { Fail "unsupported architecture $rawArch" }
}

$channel = if ($env:T3CODE_CHANNEL) { $env:T3CODE_CHANNEL } else { "stable" }
$version = $env:T3CODE_VERSION
if (-not $version) {
  $tagPattern = switch ($channel) {
    "stable" { '^v\d+\.\d+\.\d+
		
		
		
		
	

 }
    "nightly" { '^v\d+\.\d+\.\d+-nightly\.\d+\.\d+
		
		
		
		
	

 }
    "preview" { '^v\d+\.\d+\.\d+-preview\.\d+\.\d+
		
		
		
		
	

 }
    default { Fail "T3CODE_CHANNEL must be stable, nightly, or preview" }
  }
  if ($channel -eq "stable") {
    # release.yml marks only plain stable releases latest. This is a github.com
    # page, so it is not cut off by a page of newer nightlies or the API quota.
    $release = Invoke-RestMethod -Uri "https://github.com/$repo/releases/latest" -Headers @{ "User-Agent" = "t3-install"; "Accept" = "application/json" }
    $tag = ($release | Where-Object { $_.tag_name -match $tagPattern }).tag_name
  } else {
    $tag = $null
    for ($page = 1; -not $tag -and $page -le 10; $page++) {
      $releases = Invoke-RestMethod -Uri "https://api.github.com/repos/$repo/releases?per_page=100&page=$page" -Headers @{ "User-Agent" = "t3-install" }
      $tag = ($releases | Where-Object { -not $_.draft -and $_.tag_name -match $tagPattern } | Select-Object -First 1).tag_name
      if (-not $releases) { break }
    }
  }
  if (-not $tag) { Fail "could not find a $channel release; set T3CODE_VERSION" }
  $version = $tag.Substring(1)
}
if ($version -match '-preview\.') {
  Write-Warning "t3 $version is a preview build. Preview builds are cut by maintainers from unreleased branches to exercise the release pipeline. They can be broken, receive no fixes, and are never offered as updates. Set T3CODE_CHANNEL=stable (the default) for a supported build."
  if ($channel -ne "preview" -and -not $env:T3CODE_VERSION) {
    Fail "refusing a preview build that was not explicitly requested"
  }
}

$stem = "t3-$version-win32-$arch"
$archive = "$stem.zip"
$versionsDir = Join-Path $t3Home "runtime\versions"
$targetDir = Join-Path $versionsDir $version
$marker = Join-Path $targetDir ".install-complete"

if ((Test-Path $marker) -and ((Get-Content $marker -Raw).Trim() -eq $version)) {
  Step "Version $version is already downloaded."
} else {
  New-Item -ItemType Directory -Force -Path $versionsDir | Out-Null
  $staging = Join-Path $versionsDir (".staging-" + [System.IO.Path]::GetRandomFileName())
  New-Item -ItemType Directory -Path $staging | Out-Null
  try {
    if ($interactive) { [Console]::Error.Write("`r$esc[2K") }
    [Console]::Error.WriteLine("  ${muted}Installing$reset T3 Code $bold$version$reset`n")
    Step "Downloading..."
    try {
      Fetch "$baseUrl/v$version/SHA256SUMS" (Join-Path $staging "SHA256SUMS")
    } catch {
      $status = $_.Exception.Response.StatusCode.value__
      if ($status -eq 404) {
        Fail "t3 $version has no release archive for win32-$arch; releases before the self-contained CLI can only be installed with 'npm install -g t3@$version'"
      }
      throw
    }
    Fetch "$baseUrl/v$version/$archive" (Join-Path $staging $archive) -progress

    Step "Verifying the download..."

    $expected = (Get-Content (Join-Path $staging "SHA256SUMS") | Where-Object { $_ -match "\s\*?$([regex]::Escape($archive))$" } | Select-Object -First 1)
    if (-not $expected) { Fail "$archive is not listed in SHA256SUMS" }
    $expected = ($expected -split "\s+")[0].ToLowerInvariant()
    $actual = (Get-FileHash -Algorithm SHA256 (Join-Path $staging $archive)).Hash.ToLowerInvariant()
    if ($actual -ne $expected) { Fail "checksum mismatch for $archive" }

    Step "Extracting T3 Code..."
    # The archive module reads the global preference, not the caller's local scope.
    $savedProgress = $global:ProgressPreference
    try {
      $global:ProgressPreference = "SilentlyContinue"
      Expand-Archive -Path (Join-Path $staging $archive) -DestinationPath $staging -Force
    } finally { $global:ProgressPreference = $savedProgress }
    Get-ChildItem (Join-Path $staging $stem) | Move-Item -Destination $staging
    Remove-Item (Join-Path $staging $stem), (Join-Path $staging $archive), (Join-Path $staging "SHA256SUMS") -Recurse -Force

    & (Join-Path $staging "t3.exe") --version | Out-Null
    if ($LASTEXITCODE -ne 0) { Fail "the downloaded executable does not run" }
    Set-Content -Path (Join-Path $staging ".install-complete") -Value $version -NoNewline

    if (Test-Path $targetDir) { Remove-Item $targetDir -Recurse -Force }
    Move-Item $staging $targetDir
  } catch {
    if (Test-Path $staging) { Remove-Item $staging -Recurse -Force }
    throw
  }
}

Step "Setting up the t3 command..."
New-Item -ItemType Directory -Force -Path $binDir | Out-Null
$shim = Join-Path $binDir "t3.cmd"
# UTF-8 without a BOM: cmd.exe reads the shim as-is, and ASCII would corrupt
# non-ASCII characters in the user's home path.
[System.IO.File]::WriteAllText($shim, "@echo off`r`n`"$(Join-Path $targetDir 't3.exe')`" %*", (New-Object System.Text.UTF8Encoding $false))
# Pruning keeps what this shim points at; a background service cannot see $binDir otherwise.
$launchers = Join-Path $t3Home "runtime\launchers"
$shimPath = (Resolve-Path $shim).Path
if (-not ((Test-Path $launchers) -and ((Get-Content $launchers) -contains $shimPath))) {
  [System.IO.File]::AppendAllText($launchers, "$shimPath`r`n", (New-Object System.Text.UTF8Encoding $false))
}
if ($interactive) { [Console]::Error.Write("`r$esc[2K") }
[Console]::Error.WriteLine("  ${green}Installed T3 Code $version$reset`n")
if (($env:PATH -split ";") -notcontains $binDir) {
  Write-Host "  Add $binDir to your PATH, then run ${bold}t3$reset.`n"
} else {
  Write-Host "  Run ${bold}t3$reset to use T3 Code here, or ${bold}t3 up$reset to use it from your other devices.`n"
}
}\n \"nightly\" { '^v\\d+\\.\\d+\\.\\d+-nightly\\.\\d+\\.\\d+ }\n \"preview\" { '^v\\d+\\.\\d+\\.\\d+-preview\\.\\d+\\.\\d+ }\n default { Fail \"T3CODE_CHANNEL must be stable, nightly, or preview\" }\n }\n if ($channel -eq \"stable\") {\n # release.yml marks only plain stable releases latest. This is a github.com\n # page, so it is not cut off by a page of newer nightlies or the API quota.\n $release = Invoke-RestMethod -Uri \"https://github.com/$repo/releases/latest\" -Headers @{ \"User-Agent\" = \"t3-install\"; \"Accept\" = \"application/json\" }\n $tag = ($release | Where-Object { $_.tag_name -match $tagPattern }).tag_name\n } else {\n $tag = $null\n for ($page = 1; -not $tag -and $page -le 10; $page++) {\n $releases = Invoke-RestMethod -Uri \"https://api.github.com/repos/$repo/releases?per_page=100&page=$page\" -Headers @{ \"User-Agent\" = \"t3-install\" }\n $tag = ($releases | Where-Object { -not $_.draft -and $_.tag_name -match $tagPattern } | Select-Object -First 1).tag_name\n if (-not $releases) { break }\n }\n }\n if (-not $tag) { Fail \"could not find a $channel release; set T3CODE_VERSION\" }\n $version = $tag.Substring(1)\n}\nif ($version -match '-preview\\.') {\n Write-Warning \"t3 $version is a preview build. Preview builds are cut by maintainers from unreleased branches to exercise the release pipeline. They can be broken, receive no fixes, and are never offered as updates. Set T3CODE_CHANNEL=stable (the default) for a supported build.\"\n if ($channel -ne \"preview\" -and -not $env:T3CODE_VERSION) {\n Fail \"refusing a preview build that was not explicitly requested\"\n }\n}\n\n$stem = \"t3-$version-win32-$arch\"\n$archive = \"$stem.zip\"\n$versionsDir = Join-Path $t3Home \"runtime\\versions\"\n$targetDir = Join-Path $versionsDir $version\n$marker = Join-Path $targetDir \".install-complete\"\n\nif ((Test-Path $marker) -and ((Get-Content $marker -Raw).Trim() -eq $version)) {\n Step \"Version $version is already downloaded.\"\n} else {\n New-Item -ItemType Directory -Force -Path $versionsDir | Out-Null\n $staging = Join-Path $versionsDir (\".staging-\" + [System.IO.Path]::GetRandomFileName())\n New-Item -ItemType Directory -Path $staging | Out-Null\n try {\n if ($interactive) { [Console]::Error.Write(\"`r$esc[2K\") }\n [Console]::Error.WriteLine(\" ${muted}Installing$reset T3 Code $bold$version$reset`n\")\n Step \"Downloading...\"\n try {\n Fetch \"$baseUrl/v$version/SHA256SUMS\" (Join-Path $staging \"SHA256SUMS\")\n } catch {\n $status = $_.Exception.Response.StatusCode.value__\n if ($status -eq 404) {\n Fail \"t3 $version has no release archive for win32-$arch; releases before the self-contained CLI can only be installed with 'npm install -g t3@$version'\"\n }\n throw\n }\n Fetch \"$baseUrl/v$version/$archive\" (Join-Path $staging $archive) -progress\n\n Step \"Verifying the download...\"\n\n $expected = (Get-Content (Join-Path $staging \"SHA256SUMS\") | Where-Object { $_ -match \"\\s\\*?$([regex]::Escape($archive))$\" } | Select-Object -First 1)\n if (-not $expected) { Fail \"$archive is not listed in SHA256SUMS\" }\n $expected = ($expected -split \"\\s+\")[0].ToLowerInvariant()\n $actual = (Get-FileHash -Algorithm SHA256 (Join-Path $staging $archive)).Hash.ToLowerInvariant()\n if ($actual -ne $expected) { Fail \"checksum mismatch for $archive\" }\n\n Step \"Extracting T3 Code...\"\n # The archive module reads the global preference, not the caller's local scope.\n $savedProgress = $global:ProgressPreference\n try {\n $global:ProgressPreference = \"SilentlyContinue\"\n Expand-Archive -Path (Join-Path $staging $archive) -DestinationPath $staging -Force\n } finally { $global:ProgressPreference = $savedProgress }\n Get-ChildItem (Join-Path $staging $stem) | Move-Item -Destination $staging\n Remove-Item (Join-Path $staging $stem), (Join-Path $staging $archive), (Join-Path $staging \"SHA256SUMS\") -Recurse -Force\n\n & (Join-Path $staging \"t3.exe\") --version | Out-Null\n if ($LASTEXITCODE -ne 0) { Fail \"the downloaded executable does not run\" }\n Set-Content -Path (Join-Path $staging \".install-complete\") -Value $version -NoNewline\n\n if (Test-Path $targetDir) { Remove-Item $targetDir -Recurse -Force }\n Move-Item $staging $targetDir\n } catch {\n if (Test-Path $staging) { Remove-Item $staging -Recurse -Force }\n throw\n }\n}\n\nStep \"Setting up the t3 command...\"\nNew-Item -ItemType Directory -Force -Path $binDir | Out-Null\n$shim = Join-Path $binDir \"t3.cmd\"\n# UTF-8 without a BOM: cmd.exe reads the shim as-is, and ASCII would corrupt\n# non-ASCII characters in the user's home path.\n[System.IO.File]::WriteAllText($shim, \"@echo off`r`n`\"$(Join-Path $targetDir 't3.exe')`\" %*\", (New-Object System.Text.UTF8Encoding $false))\n# Pruning keeps what this shim points at; a background service cannot see $binDir otherwise.\n$launchers = Join-Path $t3Home \"runtime\\launchers\"\n$shimPath = (Resolve-Path $shim).Path\nif (-not ((Test-Path $launchers) -and ((Get-Content $launchers) -contains $shimPath))) {\n [System.IO.File]::AppendAllText($launchers, \"$shimPath`r`n\", (New-Object System.Text.UTF8Encoding $false))\n}\nif ($interactive) { [Console]::Error.Write(\"`r$esc[2K\") }\n[Console]::Error.WriteLine(\" ${green}Installed T3 Code $version$reset`n\")\nif (($env:PATH -split \";\") -notcontains $binDir) {\n Write-Host \" Add $binDir to your PATH, then run ${bold}t3$reset.`n\"\n} else {\n Write-Host \" Run ${bold}t3$reset to use T3 Code here, or ${bold}t3 up$reset to use it from your other devices.`n\"\n}\n","preview":null,"history":null,"version":"fe452674c203f3db921f2edc87bb9b6530ccef36"},"/_session?shell=1":null}