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.

6.9 KB
Raw Blame
# 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