docs: strip non-essential comments, fold key facts into docstrings

This commit is contained in:
imSp4rky
2026-08-16 23:32:02 -06:00
parent 66bcbe9377
commit 511f96d8db
81 changed files with 204 additions and 1017 deletions
@@ -82,9 +82,6 @@ def selected(result: Dict[str, Any]) -> List[str]:
return keys
# ---------- serialize_title: the JSON contract ----------
def test_partless_episode_json_has_no_part_key() -> None:
d = serialize_title(ep(part=None))
assert "part" not in d
@@ -137,9 +134,6 @@ def test_movie_json_unaffected() -> None:
assert "part" not in d
# ---------- list_tracks_handler: the REST wanted filter ----------
@pytest.fixture
def split_titles() -> List[Episode]:
"""E1 split into three parts, E2 unsplit."""
@@ -172,9 +166,6 @@ def test_rest_part_of_unsplit_episode_selects_nothing(monkeypatch, split_titles)
assert result["status"] == 404
# ---------- discrete season/episode/part request fields ----------
def test_discrete_fields_without_part_select_every_part(monkeypatch, split_titles) -> None:
result = run_list_tracks(monkeypatch, split_titles, season=1, episode=1)
assert selected(result) == ["1x1.1", "1x1.2", "1x1.3"]
@@ -207,18 +198,12 @@ def test_part_is_a_transport_key_not_a_service_option() -> None:
assert "part" in handlers.SESSION_TRANSPORT_KEYS
# ---------- ordering ----------
def test_rest_multi_episode_order_is_stable_across_parts(monkeypatch) -> None:
titles = [ep(1, 2, None), ep(1, 1, 3), ep(1, 1, 1), ep(1, 1, 2)]
result = run_list_tracks(monkeypatch, titles, wanted="S01")
assert selected(result) == ["1x1.1", "1x1.2", "1x1.3", "1x2"]
# ---------- download_manager: already-internal wanted sniff ----------
SNIFF = r"^!?\d+x\d+(\.\d+)?$"
@@ -283,9 +268,6 @@ def test_perform_download_still_converts_cli_style_tokens(monkeypatch) -> None:
assert params["wanted"] == ["1x1"]
# ---------- CLI / REST agreement ----------
def test_dl_and_handlers_share_the_one_match_helper() -> None:
"""Both filters must route through Episode.matches_wanted, or they drift."""
from pathlib import Path