feat: change swagger URL from /ui to /api

Some users got confused about the /ui endpoint being a full endpoint,
when it is not, lets move /ui to /api instead.

fixes: #131

deepaas/api/__init__.py

@@ -55,7 +55,7 @@
 async def get_app(
     swagger=True,
     enable_doc=True,
-    doc="/ui",
+    doc="/api",
     prefix="",
     static_path="/static/swagger",
     base_path="",

deepaas/api/versions.py

@@ -63,6 +63,12 @@ async def get(self):
         return web.json_response(response)
 
 
+@routes.get("/ui")
+async def redirect_ui(request):
+    doc_url = request.app.router.named_resources().get("swagger.docs").url_for()
+    return web.HTTPFound(doc_url)
+
+
 def register_version(version, func):
     # NOTE(aloga): we could use a @classmethod on Versions, but it fails
     # with a TypeError: 'classmethod' object is not callable since the function

deepaas/cmd/run.py

@@ -83,7 +83,7 @@ def main():
 
     base = "http://{}:{}".format(CONF.listen_ip, CONF.listen_port)
     spec = "{}/swagger.json".format(base)
-    docs = "{}/ui".format(base)
+    docs = "{}/api".format(base)
     v2 = "{}/v2".format(base)
 
     print(INTRO)

deepaas/config.py

@@ -55,7 +55,7 @@
         default=True,
         help="""
 Enable documentation endpoint. If set we will provide the documentation
-through the "/ui" endpoint. Default is to provide this information.
+through the "/api" endpoint. Default is to provide this information.
 """,
     ),
     cfg.IntOpt(

deepaas/tests/fake_responses.py

@@ -49,7 +49,7 @@
         v2_version,
     ],
     "links": [
-        {"rel": "help", "type": "text/html", "href": "/ui"},
+        {"rel": "help", "type": "text/html", "href": "/api"},
         {"rel": "describedby", "type": "application/json", "href": "/swagger.json"},
     ],
 }
@@ -59,15 +59,15 @@
         v2_version,
     ],
     "links": [
-        {"rel": "help", "type": "text/html", "href": "/ui"},
+        {"rel": "help", "type": "text/html", "href": "/api"},
         {"rel": "describedby", "type": "application/json", "href": "/swagger.json"},
     ],
 }
 
 empty_versions = {
     "versions": [],
     "links": [
-        {"rel": "help", "type": "text/html", "href": "/ui"},
+        {"rel": "help", "type": "text/html", "href": "/api"},
         {"rel": "describedby", "type": "application/json", "href": "/swagger.json"},
     ],
 }

deepaas/tests/test_v2_api.py

@@ -160,7 +160,7 @@ def assert_ok(self, response):
         self.assertIn(response.status, [200, 201])
 
     async def test_not_found(self):
-        ret = await self.client.get("/ui")
+        ret = await self.client.get("/api")
         self.assertEqual(404, ret.status)
 
 

deepaas/tests/test_versions_api.py

@@ -34,7 +34,7 @@ async def get_application(self):
         versions.Versions.versions = {}
 
         aiohttp_apispec.setup_aiohttp_apispec(
-            app=app, url="/swagger.json", swagger_path="/ui"
+            app=app, url="/swagger.json", swagger_path="/api"
         )
 
         return app