Installation

pip3 install https://github.com/plainas/flask-swagger-types/zipball/master

Example app:

fromflaskimportFlask,request,make_response,Responseimportmarshmallowimportpkg_resourcesfromflaskswaggertypesimportFlaskSwaggerTypes# 1. Define some general info you want included in your spec.spec_metadata= {'title':"My fancy web api",'description':"Does some fancy api stuff on my fancy api-y server" ,#'basePath': "/sofancy/", #(optional)'version':"33",#'host': "fancy.example.com" #(optional)}# 2. Define some marshmallow schemasclassPants(marshmallow.Schema):_id=marshmallow.fields.Int()name=marshmallow.fields.String()brand=marshmallow.fields.String()size=marshmallow.fields.Int()# You can define collections by nesting an existing type with Nested()classPantsList(marshmallow.Schema):pants=marshmallow.fields.Nested(Pants,many=True)# responses are defined like so:responses= [    [200 ,"Server will reply with 200 to successfull calls" ],    [400 ,"Just mentioning that calls to this api method could go south"],]# you can optionally pass the response Schemaresponses_with_type= [    [200 ,"Server will reply with 200 to successfull calls",PantsList ],    [400 ,"Server will repply with 400 if it rails to retrieve a list of pants" ],]# 3. Create your flask app as usualapp=Flask(__name__)# 4. Initialize flask-swagger-typesfst=FlaskSwaggerTypes(app,spec_metadata)# 5. Define some routes with @Fstroute()@fst.Fstroute('/savePants',"POST", {'body' :Pants },responses)defsaveYourFancyPants():# Parsed and validated data will be available atprint(request.fst_data)#...return"Success!!!"# path paramters are parsed and will automatically show up in your swagger spec# without the need to manually pass its schema.@fst.Fstroute('/getManyPants/<int:size>/<string:brand>',"GET", {},responses )defgetManyFancyPants(size,brand):print(request.fst_data)# ...return"your pants list here"@fst.Fstroute('/getFancyPants',"GET", {},responses_with_type)defgetFancyPants():pantslistschema=PantsList()empty_list=pantslistschema.dumps([])returnempty_list# 6. Start your flask app as usualapp.run()# Your swagger spec can now be accessed at [YOUR_APP_URL]/swagger_spec# To browse your api with swager-ui, go to [YOUR_APP_URL]/swagger_ui?url=/swagger_spec#/default

Api reference

#TODO.The sample app should cover what you need. If not, read the source. It's less than 200 lines of code.