feat: show bootstrap installation progress

Author: Fedoseew

docs/DISTRIBUTION.md

@@ -27,6 +27,14 @@ The release also includes `install.sh` and `install.ps1`. README downloads the
 installer from the same release as the application archives, keeping the
 bootstrap script and archive layout in sync.
 
+In a terminal, the bootstrap installer highlights download, verification,
+extraction, and wizard startup messages. On macOS/Linux, curl shows its native
+download progress bar (or activity indicator when the size is unknown).
+PowerShell shows native progress for installation phases and web downloads,
+and closes its progress display before starting the wizard and on failure.
+Redirected output and CI use plain status lines; `NO_COLOR` disables colored
+status messages.
+
 The stable asset names allow installers to use GitHub's
 `releases/latest/download` URL while the release tag records the exact version.
 Installations are stored by archive checksum, so installing the same release is

install.ps1

@@ -20,6 +20,26 @@ param(
 
 $ErrorActionPreference = "Stop"
 
+$interactiveOutput = -not [Console]::IsOutputRedirected -and -not [Console]::IsErrorRedirected -and
+    $env:TERM -ne "dumb" -and -not $env:CI
+
+function Write-InstallStatus {
+    param([string]$Message, [switch]$Progress)
+
+    if ($interactiveOutput -and -not $env:NO_COLOR) {
+        Write-Host $Message -ForegroundColor Cyan
+    } else {
+        Write-Host $Message
+    }
+    if ($interactiveOutput) {
+        if ($Progress) {
+            Write-Progress -Id 1 -Activity "Installing Jmix CLI" -Status $Message
+        } else {
+            Write-Progress -Id 1 -Activity "Installing Jmix CLI" -Completed
+        }
+    }
+}
+
 if ($env:OS -ne "Windows_NT") {
     throw "Jmix CLI installer: install.ps1 supports Windows only."
 }
@@ -46,11 +66,13 @@ function Copy-ReleaseAsset {
         [Parameter(Mandatory = $true)][string]$Destination
     )
 
-    Write-Host "Downloading $Name..."
+    Write-InstallStatus "Downloading $Name..." -Progress
     if (Test-Path -LiteralPath $ReleaseBaseUrl -PathType Container) {
         Copy-Item -LiteralPath (Join-Path $ReleaseBaseUrl $Name) -Destination $Destination
     } else {
         $url = $ReleaseBaseUrl.TrimEnd("/") + "/" + $Name
+        # Keep Invoke-WebRequest's own byte progress quiet in logs as well.
+        if (-not $interactiveOutput) { $ProgressPreference = "SilentlyContinue" }
         Invoke-WebRequest -UseBasicParsing -Uri $url -OutFile $Destination
     }
 }
@@ -60,6 +82,7 @@ try {
     Copy-ReleaseAsset -Name $archiveName -Destination $archiveFile
     Copy-ReleaseAsset -Name $checksumName -Destination $checksumFile
 
+    Write-InstallStatus "Verifying $archiveName..." -Progress
     $checksumContent = Get-Content -LiteralPath $checksumFile -Raw
     if ([string]::IsNullOrWhiteSpace($checksumContent)) {
         throw "Jmix CLI installer: invalid checksum file for $archiveName."
@@ -89,6 +112,7 @@ try {
         $extractDir = Join-Path $tempDir "extracted"
         New-Item -ItemType Directory -Path $extractDir | Out-Null
         New-Item -ItemType Directory -Force -Path $versionsDir | Out-Null
+        Write-InstallStatus "Extracting $archiveName..." -Progress
         Expand-Archive -LiteralPath $archiveFile -DestinationPath $extractDir
         $imageDir = Join-Path $extractDir "jmix"
         if (-not (Test-Path -LiteralPath (Join-Path $imageDir "jmix.exe") -PathType Leaf)) {
@@ -124,7 +148,7 @@ try {
     Set-Content -LiteralPath (Join-Path $InstallRoot "bin-dir") -Value $BinDir -Encoding UTF8
 
     if ($installed) {
-        Write-Host "Installed Jmix CLI at $commandPath"
+        Write-InstallStatus "Installed Jmix CLI at $commandPath"
     }
 
     if (-not $SkipPathUpdate -and $env:JMIX_CLI_SKIP_PATH_UPDATE -ne "1") {
@@ -140,6 +164,9 @@ try {
         $env:Path = "$BinDir;$env:Path"
     }
 } finally {
+    if ($interactiveOutput) {
+        Write-Progress -Id 1 -Activity "Installing Jmix CLI" -Completed
+    }
     if (Test-Path -LiteralPath $tempDir) {
         Remove-Item -LiteralPath $tempDir -Recurse -Force
     }
@@ -149,5 +176,5 @@ if ($NoRun -or $env:JMIX_CLI_NO_RUN -eq "1") {
     return
 }
 
-Write-Host "Starting the Jmix project wizard..."
+Write-InstallStatus "Starting the Jmix project wizard..."
 & $launcher @CliArguments

install.sh

@@ -7,6 +7,21 @@ readonly RELEASE_BASE_URL="${JMIX_CLI_RELEASE_BASE_URL:-$DEFAULT_RELEASE_BASE_UR
 readonly INSTALL_ROOT="${JMIX_CLI_INSTALL_ROOT:-${XDG_DATA_HOME:-$HOME/.local/share}/jmix-cli}"
 readonly BIN_DIR="${JMIX_CLI_BIN_DIR:-$HOME/.local/bin}"
 
+interactive_output=false
+if [[ -t 1 && -t 2 && "${TERM:-dumb}" != "dumb" && -z "${CI:-}" ]]; then
+    interactive_output=true
+fi
+
+status() {
+    local color="$1"
+    shift
+    if [[ "$interactive_output" == true && -z "${NO_COLOR:-}" ]]; then
+        printf '\033[1;%sm%s\033[0m\n' "$color" "$*"
+    else
+        printf '%s\n' "$*"
+    fi
+}
+
 fail() {
     echo "Jmix CLI installer: $*" >&2
     exit 1
@@ -45,10 +60,14 @@ download_asset() {
     local destination="$2"
     local base="${RELEASE_BASE_URL%/}"
 
-    echo "Downloading $name..."
+    status 36 "Downloading $name..."
     case "$base" in
         http://* | https://* | file://*)
-            curl -fsSL "$base/$name" -o "$destination"
+            local progress_options=(-s)
+            if [[ "$interactive_output" == true ]]; then
+                progress_options=(--progress-bar)
+            fi
+            curl -fSL "${progress_options[@]}" "$base/$name" -o "$destination"
             ;;
         *)
             cp "$base/$name" "$destination"
@@ -61,6 +80,7 @@ checksum_file="$temp_dir/$checksum_name"
 download_asset "$archive_name" "$archive_file"
 download_asset "$checksum_name" "$checksum_file"
 
+status 36 "Verifying $archive_name..."
 expected_checksum="$(awk 'NR == 1 { print tolower($1) }' "$checksum_file")"
 [[ "$expected_checksum" =~ ^[[:xdigit:]]{64}$ ]] || fail "invalid checksum file for $archive_name."
 
@@ -98,6 +118,7 @@ else
     [[ ! -e "$version_dir" ]] || fail "incomplete installation found at $version_dir."
     extract_dir="$temp_dir/extracted"
     mkdir -p "$extract_dir" "$versions_dir"
+    status 36 "Extracting $archive_name..."
     tar -xzf "$archive_file" -C "$extract_dir"
     [[ -x "$extract_dir/$image_name/$launcher_relative" ]] || fail "release archive has an unexpected layout."
     : > "$extract_dir/$image_name/$INSTALL_MARKER"
@@ -136,7 +157,7 @@ mkdir -p "$INSTALL_ROOT"
 printf '%s\n' "$BIN_DIR" > "$INSTALL_ROOT/bin-dir"
 
 if [[ "$installed" == true ]]; then
-    echo "Installed Jmix CLI at $command_path"
+    status 32 "Installed Jmix CLI at $command_path"
 fi
 case ":$PATH:" in
     *":$BIN_DIR:"*) ;;
@@ -147,7 +168,7 @@ if [[ "${JMIX_CLI_NO_RUN:-0}" == "1" ]]; then
     exit 0
 fi
 
-echo "Starting the Jmix project wizard..."
+status 36 "Starting the Jmix project wizard..."
 cleanup
 trap - EXIT HUP INT TERM
 if { exec 3</dev/tty; } 2>/dev/null; then

tests/test-install.ps1

@@ -26,6 +26,13 @@ try {
     if ($firstOutput -notmatch "Downloading $([regex]::Escape($archive.Name))\.\.\.") {
         throw "Installer did not report the release download."
     }
+    if ($firstOutput -notmatch "Verifying $([regex]::Escape($archive.Name))" -or
+        $firstOutput -notmatch "Extracting $([regex]::Escape($archive.Name))") {
+        throw "Installer did not report verification and extraction."
+    }
+    if ($firstOutput.Contains([string][char]27)) {
+        throw "Redirected installer output contains terminal escape sequences."
+    }
 
     $commandPath = Join-Path $binDir "jmix.cmd"
     if (-not (Test-Path -LiteralPath $commandPath -PathType Leaf)) {

tests/test-install.sh

@@ -37,6 +37,9 @@ run_installer() {
 first_output="$(run_installer "$release_dir")"
 [[ "$first_output" == *"Downloading $archive_name..."* ]]
 [[ "$first_output" == *"Installed Jmix CLI"* ]]
+[[ "$first_output" == *"Verifying $archive_name..."* ]]
+[[ "$first_output" == *"Extracting $archive_name..."* ]]
+[[ "$first_output" != *$'\033'* && "$first_output" != *$'\r'* ]]
 [[ -x "$temp_dir/bin/jmix" ]]
 # Self-update reads these; never let the tests reach the real release feed.
 export JMIX_CLI_NO_AUTO_UPDATE=1
@@ -76,6 +79,12 @@ start_output="$(
 [[ "$start_output" == *"Starting the Jmix project wizard"* ]]
 [[ "$start_output" == *"Jmix CLI"* ]]
 
+# URL downloads use curl too; redirected output must stay plain and quiet.
+url_output="$(run_installer "file://$release_dir" 2>&1)"
+[[ "$url_output" == *"already up to date"* ]]
+[[ "$url_output" != *$'\033'* && "$url_output" != *$'\r'* ]]
+[[ "$url_output" != *"100.0%"* ]]
+
 tampered_dir="$temp_dir/tampered-release"
 mkdir -p "$tampered_dir"
 cp "$release_dir/$archive_name" "$release_dir/$archive_name.sha256" "$tampered_dir/"