| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242 |
- """Tests pour src.server_mcp.resources."""
- from __future__ import annotations
- from typing import Any
- from unittest.mock import MagicMock
- import httpx
- import pytest
- from mcp.client.session import ClientSession
- from src.server_mcp.resources import (
- _GET_RESOURCES_WHITELIST,
- _filter_list,
- _unwrap_data,
- )
- from src.services.client_rest import HTTPMethod
- from tests.conftest import read_resource_json
- def _http_error() -> httpx.HTTPStatusError:
- request = httpx.Request("GET", "https://api.example.com/rest/tools/resource/1")
- response = httpx.Response(500, request=request)
- return httpx.HTTPStatusError("Server Error", request=request, response=response)
- class TestHelpers:
- def test_filter_list_filters_dict_items(self) -> None:
- items = [
- {"id": 1, "alias": "a", "extra": "x"},
- "raw-item",
- ]
- result = _filter_list(items, _GET_RESOURCES_WHITELIST)
- assert result[0] == {"id": 1, "alias": "a"}
- assert result[1] == "raw-item"
- def test_unwrap_data_returns_response_when_not_wrapped(self) -> None:
- raw = {"id": 1, "alias": "home"}
- assert _unwrap_data(raw) is raw
- @pytest.mark.anyio
- class TestResourcesMcpIntegration:
- async def test_list_resources_exposes_static_endpoints(
- self,
- mcp_session: ClientSession,
- ) -> None:
- result = await mcp_session.list_resources()
- uris = {str(resource.uri) for resource in result.resources}
- assert uris == {"modx://templates", "modx://categories"}
- async def test_get_resource_via_client_session(
- self,
- mcp_session: ClientSession,
- client_rest: MagicMock,
- ) -> None:
- client_rest.execute.return_value = {
- "code": "200",
- "data": {
- "id": 10000,
- "alias": "accueil",
- "pagetitle": "Accueil",
- "internalKey": "ignored",
- },
- }
- result = await read_resource_json(mcp_session, "modx://resource/10000")
- assert result == {"id": 10000, "alias": "accueil", "pagetitle": "Accueil"}
- client_rest.execute.assert_called_once_with(
- method=HTTPMethod.GET,
- endpoint="/rest/tools/resource/10000",
- params={"showUnpublished": 1},
- )
- async def test_get_resource_falls_back_without_query_params_on_http_error(
- self,
- mcp_session: ClientSession,
- client_rest: MagicMock,
- ) -> None:
- client_rest.execute.side_effect = [
- _http_error(),
- {"code": "200", "data": {"id": 10000, "alias": "accueil"}},
- ]
- result = await read_resource_json(mcp_session, "modx://resource/10000")
- assert result == {"id": 10000, "alias": "accueil"}
- assert client_rest.execute.call_count == 2
- async def test_get_resource_returns_raw_wrapper_when_data_is_not_dict(
- self,
- mcp_session: ClientSession,
- client_rest: MagicMock,
- ) -> None:
- client_rest.execute.return_value = {"code": "200", "data": "unexpected"}
- result = await read_resource_json(mcp_session, "modx://resource/10000")
- assert result == {"data": {"code": "200", "data": "unexpected"}}
- async def test_get_resources_filters_list_items(
- self,
- mcp_session: ClientSession,
- client_rest: MagicMock,
- ) -> None:
- client_rest.execute.return_value = {
- "code": "200",
- "data": [
- {"id": 1, "alias": "child", "pagetitle": "Child", "extra": "x"},
- ],
- }
- result = await read_resource_json(mcp_session, "modx://resources/10000")
- assert result == {"items": [{"id": 1, "alias": "child", "pagetitle": "Child"}]}
- client_rest.execute.assert_called_once_with(
- method=HTTPMethod.GET,
- endpoint="/rest/tools/getresources/10000",
- params={"depth": -1, "includedTv": 0, "showUnpublished": 1},
- )
- async def test_get_resources_filters_items_inside_dict(
- self,
- mcp_session: ClientSession,
- client_rest: MagicMock,
- ) -> None:
- client_rest.execute.return_value = {
- "code": "200",
- "data": {
- "items": [{"id": 2, "alias": "x", "noise": "y"}],
- "meta": "kept",
- },
- }
- result = await read_resource_json(mcp_session, "modx://resources/10000")
- assert result["items"] == [{"id": 2, "alias": "x"}]
- assert result["meta"] == "kept"
- async def test_get_resources_filters_flat_dict_when_no_items_key(
- self,
- mcp_session: ClientSession,
- client_rest: MagicMock,
- ) -> None:
- client_rest.execute.return_value = {
- "code": "200",
- "data": {"id": 3, "alias": "solo", "noise": "y"},
- }
- result = await read_resource_json(mcp_session, "modx://resources/10000")
- assert result == {"id": 3, "alias": "solo"}
- async def test_get_resources_falls_back_without_query_params_on_http_error(
- self,
- mcp_session: ClientSession,
- client_rest: MagicMock,
- ) -> None:
- client_rest.execute.side_effect = [
- _http_error(),
- {"code": "200", "data": [{"id": 1, "alias": "child"}]},
- ]
- result = await read_resource_json(mcp_session, "modx://resources/10000")
- assert result == {"items": [{"id": 1, "alias": "child"}]}
- assert client_rest.execute.call_count == 2
- async def test_get_template_via_client_session(
- self,
- mcp_session: ClientSession,
- client_rest: MagicMock,
- ) -> None:
- client_rest.execute.return_value = {"code": "200", "data": {"id": 12, "name": "Page"}}
- result = await read_resource_json(mcp_session, "modx://template/12")
- assert result == {"id": 12, "name": "Page"}
- async def test_get_templates_via_client_session(
- self,
- mcp_session: ClientSession,
- client_rest: MagicMock,
- ) -> None:
- client_rest.execute.return_value = {"code": "200", "data": [{"id": 12}]}
- result = await read_resource_json(mcp_session, "modx://templates")
- assert result == {"items": [{"id": 12}]}
- async def test_get_tv_via_client_session(
- self,
- mcp_session: ClientSession,
- client_rest: MagicMock,
- ) -> None:
- client_rest.execute.return_value = {"code": "200", "data": {"id": 5, "name": "tv"}}
- result = await read_resource_json(mcp_session, "modx://tv/5")
- assert result == {"id": 5, "name": "tv"}
- async def test_get_category_via_client_session(
- self,
- mcp_session: ClientSession,
- client_rest: MagicMock,
- ) -> None:
- client_rest.execute.return_value = {"code": "200", "data": {"id": 7, "category": "UI"}}
- result = await read_resource_json(mcp_session, "modx://category/7")
- assert result == {"id": 7, "category": "UI"}
- async def test_get_categories_via_client_session(
- self,
- mcp_session: ClientSession,
- client_rest: MagicMock,
- ) -> None:
- client_rest.execute.return_value = {"code": "200", "data": [{"id": 1}]}
- result = await read_resource_json(mcp_session, "modx://categories")
- assert result == {"items": [{"id": 1}]}
- async def test_get_categories_returns_warning_when_endpoint_unavailable(
- self,
- mcp_session: ClientSession,
- client_rest: MagicMock,
- ) -> None:
- client_rest.execute.side_effect = _http_error()
- result = await read_resource_json(mcp_session, "modx://categories")
- assert result == {
- "items": [],
- "warning": "Endpoint /rest/tools/categories indisponible sur ce serveur.",
- }
|