Merge branch 'olexandr-klymenko-master'

Author: goranpavlovic

aiohttp_swagger/__init__.py

@@ -40,6 +40,7 @@ def setup_swagger(app: web.Application,
                   swagger_from_file: str = None,
                   swagger_url: str = "/api/doc",
                   api_base_url: str = "/",
+                  swagger_validator_url: str = "",
                   description: str = "Swagger API definition",
                   api_version: str = "1.0.0",
                   title: str = "Swagger API",
@@ -99,6 +100,7 @@ def setup_swagger(app: web.Application,
                      format(api_base_url.rstrip('/'), _swagger_def_url))
             .replace("##STATIC_PATH##", '{}{}'.
                      format(api_base_url.rstrip('/'), statics_path))
+            .replace("##SWAGGER_VALIDATOR_URL##", swagger_validator_url)
         )
 
 

aiohttp_swagger/swagger_ui/index.html

@@ -50,6 +50,7 @@
       }
       window.swaggerUi = new SwaggerUi({
         url: url,
+        validatorUrl: "##SWAGGER_VALIDATOR_URL##" || null,
         dom_id: "swagger-ui-container",
         supportedSubmitMethods: ['get', 'post', 'put', 'delete', 'patch'],
         onComplete: function(swaggerApi, swaggerUi){

doc/source/customizing.rst

@@ -255,4 +255,17 @@ In this case `api_base_url` argument of `setup_swagger` function should be the s
 
     app.add_subapp(prefix='/sub_app_prefix', subapp=sub_app)
 
-    web.run_app(app, host="127.0.0.1")
+    web.run_app(app, host="127.0.0.1")
+
+Swagger validation
++++++++++++++++++++
+
+:samp:`aiohttp-swagger` allows to perform online swagger validation. By default this feature is turned off `(swagger_validator_url='')`:
+
+
+.. code-block:: python
+
+    setup_swagger(app,
+                  api_base_url='/sub_app_prefix',
+                  swagger_validator_url='//online.swagger.io/validator'
+                  )