{"id": "testing_plugins:testing-plugins-pytest-httpx", "page": "testing_plugins", "ref": "testing-plugins-pytest-httpx", "title": "Testing outbound HTTP calls with pytest-httpx", "content": "If your plugin makes outbound HTTP calls - for example datasette-auth-github or datasette-import-table - you may need to mock those HTTP requests in your tests. \n             The  pytest-httpx  package is a useful library for mocking calls. It can be tricky to use with Datasette though since it mocks all HTTPX requests, and Datasette's own testing mechanism uses HTTPX internally. \n             To avoid breaking your tests, you can return  [\"localhost\"]  from the  non_mocked_hosts()  fixture. \n             As an example, here's a very simple plugin which executes an HTTP response and returns the resulting content: \n             from datasette import hookimpl\nfrom datasette.utils.asgi import Response\nimport httpx\n\n\n@hookimpl\ndef register_routes():\n    return [\n        (r\"^/-/fetch-url$\", fetch_url),\n    ]\n\n\nasync def fetch_url(datasette, request):\n    if request.method == \"GET\":\n        return Response.html(\n            \"\"\"\n            <form action=\"/-/fetch-url\" method=\"post\">\n            <input type=\"hidden\" name=\"csrftoken\" value=\"{}\">\n            <input name=\"url\"><input type=\"submit\">\n        </form>\"\"\".format(\n                request.scope[\"csrftoken\"]()\n            )\n        )\n    vars = await request.post_vars()\n    url = vars[\"url\"]\n    return Response.text(httpx.get(url).text) \n             Here's a test for that plugin that mocks the HTTPX outbound request: \n             from datasette.app import Datasette\nimport pytest\n\n\n@pytest.fixture\ndef non_mocked_hosts():\n    # This ensures httpx-mock will not affect Datasette's own\n    # httpx calls made in the tests by datasette.client:\n    return [\"localhost\"]\n\n\nasync def test_outbound_http_call(httpx_mock):\n    httpx_mock.add_response(\n        url=\"https://www.example.com/\",\n        text=\"Hello world\",\n    )\n    datasette = Datasette([], memory=True)\n    response = await datasette.client.post(\n        \"/-/fetch-url\",\n        data={\"url\": \"https://www.example.com/\"},\n    )\n    assert response.text == \"Hello world\"\n\n    outbound_request = httpx_mock.get_request()\n    assert (\n        outbound_request.url == \"https://www.example.com/\"\n    )", "breadcrumbs": "[\"Testing plugins\"]", "references": "[{\"href\": \"https://pypi.org/project/pytest-httpx/\", \"label\": \"pytest-httpx\"}]"}