expose app property for TestClient

CHANGES/2891.bugfix

@@ -0,0 +1 @@
+expose property `app` for TestClient

aiohttp/test_utils.py

@@ -187,6 +187,10 @@ def port(self):
     def server(self):
         return self._server
 
+    @property
+    def app(self):
+        return getattr(self._server, "app", None)
+
     @property
     def session(self):
         """An internal aiohttp.ClientSession.

docs/client_reference.rst

@@ -474,6 +474,7 @@ The client session supports the context manager protocol for self closing.
                             autoping=True,\
                             heartbeat=None,\
                             origin=None, \
+                            headers=None, \
                             proxy=None, proxy_auth=None, ssl=None, \
                             verify_ssl=None, fingerprint=None, \
                             ssl_context=None, proxy_headers=None, \
@@ -500,18 +501,22 @@ The client session supports the context manager protocol for self closing.
 
       :param bool autoclose: Automatically close websocket connection on close
                              message from server. If *autoclose* is False
-                             them close procedure has to be handled manually
+                             them close procedure has to be handled manually. 
+                             ``True`` by default
 
       :param bool autoping: automatically send *pong* on *ping*
-                            message from server
+                            message from server. ``True`` by default
 
       :param float heartbeat: Send *ping* message every *heartbeat*
                               seconds and wait *pong* response, if
                               *pong* response is not received then
                               close connection. The timer is reset on any data
-                              reception.
+                              reception.(optional)
 
-      :param str origin: Origin header to send to server
+      :param str origin: Origin header to send to server(optional)
+
+      :param dict headers: HTTP Headers to send with
+                           the request (optional)
 
       :param str proxy: Proxy URL, :class:`str` or :class:`~yarl.URL` (optional)
 
@@ -560,16 +565,16 @@ The client session supports the context manager protocol for self closing.
          authority channel, supported SSL options etc.
 
          .. versionadded:: 2.3
+
+         .. deprecated:: 3.0
+
+            Use ``ssl=ssl_context``
 
       :param dict proxy_headers: HTTP headers to send to the proxy if the
          parameter proxy has been provided.
 
          .. versionadded:: 2.3
 
-         .. deprecated:: 3.0
-
-            Use ``ssl=ssl_context``
-
       :param int compress: Enable Per-Message Compress Extension support.
                            0 for disable, 9 to 15 for window bit support.
                            Default value is 0.

docs/testing.rst

@@ -684,6 +684,12 @@ Test Client
       :class:`BaseTestServer` test server instance used in conjunction
       with client.
 
+   .. attribute:: app
+
+      An alias for :attr:`self.server.app`. return ``None`` if 
+      ``self.server`` is not :class:`TestServer` 
+      instance(e.g. :class:`RawTestServer` instance for test low-level server).
+
    .. attribute:: session
 
       An internal :class:`aiohttp.ClientSession`.

tests/test_test_utils.py

@@ -8,6 +8,7 @@
 import aiohttp
 from aiohttp import web
 from aiohttp.test_utils import AioHTTPTestCase
+from aiohttp.test_utils import RawTestServer as _RawTestServer
 from aiohttp.test_utils import TestClient as _TestClient
 from aiohttp.test_utils import TestServer as _TestServer
 from aiohttp.test_utils import (loop_context, make_mocked_request,
@@ -214,6 +215,23 @@ async def test_test_client_props(loop):
     async with client:
         assert isinstance(client.port, int)
         assert client.server is not None
+        assert client.app is not None
+    assert client.port is None
+
+
+async def test_test_client_raw_server_props(loop):
+
+    async def hello(request):
+        return web.Response(body=_hello_world_bytes)
+
+    client = _TestClient(_RawTestServer(hello, host='127.0.0.1', loop=loop),
+                         loop=loop)
+    assert client.host == '127.0.0.1'
+    assert client.port is None
+    async with client:
+        assert isinstance(client.port, int)
+        assert client.server is not None
+        assert client.app is None
     assert client.port is None