{"id": "testing_plugins:testing-datasette-client", "page": "testing_plugins", "ref": "testing-datasette-client", "title": "Using datasette.client in tests", "content": "The  datasette.client  mechanism is designed for use in tests. It provides access to a pre-configured  HTTPX async client  instance that can make GET, POST and other HTTP requests against a Datasette instance from inside a test. \n             A simple test looks like this: \n             @pytest.mark.asyncio\nasync def test_homepage():\n    ds = Datasette(memory=True)\n    response = await ds.client.get(\"/\")\n    html = response.text\n    assert \"<h1>\" in html\n \n             Or for a JSON API: \n             @pytest.mark.asyncio\nasync def test_actor_is_null():\n    ds = Datasette(memory=True)\n    response = await ds.client.get(\"/-/actor.json\")\n    assert response.json() == {\"actor\": None}\n \n             To make requests as an authenticated actor, create a signed  ds_cookie  using the  datasette.client.actor_cookie()  helper function and pass it in  cookies=  like this: \n             @pytest.mark.asyncio\nasync def test_signed_cookie_actor():\n    ds = Datasette(memory=True)\n    cookies = {\"ds_actor\": ds.client.actor_cookie({\"id\": \"root\"})}\n    response = await ds.client.get(\"/-/actor.json\", cookies=cookies)\n    assert response.json() == {\"actor\": {\"id\": \"root\"}}", "breadcrumbs": "[\"Testing plugins\"]", "references": "[{\"href\": \"https://www.python-httpx.org/async/\", \"label\": \"HTTPX async client\"}]"}