Add app.add_routes() method (#2787)

* Add app.add_routes() method

* Add changenote

* Add a test

CHANGES/2787.feature

@@ -0,0 +1 @@
+Implement ``app.add_routes()`` method.

aiohttp/web_app.py

@@ -194,6 +194,9 @@ def add_subapp(self, prefix, subapp):
             subapp._set_loop(self._loop)
         return resource
 
+    def add_routes(self, routes):
+        self.router.add_routes(routes)
+
     @property
     def on_response_prepare(self):
         return self._on_response_prepare

docs/web_reference.rst

@@ -1218,8 +1218,9 @@ duplicated like one using :meth:`Application.copy`.
    :param handler_args: dict-like object that overrides keyword arguments of
                         :meth:`Application.make_handler`
 
-   :param client_max_size: client's maximum size in a request, in bytes. If a POST
-                           request exceeds this value, it raises an
+   :param client_max_size: client's maximum size in a request, in
+                           bytes.  If a POST request exceeds this
+                           value, it raises an
                            `HTTPRequestEntityTooLarge` exception.
 
    :param loop: event loop
@@ -1309,6 +1310,32 @@ duplicated like one using :meth:`Application.copy`.
 
       .. seealso:: :ref:`aiohttp-web-graceful-shutdown` and :attr:`on_shutdown`.
 
+   .. method:: add_subapp(prefix, subapp)
+
+      Register nested sub-application under given path *prefix*.
+
+      In resolving process if request's path starts with *prefix* then
+      further resolving is passed to *subapp*.
+
+      :param str prefix: path's prefix for the resource.
+
+      :param Application subapp: nested application attached under *prefix*.
+
+      :returns: a :class:`PrefixedSubAppResource` instance.
+
+   .. method:: add_routes(routes_table)
+
+      Register route definitions from *routes_table*.
+
+      The table is a :class:`list` of :class:`RouteDef` items or
+      :class:`RouteTableDef`.
+
+      The method is a shortcut for
+      ``app.router.add_routes(routes_table)``, see also
+      :meth:`UrlDispatcher.add_routes`.
+
+      .. versionadded:: 3.1
+
    .. method:: make_handler(loop=None, **kwargs)
 
     Creates HTTP protocol factory for handling requests.
@@ -1619,19 +1646,6 @@ Router is any object that implements :class:`AbstractRouter` interface.
 
       :returns: new :class:`StaticRoute` instance.
 
-   .. method:: add_subapp(prefix, subapp)
-
-      Register nested sub-application under given path *prefix*.
-
-      In resolving process if request's path starts with *prefix* then
-      further resolving is passed to *subapp*.
-
-      :param str prefix: path's prefix for the resource.
-
-      :param Application subapp: nested application attached under *prefix*.
-
-      :returns: a :class:`PrefixedSubAppResource` instance.
-
    .. comethod:: resolve(request)
 
       A :ref:`coroutine<coroutine>` that returns

tests/test_web_functional.py

@@ -1708,3 +1708,16 @@ async def handler(request):
     assert 200 == resp.status
     txt = await resp.text()
     assert 'OK' == txt
+
+
+async def test_app_add_routes(aiohttp_client):
+
+    async def handler(request):
+        return web.Response()
+
+    app = web.Application()
+    app.add_routes([web.get('/get', handler)])
+
+    client = await aiohttp_client(app)
+    resp = await client.get('/get')
+    assert resp.status == 200