import asyncio import os from types import SimpleNamespace from unittest.mock import AsyncMock, MagicMock, patch import pytest from app.application.subscription.write import add_subscribe, async_add_subscribe from app.db.models.subscribe import Subscribe from app.db.models.subscribehistory import SubscribeHistory from app.db.oper.subscribe import SubscribeOper from app.domain.context import MusicInfo from app.schemas.types import MediaSource, MediaType def _add(**kwargs): """ 经应用层写入路径新增订阅。 媒体翻译住在 app/application/subscription/write.py,查重与落库仍在 SubscribeOper——本文件 钉的是查重语义(谁被查、查几次、带哪些身份字段),所以从翻译入口进、把不带真会话 的 Oper 注进去,两层的契约一次跑通。 """ return add_subscribe(subscribe_oper=SubscribeOper(db=MagicMock()), **kwargs) async def _async_add(**kwargs): """异步写入路径,与 _add 共用注入方式。""" session = MagicMock() session.flush = AsyncMock() return await async_add_subscribe( subscribe_oper=SubscribeOper(db=session), **kwargs, ) def _media(episode_group): """构造订阅新增路径所需的稳定 MediaInfo 契约替身。""" return SimpleNamespace( title="测试剧", year="2026", type=MediaType.TV, media_source=MediaSource.TMDB, media_id="987654321", episode_group=episode_group, vote_average=8.0, overview="测试简介", get_poster_image=lambda: None, get_backdrop_image=lambda: None, ) def test_add_history_converts_boolean_integer_flags(monkeypatch): """ 写入订阅历史前应把布尔开关转为整型,兼容 PostgreSQL 的严格类型检查。 """ captured = {} def fake_stage_create(_oper, model): """ 截获待写入模型,避免测试依赖具体数据库方言的类型宽松行为。 """ captured.update({ "id": model.id, "best_version": model.best_version, "best_version_full": model.best_version_full, "search_imdbid": model.search_imdbid, }) return model monkeypatch.setattr(SubscribeOper, "_stage_create", fake_stage_create) SubscribeOper().add_history( id=100, name="Test Movie", type="电影", best_version=False, best_version_full=True, search_imdbid=False, unknown_field=True, ) assert captured == { "id": None, "best_version": 0, "best_version_full": 1, "search_imdbid": 0, } @pytest.mark.parametrize("episode_group", [None, "eg-1"]) def test_add_scopes_duplicate_lookup_by_episode_group(episode_group): """同步新增前后都必须按剧集组查询,主季和自定义组不能互相去重。""" persisted = SimpleNamespace(id=88) created = SimpleNamespace(create=MagicMock()) with patch("app.db.oper.subscribe.Subscribe") as subscribe_model: subscribe_model.exists.side_effect = [None, persisted] subscribe_model.return_value = created sid, message = _add( mediainfo=_media(episode_group), season=1, ) assert (sid, message) == (88, "新增订阅成功") assert subscribe_model.exists.call_count == 2 assert all( call.kwargs["episode_group"] == episode_group for call in subscribe_model.exists.call_args_list ) # 媒体身份的三种残缺形态。守卫写的是 ``not media_source or not media_id``——只测「两者都空」 # 时 ``or`` 与 ``and`` 表现一致,必须把「只缺一半」的两种也测到,否则守卫被改宽也没人知道。 # 注意:真实的 resolve_media_identity 只会返回「两个都有」或「两个都空」,构造不出半残身份, # 所以这里必须替换掉它才能把守卫本身的契约钉住。 _INCOMPLETE_IDENTITIES = [ pytest.param((None, "987654321"), id="缺来源"), pytest.param((MediaSource.TMDB, None), id="缺原生ID"), pytest.param((None, None), id="两者皆缺"), ] @pytest.mark.parametrize("identity", _INCOMPLETE_IDENTITIES) def test_add_rejects_incomplete_media_identity(identity): """ 媒体身份只要缺一半就必须拒绝新增,且不得落库。 身份不全的订阅写进去就是一条永远匹配不上资源的僵尸订阅,后续按身份去重也会失效。 """ with patch("app.application.subscription.write.resolve_media_identity", return_value=identity), \ patch("app.db.oper.subscribe.Subscribe") as subscribe_model: result = _add(mediainfo=_media(None), season=1) assert result == (0, "媒体身份不完整") # 守卫必须在查询与建模之前短路,而不是先写进去再补救 subscribe_model.exists.assert_not_called() subscribe_model.assert_not_called() @pytest.mark.parametrize("identity", _INCOMPLETE_IDENTITIES) def test_async_add_rejects_incomplete_media_identity(identity): """异步新增与同步路径共用同一道身份守卫,两条链路不能一宽一严。""" with patch("app.application.subscription.write.resolve_media_identity", return_value=identity), \ patch("app.db.oper.subscribe.Subscribe") as subscribe_model: subscribe_model.async_exists = AsyncMock() result = asyncio.run(_async_add( mediainfo=_media(None), season=1)) assert result == (0, "媒体身份不完整") subscribe_model.async_exists.assert_not_awaited() subscribe_model.assert_not_called() def test_add_reports_failure_when_the_new_subscribe_cannot_be_read_back(): """ 创建后回查落空必须如实报「新增订阅失败」,不能把落空当成功返回。 回查落空意味着写入实际没生效(唯一约束冲突、事务回滚等);此时若返回成功, 调用方会继续按订阅已建立往下走,用户看到「订阅成功」却永远等不到资源。 """ created = SimpleNamespace(create=MagicMock()) with patch("app.db.oper.subscribe.Subscribe") as subscribe_model: subscribe_model.exists.side_effect = [None, None] subscribe_model.return_value = created result = _add(mediainfo=_media(None), season=1) assert result == (0, "新增订阅失败") def test_async_add_reports_failure_when_the_new_subscribe_cannot_be_read_back(): """异步新增的回查落空路径与同步一致。""" created = SimpleNamespace(async_create=AsyncMock()) with patch("app.db.oper.subscribe.Subscribe") as subscribe_model: subscribe_model.async_exists = AsyncMock(side_effect=[None, None]) subscribe_model.return_value = created result = asyncio.run(_async_add( mediainfo=_media(None), season=1)) assert result == (0, "新增订阅失败") def test_add_reports_existing_subscription_without_creating(): """ 首次查询即命中时返回既有订阅,不再建第二条。 重复建订阅会让同一部剧被两条订阅并行搜索、重复下载。 """ existing = SimpleNamespace(id=77) with patch("app.db.oper.subscribe.Subscribe") as subscribe_model: subscribe_model.exists.return_value = existing result = _add(mediainfo=_media(None), season=1) assert result == (77, "订阅已存在") assert subscribe_model.exists.call_count == 1 subscribe_model.assert_not_called() def test_async_add_reports_existing_subscription_without_creating(): """异步新增命中既有订阅时同样不建第二条。""" existing = SimpleNamespace(id=78) with patch("app.db.oper.subscribe.Subscribe") as subscribe_model: subscribe_model.async_exists = AsyncMock(return_value=existing) result = asyncio.run(_async_add( mediainfo=_media(None), season=1)) assert result == (78, "订阅已存在") assert subscribe_model.async_exists.await_count == 1 subscribe_model.assert_not_called() def test_music_subscribe_persists_release_cover_as_poster_and_backdrop(): """音乐订阅应把 MusicBrainz 发行封面写入订阅海报和背景字段。""" persisted = SimpleNamespace(id=92) created = SimpleNamespace(create=MagicMock()) media = MusicInfo( media_source=MediaSource.MusicBrainz, media_id="977e6978-139d-425c-bb98-6b0c62d1e45e", title="晴天", cover_url="https://coverartarchive.org/release-group/example/front-500", ) with patch("app.db.oper.subscribe.Subscribe") as subscribe_model: subscribe_model.exists.side_effect = [None, persisted] subscribe_model.return_value = created sid, _ = _add(mediainfo=media, season=None) assert sid == 92 payload = subscribe_model.call_args.kwargs assert payload["poster"] == media.cover_url assert payload["backdrop"] == media.cover_url def test_music_subscribe_persists_numeric_year_as_string(): """音乐识别链路的年份可能是数字,写库前必须转字符串避免 PostgreSQL 类型错误。""" persisted = SimpleNamespace(id=93) created = SimpleNamespace(create=MagicMock()) media = MusicInfo( media_source=MediaSource.MusicBrainz, media_id="2af54891-e954-40e8-8b90-b7e98c740f21", title="心愿", year=2025, cover_url="https://coverartarchive.org/release/example/front-500", ) with patch("app.db.oper.subscribe.Subscribe") as subscribe_model: subscribe_model.exists.side_effect = [None, persisted] subscribe_model.return_value = created sid, _ = _add(mediainfo=media, season=None) assert sid == 93 payload = subscribe_model.call_args.kwargs assert payload["year"] == "2025" def test_music_album_subscription_persists_entity_and_track_count(): """专辑订阅必须保存实体类型和总曲目数,供搜索校验与完成判定复用。""" persisted = SimpleNamespace(id=94) created = SimpleNamespace(create=MagicMock()) media = MusicInfo( media_source=MediaSource.MusicBrainz, media_id="release-group-1", music_type="album", title="叶惠美", album="叶惠美", total_tracks=11, ) with patch("app.db.oper.subscribe.Subscribe") as subscribe_model: subscribe_model.exists.side_effect = [None, persisted] subscribe_model.return_value = created sid, _ = _add(mediainfo=media, season=None) assert sid == 94 payload = subscribe_model.call_args.kwargs assert payload["music_type"] == "album" assert payload["total_tracks"] == 11 def test_music_recording_subscription_drops_album_track_count_and_scopes_identity(): """单曲只持久化实体类型,重复查询也必须携带实体,不能与专辑身份串用。""" persisted = SimpleNamespace(id=95) created = SimpleNamespace(create=MagicMock()) media = MusicInfo( media_source=MediaSource.MusicBrainz, media_id="recording-1", music_type="recording", title="晴天", album="叶惠美", total_tracks=11, ) with patch("app.db.oper.subscribe.Subscribe") as subscribe_model: subscribe_model.exists.side_effect = [None, persisted] subscribe_model.return_value = created sid, _ = _add(mediainfo=media, season=None) assert sid == 95 payload = subscribe_model.call_args.kwargs assert payload["music_type"] == "recording" assert payload["total_tracks"] is None assert all( call.kwargs["music_type"] == "recording" for call in subscribe_model.exists.call_args_list ) @pytest.mark.parametrize("episode_group", [None, "eg-1"]) def test_async_add_scopes_duplicate_lookup_by_episode_group(episode_group): """异步新增与同步路径使用相同的剧集组身份契约。""" persisted = SimpleNamespace(id=89) created = SimpleNamespace(async_create=AsyncMock()) with patch("app.db.oper.subscribe.Subscribe") as subscribe_model: subscribe_model.async_exists = AsyncMock(side_effect=[None, persisted]) subscribe_model.return_value = created sid, message = asyncio.run(_async_add( mediainfo=_media(episode_group), season=1, )) assert (sid, message) == (89, "新增订阅成功") assert subscribe_model.async_exists.await_count == 2 assert all( call.kwargs["episode_group"] == episode_group for call in subscribe_model.async_exists.await_args_list ) def test_owner_scoped_add_forwards_episode_group_sync_and_async(): """按 owner 去重的同步与异步新增也必须使用同一剧集组身份。""" media = _media("eg-owner") sync_persisted = SimpleNamespace(id=90) sync_created = SimpleNamespace(create=MagicMock()) with patch("app.db.oper.subscribe.Subscribe") as subscribe_model: subscribe_model.exists_by_username.side_effect = [None, sync_persisted] subscribe_model.return_value = sync_created sid, _ = _add( mediainfo=media, season=1, username="alice", owner_scope=True, ) assert sid == 90 assert all( call.kwargs["episode_group"] == "eg-owner" for call in subscribe_model.exists_by_username.call_args_list ) async_persisted = SimpleNamespace(id=91) async_created = SimpleNamespace(async_create=AsyncMock()) with patch("app.db.oper.subscribe.Subscribe") as subscribe_model: subscribe_model.async_exists_by_username = AsyncMock( side_effect=[None, async_persisted] ) subscribe_model.return_value = async_created sid, _ = asyncio.run(_async_add( mediainfo=media, season=1, username="alice", owner_scope=True, )) assert sid == 91 assert all( call.kwargs["episode_group"] == "eg-owner" for call in subscribe_model.async_exists_by_username.await_args_list ) def test_exists_defaults_to_main_season_episode_group(): """省略剧集组时按主季查询,显式剧集组按对应范围查询。""" oper = SubscribeOper(db=object()) with patch("app.db.oper.subscribe.Subscribe") as subscribe_model: subscribe_model.exists.return_value = SimpleNamespace(id=1) assert oper.exists( media_source=MediaSource.TMDB, media_id="100", season=1 ) is True assert subscribe_model.exists.call_args.kwargs["episode_group"] is None assert oper.exists( media_source=MediaSource.TMDB, media_id="100", season=1, episode_group="eg-1", ) is True assert subscribe_model.exists.call_args.kwargs["episode_group"] == "eg-1" with patch("app.db.oper.subscribe.SubscribeHistory") as history_model: history_model.exists.return_value = SimpleNamespace(id=2) assert oper.exist_history( media_source=MediaSource.TMDB, media_id="100", season=1 ) is True assert history_model.exists.call_args.kwargs["episode_group"] is None assert oper.exist_history( media_source=MediaSource.TMDB, media_id="100", season=1, episode_group="eg-1", ) is True assert history_model.exists.call_args.kwargs["episode_group"] == "eg-1" def test_subscribe_exists_distinguishes_same_season_episode_groups(db): """同一媒体同一季的主季、自定义剧集组应分别命中各自订阅。""" db.watermark(Subscribe) media_id = str(-(900_000_000 + os.getpid())) rows = [ Subscribe(name="主季订阅", type=MediaType.TV.value, state="N", media_source=MediaSource.TMDB.value, media_id=media_id, season=1, episode_group=None), Subscribe(name="剧集组订阅", type=MediaType.TV.value, state="N", media_source=MediaSource.TMDB.value, media_id=media_id, season=1, episode_group="eg-1"), ] for row in rows: row.create(db.session) db.session.commit() main_season = Subscribe.exists( db.session, media_source=MediaSource.TMDB, media_id=media_id, season=1, episode_group=None, ) main_name = main_season.name episode_group = Subscribe.exists( db.session, media_source=MediaSource.TMDB, media_id=media_id, season=1, episode_group="eg-1", ) episode_group_name = episode_group.name assert main_name == "主季订阅" assert episode_group_name == "剧集组订阅" Subscribe.delete(db.session, rid=main_season.id) db.session.commit() assert Subscribe.exists( db.session, media_source=MediaSource.TMDB, media_id=media_id, season=1, ) is None def test_subscribe_exists_distinguishes_music_entities_with_same_source_id(db): """统一来源 ID 相同时,单曲与专辑仍是两条独立订阅身份。""" db.watermark(Subscribe) media_id = f"music-shared-{os.getpid()}" rows = [ Subscribe( name="同名单曲", type=MediaType.MUSIC.value, state="N", media_source="musicbrainz", media_id=media_id, music_type="recording", ), Subscribe( name="同名专辑", type=MediaType.MUSIC.value, state="N", media_source="musicbrainz", media_id=media_id, music_type="album", total_tracks=10, ), ] for row in rows: row.create(db.session) db.session.commit() recording = Subscribe.exists( db.session, media_source="musicbrainz", media_id=media_id, music_type="recording", ) album = Subscribe.exists( db.session, media_source="musicbrainz", media_id=media_id, music_type="album", ) assert recording.name == "同名单曲" assert album.name == "同名专辑" def test_subscribe_chain_exists_forwards_episode_group(): """订阅前置存在性检查必须查询当前剧集组,不能退回主季范围。""" from app.chain.subscribe import SubscribeChain media = _media("eg-1") meta = SimpleNamespace(begin_season=1) with patch("app.chain.subscribe.SubscribeOper") as subscribe_oper_cls: subscribe_oper_cls.return_value.exists.return_value = True assert SubscribeChain.exists(media, meta) is True subscribe_oper_cls.return_value.exists.assert_called_once_with( media_source=MediaSource.TMDB, media_id=media.media_id, music_type=None, season=1, episode_group="eg-1", )