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.

7.2 KB
Raw Blame
# SPDX-License-Identifier: AGPL-3.0-only
# Copyright 2026-present the Unsloth AI Inc. team. All rights reserved.

import fnmatch
import os
import re
import subprocess
import zipfile
from fnmatch import fnmatchcase
from pathlib import Path

import pytest

REPO_ROOT = Path(__file__).resolve().parents[3]

_PRUNED = {".git", "__pycache__", "node_modules", "dist", "build", "venv", ".venv"}


def _finder_patterns(field):
    text = (REPO_ROOT / "pyproject.toml").read_text(encoding = "utf-8")
    finder = text.split("[tool.setuptools.packages.find]", 1)[1].split("\n[", 1)[0]
    match = re.search(rf"^{field}\s*=\s*\[(.*?)\]", finder, re.MULTILINE | re.DOTALL)
    assert match, f"no packages.find {field} list in pyproject.toml"
    return re.findall(r'["\']([^"\']+)["\']', match.group(1))


def _exclude_package_data():
    """The [tool.setuptools.exclude-package-data] table, as {package: patterns}."""
    text = (REPO_ROOT / "pyproject.toml").read_text(encoding = "utf-8")
    section = text.split("[tool.setuptools.exclude-package-data]", 1)
    assert len(section) == 2, "no exclude-package-data table in pyproject.toml"
    body = section[1].split("\n[", 1)[0]
    table = {}
    # DOTALL: a multi-line array read as {} would mean 'nothing excluded'.
    for entry in re.finditer(
        r'^\s*"?([\w.*]+)"?\s*=\s*\[(.*?)\]',
        body,
        re.MULTILINE | re.DOTALL,
    ):
        # "*" is setuptools' pyproject spelling of the all-packages key.
        key = "" if entry.group(1) == "*" else entry.group(1)
        table[key] = re.findall(r'["\']([^"\']+)["\']', entry.group(2))
    return table


def _discovered_packages():
    """Packages under studio/, resolved the way setuptools' PackageFinder does."""
    include = _finder_patterns("include")
    exclude = _finder_patterns("exclude")
    packages = set()
    for dirpath, dirnames, filenames in os.walk(REPO_ROOT / "studio"):
        dirnames[:] = [d for d in dirnames if d not in _PRUNED]
        if "__init__.py" not in filenames:
            continue
        name = str(Path(dirpath).relative_to(REPO_ROOT)).replace(os.sep, ".")
        if not any(fnmatchcase(name, pat) for pat in include):
            continue
        if any(fnmatchcase(name, pat) for pat in exclude):
            continue
        packages.add(name)
    assert "studio.backend" in packages, "studio.backend should always be packaged"
    return packages


def _tracked_files():
    try:
        out = subprocess.run(
            ["git", "ls-files", "studio"],
            cwd = REPO_ROOT,
            capture_output = True,
            text = True,
            check = True,
        ).stdout
    except (OSError, subprocess.CalledProcessError):  # pragma: no cover - no git checkout
        pytest.skip("not a git checkout, cannot resolve the setuptools-scm file list")
    return [line for line in out.splitlines() if line]


def _wheel_payload():
    """Files build_py stages, minus exclude-package-data's veto of include-package-data ancestor leaks."""
    package_dirs = {name.replace(".", "/"): name for name in _discovered_packages()}
    excluded = _exclude_package_data()
    shipped = []
    for path in _tracked_files():
        parent = os.path.dirname(path)
        while parent and parent not in package_dirs:
            parent = os.path.dirname(parent)
        if parent not in package_dirs:
            continue
        patterns = excluded.get("", []) + excluded.get(package_dirs[parent], [])
        if any(fnmatch.filter([path], f"{parent}/{pat}") for pat in patterns):
            continue
        shipped.append(path)
    return shipped


def test_generated_compiled_caches_are_excluded():
    patterns = _finder_patterns("exclude")

    for package in ("unsloth_compiled_cache", "studio.backend.unsloth_compiled_cache"):
        assert any(fnmatchcase(package, pattern) for pattern in patterns)


def test_backend_test_suites_stay_out_of_the_wheel():
    # With include-package-data they would return as package data of studio.backend.
    leaked = [
        path
        for path in _wheel_payload()
        if path.startswith("studio/backend/") and "/tests/" in path
    ]
    assert not leaked, f"{len(leaked)} backend test files would ship, e.g. {leaked[:3]}"


def test_frontend_source_tree_stays_out_of_the_wheel():
    # Vite copies public/ into dist, and src/ is compiled .tsx: 35MB of an 82MB wheel in 2026.9.2.
    shipped = _wheel_payload()
    leaked = [
        path
        for path in shipped
        if path.startswith(("studio/frontend/public/", "studio/frontend/src/"))
    ]
    assert not leaked, f"{len(leaked)} frontend source files would ship, e.g. {leaked[:3]}"


def test_desktop_crate_sources_stay_out_of_the_wheel():
    leaked = [
        path
        for path in _wheel_payload()
        if path.startswith("studio/src-tauri/") and not path.startswith("studio/src-tauri/icons/")
    ]
    assert not leaked, f"{len(leaked)} desktop crate files would ship, e.g. {leaked[:3]}"


def test_installer_icons_survive_the_src_tauri_exclusion():
    # install.sh copies icons out of site-packages/studio/src-tauri/icons, so keep that dir.
    shipped = set(_wheel_payload())
    for path in (
        "studio/src-tauri/icons/icon.icns",
        "studio/src-tauri/icons/icon.png",
    ):
        assert path in shipped, f"{path} must stay in the wheel for install.sh"


def test_built_wheel_has_no_frontend_source():
    """Artifact-level check, run when a wheel has already been built."""
    wheels = sorted((REPO_ROOT / "dist").glob("unsloth-*.whl"))
    if not wheels:
        pytest.skip("no built wheel in dist/, run `python -m build --wheel` first")
    names = zipfile.ZipFile(wheels[-1]).namelist()
    leaked = [n for n in names if n.startswith(("studio/frontend/public/", "studio/frontend/src/"))]
    assert not leaked, f"{wheels[-1].name} ships {len(leaked)} frontend source files"
    # Guarding only the exclusion would pass on a wheel with no UI at all.
    assert any(
        n.startswith("studio/frontend/dist/") for n in names
    ), f"{wheels[-1].name} ships no frontend/dist; the UI would 404"


def test_manifest_prunes_match_exclude_package_data():
    """exclude-package-data (wheel) and MANIFEST prunes (sdist) must name the same paths."""
    manifest = (REPO_ROOT / "MANIFEST.in").read_text(encoding = "utf-8")
    for path in (
        "studio/frontend/public",
        "studio/frontend/src",
        "studio/src-tauri/src",
    ):
        assert f"prune {path}\n" in manifest, f"MANIFEST.in must prune {path}"
    assert (
        "prune studio/src-tauri/icons" not in manifest
    ), "src-tauri/icons is read from site-packages by install.sh; do not prune it"


def test_backend_runtime_still_ships():
    shipped = set(_wheel_payload())
    for path in ("studio/backend/main.py", "studio/backend/hub/__init__.py"):
        assert path in shipped, f"{path} must stay in the wheel"


def test_built_wheel_has_no_backend_tests():
    """Artifact-level check, run when a wheel has already been built."""
    wheels = sorted((REPO_ROOT / "dist").glob("unsloth-*.whl"))
    if not wheels:
        pytest.skip("no built wheel in dist/, run `python -m build --wheel` first")
    names = zipfile.ZipFile(wheels[-1]).namelist()
    leaked = [n for n in names if n.startswith("studio/backend/") and "/tests/" in n]
    assert not leaked, f"{wheels[-1].name} ships {len(leaked)} backend test files"