""" 验证绿联媒体服务器的目录查询、登录和会话管理。 """ from unittest.mock import patch import pytest from app import schemas from app.application.history import TransferHistoryMonthlyStatistics from app.modules.ugreen.ugreen import Ugreen from app.schemas.types import MediaSource try: from app.api.endpoints import dashboard as dashboard_endpoint except Exception: dashboard_endpoint = None class _FakeUgreenApi: host = "http://127.0.0.1:9999" token = "test-token" @staticmethod def video_all(classification: int, page: int = 1, page_size: int = 1): """ 按电影和电视剧分类返回预设总数,模拟不提供集数统计的绿联接口。 """ if classification == -102: return {"total_num": 12} if classification == -103: return {"total_num": 34} return {"total_num": 0} class _FakeReconnectApi: token = "test-token" @staticmethod def login(_username, _password): """ 返回固定登录令牌,隔离重连流程的真实认证请求。 """ return "test-token" @staticmethod def current_user(): """ 返回预设当前用户,模拟登录后的身份查询成功。 """ return {"name": "tester"} @staticmethod def close(): """ 保留客户端关闭入口,不释放任何真实网络资源。 """ return None @staticmethod def export_session_state(): """ 返回可持久化的测试令牌与公钥,供会话恢复流程使用。 """ return {"token": "test-token", "public_key": "public-key"} class _PagedFolderApi: def __init__(self, stop_after: int | None = None): self.calls = 0 self.pages = [] self.stop_after = stop_after def poster_wall_get_folder(self, page: int, page_size: int = 100): """ 记录目录分页请求,并按预设页数模拟末页标记。 """ self.calls += 1 self.pages.append(page) if self.stop_after is not None and page >= self.stop_after: return { "folder_arr": [ {"media_lib_set_id": page, "path": f"/library/{page}"}, ], "is_last_page": True, } return { "folder_arr": [ {"media_lib_set_id": page, "path": f"/library/{page}"}, ], "is_last_page": False, } class _FakeMediaApi: """ 媒体库服务接口的最小伪实现。 """ host = "https://nas.example:9443" token = "media-token" user_id = "user-id" server_id = "server-id" def __init__(self) -> None: """ 初始化可记录请求参数的伪媒体接口。 """ self.calls: list[tuple[str, dict]] = [] @staticmethod def _movie() -> dict: """ 返回电影条目样本。 """ return { "Id": "movie-id", "Type": "Movie", "Name": "示例电影", "OriginalTitle": "Example Movie", "ProductionYear": 2024, "ProviderIds": {"Tmdb": "100"}, "ParentId": "movie-library", "Path": "/media/movies/example", "BackdropImageTags": ["movie-backdrop"], } @staticmethod def _series() -> dict: """ 返回电视剧条目样本。 """ return { "Id": "series-id", "Type": "Series", "Name": "示例剧集", "OriginalTitle": "Example Series", "ProductionYear": 2023, "ProviderIds": {"Tmdb": "200"}, "ParentId": "tv-library", "Path": "/media/tv/example", } @staticmethod def _episode() -> dict: """ 返回剧集条目样本。 """ return { "Id": "episode-id", "Type": "Episode", "Name": "第二集", "SeriesName": "示例剧集", "SeriesId": "series-id", "ParentId": "season-id", "ParentIndexNumber": 1, "IndexNumber": 2, "ProviderIds": {"Tmdb": "200"}, "UserData": {"PlayedPercentage": 25.0}, } def current_user(self) -> dict: """ 返回有效媒体库用户。 """ return {"Id": self.user_id, "Name": "tester"} def views(self) -> list[dict]: """ 返回电影和电视剧媒体库视图。 """ return [ { "Id": "movie-library", "Name": "电影", "CollectionType": "movies", "Path": "/media/movies", }, { "Id": "tv-library", "Name": "剧集", "CollectionType": "tvshows", "Path": "/media/tv", }, ] def items(self, **kwargs: object) -> dict: """ 按查询条件返回预置的用户条目。 """ self.calls.append(("items", dict(kwargs))) parent_id = kwargs.get("parent_id") ids = kwargs.get("ids") include_item_types = kwargs.get("include_item_types") if ids == "movie-id": return {"Items": [self._movie()], "TotalRecordCount": 1} if ids == "series-id": return {"Items": [self._series()], "TotalRecordCount": 1} if parent_id == "movie-library": return {"Items": [self._movie()], "TotalRecordCount": 1} if parent_id == "tv-library": return {"Items": [self._series()], "TotalRecordCount": 1} if include_item_types == "Movie": return {"Items": [self._movie()], "TotalRecordCount": 1} if include_item_types == "Series": return {"Items": [self._series()], "TotalRecordCount": 1} if include_item_types == "Movie,Series": return { "Items": [self._movie(), self._series()], "TotalRecordCount": 2, } if include_item_types == "Movie,Series,MusicAlbum": return { "Items": [self._movie(), self._series()], "TotalRecordCount": 2, } return {"Items": [], "TotalRecordCount": 0} def item(self, item_id: str) -> dict | None: """ 返回指定媒体条目详情。 """ return { "movie-id": self._movie(), "series-id": self._series(), }.get(item_id) def counts(self) -> dict: """ 返回媒体库数量统计。 """ return { "MovieCount": 11, "SeriesCount": 3, "EpisodeCount": 27, "MusicAlbumCount": 5, } def resume(self, limit: int = 20) -> list[dict]: """ 返回继续观看条目。 """ _ = limit return [self._movie() | {"UserData": {"PlayedPercentage": 50.0}}, self._episode()] def episodes(self, series_id: str, season: int | None = None) -> list[dict]: """ 返回指定剧集的已入库集数。 """ assert series_id == "series-id" assert season in (None, 1) return [self._episode()] def image_url(self, item_id: str, image_type: str = "Primary") -> str: """ 返回伪造的媒体图片地址。 """ return f"{self.host}/emby/Items/{item_id}/Images/{image_type}?api_key={self.token}" def close(self) -> None: """ 关闭伪媒体接口。 """ return None def _build_media_service() -> tuple[Ugreen, _FakeMediaApi]: """ 构造已认证的媒体库服务模式绿联实例。 """ media_api = _FakeMediaApi() ugreen = Ugreen.__new__(Ugreen) ugreen._host = media_api.host ugreen._username = "tester" ugreen._password = "secret" ugreen._userinfo = {"Id": media_api.user_id, "Name": "tester"} ugreen._verify_ssl = True ugreen._connection_mode = Ugreen.MEDIA_SERVICE_CONNECTION_MODE ugreen._media_api = media_api ugreen._api = None ugreen._playhost = "https://play.example" ugreen._libraries = {} ugreen._library_paths = {} ugreen._sync_libraries = [] return ugreen, media_api def test_resolve_scan_type(): """ 扫描模式支持具名策略与数字形式,并归一化为接口扫描类型。 """ resolve = Ugreen._Ugreen__resolve_scan_type assert resolve(scan_mode="new_and_modified") == 1 assert resolve(scan_mode="supplement_missing") == 2 assert resolve(scan_mode="full_override") == 3 assert resolve(scan_mode="1") == 1 assert resolve(scan_mode="2") == 2 assert resolve(scan_mode="3") == 3 assert resolve(scan_type=1) == 1 assert resolve(scan_type=2) == 2 assert resolve(scan_type=3) == 3 assert resolve(scan_mode="unknown") == 2 assert resolve() == 2 def test_resolve_verify_ssl(): """ 证书校验设置兼容布尔值与常见字符串,未配置时默认开启。 """ resolve = Ugreen._Ugreen__resolve_verify_ssl assert resolve(True) is True assert resolve(False) is False assert resolve("true") is True assert resolve("1") is True assert resolve("false") is False assert resolve("0") is False assert resolve(None) is True def test_resolve_connection_mode_uses_media_service_port(): """ 9443 默认使用媒体库服务,显式 internal 可保留旧接口行为。 """ resolve = Ugreen._Ugreen__resolve_connection_mode assert resolve("https://nas.example:9443") == Ugreen.MEDIA_SERVICE_CONNECTION_MODE assert resolve("nas.example:9443") == Ugreen.MEDIA_SERVICE_CONNECTION_MODE assert resolve("https://nas.example:9443", "internal") == Ugreen.INTERNAL_CONNECTION_MODE assert resolve("https://nas.example:9999", "media_service") == Ugreen.MEDIA_SERVICE_CONNECTION_MODE def test_media_service_supports_library_query_and_core_media_operations(): """ 媒体库服务模式应覆盖媒体库、搜索、详情、播放和同步查询能力。 """ ugreen, media_api = _build_media_service() libraries = ugreen.get_librarys() assert libraries is not None assert [library.id for library in libraries] == ["movie-library", "tv-library"] assert libraries[0].type == "电影" assert libraries[0].item_count == 1 stat = ugreen.get_medias_count() assert stat.movie_count == 11 assert stat.tv_count == 3 assert stat.episode_count == 27 assert stat.music_count == 5 assert ugreen.get_user_count() == 1 movies = ugreen.get_movies( "示例电影", year="2024", media_source=MediaSource.TMDB, media_id="100", ) assert movies is not None assert [movie.item_id for movie in movies] == ["movie-id"] assert ugreen.get_iteminfo("movie-id").title == "示例电影" series_id, season_episodes = ugreen.get_tv_episodes( item_id="series-id", title="示例剧集", year="2023", media_source=MediaSource.TMDB, media_id="200", season=1, ) assert series_id == "series-id" assert season_episodes == {1: [2]} items = list(ugreen.get_items("movie-library", limit=1)) assert [item.item_id for item in items] == ["movie-id"] assert ugreen.get_items_count("movie-library") == 1 play_url = ugreen.get_play_url("movie-id") assert play_url == ("https://play.example/web/index.html#!/item?id=movie-id&context=home&serverId=server-id") resume = ugreen.get_resume(num=2) assert resume is not None assert [item.item_id for item in resume] == ["movie-id", "episode-id"] assert resume[0].percent == 50.0 latest = ugreen.get_latest(num=2) assert latest is not None assert [item.item_id for item in latest] == ["movie-id", "series-id"] assert ugreen.get_latest_backdrops(num=1, remote=True) == [ "https://play.example/emby/Items/movie-id/Images/Backdrop?api_key=media-token" ] assert ugreen.refresh_root_library() is False assert any(name == "items" for name, _ in media_api.calls) def test_get_medias_count_episode_is_none(): """ 绿联只提供电影和电视剧数量时,集数保持未知而非误填为零。 """ ugreen = Ugreen.__new__(Ugreen) ugreen._host = "http://127.0.0.1:9999" ugreen._username = "tester" ugreen._password = "secret" ugreen._userinfo = {"name": "tester"} ugreen._api = _FakeUgreenApi() stat = ugreen.get_medias_count() assert stat.movie_count == 12 assert stat.tv_count == 34 assert stat.episode_count is None def test_reconnect_does_not_eagerly_load_libraries(): """ 客户端重连不立即加载媒体库,避免认证路径触发额外扫描。 """ ugreen = Ugreen.__new__(Ugreen) ugreen._host = "http://127.0.0.1:9999" ugreen._username = "tester" ugreen._password = "secret" ugreen._verify_ssl = True ugreen._libraries = {"old": {"id": "old"}} ugreen._library_paths = {"old": "/old"} ugreen._api = None ugreen._userinfo = None with patch.object(Ugreen, "_Ugreen__restore_persisted_session", return_value=False), patch( "app.modules.ugreen.ugreen.Api", return_value=_FakeReconnectApi() ), patch.object(Ugreen, "_Ugreen__save_persisted_session", return_value=None), patch.object( Ugreen, "disconnect", wraps=ugreen.disconnect ), patch.object(Ugreen, "get_librarys") as mocked_get_librarys: assert ugreen.reconnect() is True mocked_get_librarys.assert_not_called() assert ugreen._libraries == {} assert ugreen._library_paths == {} def test_load_library_paths_stops_at_last_page(): """ 读取媒体库路径时遇到末页标记立即停止请求。 """ ugreen = Ugreen.__new__(Ugreen) ugreen._username = "tester" ugreen._api = _PagedFolderApi(stop_after=3) paths = ugreen._Ugreen__load_library_paths() assert ugreen._api.pages == [1, 2, 3] assert paths["3"] == "/library/3" def test_load_library_paths_respects_page_limit(): """ 接口始终不报告末页时,媒体库路径读取仍受页数上限约束。 """ ugreen = Ugreen.__new__(Ugreen) ugreen._username = "tester" ugreen._api = _PagedFolderApi() paths = ugreen._Ugreen__load_library_paths() assert ugreen._api.calls == Ugreen.LIBRARY_PATH_PAGE_LIMIT assert len(paths) == Ugreen.LIBRARY_PATH_PAGE_LIMIT assert str(Ugreen.LIBRARY_PATH_PAGE_LIMIT) in paths class _DashboardRepository: """ Dashboard 汇总测试使用的零增量历史仓储。 """ @staticmethod def monthly_media_statistics() -> TransferHistoryMonthlyStatistics: """ 返回全零月度统计,隔离媒体服务汇总断言。 """ return TransferHistoryMonthlyStatistics( movies=0, tv_shows=0, episodes=0, music=0, ) @pytest.mark.skipif( dashboard_endpoint is None, reason="dashboard endpoint dependencies are missing", ) def test_statistic_all_episode_missing(): """ 所有媒体服务均缺少集数统计时,聚合结果保留未知状态。 """ mocked_stats = [ schemas.Statistic(movie_count=10, tv_count=20, episode_count=None, user_count=2), schemas.Statistic(movie_count=1, tv_count=2, episode_count=None, user_count=1), ] from app.application.dashboard import DashboardQueryService service = DashboardQueryService( repository=_DashboardRepository(), media_statistics=lambda _name: mocked_stats, ) ret = dashboard_endpoint.statistic(name="ugreen", service=service, _=None) assert ret.movie_count == 11 assert ret.tv_count == 22 assert ret.user_count == 3 assert ret.episode_count is None @pytest.mark.skipif( dashboard_endpoint is None, reason="dashboard endpoint dependencies are missing", ) def test_statistic_mixed_episode_count(): """ 部分媒体服务提供集数时,只累加已知数量并兼容缺失值。 """ mocked_stats = [ schemas.Statistic(movie_count=10, tv_count=20, episode_count=None, user_count=2), schemas.Statistic(movie_count=1, tv_count=2, episode_count=6, user_count=1), ] from app.application.dashboard import DashboardQueryService service = DashboardQueryService( repository=_DashboardRepository(), media_statistics=lambda _name: mocked_stats, ) ret = dashboard_endpoint.statistic(name="all", service=service, _=None) assert ret.movie_count == 11 assert ret.tv_count == 22 assert ret.user_count == 3 assert ret.episode_count == 6