Replace HTTP client on TestClient from requests to httpx

README.md

@@ -30,7 +30,7 @@ It is production-ready, and gives you the following:
 * WebSocket support.
 * In-process background tasks.
 * Startup and shutdown events.
-* Test client built on `requests`.
+* Test client built on `httpx`.
 * CORS, GZip, Static Files, Streaming responses.
 * Session and Cookie support.
 * 100% test coverage.
@@ -87,7 +87,7 @@ For a more complete example, see [encode/starlette-example](https://github.com/e
 
 Starlette only requires `anyio`, and the following are optional:
 
-* [`requests`][requests] - Required if you want to use the `TestClient`.
+* [`httpx`][httpx] - Required if you want to use the `TestClient`.
 * [`jinja2`][jinja2] - Required if you want to use `Jinja2Templates`.
 * [`python-multipart`][python-multipart] - Required if you want to support form parsing, with `request.form()`.
 * [`itsdangerous`][itsdangerous] - Required for `SessionMiddleware` support.
@@ -134,6 +134,7 @@ in isolation.
 <p align="center"><i>Starlette is <a href="https://github.com/encode/starlette/blob/master/LICENSE.md">BSD licensed</a> code.<br/>Designed & crafted with care.</i></br>&mdash; ⭐️ &mdash;</p>
 
 [asgi]: https://asgi.readthedocs.io/en/latest/
+[httpx]: https://www.python-httpx.org/
 [requests]: http://docs.python-requests.org/en/master/
 [jinja2]: http://jinja.pocoo.org/
 [python-multipart]: https://andrew-d.github.io/python-multipart/

docs/index.md

@@ -27,7 +27,7 @@ It is production-ready, and gives you the following:
 * WebSocket support.
 * In-process background tasks.
 * Startup and shutdown events.
-* Test client built on `requests`.
+* Test client built on `httpx`.
 * CORS, GZip, Static Files, Streaming responses.
 * Session and Cookie support.
 * 100% test coverage.
@@ -83,7 +83,7 @@ For a more complete example, [see here](https://github.com/encode/starlette-exam
 
 Starlette only requires `anyio`, and the following dependencies are optional:
 
-* [`requests`][requests] - Required if you want to use the `TestClient`.
+* [`httpx`][httpx] - Required if you want to use the `TestClient`.
 * [`jinja2`][jinja2] - Required if you want to use `Jinja2Templates`.
 * [`python-multipart`][python-multipart] - Required if you want to support form parsing, with `request.form()`.
 * [`itsdangerous`][itsdangerous] - Required for `SessionMiddleware` support.
@@ -130,7 +130,7 @@ in isolation.
 <p align="center"><i>Starlette is <a href="https://github.com/encode/starlette/blob/master/LICENSE.md">BSD licensed</a> code.<br/>Designed & crafted with care.</i></br>&mdash; ⭐️ &mdash;</p>
 
 [asgi]: https://asgi.readthedocs.io/en/latest/
-[requests]: http://docs.python-requests.org/en/master/
+[httpx]: https://www.python-httpx.org/
 [jinja2]: http://jinja.pocoo.org/
 [python-multipart]: https://andrew-d.github.io/python-multipart/
 [itsdangerous]: https://pythonhosted.org/itsdangerous/

docs/testclient.md

@@ -1,6 +1,6 @@
 
 The test client allows you to make requests against your ASGI application,
-using the `requests` library.
+using the `httpx` library.
 
 ```python
 from starlette.responses import HTMLResponse
@@ -19,11 +19,11 @@ def test_app():
     assert response.status_code == 200
 ```
 
-The test client exposes the same interface as any other `requests` session.
+The test client exposes the same interface as any other `httpx` session.
 In particular, note that the calls to make a request are just standard
 function calls, not awaitables.
 
-You can use any of `requests` standard API, such as authentication, session
+You can use any of `httpx` standard API, such as authentication, session
 cookies handling, or file uploads.
 
 By default the `TestClient` will raise any exceptions that occur in the
@@ -58,7 +58,7 @@ def test_app()
 
 You can also test websocket sessions with the test client.
 
-The `requests` library will be used to build the initial handshake, meaning you
+The `httpx` library will be used to build the initial handshake, meaning you
 can use the same authentication options and other headers between both http and
 websocket testing.
 
@@ -91,7 +91,7 @@ always raised by the test client.
 
 #### Establishing a test session
 
-* `.websocket_connect(url, subprotocols=None, **options)` - Takes the same set of arguments as `requests.get()`.
+* `.websocket_connect(url, subprotocols=None, **options)` - Takes the same set of arguments as `httpx.get()`.
 
 May raise `starlette.websockets.WebSocketDisconnect` if the application does not accept the websocket connection.
 

requirements.txt

@@ -9,7 +9,6 @@ databases[sqlite]==0.5.5
 flake8==4.0.1
 isort==5.10.1
 mypy==0.931
-types-requests==2.26.3
 types-contextvars==2.4.2
 types-PyYAML==6.0.4
 types-dataclasses==0.6.2

setup.cfg

@@ -29,6 +29,8 @@ filterwarnings=
     ignore: The 'variables' alias has been deprecated. Please use 'variable_values' instead\.:DeprecationWarning
     # Workaround for Python 3.9.7 (see https://bugs.python.org/issue45097)
     ignore:The loop argument is deprecated since Python 3\.8, and scheduled for removal in Python 3\.10\.:DeprecationWarning:asyncio
+    ignore: The `allow_redirects` argument is deprecated. Use `follow_redirects` instead.:DeprecationWarning
+    ignore: Use 'content=<...>' to upload raw bytes/text content.:DeprecationWarning
     ignore: run_until_first_complete is deprecated and will be removed in a future version.:DeprecationWarning
     ignore: starlette\.middleware\.wsgi is deprecated and will be removed in a future release\.*:DeprecationWarning
 

setup.py

@@ -48,7 +48,8 @@ def get_long_description():
             "jinja2",
             "python-multipart",
             "pyyaml",
-            "requests",
+            # "httpx>=0.20.0"
+            "httpx @ git+https://github.com/encode/httpx.git@master",
         ]
     },
     classifiers=[