unsloth/tests/studio/test_node_decision.ps1
Michael Han 6d8c18cd1a
Replace standalone Studio wording with Unsloth (#7221)
* Replace standalone Studio wording with Unsloth

Replace the single word Studio with Unsloth wherever it is used as
shorthand for Unsloth Studio in docs, CLI output, UI strings, i18n
locales, workflow display names, comments and docstrings.

Kept unchanged: the full name Unsloth Studio, third party product
names (LM Studio, Visual Studio, Mac Studio), feature names
(Recipe Studio, Fine-tuning Studio and its translations), and all
identifiers such as env vars, commands, paths and filenames.

* Address review feedback on the Studio wording rename

Use "an" before Unsloth where the rename left the article as "a".
Restore the split brand where Unsloth and Studio render as two halves
of the full product name: the onboarding sidebar subtitle and the
IPv6 localhost warning. Scope two messages to the full name Unsloth
Studio where plain Unsloth was misleading: the AMD README bullet and
the CLI studio setup error.
2026-07-19 00:47:04 -07:00

83 lines
4.7 KiB
PowerShell

#!/usr/bin/env pwsh
# Unit test for setup.ps1's Get-NodeDecision (the isolated-Node source picker:
# system | bundled | skip). Pure helper, AST-extracted and run in-process -- no
# Node/npm/network needed. Also serves as a setup.ps1 parse/syntax gate.
# Run: pwsh -NoProfile -File tests/studio/test_node_decision.ps1
$ErrorActionPreference = "Stop"
$setupPath = [System.IO.Path]::Combine($PSScriptRoot, "..", "..", "studio", "setup.ps1")
$setupPath = (Resolve-Path $setupPath).Path
$source = Get-Content -Raw -Path $setupPath
$tokens = $null; $errors = $null
$ast = [System.Management.Automation.Language.Parser]::ParseFile($setupPath, [ref]$tokens, [ref]$errors)
if ($errors) { $errors | ForEach-Object { $_.ToString() }; throw "setup.ps1 has parse errors" }
$fn = $ast.FindAll({ param($n)
$n -is [System.Management.Automation.Language.FunctionDefinitionAst] -and $n.Name -eq "Get-NodeDecision"
}, $true)
if ($fn.Count -ne 1) { throw "expected exactly one Get-NodeDecision in setup.ps1, found $($fn.Count)" }
Invoke-Expression $fn[0].Extent.Text
$failures = 0
function Check($name, $cond) {
if ($cond) { Write-Host " PASS $name" }
else { Write-Host " FAIL $name" -ForegroundColor Red; $script:failures++ }
}
function D($node, $npm, $skip) { Get-NodeDecision -NodeVersion $node -NpmVersion $npm -SkipInstall $skip }
Write-Host "Get-NodeDecision"
# system
Check "node22 + npm11 -> system" ((D "v22.17.1" "11.13.0" "0") -eq "system")
Check "node20.19 + npm11 -> system" ((D "v20.19.0" "11.0.0" "0") -eq "system")
Check "node24 + npm11 -> system" ((D "v24.17.0" "11.13.0" "0") -eq "system")
Check "node23 + npm11 -> system" ((D "v23.5.0" "11.0.0" "0") -eq "system")
# bundled (the reported bug: fine Node, stale npm)
Check "node22 + npm10 -> bundled" ((D "v22.17.1" "10.9.2" "0") -eq "bundled")
Check "node18 -> bundled" ((D "v18.20.0" "11.0.0" "0") -eq "bundled")
Check "node22.11 -> bundled" ((D "v22.11.0" "11.0.0" "0") -eq "bundled")
Check "node20.18 -> bundled" ((D "v20.18.0" "11.0.0" "0") -eq "bundled")
Check "node21 (odd) -> bundled" ((D "v21.7.0" "11.0.0" "0") -eq "bundled")
Check "missing -> bundled" ((D "" "" "0") -eq "bundled")
# skip flag
Check "npm10 + skip -> skip" ((D "v22.17.1" "10.9.2" "1") -eq "skip")
Check "missing + skip -> skip" ((D "" "" "1") -eq "skip")
Check "good + skip -> system" ((D "v22.17.1" "11.13.0" "1") -eq "system")
# Structural guards: OXC can need Node when frontend is skipped, custom roots
# must exist before NodeParent creation, bundled Node must isolate npm, and the
# reuse (system) arm must touch nothing -- no prefix pin, no global install.
$nodeSourceOffset = $source.IndexOf('$NodeSource = Get-NodeDecision')
$skipFrontendBranchOffset = $source.IndexOf('} elseif ($SkipFrontend) {')
$customHomeErrorOffset = $source.IndexOf('UNSLOTH_STUDIO_HOME/STUDIO_HOME=$NodeOverride does not exist')
$nodeParentMkdirOffset = $source.IndexOf('New-Item -ItemType Directory -Force -Path $NodeParent')
$npmPrefixOffset = $source.IndexOf('$env:NPM_CONFIG_PREFIX = $NodeDir')
$nodePathClearOffset = $source.IndexOf('Remove-Item Env:NODE_PATH')
$bundledBranchOffset = $source.IndexOf('} elseif ($NodeSource -eq "bundled") {')
$systemArmOffset = $source.IndexOf('$SysNodeVersion | npm $SysNpmVersion (system)')
$globalBunOffset = $source.IndexOf('npm install -g bun')
Check "NodeSource initialized before SKIP_STUDIO_FRONTEND branch" (
$nodeSourceOffset -ge 0 -and $skipFrontendBranchOffset -ge 0 -and $nodeSourceOffset -lt $skipFrontendBranchOffset
)
Check "custom Unsloth home validated before Node parent creation" (
$customHomeErrorOffset -ge 0 -and $nodeParentMkdirOffset -ge 0 -and $customHomeErrorOffset -lt $nodeParentMkdirOffset
)
Check "bundled Node pins npm prefix and clears NODE_PATH" (
$npmPrefixOffset -ge 0 -and $nodePathClearOffset -ge 0 -and $npmPrefixOffset -lt $nodePathClearOffset
)
# Symmetric to tests/sh/test_system_node_readonly.sh: the prefix pin and the only
# global install (bun) sit between the bundled-branch marker and the system arm,
# i.e. inside bundled, so reusing a good system Node mutates nothing.
Check "npm prefix pin lives in the bundled branch, not the system arm" (
$bundledBranchOffset -ge 0 -and $systemArmOffset -ge 0 -and
$bundledBranchOffset -lt $npmPrefixOffset -and $npmPrefixOffset -lt $systemArmOffset
)
Check "global bun install lives in the bundled branch, not the system arm" (
$bundledBranchOffset -ge 0 -and $systemArmOffset -ge 0 -and
$bundledBranchOffset -lt $globalBunOffset -and $globalBunOffset -lt $systemArmOffset
)
Write-Host ""
if ($failures -gt 0) { Write-Host "$failures check(s) FAILED" -ForegroundColor Red; exit 1 }
Write-Host "All checks passed" -ForegroundColor Green