Files
SolitaryThinker db866dfb04 [misc] v2: simplify docstrings/comments + drop deleted-design-doc citations
Sweep all 296 v2 modules: simplify verbose docstrings/comments and remove 376 dangling
"(design_vN §X)" citations to the now-deleted design docs (v2/README.md is the source of
truth). Comment/docstring-only — AST-verified code-identical; the CPU suite holds at 237
passed / 5 pre-existing. Also applies yapf + ruff --fix auto-fixes (import ordering,
forward-ref annotation de-quoting under `from __future__ import annotations`; behavior-
neutral, suite-confirmed) and adds the legitimate domain terms mot/clen/te to the codespell
ignore-list. Remaining ruff (24) + mypy (68 no-untyped-call) findings are pre-existing v2
debt, untouched here.
2026-06-19 20:54:59 +00:00

88 lines
4.0 KiB
Python

"""The adapter plane — per-request LoRA / ControlNet over one base.
Many adapters served over ONE resident base; a request picks which to apply (`DiffusionParams.adapters`).
These assert: per-request selection changes output, multi-LoRA composes, ControlNet conditions on a
control image, mixed-adapter requests interleave without smearing, hot-swap changes generation, and the
cache key partitions by the active adapter stack (adapted ≠ base, and version A ≠ version B).
"""
from __future__ import annotations
import numpy as np
from v2.cache import CacheManager
from v2.cache.keys import CacheKey
from v2.card import load_card
from v2.recipes.adapters import build_adapter_card, build_adapter_program
from v2.parity import assert_interleave_parity
from v2.request import DiffusionParams, TaskType, make_request
from v2.request.modalpart import ImagePart, TextPart
from v2.runtime import Engine
def _engine():
card = build_adapter_card()
inst = load_card(card, cache_manager=CacheManager.from_card(card))
eng = Engine()
eng.register(card.model_id, inst, build_adapter_program())
return eng, inst
def _gen(eng, adapters=(), control=None, seed=3):
inputs = (TextPart("a portrait"),) + ((ImagePart(pixels=control),) if control is not None else ())
req = make_request(TaskType.T2V, "wan-adapters", "a portrait", inputs=inputs,
diffusion=DiffusionParams(num_steps=6, seed=seed, adapters=adapters))
return np.asarray(eng.run(req).artifacts["video"].frames)
def test_per_request_adapter_changes_output():
eng, _ = _engine()
base = _gen(eng)
anime = _gen(eng, ("lora_anime",))
realistic = _gen(eng, ("lora_realistic",))
assert not np.array_equal(base, anime)
assert not np.array_equal(anime, realistic)
assert np.array_equal(anime, _gen(eng, ("lora_anime",))) # deterministic
def test_multi_lora_composes():
eng, _ = _engine()
a = _gen(eng, ("lora_anime",))
b = _gen(eng, ("lora_realistic",))
ab = _gen(eng, ("lora_anime", "lora_realistic"))
assert not np.array_equal(ab, a) and not np.array_equal(ab, b)
def test_controlnet_conditions_on_the_control_image():
eng, _ = _engine()
c_hi = _gen(eng, ("control_pose",), control=np.full((3, 1, 4, 6), 0.5, dtype="float32"))
c_lo = _gen(eng, ("control_pose",), control=np.full((3, 1, 4, 6), -0.5, dtype="float32"))
assert not np.array_equal(c_hi, c_lo) # different control ⇒ different video
def test_mixed_adapter_requests_interleave_without_smearing():
"""One base, different adapters per request — interleaving is bit-identical to serial (the active
adapter set lives in the request/LoopState, never global)."""
eng, _ = _engine()
reqs = [make_request(TaskType.T2V, "wan-adapters", "a portrait",
diffusion=DiffusionParams(num_steps=4, seed=s, adapters=ad))
for s, ad in [(1, ()), (2, ("lora_anime",)), (3, ("lora_realistic",))]]
assert not assert_interleave_parity(eng, reqs)
def test_hot_swap_changes_generation():
eng, inst = _engine()
before = _gen(eng, ("lora_anime",))
inst.component("lora_anime").update(seed=999) # swap the adapter's weights
assert not np.array_equal(before, _gen(eng, ("lora_anime",)))
def test_cache_key_partitions_by_adapter_stack():
base = CacheKey(model_id="m", component_id="transformer", weights_version="w1",
adapter_versions=(), precision="float32", input_hashes=())
a = CacheKey(model_id="m", component_id="transformer", weights_version="w1",
adapter_versions=CacheKey.adapters({"lora_anime": "v1"}), precision="float32", input_hashes=())
b = CacheKey(model_id="m", component_id="transformer", weights_version="w1",
adapter_versions=CacheKey.adapters({"lora_anime": "v2"}), precision="float32", input_hashes=())
assert a != base # adapted ≠ base (no stale reuse)
assert a != b # adapter version A ≠ version B (hot-swap)