Skip to content

Local UI to run and train LLMs and diffusion models. Supports GGUF, MLX, Qwen3.8, DeepSeek-V4.1, MiniMax-H3, Gemma 4, FLUX and more.

11.3 KB
Raw Blame
<#
    Pester tests for Write-StudioLine / step / substep / Write-StudioStdoutMirror in setup.ps1.
    Invariant: exactly one sink per line (console handle when redirected, else Write-Host),
    so the desktop log does not print each step twice or split a label across lines.
    Functions are extracted and dot-sourced; a missing one fails loudly.
#>

BeforeAll {
    . (Join-Path $PSScriptRoot 'Get-FunctionSource.ps1')

    $candidates = @(
        $env:SETUP_PS1_PATH,
        (Join-Path $PSScriptRoot '..\..\studio\setup.ps1')
    ) | Where-Object { $_ }
    $script:SetupPs1 = $candidates | Where-Object { Test-Path -LiteralPath $_ } | Select-Object -First 1
    if (-not $script:SetupPs1) { throw "Could not locate studio/setup.ps1 (set SETUP_PS1_PATH)." }
    Write-Host "setup.ps1 under test: $script:SetupPs1"

    $script:InstallPs1 = Join-Path $PSScriptRoot '..\..\install.ps1'

    foreach ($fn in @('Get-StudioAnsi', 'Write-StudioLine', 'Write-StudioStdoutMirror', 'step', 'substep')) {
        $src = Get-FunctionSource -Path $script:SetupPs1 -Name $fn
        if (-not $src) { throw "Function '$fn' not found in $script:SetupPs1 - cannot test the real code." }
        . ([scriptblock]::Create($src))
    }

    function Invoke-CapturingConsoleOut {
        param(
            [Parameter(Mandatory = $true)][scriptblock]$Body,
            [Parameter(Mandatory = $true)][bool]$Redirected
        )
        $script:StudioStdoutRedirected = $Redirected
        $previous = [Console]::Out
        $writer = New-Object System.IO.StringWriter
        try {
            [Console]::SetOut($writer)
            # 6>&1 folds Write-Host into the pipeline so a stray one on the redirected path is caught.
            $hostRecords = & $Body 6>&1
        } finally {
            [Console]::SetOut($previous)
        }
        [pscustomobject]@{
            Console = $writer.ToString()
            HostRecordCount = @($hostRecords).Count
            HostRecords = @(@($hostRecords) | ForEach-Object { "$_" })
        }
    }

    # The leading comma is load-bearing: `return @($x)` unrolls a one-element array to a
    # scalar string, whose [0] is its first character.
    function Get-EmittedLines {
        param([string]$Text)
        if ([string]::IsNullOrEmpty($Text)) { return , @() }
        return , @($Text -split "`r?`n" | Where-Object { $_ -ne '' })
    }

    # Strip comments first: the scripts under test mention -NoNewline in prose.
    function Get-CodeWithoutComments {
        param([string]$Source)
        $stripped = $Source -replace '(?m)#.*$', ''
        return $stripped
    }
}

Describe 'Write-StudioLine is the single sink for every non-step line' {
    BeforeEach {
        $script:StudioVtOk = $false
        $env:NO_COLOR = $null
    }

    It 'writes to the console handle, and nothing to Write-Host, when redirected' {
        $r = Invoke-CapturingConsoleOut -Redirected $true -Body {
            Write-StudioLine "plain"
            Write-StudioLine "colored" -ForegroundColor Red
        }
        (Get-EmittedLines $r.Console) | Should -Be @('plain', 'colored')
        $r.HostRecordCount | Should -Be 0
    }

    It 'keeps the banner emoji and the U+2500 rule intact when redirected' {
        $rule = [string]::new([char]0x2500, 52)
        $sloth = [char]::ConvertFromUtf32(0x1F9A5)
        $r = Invoke-CapturingConsoleOut -Redirected $true -Body {
            Write-StudioLine ("  " + $sloth + " Unsloth Studio Setup") -ForegroundColor Green
            Write-StudioLine "  $rule" -ForegroundColor DarkGray
        }
        $lines = Get-EmittedLines $r.Console
        $lines.Count | Should -Be 2
        $lines[0] | Should -Be "  $sloth Unsloth Studio Setup"
        $lines[1] | Should -Be "  $rule"
    }

    It 'emits a blank line as a blank line, not as nothing' {
        $r = Invoke-CapturingConsoleOut -Redirected $true -Body { Write-StudioLine "" }
        $r.Console | Should -Not -BeNullOrEmpty
        $r.Console.Trim() | Should -BeNullOrEmpty
    }

    It 'never leaks an ANSI escape onto the redirected sink' {
        $r = Invoke-CapturingConsoleOut -Redirected $true -Body {
            Write-StudioLine "warning" -ForegroundColor Yellow
        }
        $r.Console | Should -Not -Match ([regex]::Escape([char]27))
    }

    It 'stays on Write-Host, message intact, when attached to a console' {
        $r = Invoke-CapturingConsoleOut -Redirected $false -Body {
            Write-StudioLine "plain"
            Write-StudioLine "colored" -ForegroundColor Red
        }
        $r.Console | Should -BeNullOrEmpty
        $r.HostRecordCount | Should -Be 2
        $r.HostRecords | Should -Be @('plain', 'colored')
    }

    It 'still prints an interactive blank line' {
        $r = Invoke-CapturingConsoleOut -Redirected $false -Body { Write-StudioLine "" }
        $r.HostRecordCount | Should -Be 1
    }

    It 'passes -ForegroundColor through only when the caller supplied one' {
        # An empty color cannot bind to ConsoleColor and would abort the install under "Stop".
        { Invoke-CapturingConsoleOut -Redirected $false -Body {
            Write-StudioLine "no color here"
        } } | Should -Not -Throw
    }
}

Describe 'step / substep emit exactly one copy when stdout is redirected' {
    BeforeEach {
        $script:StudioVtOk = $false
        $env:NO_COLOR = $null
    }

    It 'emits a step once, with label and value on the SAME line' {
        $r = Invoke-CapturingConsoleOut -Redirected $true -Body {
            step "gpu" "none (chat-only / GGUF)"
        }
        $lines = Get-EmittedLines $r.Console
        $lines.Count | Should -Be 1
        $lines[0] | Should -Be "  gpu            none (chat-only / GGUF)"
    }

    It 'emits a substep once' {
        $r = Invoke-CapturingConsoleOut -Redirected $true -Body {
            substep "installing OXC validator runtime..."
        }
        (Get-EmittedLines $r.Console).Count | Should -Be 1
    }

    It 'writes NOTHING through Write-Host when redirected (the second copy)' {
        $r = Invoke-CapturingConsoleOut -Redirected $true -Body {
            step "long paths" "enabled"
            substep "detail"
        }
        $r.HostRecordCount | Should -Be 0
    }

    It 'keeps one line per step across a realistic run' {
        $r = Invoke-CapturingConsoleOut -Redirected $true -Body {
            step "gpu" "none (chat-only / GGUF)"
            step "long paths" "enabled"
            step "git" "git version 2.53.0.windows.2"
            substep "setting up Python environment..."
        }
        (Get-EmittedLines $r.Console).Count | Should -Be 4
    }

    It 'truncates an over-long label to the 15-column field without wrapping' {
        $r = Invoke-CapturingConsoleOut -Redirected $true -Body {
            step "an-extremely-long-label" "value"
        }
        $lines = Get-EmittedLines $r.Console
        $lines.Count | Should -Be 1
        $lines[0] | Should -Be "  an-extremely-lovalue"
    }
}

Describe 'step / substep stay on Write-Host when attached to a console' {
    BeforeEach {
        $script:StudioVtOk = $false
        $env:NO_COLOR = $null
    }

    It 'writes nothing to the console handle when NOT redirected' {
        $r = Invoke-CapturingConsoleOut -Redirected $false -Body {
            step "gpu" "none (chat-only / GGUF)"
        }
        $r.Console | Should -BeNullOrEmpty
    }

    It 'emits a step as a SINGLE Write-Host record (not -NoNewline label + value)' {
        $r = Invoke-CapturingConsoleOut -Redirected $false -Body {
            step "gpu" "none (chat-only / GGUF)"
        }
        $r.HostRecordCount | Should -Be 1
    }

    It 'emits a substep as a single Write-Host record' {
        $r = Invoke-CapturingConsoleOut -Redirected $false -Body {
            substep "detail"
        }
        $r.HostRecordCount | Should -Be 1
    }

    It 'still emits one record on the ANSI path' {
        $script:StudioVtOk = $true
        $r = Invoke-CapturingConsoleOut -Redirected $false -Body {
            step "gpu" "ok"
            substep "detail"
        }
        $r.HostRecordCount | Should -Be 2
    }

    It 'still emits one record with NO_COLOR set' {
        $script:StudioVtOk = $true
        $env:NO_COLOR = '1'
        try {
            $r = Invoke-CapturingConsoleOut -Redirected $false -Body {
                step "gpu" "ok"
            }
            $r.HostRecordCount | Should -Be 1
        } finally {
            $env:NO_COLOR = $null
        }
    }
}

Describe 'Write-StudioStdoutMirror honors the resolved sink' {
    It 'writes when the sink says redirected' {
        $r = Invoke-CapturingConsoleOut -Redirected $true -Body {
            Write-StudioStdoutMirror "hello"
        }
        (Get-EmittedLines $r.Console) | Should -Be @('hello')
    }

    It 'stays silent when the sink says interactive' {
        $r = Invoke-CapturingConsoleOut -Redirected $false -Body {
            Write-StudioStdoutMirror "hello"
        }
        $r.Console | Should -BeNullOrEmpty
    }
}

Describe 'Source contracts that keep the fix from regressing' {
    It 'resolves the redirected sink once, into a script-scoped variable' {
        $source = Get-Content -Raw -LiteralPath $script:SetupPs1
        $source | Should -Match '\$script:StudioStdoutRedirected\s*=\s*\[Console\]::IsOutputRedirected'
    }

    It 'no longer calls IsOutputRedirected from inside the mirror' {
        # Resolved once up front, so the sink cannot disagree with the branch step/substep took.
        $src = Get-FunctionSource -Path $script:SetupPs1 -Name 'Write-StudioStdoutMirror'
        $src | Should -Not -Match 'IsOutputRedirected'
    }

    It 'does not use -NoNewline in setup.ps1 step (record boundaries become newlines)' {
        $src = Get-FunctionSource -Path $script:SetupPs1 -Name 'step'
        (Get-CodeWithoutComments $src) | Should -Not -Match '-NoNewline'
    }

    It 'does not use -NoNewline in install.ps1 step either' {
        $src = Get-FunctionSource -Path $script:InstallPs1 -Name 'step'
        $src | Should -Not -BeNullOrEmpty
        (Get-CodeWithoutComments $src) | Should -Not -Match '-NoNewline'
    }

    It 'defines Write-StudioLine in install.ps1 too, with the same body' {
        # install.ps1 cannot dot-source setup.ps1, so it holds a copy that must not drift.
        $setup = ((Get-FunctionSource -Path $script:SetupPs1 -Name 'Write-StudioLine') -replace '\s+', ' ').Trim()
        $install = ((Get-FunctionSource -Path $script:InstallPs1 -Name 'Write-StudioLine') -replace '\s+', ' ').Trim()
        $setup | Should -Not -BeNullOrEmpty
        $install | Should -Be $setup
    }

    It 'defines Write-StudioLine before the first line either script prints' {
        # A top-level call above the definition fails; comments are stripped since both name it in prose.
        foreach ($path in @($script:SetupPs1, $script:InstallPs1)) {
            $source = Get-CodeWithoutComments (Get-Content -Raw -LiteralPath $path)
            $definition = $source.IndexOf('function Write-StudioLine')
            $definition | Should -BeGreaterThan -1
            $source.IndexOf('Write-StudioLine') | Should -Be ($definition + 'function '.Length)
        }
    }

    It 'sets the UTF-8 console encoding in both entry scripts' {
        foreach ($path in @($script:SetupPs1, $script:InstallPs1)) {
            $source = Get-Content -Raw -LiteralPath $path
            $source | Should -Match '\[Console\]::OutputEncoding\s*=\s*\$_UnslothUtf8NoBom'
            $source | Should -Match "PYTHONUTF8"
            $source | Should -Match "PYTHONIOENCODING"
        }
    }
}