Fix NoContent with NoContentSchema and replace pagination Nested schema

example/fake_api/bottle_api.py

@@ -85,19 +85,14 @@ class BottleController(object):
         }
 
     @hapic.with_api_doc()
-    @hapic.handle_exception(NoContentException, http_code=HTTPStatus.NO_CONTENT)
+    @hapic.output_body(NoContentSchema(),
+                       default_http_code=204)
     @hapic.input_path(UserPathSchema())
     def del_user(self, id, hapic_data: HapicData):
         """
         delete user
         """
-
-        # TODO - G.M - 2017-12-05 - Add better
-        #  way to doc response of this function, using response object ?
-        # return bottle.Response(
-        #     status=204,
-        # )
-        raise NoContentException
+        return NoContentSchema()
 
     def bind(self, app:bottle.Bottle):
         app.route('/about', callback=self.about)

example/fake_api/flask_api.py

@@ -86,19 +86,14 @@ class FlaskController(object):
         }
 
     @hapic.with_api_doc()
-    @hapic.handle_exception(NoContentException, http_code=HTTPStatus.NO_CONTENT)
+    @hapic.output_body(NoContentSchema(),
+                       default_http_code=204)
     @hapic.input_path(UserPathSchema())
     def del_user(self, id, hapic_data: HapicData):
         """
         delete user
         """
-
-        # TODO - G.M - 2017-12-05 - Add better
-        #  way to doc response of this function, using response object ?
-        # return flask.Response(
-        #     status=204,
-        # )
-        raise NoContentException
+        return NoContentSchema()
 
     def bind(self, app: flask.Flask):
         app.add_url_rule('/about',

example/fake_api/pyramid_api.py

@@ -87,19 +87,14 @@ class PyramidController(object):
         }
 
     @hapic.with_api_doc()
-    @hapic.handle_exception(NoContentException, http_code=HTTPStatus.NO_CONTENT)
+    @hapic.output_body(NoContentSchema(),
+                       default_http_code=204)
     @hapic.input_path(UserPathSchema())
     def del_user(self, context, request, hapic_data: HapicData):
         """
         delete user
         """
-
-        # TODO - G.M - 2017-12-05 - Add better
-        #  way to doc response of this function, using response object ?
-        # return Response(
-        #     status_code=204,
-        # )
-        raise NoContentException
+        return NoContentSchema()
 
     def bind(self, configurator: Configurator):
         configurator.add_route('about', '/about', request_method='GET')

example/fake_api/schema.py

@@ -1,6 +1,8 @@
 # -*- coding: utf-8 -*-
 import marshmallow
 
+class NoContentSchema(marshmallow.Schema):
+    pass
 
 class AboutResponseSchema(marshmallow.Schema):
     version = marshmallow.fields.String(required=True,)
@@ -47,8 +49,6 @@ class ListsUserSchema(marshmallow.Schema):
     # Can't add doc for nested Schema properly
     # When schema item isn't added through their own method
     # Ex : Pagination Schema doesn't work here but UserSchema is ok.
-    pagination = {
-        'first_id': marshmallow.fields.Int(required=True),
-        'last_id': marshmallow.fields.Int(required=True),
-        'current_id': marshmallow.fields.Int(required=True),
-    }
+    pagination = marshmallow.fields.Nested(
+        PaginationSchema
+    )