Add support resource (add_resource) based decorator.

Author: belyalov

README.md

@@ -59,6 +59,12 @@ async def images(req, resp, fn):
     # Send picture. Filename - in just a parameter
     await resp.send_file('images/{}'.format(fn))
 
+# Some REST API endpoint
+@app.resource('/user/<id>')
+def user(data, id):
+    return {'id': id, 'name': 'Foo', 'status': 'online'}
+
+
 if __name__ == '__main__':
     app.run(host='0.0.0.0', port=80)
 ```
@@ -110,6 +116,22 @@ Main tinyweb app class.
   `**kwargs` are optional and will be passed to handler directly.
     **Note**: only `GET`, `POST`, `PUT` and `DELETE` methods are supported. Check [restapi full example](https://github.com/belyalov/tinyweb/blob/master/examples/rest_api.py) as well.
 
+* `@resource` - the same idea as for `route` but for resource:
+    ```python
+    # Regular version
+    @app.resource('/user/<id>')
+    def user(data, id):
+        return {'id': id, 'name': 'foo'}
+
+    # Generator based / different HTTP method
+    @app.resource('/user/<id>', method='POST')
+    async def user(data, id):
+        yield '{'
+        yield '"id": "{}",'.format(id)
+        yield '"name": "test",'
+        yield '}'
+    ```
+
 * `run(self, host="127.0.0.1", port=8081, loop_forever=True, backlog=10)` - run web server. Since *tinyweb* is fully async server by default it is blocking call assuming that you've added other tasks before.
     * `host` - host to listen on
     * `port` - port to listen on

test/test_server.py

@@ -254,7 +254,7 @@ def testUrlFinderNegative(self):
             srv.add_route('/duppp', 1)
 
 
-# We want to test decorator @server.route as well
+# We want to test decorators as well
 server_for_decorators = webserver()
 
 
@@ -265,6 +265,16 @@ async def route_for_decorator(req, resp, user_id):
     await resp.send('YO, {}'.format(user_id))
 
 
+@server_for_decorators.resource('/rest1/<user_id>')
+def resource_for_decorator1(data, user_id):
+    return {'name': user_id}
+
+
+@server_for_decorators.resource('/rest2/<user_id>')
+async def resource_for_decorator2(data, user_id):
+    yield '{"name": user_id}'
+
+
 class ServerFull(unittest.TestCase):
 
     def setUp(self):
@@ -279,7 +289,7 @@ def setUp(self):
         self.srv = webserver()
         self.srv.conns[id(1)] = None
 
-    def testDecorator(self):
+    def testRouteDecorator1(self):
         """Test @.route() decorator"""
         # First decorator
         rdr = mockReader(['GET /uid/man1 HTTP/1.1\r\n',
@@ -294,6 +304,7 @@ def testDecorator(self):
         self.assertEqual(wrt.history, expected)
         self.assertTrue(wrt.closed)
 
+    def testRouteDecorator2(self):
         # Second decorator
         rdr = mockReader(['GET /uid2/man2 HTTP/1.1\r\n',
                           HDRE])
@@ -309,6 +320,42 @@ def testDecorator(self):
         self.assertEqual(wrt.history, expected)
         self.assertTrue(wrt.closed)
 
+    def testResourceDecorator1(self):
+        """Test @.resource() decorator"""
+        rdr = mockReader(['GET /rest1/man1 HTTP/1.1\r\n',
+                          HDRE])
+        wrt = mockWriter()
+        run_coro(server_for_decorators._handler(rdr, wrt))
+        expected = ['HTTP/1.0 200 MSG\r\n'
+                    'Access-Control-Allow-Origin: *\r\n' +
+                    'Access-Control-Allow-Headers: *\r\n' +
+                    'Content-Length: 16\r\n' +
+                    'Access-Control-Allow-Methods: GET\r\n' +
+                    'Content-Type: application/json\r\n\r\n',
+                    '{"name": "man1"}']
+        self.assertEqual(wrt.history, expected)
+        self.assertTrue(wrt.closed)
+
+    def testResourceDecorator2(self):
+        rdr = mockReader(['GET /rest2/man2 HTTP/1.1\r\n',
+                          HDRE])
+        wrt = mockWriter()
+        run_coro(server_for_decorators._handler(rdr, wrt))
+        expected = ['HTTP/1.1 200 MSG\r\n' +
+                    'Access-Control-Allow-Methods: GET\r\n' +
+                    'Connection: close\r\n' +
+                    'Access-Control-Allow-Headers: *\r\n' +
+                    'Content-Type: application/json\r\n' +
+                    'Transfer-Encoding: chunked\r\n' +
+                    'Access-Control-Allow-Origin: *\r\n\r\n',
+                    '11\r\n',
+                    '{"name": user_id}',
+                    '\r\n',
+                    '0\r\n\r\n'
+                    ]
+        self.assertEqual(wrt.history, expected)
+        self.assertTrue(wrt.closed)
+
     async def dummy_handler(self, req, resp):
         """Dummy URL handler. It just records the fact - it has been called"""
         self.dummy_req = req

tinyweb/server.py

@@ -577,6 +577,29 @@ def _route(f):
             return f
         return _route
 
+    def resource(self, url, method='GET', **kwargs):
+        """Decorator for add_resource() method
+
+        Examples:
+            @app.resource('/users')
+            def users(data):
+                return {'a': 1}
+
+            @app.resource('/messages/<topic_id>')
+            async def index(data, topic_id):
+                yield '{'
+                yield '"topic_id": "{}",'.format(topic_id)
+                yield '"message": "test",'
+                yield '}'
+        """
+        def _resource(f):
+            self.add_route(url, restful_resource_handler,
+                           methods=[method],
+                           save_headers=['Content-Length', 'Content-Type'],
+                           _callmap={method.encode(): (f, kwargs)})
+            return f
+        return _resource
+
     async def _tcp_server(self, host, port, backlog):
         """TCP Server implementation.
         Opens socket for accepting connection and