mirror of
https://github.com/unshackle-dl/unshackle.git
synced 2026-11-14 04:55:07 +00:00
A season run skips such a title and continues; one title, or a run that skips every title, still exits 1 (now also for -ado/-fso). REST jobs report skipped_titles.
344 lines
15 KiB
Python
344 lines
15 KiB
Python
"""Run the kind-only filters through the real dl.result() selection loop.
|
|
|
|
A fake service hands in-memory tracks to the loop, and the run stops at the first
|
|
title that reaches ``Tracks.tree``, the step right after selection. A title with no
|
|
track of the kind never gets there, so what the hook records is what the run kept.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
import inspect
|
|
import logging
|
|
from typing import Any, Optional, cast
|
|
|
|
import pytest
|
|
import requests
|
|
|
|
from unshackle.commands.dl import dl
|
|
from unshackle.core.api.handlers import DEFAULT_DOWNLOAD_PARAMS
|
|
from unshackle.core.constants import DOWNLOAD_LICENCE_ONLY
|
|
from unshackle.core.service import Service
|
|
from unshackle.core.titles import Episode, Series
|
|
from unshackle.core.tracks import Audio, Subtitle, Tracks, Video
|
|
|
|
|
|
class Selected(BaseException):
|
|
"""Carries the kept track ids out of the loop."""
|
|
|
|
def __init__(self, tracks: Tracks) -> None:
|
|
self.ids = {
|
|
"video": [t.id for t in tracks.videos],
|
|
"audio": [t.id for t in tracks.audio],
|
|
"subs": [t.id for t in tracks.subtitles],
|
|
}
|
|
|
|
|
|
class Harness(dl):
|
|
def __getattr__(self, name: str) -> None:
|
|
# every optional dl attribute (tmdb ids, cdm, vaults, ...) reads as unset
|
|
return None
|
|
|
|
|
|
class FakeService:
|
|
"""One episode per entry; ``ad`` adds a descriptive track, ``forced`` a forced subtitle, ``ko`` Korean audio."""
|
|
|
|
def __init__(self, episodes: dict[int, dict[str, bool]]) -> None:
|
|
self.episodes = episodes
|
|
self.session = None
|
|
|
|
def authenticate(self, cookies: Any = None, credential: Any = None) -> None:
|
|
pass
|
|
|
|
def get_titles_cached(self) -> Series:
|
|
return Series(
|
|
Episode(id_=f"show-s01-e{n:03}", service=FakeService, title="Show", season=1, number=n, language="en")
|
|
for n in self.episodes
|
|
)
|
|
|
|
def get_tracks(self, title: Episode) -> Tracks:
|
|
kinds = self.episodes[title.number]
|
|
tracks = Tracks()
|
|
tracks.add(Video(id_="v", url="https://x/v", language="en", codec=Video.Codec.AVC, range_=Video.Range.SDR))
|
|
tracks.add(Audio(id_="a", url="https://x/a", language="en", codec=Audio.Codec.AAC, bitrate=128_000))
|
|
if kinds.get("ad"):
|
|
tracks.add(
|
|
Audio(id_="ad", url="https://x/ad", language="en", codec=Audio.Codec.AAC, bitrate=1, descriptive=True)
|
|
)
|
|
if kinds.get("ko"):
|
|
tracks.add(Audio(id_="ko", url="https://x/ko", language="ko", codec=Audio.Codec.AAC, bitrate=128_000))
|
|
tracks.add(Subtitle(id_="s", url="https://x/s", language="en", codec=Subtitle.Codec.WebVTT))
|
|
if kinds.get("forced"):
|
|
tracks.add(Subtitle(id_="sf", url="https://x/sf", language="en", codec=Subtitle.Codec.WebVTT, forced=True))
|
|
return tracks
|
|
|
|
def get_chapters(self, title: Episode) -> list:
|
|
return []
|
|
|
|
def __getattr__(self, name: str) -> Any:
|
|
if name.startswith(("on_", "get_")):
|
|
# the event hooks (on_track_downloaded, ...) and the DRM callbacks a run past selection probes
|
|
return lambda *a, **k: None
|
|
raise AttributeError(name)
|
|
|
|
|
|
def run(
|
|
monkeypatch: pytest.MonkeyPatch,
|
|
caplog: pytest.LogCaptureFixture,
|
|
episodes: dict,
|
|
service: Optional[FakeService] = None,
|
|
to_end: bool = False,
|
|
**flags: Any,
|
|
) -> Any:
|
|
"""Return the Selected ids, the exit code, or None for a run that completes; to_end runs past selection."""
|
|
if not to_end:
|
|
monkeypatch.setattr(Tracks, "tree", lambda self, *a, **k: (_ for _ in ()).throw(Selected(self)))
|
|
else:
|
|
monkeypatch.setattr("unshackle.commands.dl.download_tracks_in_passes", lambda *a, **k: None)
|
|
monkeypatch.setattr("unshackle.core.providers.search_metadata", lambda *a, **k: None)
|
|
cmd = Harness.__new__(Harness)
|
|
cmd.log = logging.getLogger("test_kind_only")
|
|
cmd.service = "FAKE"
|
|
cmd.tmdb_searched = True
|
|
cmd.completed_files = []
|
|
cmd.skipped_titles = []
|
|
cmd.skipped_subtitles = []
|
|
kwargs: dict[str, Any] = {}
|
|
for name, param in inspect.signature(dl.result).parameters.items():
|
|
if name in DEFAULT_DOWNLOAD_PARAMS:
|
|
kwargs[name] = DEFAULT_DOWNLOAD_PARAMS[name]
|
|
elif name not in ("self", "service"):
|
|
kwargs[name] = None if param.default is inspect.Parameter.empty else param.default
|
|
kwargs.update(quality=[], vcodec=[], acodec=[], range_=[], wanted=[], cdm_only=None, downloads=1)
|
|
kwargs.update(flags)
|
|
caplog.set_level(logging.WARNING, logger="test_kind_only")
|
|
service = service or FakeService(episodes)
|
|
if to_end:
|
|
service.session = requests.Session()
|
|
try:
|
|
cmd.result(cast(Service, service), **kwargs)
|
|
except Selected as sel:
|
|
return sel.ids
|
|
except SystemExit as exc:
|
|
return exc.code
|
|
finally:
|
|
DOWNLOAD_LICENCE_ONLY.clear()
|
|
return None
|
|
|
|
|
|
def test_ado_keeps_the_descriptive_track_and_the_other_types(
|
|
monkeypatch: pytest.MonkeyPatch, caplog: pytest.LogCaptureFixture
|
|
) -> None:
|
|
ids = run(monkeypatch, caplog, {1: {"ad": True, "forced": True}}, audio_description_only=True)
|
|
assert ids == {"video": ["v"], "audio": ["ad"], "subs": ["s"]}
|
|
|
|
|
|
def test_fso_keeps_the_forced_track_and_the_other_types(
|
|
monkeypatch: pytest.MonkeyPatch, caplog: pytest.LogCaptureFixture
|
|
) -> None:
|
|
ids = run(monkeypatch, caplog, {1: {"ad": True, "forced": True}}, forced_subs_only=True)
|
|
assert ids == {"video": ["v"], "audio": ["a"], "subs": ["sf"]}
|
|
|
|
|
|
def test_only_flags_with_their_type_flags_give_a_single_kind(
|
|
monkeypatch: pytest.MonkeyPatch, caplog: pytest.LogCaptureFixture
|
|
) -> None:
|
|
ids = run(monkeypatch, caplog, {1: {"ad": True, "forced": True}}, audio_description_only=True, audio_only=True)
|
|
assert ids == {"video": [], "audio": ["ad"], "subs": []}
|
|
ids = run(monkeypatch, caplog, {1: {"ad": True, "forced": True}}, forced_subs_only=True, subs_only=True)
|
|
assert ids == {"video": [], "audio": [], "subs": ["sf"]}
|
|
|
|
|
|
@pytest.mark.parametrize("flag", ["audio_description_only", "forced_subs_only"])
|
|
def test_a_single_title_with_no_such_track_exits(
|
|
monkeypatch: pytest.MonkeyPatch, caplog: pytest.LogCaptureFixture, flag: str
|
|
) -> None:
|
|
assert run(monkeypatch, caplog, {1: {}}, **{flag: True}) == 1
|
|
assert "Skipping" not in caplog.text
|
|
|
|
|
|
def test_subs_only_with_no_matching_subtitle_exits_a_single_title_and_skips_in_a_season(
|
|
monkeypatch: pytest.MonkeyPatch, caplog: pytest.LogCaptureFixture
|
|
) -> None:
|
|
assert run(monkeypatch, caplog, {1: {}}, subs_only=True, s_lang=["fr"]) == 1
|
|
assert run(monkeypatch, caplog, {1: {}, 2: {}}, subs_only=True, s_lang=["fr"]) == 1
|
|
assert caplog.text.count("Skipping Show S01E") == 2
|
|
assert "Skipping Show S01E02: There's no track left for the selected options." in caplog.text
|
|
|
|
|
|
def test_a_multi_title_run_skips_the_title_and_continues(
|
|
monkeypatch: pytest.MonkeyPatch, caplog: pytest.LogCaptureFixture
|
|
) -> None:
|
|
ids = run(monkeypatch, caplog, {1: {}, 2: {"ad": True}}, audio_description_only=True)
|
|
assert ids["audio"] == ["ad"]
|
|
assert "Skipping Show S01E01" in caplog.text
|
|
|
|
|
|
def test_a_multi_title_run_with_every_title_skipped_fails(
|
|
monkeypatch: pytest.MonkeyPatch, caplog: pytest.LogCaptureFixture
|
|
) -> None:
|
|
assert run(monkeypatch, caplog, {1: {}, 2: {}}, forced_subs_only=True) == 1
|
|
assert caplog.text.count("Skipping Show S01E") == 2
|
|
|
|
|
|
def test_a_required_language_miss_stops_the_run_by_default(
|
|
monkeypatch: pytest.MonkeyPatch, caplog: pytest.LogCaptureFixture
|
|
) -> None:
|
|
sink: list[dict] = []
|
|
assert run(monkeypatch, caplog, {1: {}, 2: {"ko": True}}, require_audio=["ko"], progress_sink=sink.append) == 1
|
|
assert "Skipping" not in caplog.text
|
|
assert "Show S01E01: Required audio language(s) not found: ko" in caplog.text
|
|
assert not any("skipped_titles" in event for event in sink)
|
|
|
|
|
|
def test_skip_missing_skips_the_title_and_reports_it(
|
|
monkeypatch: pytest.MonkeyPatch, caplog: pytest.LogCaptureFixture
|
|
) -> None:
|
|
sink: list[dict] = []
|
|
ids = run(
|
|
monkeypatch,
|
|
caplog,
|
|
{1: {}, 2: {"ko": True}},
|
|
require_audio=["ko"],
|
|
skip_missing=True,
|
|
progress_sink=sink.append,
|
|
)
|
|
assert ids == {"video": ["v"], "audio": ["a"], "subs": ["s"]}
|
|
assert "Skipping Show S01E01: Required audio language(s) not found: ko" in caplog.text
|
|
assert {"skipped_titles": [{"title": "Show S01E01", "reason": "Required audio language(s) not found: ko"}]} in sink
|
|
|
|
|
|
def test_require_audio_video_and_subs_work_together(
|
|
monkeypatch: pytest.MonkeyPatch, caplog: pytest.LogCaptureFixture
|
|
) -> None:
|
|
ids = run(monkeypatch, caplog, {1: {}}, require_audio=["en"], require_video=["en"], require_subs=["en"])
|
|
assert ids == {"video": ["v"], "audio": ["a"], "subs": ["s"]}
|
|
assert run(monkeypatch, caplog, {1: {}}, require_audio=["ko"], require_video=["ko"], require_subs=["ko"]) == 1
|
|
assert (
|
|
"Required audio language(s) not found: ko; Required video language(s) not found: ko; "
|
|
"Required subtitle language(s) not found: ko"
|
|
) in caplog.text
|
|
assert run(monkeypatch, caplog, {1: {}}, require_audio=["en"], require_video=["ko"], require_subs=["en"]) == 1
|
|
assert "Show S01E01: Required video language(s) not found: ko" in caplog.text
|
|
|
|
|
|
def test_skip_missing_skips_a_filter_miss_and_continues(
|
|
monkeypatch: pytest.MonkeyPatch, caplog: pytest.LogCaptureFixture
|
|
) -> None:
|
|
ids = run(monkeypatch, caplog, {1: {}, 2: {"ko": True}}, a_lang=["ko"], skip_missing=True)
|
|
assert ids == {"video": ["v"], "audio": ["ko"], "subs": ["s"]}
|
|
assert "Skipping Show S01E01" in caplog.text
|
|
|
|
|
|
def test_skip_missing_still_fails_a_run_that_skips_every_title(
|
|
monkeypatch: pytest.MonkeyPatch, caplog: pytest.LogCaptureFixture
|
|
) -> None:
|
|
assert run(monkeypatch, caplog, {1: {}, 2: {}}, require_audio=["ko"], skip_missing=True) == 1
|
|
assert "Skipped all 2 titles" in caplog.text
|
|
assert run(monkeypatch, caplog, {1: {}}, require_audio=["ko"], skip_missing=True) == 1
|
|
|
|
|
|
class LangService(FakeService):
|
|
"""Each episode names its original language and its audio languages; the video is in the original language."""
|
|
|
|
def get_titles_cached(self) -> Series:
|
|
return Series(
|
|
Episode(id_=f"show-s01-e{n:03}", service=FakeService, title="Show", season=1, number=n, language=ep["orig"])
|
|
for n, ep in self.episodes.items()
|
|
)
|
|
|
|
def get_tracks(self, title: Episode) -> Tracks:
|
|
ep = self.episodes[title.number]
|
|
tracks = Tracks()
|
|
tracks.add(Video(id_="v", url="https://x/v", language=ep["orig"] or "en", codec=Video.Codec.AVC))
|
|
for lang in ep["audio"]:
|
|
tracks.add(Audio(id_=lang, url=f"https://x/{lang}", language=lang, codec=Audio.Codec.AAC, bitrate=128_000))
|
|
return tracks
|
|
|
|
|
|
JA_EN = {"orig": "ja", "audio": ["ja", "en"]}
|
|
FR = {"orig": "ja", "audio": ["fr"]}
|
|
EVERY = {"orig": "ja", "audio": ["ja", "ko", "en"]}
|
|
ORIG_KO_EN = ["orig", "ko", "en"]
|
|
|
|
|
|
@pytest.mark.parametrize(
|
|
"first,flags,outcome,logged",
|
|
[
|
|
(JA_EN, {}, 1, "Show S01E01: ko not found in audio tracks"),
|
|
(JA_EN, {"skip_missing": True}, ["ja", "ko", "en"], "Skipping Show S01E01: ko not found in audio tracks"),
|
|
({"orig": "ja", "audio": ["ko", "en"]}, {"skip_missing": True}, ["ja", "ko", "en"], "S01E01: orig not found"),
|
|
(JA_EN, {"best_available": True}, ["ja", "en"], "ko not found in audio tracks, continuing with: orig, en"),
|
|
(FR, {"best_available": True}, 1, "orig, ko, en not found in audio tracks and no fallback available"),
|
|
(FR, {"best_available": True, "skip_missing": True}, ["ja", "ko", "en"], "Skipping Show S01E01: orig, ko, en"),
|
|
(JA_EN, {"best_available": True, "require_audio": ["ko"]}, 1, "Required audio language(s) not found: ko"),
|
|
(
|
|
JA_EN,
|
|
{"best_available": True, "require_audio": ["ko"], "skip_missing": True},
|
|
["ja", "ko", "en"],
|
|
"Skipping Show S01E01: Required audio language(s) not found: ko",
|
|
),
|
|
],
|
|
)
|
|
def test_several_audio_languages_skip_an_episode_that_misses_one(
|
|
monkeypatch: pytest.MonkeyPatch,
|
|
caplog: pytest.LogCaptureFixture,
|
|
first: dict,
|
|
flags: dict[str, Any],
|
|
outcome: Any,
|
|
logged: str,
|
|
) -> None:
|
|
"""-al orig,ko,en on a season where only the second episode has all three."""
|
|
episodes = {1: first, 2: EVERY}
|
|
result = run(monkeypatch, caplog, episodes, service=LangService(episodes), a_lang=ORIG_KO_EN, **flags)
|
|
assert (result if outcome == 1 else result["audio"]) == outcome
|
|
assert logged in caplog.text
|
|
|
|
|
|
def test_several_audio_languages_fail_a_season_that_misses_one_everywhere(
|
|
monkeypatch: pytest.MonkeyPatch, caplog: pytest.LogCaptureFixture
|
|
) -> None:
|
|
episodes = {1: JA_EN, 2: JA_EN}
|
|
assert run(monkeypatch, caplog, episodes, service=LangService(episodes), a_lang=ORIG_KO_EN, skip_missing=True) == 1
|
|
assert caplog.text.count("ko not found in audio tracks") == 2
|
|
assert "Skipped all 2 titles" in caplog.text
|
|
|
|
|
|
def test_a_partly_skipped_run_completes_and_lists_the_skips(
|
|
monkeypatch: pytest.MonkeyPatch, caplog: pytest.LogCaptureFixture
|
|
) -> None:
|
|
episodes = {1: {}, 2: {"ko": True}}
|
|
assert run(monkeypatch, caplog, episodes, to_end=True, a_lang=["ko"], skip_missing=True, skip_dl=True) is None
|
|
assert "Skipped 1 of 2 titles: Show S01E01" in caplog.text
|
|
|
|
|
|
@pytest.mark.parametrize("no_mux,settled", [(False, 2), (True, 1)])
|
|
def test_a_skipped_title_settles_its_post_script_group(
|
|
monkeypatch: pytest.MonkeyPatch, caplog: pytest.LogCaptureFixture, no_mux: bool, settled: int
|
|
) -> None:
|
|
"""The season event waits on every title of a group; a skipped title counts as settled, once at count time."""
|
|
import unshackle.commands.dl as dl_module
|
|
|
|
seen: list[str] = []
|
|
group = dl_module.post_script_group
|
|
monkeypatch.setattr(dl_module, "post_script_group", lambda t: seen.append(str(t)) or group(t))
|
|
run(monkeypatch, caplog, {1: {}, 2: {"ko": True}}, a_lang=["ko"], skip_missing=True, no_mux=no_mux)
|
|
assert seen.count("Show S01E01") == settled
|
|
|
|
|
|
class LcevcService(FakeService):
|
|
"""A 540p base video and the 1080p LCEVC enhancement layer that decodes on top of it."""
|
|
|
|
def get_tracks(self, title: Episode) -> Tracks:
|
|
tracks = super().get_tracks(title)
|
|
tracks.videos[0].height = 540
|
|
tracks.add(Video(id_="lcevc", url="https://x/l", language="en", codec=Video.Codec.LCEVC, height=1080))
|
|
return tracks
|
|
|
|
|
|
def test_an_lcevc_layer_is_left_out_unless_asked_for(
|
|
monkeypatch: pytest.MonkeyPatch, caplog: pytest.LogCaptureFixture
|
|
) -> None:
|
|
assert run(monkeypatch, caplog, {1: {}}, service=LcevcService({1: {}}))["video"] == ["v"]
|
|
asked = run(monkeypatch, caplog, {1: {}}, service=LcevcService({1: {}}), vcodec=[Video.Codec.LCEVC])
|
|
assert asked["video"] == ["lcevc"]
|