Skip to content

armgit / Soup

Public Imported from GitHub
0

Fine-tune LLMs from one YAML. Layer streaming trains an 8B model on a 4 GB laptop GPU.

11.2 KB
Raw Blame
from pathlib import Path

import pytest

_SOUP_YAML = (
    "base: hf-internal-testing/tiny-random-gpt2\n"
    "task: sft\n"
    "data:\n  train: data.jsonl\n  format: chatml\n"
    "output: ./out\n"
)

REPO_ROOT = Path(__file__).parent.parent.resolve()


def _strip_ansi(s: str) -> str:
    import re

    return re.sub(r"\x1B\[[0-?]*[ -/]*[@-~]", "", s)


class TestValidateLambdaLabs:

    def test_lambda_validate_cloud(self):
        from soup_cli.cloud.lambda_labs import validate_cloud

        assert validate_cloud("lambda") == "lambda"
        with pytest.raises(ValueError):
            validate_cloud("runpod")
        with pytest.raises(ValueError, match="got bool"):
            validate_cloud(True)
        with pytest.raises(ValueError, match="got int"):
            validate_cloud(123)
        with pytest.raises(ValueError, match="non-empty string"):
            validate_cloud("")
        with pytest.raises(ValueError, match="null bytes"):
            validate_cloud("lamb\x00da")
        with pytest.raises(ValueError, match="exceeds"):
            validate_cloud("a" * 100)

    def test_lambda_validate_gpu(self):
        from soup_cli.cloud.lambda_labs import validate_gpu

        assert validate_gpu("a100") == "a100"
        with pytest.raises(ValueError):
            validate_gpu("tpu")
        with pytest.raises(ValueError, match="got bool"):
            validate_gpu(True)
        with pytest.raises(ValueError, match="got int"):
            validate_gpu(123)
        with pytest.raises(ValueError, match="non-empty string"):
            validate_gpu("")
        with pytest.raises(ValueError, match="null bytes"):
            validate_gpu("a10\x000")
        with pytest.raises(ValueError, match="exceeds"):
            validate_gpu("a" * 100)


class TestRenderLambdaLabsStub:
    def test_render_happy_path(self):
        from soup_cli.cloud.lambda_labs import render_lambda_stub

        stub = render_lambda_stub(
            _SOUP_YAML, gpu="a100", output_dir="./out", soup_version="0.71.22"
        )
        assert "urllib.request" in stub
        assert "gpu_1x_a100_sxm4" in stub
        compile(stub, "soup_lambda_app.py", "exec")
        namespace = {"__name__": "test"}
        exec(stub, namespace)
        payload = namespace["_launch_payload"]("us-tx-1", "registered-key")
        assert payload["user_data"] == namespace["_USER_DATA"]
        assert "soup-cli[train]==0.71.22" in payload["user_data"]
        assert payload["ssh_key_names"] == ["registered-key"]
        assert "quantity" not in payload

    @pytest.mark.parametrize("output_dir", ["/tmp/out", "../out", "out with spaces"])
    def test_non_retrievable_or_unsafe_output_rejected(self, output_dir):
        from soup_cli.cloud.lambda_labs import render_lambda_stub

        with pytest.raises(ValueError, match="output_dir"):
            render_lambda_stub(
                _SOUP_YAML, gpu="a100", output_dir=output_dir, soup_version="0.71.22"
            )

    def test_generated_controller_always_terminates(self, tmp_path, monkeypatch):
        from soup_cli.cloud.lambda_labs import render_lambda_stub

        key = tmp_path / "lambda-key"
        key.write_text("test-only", encoding="utf-8")
        stub = render_lambda_stub(
            _SOUP_YAML, gpu="a100", output_dir="./out", soup_version="0.71.22"
        )
        namespace = {"__name__": "test"}
        exec(stub, namespace)
        requests = []

        def fake_request(api_key, path, *, method="GET", payload=None):
            requests.append((api_key, path, method, payload))
            if path.endswith("/launch"):
                return {"data": {"instance_ids": ["instance-1"]}}
            return {"data": {}}

        monkeypatch.setenv("LAMBDA_API_KEY", "secret")
        monkeypatch.setenv("LAMBDA_SSH_KEY_NAME", "registered-key")
        monkeypatch.setenv("LAMBDA_SSH_PRIVATE_KEY", str(key))
        namespace["_request_json"] = fake_request
        namespace["_wait_for_ip"] = lambda *_: "192.0.2.1"
        termination_checks = []
        namespace["_wait_for_termination"] = lambda *args: termination_checks.append(args)
        namespace["_train_and_copy"] = lambda *_: (_ for _ in ()).throw(
            RuntimeError("training failed")
        )

        assert namespace["main"]() == 1
        assert termination_checks == [("secret", "instance-1")]
        assert requests[-1][1:] == (
            "/instance-operations/terminate",
            "POST",
            {"instance_ids": ["instance-1"]},
        )

    def test_render_config_yaml_validation(self):
        from soup_cli.cloud.lambda_labs import render_lambda_stub

        with pytest.raises(TypeError, match="must be a string"):
            render_lambda_stub(123, gpu="a100", output_dir="./out", soup_version="1.0.0")
        with pytest.raises(ValueError, match="exceeds"):
            render_lambda_stub(
                "a" * 2_000_000, gpu="a100", output_dir="./out", soup_version="1.0.0"
            )

    def test_render_soup_version_validation(self):
        from soup_cli.cloud.lambda_labs import render_lambda_stub

        with pytest.raises(ValueError, match="NUL-free string"):
            render_lambda_stub(_SOUP_YAML, gpu="a100", output_dir="./out", soup_version="1.0\x00")
        with pytest.raises(ValueError, match="must match"):
            render_lambda_stub(_SOUP_YAML, gpu="a100", output_dir="./out", soup_version="invalid!")
        with pytest.raises(ValueError, match="must match"):
            render_lambda_stub(_SOUP_YAML, gpu="a100", output_dir="./out", soup_version="a" * 100)


class TestPlanLambdaLabsRun:
    def test_plan(self, tmp_path, monkeypatch):
        monkeypatch.chdir(tmp_path)
        (tmp_path / "soup.yaml").write_text(_SOUP_YAML, encoding="utf-8")
        from soup_cli.cloud._common import CloudPlan
        from soup_cli.cloud.lambda_labs import plan_lambda_run

        plan = plan_lambda_run("soup.yaml", gpu="a100", output_dir="./out", soup_version="0.71.22")
        assert isinstance(plan, CloudPlan)
        assert plan.cloud == "lambda"
        assert plan.run_command == "python -I soup_lambda_app.py"

    def test_plan_config_too_large(self, tmp_path, monkeypatch):
        monkeypatch.chdir(tmp_path)
        (tmp_path / "soup.yaml").write_text("a" * 2_000_000, encoding="utf-8")
        from soup_cli.cloud.lambda_labs import plan_lambda_run

        with pytest.raises(ValueError, match="exceeds"):
            plan_lambda_run("soup.yaml", gpu="a100", output_dir="./out", soup_version="0.71.22")


class TestSubmitLambdaLabsRun:
    def test_override_seam(self, monkeypatch):
        import soup_cli.cloud.lambda_labs as m
        from soup_cli.cloud._common import CloudPlan

        plan = CloudPlan(
            cloud="lambda",
            gpu="a100",
            output_dir="./out",
            stub_path="x.py",
            stub_text="",
            run_command="python x.py",
        )
        monkeypatch.setattr(m, "_LAMBDA_SUBMIT_OVERRIDE", lambda p: 7)
        assert m.submit_lambda_run(plan) == 7

    def test_no_token_raises(self):
        import soup_cli.cloud.lambda_labs as m
        from soup_cli.cloud._common import CloudPlan

        plan = CloudPlan(
            cloud="lambda",
            gpu="a100",
            output_dir="./out",
            stub_path="x.py",
            stub_text="",
            run_command="python x.py",
        )
        with pytest.raises(RuntimeError, match="not authenticated/configured"):
            m.submit_lambda_run(plan, env={})


class TestTrainCloudCliNew:
    def test_cloud_runpod_refuses_unknown_gpu(self, tmp_path, monkeypatch):
        monkeypatch.chdir(tmp_path)
        (tmp_path / "soup.yaml").write_text(_SOUP_YAML, encoding="utf-8")
        from typer.testing import CliRunner

        from soup_cli.cli import app

        result = CliRunner().invoke(
            app, ["train", "--config", "soup.yaml", "--cloud", "runpod", "--gpu", "tpu"]
        )
        assert result.exit_code == 2, (result.output, repr(result.exception))
        assert not (tmp_path / "soup_runpod_app.py").exists()
        txt = _strip_ansi(result.output)
        assert "Invalid --cloud / --gpu" in txt
        assert "rtx4090" in txt

    def test_cloud_lambda_plan_only(self, tmp_path, monkeypatch):
        monkeypatch.chdir(tmp_path)
        (tmp_path / "soup.yaml").write_text(_SOUP_YAML, encoding="utf-8")
        from typer.testing import CliRunner

        from soup_cli.cli import app

        result = CliRunner().invoke(
            app, ["train", "--config", "soup.yaml", "--cloud", "lambda", "--gpu", "a10"]
        )
        assert result.exit_code == 0, (result.output, repr(result.exception))
        assert (tmp_path / "soup_lambda_app.py").exists()
        txt = _strip_ansi(result.output)
        assert "python -I soup_lambda_app.py" in txt

    def test_cloud_name_is_case_insensitive(self, tmp_path, monkeypatch):
        monkeypatch.chdir(tmp_path)
        (tmp_path / "soup.yaml").write_text(_SOUP_YAML, encoding="utf-8")
        from typer.testing import CliRunner

        from soup_cli.cli import app

        # Test case-insensitivity on active provider Lambda
        result = CliRunner().invoke(
            app, ["train", "--config", "soup.yaml", "--cloud", "LAMBDA", "--gpu", "a100"]
        )
        assert result.exit_code == 0, (result.output, repr(result.exception))
        assert (tmp_path / "soup_lambda_app.py").exists()

        # RunPod uses the same case-insensitive provider dispatch.
        res_runpod = CliRunner().invoke(
            app, ["train", "--config", "soup.yaml", "--cloud", "RUNPOD", "--gpu", "a100"]
        )
        assert res_runpod.exit_code == 0, (res_runpod.output, repr(res_runpod.exception))
        assert (tmp_path / "soup_runpod_app.py").exists()


class TestCloudNoSecrets:
    def test_no_secrets_in_stub_or_payload(self, monkeypatch):
        from soup_cli.cloud.lambda_labs import render_lambda_stub
        from soup_cli.cloud.modal import render_modal_stub

        secret = "LIVE_SECRET_ABCDEF123456"
        hf_token = "hf_LIVE_TOKEN_ABCDEF123456"
        wandb_key = "wandb_LIVE_KEY_ABCDEF123456"

        monkeypatch.setenv("LAMBDA_API_KEY", secret)
        monkeypatch.setenv("MODAL_TOKEN_ID", secret)
        monkeypatch.setenv("MODAL_TOKEN_SECRET", secret)
        monkeypatch.setenv("LAMBDA_SSH_KEY_NAME", "registered-key")
        monkeypatch.setenv("LAMBDA_SSH_PRIVATE_KEY", "/tmp/key")
        monkeypatch.setenv("HF_TOKEN", hf_token)
        monkeypatch.setenv("WANDB_API_KEY", wandb_key)

        # 1. Lambda Labs
        stub_lambda = render_lambda_stub(
            _SOUP_YAML, gpu="a100", output_dir="./out", soup_version="0.71.22"
        )
        assert secret not in stub_lambda
        assert hf_token not in stub_lambda
        assert wandb_key not in stub_lambda

        namespace = {"__name__": "test"}
        exec(stub_lambda, namespace)
        payload = namespace["_launch_payload"]("us-tx-1", "registered-key")
        payload_str = str(payload)
        assert secret not in payload_str
        assert hf_token not in payload_str
        assert wandb_key not in payload_str

        # 2. Modal
        stub_modal = render_modal_stub(
            _SOUP_YAML, gpu="a100", output_dir="./out", soup_version="0.71.22"
        )
        assert secret not in stub_modal
        assert hf_token not in stub_modal
        assert wandb_key not in stub_modal