Fine-tune LLMs from one YAML. Layer streaming trains an 8B model on a 4 GB laptop GPU.
Python cliconsumer-gpudpofine-tuningggufhuggingfacellmllmopslocal-ailocal-llmloralow-vrammachine-learningollamapeftpythonpytorchqlorasfttransformers
"""#1465: the Web UI plugin registry is gone, and nothing still names it.
``soup_cli.ui.plugins`` (``register_tab`` and friends, importable since v0.44.0) was a
registry nobody read: ``create_app`` never imported it, no route and nothing in
``ui/static/`` listed the registered tabs, and ``docs/serving-and-export.md`` promised a
drop-in tab that was never rendered. The maintainer's ruling on #1465 was to remove it
rather than wire it. ``soup_cli.plugins`` (``soup plugins``, the working plugin system)
and ``utils/ui_env.py`` are untouched.
"""
from __future__ import annotations
import importlib
import re
from pathlib import Path
import pytest
_ROOT = Path(__file__).resolve().parents[1]
_SRC = _ROOT / "src"
_DOCS = _ROOT / "docs"
#: The spellings the removed registry went by. ``soup_cli.plugins`` (no ``ui``) is a
#: different, working feature and is deliberately not in this list.
_REGISTRY_MARKERS = (
"soup_cli.ui.plugins",
"soup_cli/ui/plugins",
"register_tab",
"Web UI Plugin Registry",
)
#: The public names of the removed module.
_REMOVED_NAMES = ("register_tab", "list_tabs", "get_tab", "clear_tabs", "load_plugins", "TabSpec")
#: Every route ``ui/app.py`` declares with a decorator, plus the ``/static`` mount, read
#: before the removal. FastAPI's own documentation routes (``/docs``, ``/redoc``,
#: ``/openapi.json``) are left out: ``create_app`` turns them on only for a loopback host.
_ROUTES_TODAY = {
"/",
"/static",
"/api/health",
"/api/auth/ticket",
"/api/chat/send",
"/api/tool-outputs",
"/api/train/stream",
"/api/runs",
"/api/runs/compare",
"/api/runs/{run_id}",
"/api/runs/{run_id}/metrics",
"/api/runs/{run_id}/eval",
"/api/system",
"/api/templates",
"/api/config/validate",
"/api/config/schema",
"/api/config/from-form",
"/api/train/start",
"/api/train/status",
"/api/train/stop",
"/api/train/logs",
"/api/train/metrics/live",
"/api/train/progress",
"/api/data/inspect",
"/api/recipes",
}
def _files(root: Path, suffixes: tuple[str, ...]):
for path in sorted(root.rglob("*")):
if path.is_file() and path.suffix in suffixes and "__pycache__" not in path.parts:
yield path
class TestTheRegistryIsGone:
def test_the_module_cannot_be_imported(self):
# A checkout that ran the old tests keeps an ignored plugins/__pycache__/ after the
# pull, and Python then imports the directory as an empty namespace package.
try:
module = importlib.import_module("soup_cli.ui.plugins")
except ModuleNotFoundError:
return
assert module.__spec__.origin is None, module.__spec__.origin
assert [name for name in _REMOVED_NAMES if hasattr(module, name)] == []
def test_no_source_file_is_left_in_the_package_directory(self):
plugins_dir = _SRC / "soup_cli" / "ui" / "plugins"
leftovers = (
sorted(
str(path.relative_to(plugins_dir))
for path in plugins_dir.rglob("*")
if path.is_file() and "__pycache__" not in path.parts
)
if plugins_dir.is_dir()
else []
)
assert leftovers == []
def test_nothing_under_src_names_it(self):
hits = [
f"{path.relative_to(_ROOT)}: {marker}"
for path in _files(_SRC, (".py", ".html", ".js", ".css", ".md"))
for marker in _REGISTRY_MARKERS
if marker in path.read_text(encoding="utf-8", errors="replace")
]
assert hits == [], hits
def test_nothing_under_docs_names_it(self):
hits = [
f"{path.relative_to(_ROOT)}: {marker}"
for path in _files(_DOCS, (".md",))
for marker in _REGISTRY_MARKERS
if marker in path.read_text(encoding="utf-8")
]
assert hits == [], hits
def test_the_docs_contents_list_has_no_dangling_anchor(self):
"""The section and its contents-list line go together: a surviving
``(#web-ui-plugin-registry--env-knobs)`` entry would point at nothing."""
text = (_DOCS / "serving-and-export.md").read_text(encoding="utf-8")
assert "web-ui-plugin-registry" not in text
assert not re.search(r"^## .*Plugin Registry", text, re.M)
class TestNothingElseMoved:
def test_the_working_plugin_system_is_still_there(self):
"""``soup plugins`` is a different feature and the README's one mention of
plugins points at it; it must not be caught in this removal."""
plugins = importlib.import_module("soup_cli.plugins")
assert callable(plugins.load_plugins)
assert "Plugin System" in (_DOCS / "backends-and-ops.md").read_text(encoding="utf-8")
def test_ui_env_is_untouched(self):
from soup_cli.utils.ui_env import UiEnv, resolve_ui_env
assert resolve_ui_env({}) == UiEnv(None, None, None, None, None)
def test_the_web_ui_still_serves_todays_routes(self):
pytest.importorskip("fastapi")
from soup_cli.ui.app import create_app
served = {getattr(route, "path", None) for route in create_app().routes}
missing = _ROUTES_TODAY - served
assert not missing, sorted(missing)