Merge ad4f6f3 into 41b3b59

Author: ProgHaj

flask_restx/api.py

@@ -94,6 +94,7 @@ class Api(object):
     :param FormatChecker format_checker: A jsonschema.FormatChecker object that is hooked into
         the Model validator. A default or a custom FormatChecker can be provided (e.g., with custom
         checkers), otherwise the default action is to not enforce any format validation.
+    :param str default_swagger_filename: The default swagger filename.
     """
 
     def __init__(
@@ -123,6 +124,7 @@ def __init__(
         catch_all_404s=False,
         serve_challenge_on_401=False,
         format_checker=None,
+        default_swagger_filename="swagger.json",
         **kwargs
     ):
         self.version = version
@@ -153,6 +155,7 @@ def __init__(
         self._refresolver = None
         self.format_checker = format_checker
         self.namespaces = []
+        self.default_swagger_filename = default_swagger_filename
 
         self.ns_paths = dict()
 
@@ -293,7 +296,7 @@ def _register_specs(self, app_or_blueprint):
                 app_or_blueprint,
                 SwaggerView,
                 self.default_namespace,
-                "/swagger.json",
+                "/" + self.default_swagger_filename,
                 endpoint=endpoint,
                 resource_class_args=(self,),
             )

tests/test_swagger.py

@@ -3323,3 +3323,25 @@ def get(self):
 
         path = data["paths"]["/with-parser/"]
         assert "parameters" not in path
+
+    def test_nondefault_swagger_filename(self, app, client):
+        api = restx.Api(doc="/doc/test", default_swagger_filename="test.json")
+        ns = restx.Namespace("ns1")
+
+        @ns.route("/test1")
+        class Ns(restx.Resource):
+            @ns.doc("Docs")
+            def get(self):
+                pass
+
+        api.add_namespace(ns)
+        api.init_app(app)
+
+        resp = client.get("/test.json")
+        assert resp.status_code == 200
+        assert resp.content_type == "application/json"
+        resp = client.get("/doc/test")
+        assert resp.status_code == 200
+        assert resp.content_type == "text/html; charset=utf-8"
+        resp = client.get("/ns1/test1")
+        assert resp.status_code == 200