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.
Python agentaichatgptdeepseekfine-tuninggemmaimage-generationllamallmllmsopenaipythonqwenreinforcement-learningself-hostedstable-diffusiontext-to-speechttsuiunsloth
# SPDX-License-Identifier: AGPL-3.0-only
# Copyright 2026-present the Unsloth AI Inc. team. All rights reserved. See /studio/LICENSE.AGPL-3.0
"""The printed reset-password command must run; a wrong executable strands a locked-out user."""
from __future__ import annotations
import ast
import importlib.util
import os
import sys
from pathlib import Path
import pytest
_BACKEND = Path(__file__).resolve().parents[1]
if str(_BACKEND) not in sys.path:
sys.path.insert(0, str(_BACKEND))
@pytest.fixture(scope = "module")
def auth():
"""Load routes/auth.py by path so tests run without the full router stack, which pulls in structlog."""
route_path = _BACKEND / "routes" / "auth.py"
spec = importlib.util.spec_from_file_location("_reset_command_auth_route", route_path)
assert spec is not None and spec.loader is not None
module = importlib.util.module_from_spec(spec)
spec.loader.exec_module(module)
return module
@pytest.fixture
def windows(monkeypatch, auth):
monkeypatch.setattr(auth.os, "name", "nt")
def test_a_venv_install_gets_the_isolated_module_route(auth, monkeypatch, windows):
"""-I only inside the interpreter prefix: it drops the cwd so a local unsloth_cli cannot shadow it."""
monkeypatch.setattr(
auth.sys, "executable", r"C:\Users\dan\.unsloth\studio\unsloth_studio\Scripts\python.exe"
)
monkeypatch.setattr(auth, "_cli_is_inside", lambda _prefix: True)
command = auth._reset_password_command()
assert command.endswith("-I -m unsloth_cli studio reset-password")
assert "unsloth.exe" not in command
def test_a_user_site_install_is_not_told_to_isolate_itself(auth, monkeypatch, windows):
"""-I implies -s, which hides the user site; a --user install must not be told to run with -I."""
monkeypatch.setattr(auth.sys, "executable", r"C:\Python313\python.exe")
monkeypatch.setattr(auth, "_cli_is_inside", lambda _prefix: False)
command = auth._reset_password_command()
assert " -I " not in command
assert "-m unsloth_cli" not in command
assert auth._CLI_BOOTSTRAP in command
assert command.endswith(" studio reset-password")
# One pair of double quotes wraps it for cmd and PowerShell, so the bootstrap must have none.
assert '"' not in auth._CLI_BOOTSTRAP
assert command.count('"') == 2
assert "unsloth.exe" not in command
def test_the_bootstrap_matches_the_one_the_cli_uses(auth):
"""The bootstrap string must match the CLI's copy; a drift would change argv[0] handling."""
repo_root = _BACKEND.parents[1]
studio_py = (repo_root / "unsloth_cli" / "commands" / "studio.py").read_text(encoding = "utf-8")
canonical = None
for node in ast.walk(ast.parse(studio_py)):
if isinstance(node, ast.Assign) and any(
isinstance(target, ast.Name) and target.id == "_WINDOWS_CLI_ENTRYPOINT"
for target in node.targets
):
canonical = ast.literal_eval(node.value)
assert canonical, "_WINDOWS_CLI_ENTRYPOINT is gone from unsloth_cli/commands/studio.py"
assert auth._CLI_BOOTSTRAP == canonical
def test_a_spaced_interpreter_path_still_falls_through_to_the_cmd_shim(auth, monkeypatch, windows):
"""Unchanged: a quoted path is written differently in cmd and PowerShell."""
monkeypatch.setattr(auth.sys, "executable", r"C:\Program Files\Python313\python.exe")
monkeypatch.setattr(auth, "_cli_is_inside", lambda _prefix: True)
assert auth._reset_password_command() == "unsloth.cmd studio reset-password"
def test_the_prefix_check_locates_rather_than_imports(auth, tmp_path, monkeypatch):
"""A package outside the prefix must answer False, and a missing one too."""
inside = tmp_path / "venv" / "Lib" / "site-packages" / "unsloth_cli"
inside.mkdir(parents = True)
(inside / "__init__.py").write_text("", encoding = "utf-8")
class _Spec:
def __init__(self, origin):
self.origin = origin
monkeypatch.setattr(
auth.importlib.util, "find_spec", lambda _name: _Spec(str(inside / "__init__.py"))
)
assert auth._cli_is_inside(str(tmp_path / "venv"))
assert not auth._cli_is_inside(str(tmp_path / "elsewhere"))
# A namespace package has no origin and a missing spec is None; neither shows isolation.
monkeypatch.setattr(auth.importlib.util, "find_spec", lambda _name: _Spec(None))
assert not auth._cli_is_inside(str(tmp_path / "venv"))
monkeypatch.setattr(auth.importlib.util, "find_spec", lambda _name: None)
assert not auth._cli_is_inside(str(tmp_path / "venv"))
@pytest.mark.skipif(
os.name == "nt",
reason = "spoofs os.name=posix, but tmp_path is then a real Windows path and shlex.quote "
"escapes its backslashes, so the assertion compares POSIX quoting against a Windows path",
)
def test_posix_is_untouched(auth, monkeypatch, tmp_path):
"""The console script is what a POSIX user should run; nothing here changes."""
monkeypatch.setattr(auth.os, "name", "posix")
bin_dir = tmp_path / "bin"
bin_dir.mkdir()
(bin_dir / "unsloth").write_text("", encoding = "utf-8")
monkeypatch.setattr(auth.sys, "executable", str(bin_dir / "python"))
assert auth._reset_password_command() == f"{bin_dir / 'unsloth'} studio reset-password"
def test_the_console_warnings_name_the_absolute_command(monkeypatch, tmp_path):
"""Console warnings must print the absolute command, since a user's shell may lack unsloth on PATH."""
run_py = (Path(__file__).resolve().parents[1] / "run.py").read_text(encoding = "utf-8")
tree = ast.parse(run_py)
calls = sum(
isinstance(node, ast.ImportFrom)
and node.module == "routes.auth"
and any(a.name == "_reset_password_command" for a in node.names)
for node in ast.walk(tree)
)
assert calls >= 2, (
"run.py's public-bind and reachable-bind warnings must print the absolute reset command; "
"without a production caller the helper is dead and the 401's PATH form is the only hint "
"a user ever sees"
)
assert (
"`unsloth studio reset-password`. Unsloth shuts down" not in run_py
), "the public-bind warning is back to the bare PATH form"
def test_the_unauthenticated_401_body_names_no_host_path(auth, monkeypatch, tmp_path):
"""The 401 login body names no host path, since any open page can read it under wildcard CORS."""
monkeypatch.setattr(auth.os, "name", "posix")
bin_dir = tmp_path / "home" / "alice" / "unsloth" / ".venv" / "bin"
bin_dir.mkdir(parents = True)
(bin_dir / "unsloth").write_text("", encoding = "utf-8")
monkeypatch.setattr(auth.sys, "executable", str(bin_dir / "python"))
assert str(bin_dir) in auth._reset_password_command()
for multi_user in (False, True):
monkeypatch.setattr(auth.policy, "installation_is_multi_user", lambda: multi_user)
detail = auth._login_failure_detail()
assert str(bin_dir) not in detail, multi_user
assert "alice" not in detail, multi_user
assert "unsloth studio reset-password" in detail, multi_user